[{"data":1,"prerenderedAt":922},["ShallowReactive",2],{"docs-page-\u002Fdocs\u002Fdeploy":3,"docs-surround-\u002Fdocs\u002Fdeploy":891,"docs-navigation":903},{"id":4,"title":5,"body":6,"description":882,"extension":883,"meta":884,"navigation":885,"path":887,"seo":888,"stem":889,"__hash__":890},"docs\u002Fdocs\u002F4.deploy.md","Deploy y CI\u002FCD",{"type":7,"value":8,"toc":871},"minimark",[9,27,82,92,97,100,105,181,186,239,249,257,272,379,448,458,463,481,498,502,509,560,648,715,719,726,756,781,785,800,834,838,867],[10,11,12,13,17,18,22,23,26],"p",{},"El despliegue corre sobre ",[14,15,16],"strong",{},"Dokploy",", disparado por GitHub Actions después de un CI en verde. Hay dos entornos: producción (rama ",[19,20,21],"code",{},"main",") y dev (rama ",[19,24,25],{},"dev",", con su propio dominio y su propia base de datos).",[28,29,30,43],"table",{},[31,32,33],"thead",{},[34,35,36,40],"tr",{},[37,38,39],"th",{},"Momento",[37,41,42],{},"Qué corre",[44,45,46,63,73],"tbody",{},[34,47,48,52],{},[49,50,51],"td",{},"PR",[49,53,54,55,58,59,62],{},"CI: ",[19,56,57],{},"pnpm lint"," + ",[19,60,61],{},"pnpm build"," (bloqueantes) y typecheck informativo",[34,64,65,70],{},[49,66,67,68],{},"Push\u002Fmerge a ",[19,69,25],{},[49,71,72],{},"CI + despliegue del entorno dev",[34,74,75,79],{},[49,76,67,77],{},[19,78,21],{},[49,80,81],{},"CI + despliegue de producción con health check",[83,84,90],"pre",{"className":85,"code":87,"language":88,"meta":89},[86],"language-text","feature\u002F* · fix\u002F* ──push──▶ PR ──▶ merge a dev ──▶ CI ──▶ Deploy (dev) ──▶ https:\u002F\u002Fdev.tudominio.com\n                                                     │\n                                       (cuando dev está estable)\n                                                     ▼\n                                    PR release: dev ──▶ main ──▶ CI ──▶ Deploy (prod) ──▶ health check\n","text","",[19,91,87],{"__ignoreMap":89},[93,94,96],"h2",{"id":95},"activar-el-despliegue","Activar el despliegue",[10,98,99],{},"Los workflows vienen apagados; se encienden con variables y secretos del repositorio (Settings → Secrets and variables → Actions).",[10,101,102],{},[14,103,104],{},"Variables",[28,106,107,120],{},[31,108,109],{},[34,110,111,114,117],{},[37,112,113],{},"Variable",[37,115,116],{},"Ejemplo",[37,118,119],{},"Para qué",[44,121,122,137,152,166],{},[34,123,124,129,134],{},[49,125,126],{},[19,127,128],{},"DOKPLOY_DEPLOY_ENABLED",[49,130,131],{},[19,132,133],{},"true",[49,135,136],{},"Enciende el deploy de producción",[34,138,139,144,149],{},[49,140,141],{},[19,142,143],{},"HEALTHCHECK_URL",[49,145,146],{},[19,147,148],{},"https:\u002F\u002Ftudominio.com\u002Fapi\u002Fhealth",[49,150,151],{},"Verifica el rollout",[34,153,154,159,163],{},[49,155,156],{},[19,157,158],{},"DOKPLOY_DEV_DEPLOY_ENABLED",[49,160,161],{},[19,162,133],{},[49,164,165],{},"Enciende el deploy del entorno dev",[34,167,168,173,178],{},[49,169,170],{},[19,171,172],{},"DEV_HEALTHCHECK_URL",[49,174,175],{},[19,176,177],{},"https:\u002F\u002Fdev.tudominio.com\u002Fapi\u002Fhealth",[49,179,180],{},"Verifica el rollout de dev",[10,182,183],{},[14,184,185],{},"Secretos",[28,187,188,197],{},[31,189,190],{},[34,191,192,195],{},[37,193,194],{},"Secret",[37,196,119],{},[44,198,199,209,219,229],{},[34,200,201,206],{},[49,202,203],{},[19,204,205],{},"DOKPLOY_WEBHOOK_URL",[49,207,208],{},"Webhook de la app de producción en Dokploy",[34,210,211,216],{},[49,212,213],{},[19,214,215],{},"PRODUCTION_DATABASE_URL",[49,217,218],{},"Aplica migraciones antes del deploy (si falta, ese paso se salta)",[34,220,221,226],{},[49,222,223],{},[19,224,225],{},"DOKPLOY_DEV_WEBHOOK_URL",[49,227,228],{},"Webhook de la app dev",[34,230,231,236],{},[49,232,233],{},[19,234,235],{},"DEV_DATABASE_URL",[49,237,238],{},"Migraciones de la base de dev",[240,241,242],"warning",{},[10,243,244,245,248],{},"Elige ",[14,246,247],{},"un solo mecanismo",": o el auto-deploy de Dokploy (al hacer push) o el workflow. Con los dos activos, cada merge despliega dos veces.",[93,250,252,253,256],{"id":251},"el-entorno-dev-devtudominiocom","El entorno dev (",[19,254,255],{},"dev.tudominio.com",")",[10,258,259,260,262,263,267,268,271],{},"Una segunda aplicación en Dokploy que sirve la rama ",[19,261,25],{},", con base de datos propia. Los pasos completos están en la sección ",[264,265,266],"em",{},"Entorno dev"," de ",[19,269,270],{},"DEPLOYMENT.md","; en resumen:",[273,274,275,288,308,326,340,351],"ol",{},[276,277,278,281,282,284,285,287],"li",{},[14,279,280],{},"Base de datos",": una rama (branch) de Neon para ",[19,283,25],{},", creada desde la principal. Su connection string será ",[19,286,235],{},".",[276,289,290,293,294,296,297,300,301,304,305,287],{},[14,291,292],{},"Aplicación en Dokploy",": mismo repo, branch ",[19,295,25],{},", build con Nixpacks, comando de arranque ",[19,298,299],{},"node .output\u002Fserver\u002Findex.mjs"," y puerto ",[19,302,303],{},"3000",". Health check en ",[19,306,307],{},"\u002Fapi\u002Fhealth",[276,309,310,313,314,317,318,321,322,325],{},[14,311,312],{},"Variables de la app dev",": ",[19,315,316],{},"NUXT_DATABASE_URL"," (rama dev), ",[19,319,320],{},"BETTER_AUTH_SECRET"," propio y ",[19,323,324],{},"NUXT_APP_URL"," apuntando al dominio de dev. Better Auth usa esa URL como baseURL: magic links, invitaciones y callbacks deben apuntar ahí.",[276,327,328,331,332,335,336,339],{},[14,329,330],{},"Dominio",": agrega el host en Dokploy (HTTPS con Let's Encrypt) y crea un registro DNS ",[19,333,334],{},"A"," apuntando a la IP del servidor (o ",[19,337,338],{},"CNAME"," al dominio raíz).",[276,341,342,345,346,348,349,287],{},[14,343,344],{},"Automatización",": pega el webhook en el secreto ",[19,347,225],{}," y enciende ",[19,350,158],{},[276,352,353,313,356,58,359,362,363,366,367,370,371,374,375,378],{},[14,354,355],{},"E2E remoto (opcional)",[19,357,358],{},"E2E_ENABLED=true",[19,360,361],{},"E2E_BASE_URL"," y los secretos ",[19,364,365],{},"E2E_EMAIL"," \u002F ",[19,368,369],{},"E2E_PASSWORD"," de una cuenta ",[19,372,373],{},"owner"," de dev. La suite ",[14,376,377],{},"escribe y borra datos",": apúntala solo a dev.",[83,380,384],{"className":381,"code":382,"language":383,"meta":89,"style":89},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# Primera vez: crea la rama dev desde un main que ya tenga los workflows\ngit switch main && git pull\ngit switch -c dev\ngit push -u origin dev\n","bash",[19,385,386,395,419,432],{"__ignoreMap":89},[387,388,391],"span",{"class":389,"line":390},"line",1,[387,392,394],{"class":393},"sHwdD","# Primera vez: crea la rama dev desde un main que ya tenga los workflows\n",[387,396,398,402,406,409,413,416],{"class":389,"line":397},2,[387,399,401],{"class":400},"sBMFI","git",[387,403,405],{"class":404},"sfazB"," switch",[387,407,408],{"class":404}," main",[387,410,412],{"class":411},"sMK4o"," &&",[387,414,415],{"class":400}," git",[387,417,418],{"class":404}," pull\n",[387,420,422,424,426,429],{"class":389,"line":421},3,[387,423,401],{"class":400},[387,425,405],{"class":404},[387,427,428],{"class":404}," -c",[387,430,431],{"class":404}," dev\n",[387,433,435,437,440,443,446],{"class":389,"line":434},4,[387,436,401],{"class":400},[387,438,439],{"class":404}," push",[387,441,442],{"class":404}," -u",[387,444,445],{"class":404}," origin",[387,447,431],{"class":404},[449,450,451],"tip",{},[10,452,453,454,457],{},"Atajo interactivo: ",[19,455,456],{},".\u002Fscripts\u002Fsetup-dokploy-dev.sh"," (raíz del repo) recorre este montaje paso a paso — abre Neon y Dokploy, captura los valores, genera el secreto de auth, escribe los secrets\u002Fvariables en GitHub y compone el bloque de variables listo para pegar en Dokploy.",[459,460,462],"h3",{"id":461},"variables-por-entorno","Variables por entorno",[10,464,465,466,469,470,473,474,477,478,287],{},"Cada aplicación de Dokploy tiene su propio ",[14,467,468],{},"Environment",": la app de dev y la de producción no comparten variables aunque vivan en el mismo proyecto. Hay tres niveles — compartidas del proyecto (",[19,471,472],{},"${{project.VAR}}","), del entorno (",[19,475,476],{},"${{environment.VAR}}",", si tu versión los soporta) y del servicio (las de cada app, que pisan a las anteriores); lo que cambia por entorno va siempre a nivel de ",[14,479,480],{},"servicio",[10,482,483,484,486,487,490,491,493,494,497],{},"Guardar cambios en la pestaña ",[264,485,468],{}," no toca el contenedor en marcha: lanza un ",[14,488,489],{},"Deploy"," después de editar. ",[19,492,324],{}," además se lee al construir (i18n ",[19,495,496],{},"baseUrl","), así que defínela antes del primer build.",[93,499,501],{"id":500},"páginas-estáticas-prerender","Páginas estáticas (prerender)",[10,503,504,505,508],{},"Las páginas públicas se generan en el build y se sirven como archivos estáticos desde ",[19,506,507],{},".output\u002Fpublic","; el resto (dashboard, auth, API) sigue renderizándose en el servidor.",[28,510,511,521],{},[31,512,513],{},[34,514,515,518],{},[37,516,517],{},"Ruta",[37,519,520],{},"Cómo se sirve",[44,522,523,537,550],{},[34,524,525,530],{},[49,526,527],{},[19,528,529],{},"\u002F",[49,531,532,533,536],{},"Estática (HTML + ",[19,534,535],{},"_payload.json","), sin coste SSR",[34,538,539,547],{},[49,540,541,58,544],{},[19,542,543],{},"\u002Fdocs",[19,545,546],{},"\u002Fdocs\u002F**",[49,548,549],{},"Estática, una por archivo Markdown",[34,551,552,555],{},[49,553,554],{},"Todo lo demás",[49,556,557,558],{},"SSR en ",[19,559,299],{},[561,562,563,603,617,630,637],"ul",{},[276,564,565,566,569,570,573,574,577,578,577,581,584,585,588,589,592,593,596,597,584,600,287],{},"La lista vive en ",[19,567,568],{},"routeRules"," (",[19,571,572],{},"nuxt.config.ts","): ",[19,575,576],{},"'\u002F'",", ",[19,579,580],{},"'\u002F_payload.json'",[19,582,583],{},"'\u002Fdocs'"," y ",[19,586,587],{},"'\u002Fdocs\u002F**'"," con ",[19,590,591],{},"prerender: true",", y un catch-all ",[19,594,595],{},"'\u002F**': { prerender: false }"," que mantiene al crawler fuera de ",[19,598,599],{},"\u002Fapp",[19,601,602],{},"\u002Fauth",[276,604,605,608,609,612,613,616],{},[14,606,607],{},"Agregar una sección no requiere tocar la config",": el crawler (",[19,610,611],{},"crawlLinks",") descubre los archivos nuevos de ",[19,614,615],{},"content\u002Fdocs\u002F"," desde los enlaces del índice.",[276,618,619,625,626,629],{},[14,620,621,622],{},"El build pasa sin ",[19,623,624],{},".env"," (CI no tiene secretos): auth, colas y Resend se protegen con ",[19,627,628],{},"import.meta.prerender",". No hay nada que configurar.",[276,631,632,633,636],{},"El HTML se genera en inglés; el idioma del visitante (cookie ",[19,634,635],{},"i18n_locale",") se aplica en el cliente inmediatamente después de la hidratación, sin recargar.",[276,638,639,640,642,643,645,646,287],{},"Si en el futuro agregas otra página pública, dale su propia regla ",[19,641,591],{}," (el catch-all la bloquearía) y verificá que exista su ",[19,644,535],{}," en ",[19,647,507],{},[83,649,651],{"className":381,"code":650,"language":383,"meta":89,"style":89},"pnpm build                              # 13 rutas prerenderizadas\n(nohup node .output\u002Fserver\u002Findex.mjs &) # sirve .output: estáticas + SSR\nmv .env .env.ci-bak && pnpm build; mv .env.ci-bak .env   # la prueba de CI, sin secretos\n",[19,652,653,664,684],{"__ignoreMap":89},[387,654,655,658,661],{"class":389,"line":390},[387,656,657],{"class":400},"pnpm",[387,659,660],{"class":404}," build",[387,662,663],{"class":393},"                              # 13 rutas prerenderizadas\n",[387,665,666,669,672,675,678,681],{"class":389,"line":397},[387,667,668],{"class":411},"(",[387,670,671],{"class":400},"nohup",[387,673,674],{"class":404}," node",[387,676,677],{"class":404}," .output\u002Fserver\u002Findex.mjs",[387,679,680],{"class":411}," &)",[387,682,683],{"class":393}," # sirve .output: estáticas + SSR\n",[387,685,686,689,692,695,697,700,702,705,708,710,712],{"class":389,"line":421},[387,687,688],{"class":400},"mv",[387,690,691],{"class":404}," .env",[387,693,694],{"class":404}," .env.ci-bak",[387,696,412],{"class":411},[387,698,699],{"class":400}," pnpm",[387,701,660],{"class":404},[387,703,704],{"class":411},";",[387,706,707],{"class":400}," mv",[387,709,694],{"class":404},[387,711,691],{"class":404},[387,713,714],{"class":393},"   # la prueba de CI, sin secretos\n",[93,716,718],{"id":717},"migraciones-expandcontract","Migraciones (expand\u002Fcontract)",[10,720,721,722,725],{},"El paso de migraciones corre ",[14,723,724],{},"antes"," del rollout, así que durante unos minutos conviven dos versiones del código contra el mismo esquema. Toda migración sigue el patrón expand\u002Fcontract:",[273,727,728,738,744,750],{},[276,729,730,733,734,737],{},[14,731,732],{},"Expand",": agrega (columna nullable, tabla nueva, índice ",[19,735,736],{},"CONCURRENTLY",").",[276,739,740,743],{},[14,741,742],{},"Migrar código",": despliega la versión que escribe ambos formatos o que usa lo nuevo.",[276,745,746,749],{},[14,747,748],{},"Backfill",": rellena datos con un script o una tarea, fuera del deploy.",[276,751,752,755],{},[14,753,754],{},"Contract",": borra lo viejo (NOT NULL, drop) recién en un deploy posterior.",[83,757,759],{"className":381,"code":758,"language":383,"meta":89,"style":89},"pnpm db:generate   # después de cambiar el schema\npnpm db:migrate    # lo aplica también el workflow de deploy\n",[19,760,761,771],{"__ignoreMap":89},[387,762,763,765,768],{"class":389,"line":390},[387,764,657],{"class":400},[387,766,767],{"class":404}," db:generate",[387,769,770],{"class":393},"   # después de cambiar el schema\n",[387,772,773,775,778],{"class":389,"line":397},[387,774,657],{"class":400},[387,776,777],{"class":404}," db:migrate",[387,779,780],{"class":393},"    # lo aplica también el workflow de deploy\n",[93,782,784],{"id":783},"backups-de-la-base-de-datos","Backups de la base de datos",[10,786,787,788,791,792,795,796,799],{},"El dashboard admin (",[19,789,790],{},"\u002Fapp\u002Fadmin\u002Fdashboard",") genera backups manuales: un job de pg-boss corre ",[19,793,794],{},"pg_dump --format=custom"," y sube el dump al bucket dedicado (",[19,797,798],{},"NUXT_APP_S3_BACKUP_BUCKET_NAME","). Dos requisitos de despliegue:",[561,801,802,818],{},[276,803,804,810,811,569,814,817],{},[14,805,806,809],{},[19,807,808],{},"pg_dump"," en la imagen",": lo instala ",[19,812,813],{},"nixpacks.toml",[19,815,816],{},"postgresql_17","); debe ser una versión ≥ a la del servidor PostgreSQL.",[276,819,820,823,824,826,827,830,831,287],{},[14,821,822],{},"Conexión directa",": si ",[19,825,316],{}," es la pooled de Neon (",[19,828,829],{},"-pooler","), el dump deriva la conexión directa automáticamente; también se puede fijar ",[19,832,833],{},"NUXT_BACKUP_DATABASE_URL",[93,835,837],{"id":836},"salud-y-rollback","Salud y rollback",[561,839,840,848,858],{},[276,841,842,569,845,847],{},[14,843,844],{},"Liveness",[19,846,307],{},"): público y barato, no toca la base de datos. Es el que usan Dokploy y el paso final del workflow.",[276,849,850,853,854,857],{},[14,851,852],{},"Rollback",": Dokploy conserva los deployments anteriores; ",[264,855,856],{},"Redeploy"," de la revisión previa. Gracias a expand\u002Fcontract, la versión anterior del código sigue siendo compatible con el esquema.",[276,859,860,569,863,866],{},[14,861,862],{},"Salud profunda",[19,864,865],{},"\u002Fapi\u002Fadmin\u002Fsystem\u002Fhealth","): base de datos, Redis, colas, backups y DeepSeek, solo para administradores.",[868,869,870],"style",{},"html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":89,"searchDepth":397,"depth":397,"links":872},[873,874,878,879,880,881],{"id":95,"depth":397,"text":96},{"id":251,"depth":397,"text":875,"children":876},"El entorno dev (dev.tudominio.com)",[877],{"id":461,"depth":421,"text":462},{"id":500,"depth":397,"text":501},{"id":717,"depth":397,"text":718},{"id":783,"depth":397,"text":784},{"id":836,"depth":397,"text":837},"El pipeline completo (hooks, CI, Dokploy), los dos entornos y las reglas de migración y rollback.","md",{},{"icon":886},"i-lucide-cloud-upload","\u002Fdocs\u002Fdeploy",{"title":5,"description":882},"docs\u002F4.deploy","by8vZKFapKTtLYmtwIroIGfuZVvC_Iu-HCfYlALIdbc",[892,898],{"title":893,"path":894,"stem":895,"description":896,"icon":897,"children":-1},"Design system","\u002Fdocs\u002Fdesign-system","docs\u002F3.design-system","Los tres niveles del sistema (tokens, clases .ds-*, temas de componentes) y las reglas para no salirse de él.","i-lucide-swatch-book",{"title":899,"path":900,"stem":901,"description":902,"children":-1},"Customers y portal de clientes","\u002Fdocs\u002Fcustomers","docs\u002F5.customers","[object Object]",[904],{"title":905,"path":543,"stem":906,"children":907,"page":921},"Docs","docs",[908,913,918,919,920],{"title":909,"path":910,"stem":911,"icon":912},"Guía de setup","\u002Fdocs\u002Fsetup","docs\u002F1.setup","i-lucide-rocket",{"title":914,"path":915,"stem":916,"icon":917},"Ramas y flujo de trabajo","\u002Fdocs\u002Fbranching","docs\u002F2.branching","i-lucide-git-branch",{"title":893,"path":894,"stem":895,"icon":897},{"title":5,"path":887,"stem":889,"icon":886},{"title":899,"path":900,"stem":901},false,1790184046183]