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.

By the end of this guide you will have a fully working local instance of Evalua Javiera running at http://localhost:8000. You will be able to log in as a student, select a teacher, submit a rating, and view the certificate page — all without touching a database or configuring any external services.
Ratings are stored entirely in your browser’s localStorage. No database, no server-side session, and no environment variables are required to run the app.

​
Setup

1

Prerequisites

Make sure you have the following installed before continuing:
  • Python 3.8 or later — verify with python --version
  • pip — bundled with Python 3.8+; verify with pip --version
python --version
# Python 3.11.x (or any 3.8+)

pip --version
# pip 23.x ...
2

Clone the repository

Clone the project from GitHub and change into the project directory:
git clone https://github.com/groupTwoisTheBest/evaJav.git && cd evaJav
3

Install dependencies

The application requires fastapi and jinja2, listed in requirements.txt, plus uvicorn to serve the app. Install all three:
pip install -r requirements.txt
pip install uvicorn
requirements.txt contents for reference:
fastapi
jinja2
Working inside a virtual environment is recommended to keep your global Python environment clean:
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt
pip install uvicorn
4

Start the development server

Launch the FastAPI application with uvicorn. The --reload flag automatically restarts the server whenever you save a source file — ideal during development:
uvicorn main:app --reload
You should see output similar to:
INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
INFO:     Started reloader process [...] using WatchFiles
INFO:     Started server process [...]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
The --reload flag watches your project directory for file changes. Remove it when deploying to production or when running performance-sensitive tests.
5

Open the app in your browser

Navigate to the app’s root URL:
http://localhost:8000
You will be greeted by the EVAJ login form, which asks for a Document number (username) and a Password.
6

Log in as a student

Three student accounts are pre-configured in static/js/index.js. Use any of the following document numbers with the shared password MJAVIERA:
Document NumberPassword
1025657849MJAVIERA
1025657456MJAVIERA
1020113554MJAVIERA
For example, to log in with the first account:
Document:  1025657849
Password:  MJAVIERA
After a successful login you will be redirected to /seleccionatuprofesor — the teacher selection page.

​
What’s Next

User Flow Guide

Explore every screen in detail — teacher selection at /seleccionatuprofesor, the rating form at /calificaElProfesor, and the certificate page at /Agradecimiento.

Routes Reference

See all four FastAPI route definitions, their response classes, templates, and the JavaScript bundle each page loads.

Build docs developers (and LLMs) love

Get started for freeTalk to us