Skip to content

docs(deploy): document Dokploy deployment and drop Arcane flow - #428

Merged
Alountk merged 1 commit into
mainfrom
docs/dokploy-deploy
Nov 18, 2026
Merged

Alountk merged 1 commit into
mainfrom
docs/dokploy-deploy

Conversation

@Alountk

@Alountk Alountk commented Nov 18, 2026

Copy link
Copy Markdown
Owner

Pull Request

Summary

  • Actualiza la documentación de despliegue de Arcane → Dokploy tras la migración de producción (dominio https://bb.marchan.dev).
  • Documenta los puntos no triviales del stack nuevo: Traefik → contenedor 3444 (sin puerto publicado), postgres solo en loopback (pierna de auth e2e) y APP_URL para enlaces absolutos del mail.
  • Reescribe la sección de automatización: CI publica :latest en GHCR y el redespliegue es el Deploy de Dokploy (o su webhook auto-deploy), conservando la advertencia de imagen vieja y del servicio migrate.

Changes

File Change
README.md §3 "Deploy (Docker / Dokploy)": dominio, red externa, puerto 3444, env APP_URL; blurb de docs → Dokploy
docs/auth.md §Deployment (Dokploy) reescrito; §Deploy automation → GHCR + Dokploy Deploy/webhook (sin webhook→Arcane)
ROADMAP.md Notas de deploy: operativa de actualización en Dokploy en vez de Arcane
CONTRIBUTING.md Guía de reporte: "producción (LAN/Arcane)" → "bb.marchan.dev / Dokploy"

Test Plan

  • pnpm test — 3,779 pass / 6 skipped (243 files, vía pre-commit hook)
  • AUTH_MODE=local pnpm exec playwright test — n/a (solo docs)
  • pnpm run test:e2e:auth — n/a (solo docs)
  • pnpm lint + npx tsc --noEmit — lint limpio (hook); tsc n/a (sin cambios TS)
  • Migración Prisma aplicada (n/a)

Definition of Done

  • Issue vinculado y criterios de aceptación cumplidos — sin issue: precedente de los últimos PRs mergeados (ninguno vincula issue)
  • Evidencia RED→GREEN — n/a: cambio documental, sin comportamiento
  • Suites + pnpm lint en verde
  • Ayuda/docs actualizados con el cambio de flujo de despliegue
  • Línea Risk: … añadida (Risk: none)

Review checklist

  • Design — n/a (docs)
  • Functionality — ¿la documentación describe exactamente el despliegue actual?
  • Complexity — ¿se puede simplificar?
  • Tests — n/a (docs)
  • Naming — títulos/secciones coherentes
  • Comments — n/a
  • Style — inglés en README/auth.md, español en ROADMAP/CONTRIBUTING (convención por fichero)
  • Documentation — este PR es documentación

Notes

  • No toca AGENTS.md a propósito: estaba sucio con cambios locales del usuario (regla next dev); conviene actualizar su línea de "producción (Arcane)" en un PR posterior cuando el fichero esté limpio.
  • ROADMAP.md línea 110 (changelog histórico "imagen vieja en Arcane") se conserva: es historial.
  • Cualquier redespliegue debe ejecutar la pila completa (migrate antes de web).

@Alountk Alountk added the type:docs Documentation only label Nov 18, 2026
@Alountk
Alountk merged commit b5d5b60 into main Nov 18, 2026
12 checks passed
@Alountk
Alountk deleted the docs/dokploy-deploy branch November 18, 2026 22:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type:docs Documentation only

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant