# TASK-009-backend-package-hygiene-and-entrypoint-alignment ## Goal Corregir y alinear la estructura mínima del paquete backend en Python para HLL Vietnam, asegurando que el paquete, los imports y el entrypoint real sean consistentes, legibles y mantenibles. ## Context El backend bootstrap y el esqueleto API placeholder ya existen, pero en resúmenes recientes aparece una posible inconsistencia con el archivo de paquete Python (`init.py` frente a `__init__.py`). Antes de continuar con más ajustes o integrar consumo desde frontend, es importante dejar la base del paquete limpia y sin ambigüedades. ## Steps 1. Revisar la estructura actual de `backend/app/`. 2. Confirmar si el archivo correcto del paquete existe como: - `backend/app/__init__.py` 3. Si existe cualquier inconsistencia de naming o packaging, corregirla. 4. Revisar y alinear los imports internos del backend para que sean coherentes con la estructura final. 5. Confirmar cuál es el entrypoint real del backend y dejarlo claro en la documentación. 6. Revisar el comando de arranque documentado y adaptarlo si fuera necesario. 7. Validar que los endpoints placeholder actuales siguen funcionando tras el ajuste. 8. Mantener el cambio pequeño y centrado en higiene estructural, no en nuevas funcionalidades. ## Files to Read First - AGENTS.md - ai/repo-context.md - ai/architecture-index.md - backend/README.md - backend/requirements.txt - backend/app/__init__.py - backend/app/main.py - backend/app/routes.py - backend/app/payloads.py ## Expected Files to Modify - backend/app/__init__.py - backend/app/main.py - backend/app/routes.py - backend/README.md - opcionalmente otros archivos internos del backend si son estrictamente necesarios para alinear imports y entrypoint ## Constraints - No añadir integraciones reales. - No introducir dependencias nuevas innecesarias. - No tocar frontend. - No añadir base de datos. - No hacer cambios destructivos fuera del alcance del paquete backend. - Mantener el backend simple y consistente con la fase actual. ## Validation - Existe un archivo de paquete Python correcto en `backend/app/__init__.py`. - No quedan referencias ambiguas o incorrectas al package layout. - El entrypoint del backend está claro. - Los endpoints placeholder actuales siguen respondiendo. - La documentación del backend refleja el estado real. ## Change Budget - Preferir menos de 5 archivos modificados. - Preferir menos de 160 líneas cambiadas.