fix(qa): resolver diagnosticos estaticos, sincronizacion moodle y actualizar docs v3.6.4
This commit is contained in:
@@ -3,21 +3,21 @@ Plataforma web de gestión de espacios áulicos, sincronización académica y as
|
||||
|
||||
## Stack y Estructura
|
||||
- **Arquitectura**: Desacoplada (Backend Core REST API + Frontend BFF).
|
||||
- **Backend Core**: Python 3.12, Flask 3.1, SQLAlchemy ORM, SQLite / PostgreSQL 15, Marshmallow/Pydantic DTOs, Flask-JWT-Extended (HS256 stateless).
|
||||
- **Backend Core**: Python 3.12/3.14, FastAPI 0.115+, Uvicorn (ASGI) + Flask 3.1 / WSGI bridge (`a2wsgi`), SQLAlchemy ORM 2.0, SQLite / PostgreSQL 15, Pydantic v2 DTOs (`BaseModel`), PyJWT / Flask-JWT-Extended (HS256 stateless).
|
||||
- **Frontend BFF**: Node.js v20+, Express.js, motor de plantillas Nunjucks, cliente Axios con interceptores de autorización Bearer, Bootstrap 5 + Vanilla CSS.
|
||||
- **Integraciones Clave**:
|
||||
- Google OAuth 2.0 para autenticación institucional restringida a `@unicaba.edu.ar`.
|
||||
- Moodle 4.1 REST API (`core_webservice_*`, `enrol_*`) con cola asíncrona resiliente (`MoodleSyncTask`), reintentos exponenciales, Dead Letter Queue (DLQ) y capa de caché híbrida (`CacheService` en Redis / memoria).
|
||||
- Moodle 4.1 REST API (`core_webservice_*`, `enrol_*`) con cola asíncrona resiliente (`MoodleSyncTask`), reintentos exponenciales, Dead Letter Queue (DLQ), capa de caché híbrida (`CacheService` en Redis / memoria) y resolución transparente de IDs de usuario en `update_users`.
|
||||
- Motor de Notificaciones SMTP dinámico (`EmailService`) con credenciales cifradas con Fernet en base de datos.
|
||||
- Importador oficial de Google Sheets (`sheets_importer.py`) para ingesta masiva inicial.
|
||||
- **Entorno de Ejecución**: Contenedores Linux LXC en Proxmox con Nginx como proxy inverso y terminación SSL (entorno productivo institucional: `eduspace.oemspot.com.ar`).
|
||||
|
||||
## Comandos de Desarrollo y Verificación
|
||||
- **Levantar Backend (Flask API :5000)**:
|
||||
- **Levantar Backend (FastAPI / ASGI :5000)**:
|
||||
```powershell
|
||||
cd backend
|
||||
.\venv\Scripts\activate
|
||||
flask run --port 5000
|
||||
uvicorn main:app --host 0.0.0.0 --port 5000 --reload
|
||||
```
|
||||
- **Levantar Frontend BFF (Express :3000)**:
|
||||
```powershell
|
||||
|
||||
Reference in New Issue
Block a user