Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/groupTwoisTheBest/evaJav/llms.txt

Use this file to discover all available pages before exploring further.

Evalua Javiera (EVAJ) is a lightweight web application designed to give students a simple, structured way to rate their teachers. Built by Group Two, the platform guides a student through a three-step flow — log in with their document number, pick a teacher, and submit a rating across three pedagogical categories — then presents a certificate acknowledging their participation. The goal is to make teacher feedback effortless and anonymous enough to encourage honest responses, while keeping the technical footprint minimal so the app can be deployed and maintained without a dedicated backend team.

Tech Stack

Evalua Javiera is built on a deliberately lean set of technologies:
  • FastAPI — serves all four route endpoints and renders Jinja2 templates server-side.
  • Jinja2 — handles HTML templating; each page extends a shared base.html layout.
  • Vanilla JavaScript — manages client-side login validation, teacher selection, rating submission, and navigation via localStorage.
  • CSS — provides a responsive dark-themed UI across all pages.
  • Vercel — the recommended deployment target; zero-config for Python ASGI apps.
No database is required. All transient session data (selected teacher, submitted ratings) is written to and read from the browser’s localStorage.

Key Features

Student Login

Students authenticate with their document number and the shared platform password. Credentials are validated client-side before any navigation occurs.

Teacher Selection

A dedicated selection page lets students choose from the available roster — Lenny, Erika, or Freddy — before proceeding to the rating form.

Multi-Category Rating

Each teacher is rated across three independent categories: Topic Explanation (explicationsTopics), Attitude (actitudinal), and Class Activities (classActivity), each scored from Malo to Excelente.

localStorage Persistence

The selected teacher and all three rating values are stored in localStorage, meaning no server-side session or database is needed to carry state between pages.

Responsive Dark UI

All pages share a dark-themed stylesheet served from /static/, designed to display cleanly on both desktop and mobile browsers.

Certificate / Thank-You Page

After submitting ratings, students land on a certificate page (/Agradecimiento) acknowledging their participation, with a link back to select another teacher.

Next Steps

Quickstart

Clone the repo, install dependencies, and have Evalua Javiera running locally in under five minutes.

User Flow Guide

Walk through every screen — login, teacher selection, rating form, and certificate — with annotated screenshots and route details.

Build docs developers (and LLMs) love