DentMatch
Proyecto Capstone Grupo Ockham
Descripción
DentMatch es una plataforma web que conecta a estudiantes de Odontología que necesitan pacientes para sus prácticas clínicas con personas que buscan atención dental de bajo costo. Los estudiantes crean un perfil verificado con sus procedimientos pendientes, su disponibilidad y su lugar de atención. Los pacientes publican su necesidad y encuentran estudiantes que se ajusten a ella. La plataforma gestiona las postulaciones entre ambas partes y la agenda de citas, mostrando información que genera confianza (universidad, año de carrera, supervisión docente).
En etapas siguientes se incorporarán un sistema de coincidencia y clasificación de solicitudes con IA, un chat de coordinación y moderación de contenido.
Integrantes
- Benjamín Canales, Líder del Proyecto y Desarrollador Backend
- Jorge Curiqueo, Desarrollo IA y Datos
- Joaquín Rohland, Desarrollador Frontend y Desarrollo IA
Tecnologías
- Backend: Python con FastAPI y SQLAlchemy
- Frontend: HTML, CSS y JavaScript (lo sirve el mismo backend)
- Base de datos: PostgreSQL (Supabase)
- Autenticación: tokens JWT y contraseñas con hash bcrypt
Requisitos previos
- Python 3.10 o superior
- Git
- Acceso a una base de datos PostgreSQL (la del equipo en Supabase o una local)
Puesta en marcha
1. Obtener el código
git clone <URL-del-repositorio>
cd DentMatch
2. Crear y activar el entorno virtual
python -m venv venv
Activarlo según tu sistema:
| Sistema | Comando |
|---|
| Windows (PowerShell) | .\venv\Scripts\Activate.ps1 |
| Windows (CMD) | venv\Scripts\activate.bat |
| macOS / Linux | source venv/bin/activate |
Sabrás que funcionó cuando el inicio de la línea muestre (venv).
En PowerShell, si aparece un error de permisos, ejecuta una vez:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
y vuelve a activar el entorno.
3. Instalar las dependencias
pip install -r requirements.txt
4. Configurar las variables de entorno
Copia el archivo de ejemplo con el nombre .env (sin .example):
# Windows (PowerShell)
Copy-Item .env.example .env
# macOS / Linux
cp .env.example .env
Luego edita .env y completa dos valores:
| Variable | Qué es |
|---|
DATABASE_URL | Dirección de conexión a PostgreSQL. Pídele la del equipo a quien administra la base de datos, o usa una local con el formato postgresql://usuario:contraseña@localhost:5432/dentmatch. |
SECRET_KEY | Clave con la que el servidor firma los tokens de sesión. Puede ser cualquier texto largo y aleatorio. |
Para generar una SECRET_KEY:
python -c "import secrets; print(secrets.token_urlsafe(48))"
El archivo .env contiene secretos. Nunca debe subirse a Git (ya está en el .gitignore).
5. Iniciar el servidor
uvicorn app.main:app --reload --port 8001
Al arrancar, la aplicación crea automáticamente las tablas que falten en la base de datos. Las que ya existen no se modifican.
Si todo salió bien verás:
INFO: Uvicorn running on http://127.0.0.1:8001
INFO: Application startup complete.
6. Abrir la aplicación
Nota: estas direcciones corresponden al entorno de desarrollo local: el servidor (Uvicorn) corre en tu propio computador (localhost), por lo que solo tú puedes acceder a ellas. Actualmente se están evaluando distintos servicios de alojamiento (hosting) para publicar la aplicación en internet, pero aún no hay uno definido. Esta sección se actualizará con la dirección pública cuando esté disponible.
Después de iniciar sesión, cada usuario entra a su portal: /paciente o /estudiante.
Usa siempre el puerto 8001: el servidor solo acepta peticiones de ese origen.
Tareas habituales
Crear un usuario administrador
El registro público no permite crear administradores. Para crear uno:
python -m scripts.crear_admin
Te pedirá nombre, RUT, correo y contraseña. El administrador puede verificar estudiantes mediante la API (/docs).
Ejecutar las pruebas automáticas
pip install -r requirements-dev.txt
pytest
Las pruebas usan una base de datos temporal en memoria: no tocan la base real.
Detener el servidor
Presiona Ctrl + C en la terminal. Para salir del entorno virtual, escribe deactivate.
Estructura del proyecto
app/ Backend (FastAPI)
routers/ Un archivo por sección de la API (auth, solicitudes, postulaciones, citas...)
models.py Tablas de la base de datos
auth.py Contraseñas, tokens y control de acceso por rol
frontend/ Páginas, estilos y scripts del navegador
scripts/ Herramientas de apoyo (crear administrador)
tests/ Pruebas automáticas
Solución de problemas
| Problema | Posible causa |
|---|
No se encontró DATABASE_URL o SECRET_KEY | Falta el archivo .env o alguna de las dos variables. |
ModuleNotFoundError | El entorno virtual no está activado o faltó instalar las dependencias. |
| No conecta a la base de datos | DATABASE_URL incorrecta o sin acceso a internet (Supabase). |
| La página no carga o el login falla | Estás usando un puerto distinto de 8001. |
