Entorno y comandos¶
Docker (desarrollo local)¶
Los servicios se registran en el nginx-proxy compartido por VIRTUAL_HOST (*.marinacx.mywire.org).
docker compose -f docker/docker-compose.dev.yml up -d --build
| Servicio | URL |
|---|---|
| Frontend | https://app.marinacx.mywire.org |
| API | https://api.marinacx.mywire.org |
| Adminer (BD) | https://adm.marinacx.mywire.org |
Documentación viva del API (Swagger) en https://api.marinacx.mywire.org/docs.
Backend¶
ruff check # lint
ruff format # formato
mypy app # tipos
pytest # tests
alembic upgrade head # migraciones
uvicorn app.main:app --reload
Definition of Done antes de mergear: ruff y mypy limpios, pytest en verde, migración Alembic por cada cambio de esquema, y tests para cada router/servicio/repo nuevo.
Frontend¶
npm run lint
npm run build # compilación AoT (verificación real, no solo tsc)
npm test # Karma + ChromeHeadless
Cada componente/servicio/pipe nuevo lleva su *.spec.ts.
Ramas y PRs¶
- Rama por tarea (
feature/<name>,fix/<name>), commits#<issue>: <descripción>. - Cada PR se revisa con Copilot antes de mergear.