Skip to content

docs(sprint-20): add deploy readiness spec and adr#80

Merged
David-LS-Bilbao merged 1 commit into
devfrom
docs/sprint-20-deploy-readiness-plan
Jul 9, 2026
Merged

docs(sprint-20): add deploy readiness spec and adr#80
David-LS-Bilbao merged 1 commit into
devfrom
docs/sprint-20-deploy-readiness-plan

Conversation

@David-LS-Bilbao

Copy link
Copy Markdown
Owner

Sprint 20.0 — Spec + ADR de deploy readiness

Resumen

Añade la spec SDD y el ADR de arquitectura para preparar el deploy dev/staging de JobIT,
sin desplegar todavía y sin crear artefactos Docker aún.

Cambios principales

  • Nueva spec: docs/specs/features/deploy-staging-readiness.md.
  • Nuevo ADR: docs/decisions/ADR-0012-staging-deploy-architecture.md.

Decisiones documentadas

  • Alcance Sprint 20: opción B — docs + Docker verificable en local, sin tocar VPS.
  • Staging con Web, API y PostgreSQL en contenedores sobre red interna Docker.
  • Nginx Proxy Manager existente como reverse proxy futuro (HTTPS/Let's Encrypt).
  • Subdominios same-site bajo davlos.es: jobit-staging.davlos.es y
    api-jobit-staging.davlos.es (la cookie SameSite=Lax actual funciona sin tocar código).
  • PostgreSQL staging en red interna, sin puerto publicado al host.
  • Uploads/avatares con volumen persistente incluido en backups.
  • Migraciones Prisma gated: prisma migrate deploy manual con backup previo obligatorio.
  • Seed ficticio inicial; ingesta real Jooble/Greenhouse fuera de alcance.
  • Rollback por imágenes taggeadas por SHA + dump pre-migración.
  • Deploy real fuera del Sprint 20 salvo autorización posterior (gate 20.6).

Verificaciones

  • git diff --check → OK.
  • Cambio limitado a dos archivos Markdown (+386 líneas); sin superficie de runtime.
  • La PR debe pasar los required checks actuales de JobIT CI.

Fuera de alcance respetado

  • Sin Dockerfiles, docker-compose, .dockerignore ni env templates (fases 20.1–20.3).
  • Sin cambios en código, workflows, package.json/pnpm-lock.yaml.
  • Sin VPS/DNS/Nginx ni secretos reales.

Revisión

PR lista para revisión humana. No mergear por CLI.

@David-LS-Bilbao David-LS-Bilbao merged commit 443b540 into dev Jul 9, 2026
2 checks passed
@David-LS-Bilbao David-LS-Bilbao deleted the docs/sprint-20-deploy-readiness-plan branch July 9, 2026 07:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant