Deploy no Coolify

Cada app é um recurso no Coolify apontando para o repositório moldape/moldape-v2, com build por Nixpacks. Detalhes da topologia em Implantação.

Publicar uma versão

1. Faça o merge em main (ou no branch configurado no recurso).
2. No Coolify, abra o recurso (web, order-lifecycle ou docs) e clique em Deploy, ou aguarde o deploy automático, se estiver ativado.
3. Acompanhe o log de build. O Nixpacks lê o nixpacks.toml do app.
4. Confira:
   • API: https://api.moldape.com/health responde ok.
   • Web: login e abertura de um rascunho.
   • Docs: página inicial carrega.
5. Se der errado, use Rollback no Coolify para a imagem anterior.

Publicar a documentação pela primeira vez

1. Coolify → New Resource → repositório moldape-v2, build pack Nixpacks.
2. Base directory: /. Nixpacks config: apps/docs/nixpacks.toml.
3. Port: 4321. Domínio: por exemplo docs.moldape.com (criar o registro no Cloudflare).
4. Variável DOCS_SITE_URL=https://docs.moldape.com. Health check: GET /healthz.
5. Proteja com Basic Auth no Coolify se a documentação não for pública: ela descreve riscos de segurança.

Por que não `astro preview`

O astro preview usa o servidor de preview do Vite, que serve para testar o build localmente e recusa hosts que não conhece (erro Blocked request. This host is not allowed). Em produção a documentação é servida por scripts/serve.mjs: servidor estático sem dependências, com gzip, cache longo para /_astro/*, página 404 e proteção contra path traversal.

Cuidado

Nunca rode prisma migrate dev ou prisma:reset contra o banco de produção. Use pnpm prisma:migrate:deploy (prisma migrate deploy), de preferência como pre-deploy command do order-lifecycle no Coolify (R-07).