Backend Estructura Escalable

2. Crear estructura base de carpetas

• app/main.py para bootstrap
• app/api para routers y dependencias HTTP
• app/core para config, seguridad, logging y utilidades
• app/db para engine, session, base y migraciones
• app/modules/auth, app/modules/users, app/modules/incidents, app/modules/workshops
• tests con separacion unit e integration

3. Aplicar separacion por modulo

• Cada modulo debe incluir router.py, service.py, repository.py, schemas.py y models.py
• Router solo orquesta request/response
• Service contiene reglas de negocio
• Repository encapsula acceso a base de datos

4. Configurar dependencias y settings

• Variables en .env y .env.example
• Configuracion tipada en app/core/config.py
• Inyeccion de dependencias en app/api/dependencies.py

5. Configurar PostgreSQL y SQLAlchemy

• DATABASE_URL desde settings
• Session por request
• Migraciones con Alembic

6. Preparar testing

• pytest.ini y conftest.py con fixtures
• Unit tests para services
• API tests para routers

7. Entregar salida

• Arbol de carpetas completo
• Explicacion breve de cada carpeta
• Comandos de run, migrate y test

Logica de decision

• Si el equipo necesita alta concurrencia I/O: priorizar SQLAlchemy async.
• Si hay integraciones legacy sync: iniciar en sync y migrar gradualmente.
• Si el dominio crece rapido: priorizar modulo por bounded context desde el inicio.

Criterios de calidad

• Arquitectura por capas consistente en todos los modulos
• Sin secretos hardcodeados
• Estructura preparada para CI/CD y pruebas automatizadas
• Convenciones documentadas para onboarding rapido

Formato de salida esperado

• Seccion 1: arbol de carpetas
• Seccion 2: explicacion breve de cada carpeta
• Seccion 3: comandos utiles del proyecto