[{"data":1,"prerenderedAt":5178},["ShallowReactive",2],{"docs-overview":3,"docs-navigation":5168},[4,946,1887,2970,3772],{"id":5,"title":6,"body":7,"description":937,"extension":938,"meta":939,"navigation":940,"path":942,"seo":943,"stem":944,"__hash__":945},"docs\u002Fdocs\u002F1.setup.md","Guía de setup",{"type":8,"value":9,"toc":925},"minimark",[10,28,40,45,127,131,152,156,163,240,254,259,369,373,681,708,746,759,763,799,803,815,834,849,853,888,892,921],[11,12,13,14,18,19,23,24,27],"p",{},"Esta guía te deja el template corriendo en local, con la base de datos migrada y una cuenta con la que entrar. Todo se ejecuta con ",[15,16,17],"strong",{},"pnpm",", que es el gestor fijado en ",[20,21,22],"code",{},"packageManager"," dentro de ",[20,25,26],{},"package.json",".",[29,30,31],"tip",{},[11,32,33,36,37,27],{},[20,34,35],{},"pnpm install"," instala también los hooks de git: en cada commit corre ESLint sobre lo que esté en stage (segundos) y en cada push la suite completa de Playwright. Para saltar la suite de forma deliberada existe ",[20,38,39],{},"SKIP_E2E=1 git push",[41,42,44],"h2",{"id":43},"requisitos","Requisitos",[46,47,48,64],"table",{},[49,50,51],"thead",{},[52,53,54,58,61],"tr",{},[55,56,57],"th",{},"Herramienta",[55,59,60],{},"Versión",[55,62,63],{},"Para qué",[65,66,67,89,106],"tbody",{},[52,68,69,75,80],{},[70,71,72],"td",{},[15,73,74],{},"Node.js",[70,76,77],{},[20,78,79],{},">= 22.12",[70,81,82,83,85,86],{},"El runtime fijado en ",[20,84,26],{}," → ",[20,87,88],{},"engines",[52,90,91,95,100],{},[70,92,93],{},[15,94,17],{},[70,96,97],{},[20,98,99],{},"10.x",[70,101,102,103],{},"Gestor de paquetes; actívalo con ",[20,104,105],{},"corepack enable",[52,107,108,113,116],{},[70,109,110],{},[15,111,112],{},"PostgreSQL",[70,114,115],{},"15 o superior",[70,117,118,119,126],{},"Base de datos. Sirve una gratuita de ",[120,121,125],"a",{"href":122,"rel":123},"https:\u002F\u002Fneon.tech",[124],"nofollow","Neon"," o una local",[41,128,130],{"id":129},"_1-instala-las-dependencias","1. Instala las dependencias",[132,133,138],"pre",{"className":134,"code":135,"language":136,"meta":137,"style":137},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pnpm install\n","bash","",[20,139,140],{"__ignoreMap":137},[141,142,145,148],"span",{"class":143,"line":144},"line",1,[141,146,17],{"class":147},"sBMFI",[141,149,151],{"class":150},"sfazB"," install\n",[41,153,155],{"id":154},"_2-configura-el-entorno","2. Configura el entorno",[11,157,158,159,162],{},"Crea un ",[20,160,161],{},".env"," en la raíz del proyecto. Estas son las variables que necesitas para arrancar:",[132,164,168],{"className":165,"code":166,"language":167,"meta":137,"style":137},"language-ini shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# Base de datos PostgreSQL (usa la connection string completa)\nNUXT_DATABASE_URL=\"postgresql:\u002F\u002Fusuario:password@host:5432\u002Fbase?sslmode=require\"\n\n# Better Auth: cadena larga y aleatoria, distinta en cada entorno\nBETTER_AUTH_SECRET=\"pega-aqui-un-secreto-largo\"\n\n# URL pública de la app (Better Auth la usa como baseURL)\nNUXT_APP_URL=\"http:\u002F\u002Flocalhost:3000\"\n\n# Cuenta admin que crea la tarea de seed (paso 4)\nNUXT_ADMIN_EMAIL=\"admin@example.com\"\nNUXT_ADMIN_PASSWORD=\"una-password-larga\"\n","ini",[20,169,170,175,181,188,194,200,205,211,217,222,228,234],{"__ignoreMap":137},[141,171,172],{"class":143,"line":144},[141,173,174],{},"# Base de datos PostgreSQL (usa la connection string completa)\n",[141,176,178],{"class":143,"line":177},2,[141,179,180],{},"NUXT_DATABASE_URL=\"postgresql:\u002F\u002Fusuario:password@host:5432\u002Fbase?sslmode=require\"\n",[141,182,184],{"class":143,"line":183},3,[141,185,187],{"emptyLinePlaceholder":186},true,"\n",[141,189,191],{"class":143,"line":190},4,[141,192,193],{},"# Better Auth: cadena larga y aleatoria, distinta en cada entorno\n",[141,195,197],{"class":143,"line":196},5,[141,198,199],{},"BETTER_AUTH_SECRET=\"pega-aqui-un-secreto-largo\"\n",[141,201,203],{"class":143,"line":202},6,[141,204,187],{"emptyLinePlaceholder":186},[141,206,208],{"class":143,"line":207},7,[141,209,210],{},"# URL pública de la app (Better Auth la usa como baseURL)\n",[141,212,214],{"class":143,"line":213},8,[141,215,216],{},"NUXT_APP_URL=\"http:\u002F\u002Flocalhost:3000\"\n",[141,218,220],{"class":143,"line":219},9,[141,221,187],{"emptyLinePlaceholder":186},[141,223,225],{"class":143,"line":224},10,[141,226,227],{},"# Cuenta admin que crea la tarea de seed (paso 4)\n",[141,229,231],{"class":143,"line":230},11,[141,232,233],{},"NUXT_ADMIN_EMAIL=\"admin@example.com\"\n",[141,235,237],{"class":143,"line":236},12,[141,238,239],{},"NUXT_ADMIN_PASSWORD=\"una-password-larga\"\n",[11,241,242,243,246,247,249,250,253],{},"El archivo ",[20,244,245],{},".env.example"," de la raíz es la plantilla comentada: cópialo a ",[20,248,161],{}," y completa los valores. ",[20,251,252],{},"server\u002Futils\u002FruntimeConfig.ts"," es la fuente de verdad de los nombres.",[255,256,258],"h3",{"id":257},"obligatorias","Obligatorias",[46,260,261,273],{},[49,262,263],{},[52,264,265,268,270],{},[55,266,267],{},"Variable",[55,269,63],{},[55,271,272],{},"Dónde se lee",[65,274,275,297,324,347],{},[52,276,277,282,285],{},[70,278,279],{},[20,280,281],{},"NUXT_DATABASE_URL",[70,283,284],{},"Connection string de PostgreSQL",[70,286,287,290,291,290,294],{},[20,288,289],{},"server\u002Futils\u002Fdb.ts",", ",[20,292,293],{},"server\u002Futils\u002Fpgboss.ts",[20,295,296],{},"server\u002Fdatabase\u002Fdrizzle.config.ts",[52,298,299,304,307],{},[70,300,301],{},[20,302,303],{},"BETTER_AUTH_SECRET",[70,305,306],{},"Firma de sesiones, magic links y tokens",[70,308,309,310,85,313,316,317,290,320,323],{},"Better Auth la toma del entorno (fallback del SDK); alternativa ",[20,311,312],{},"NUXT_BETTER_AUTH_SECRET",[20,314,315],{},"runtimeConfig.betterAuthSecret"," (",[20,318,319],{},"server\u002Futils\u002Fauth.ts",[20,321,322],{},"secret",")",[52,325,326,331,334],{},[70,327,328],{},[20,329,330],{},"NUXT_APP_URL",[70,332,333],{},"Origen público: baseURL y trustedOrigins de Better Auth, enlaces de invitación y exportaciones, baseUrl de i18n",[70,335,336,290,339,290,341,290,344],{},[20,337,338],{},"nuxt.config.ts",[20,340,319],{},[20,342,343],{},"server\u002Futils\u002Finvitations.ts",[20,345,346],{},"server\u002Futils\u002Fform-export.ts",[52,348,349,358,364],{},[70,350,351,354,355],{},[20,352,353],{},"NUXT_ADMIN_EMAIL"," · ",[20,356,357],{},"NUXT_ADMIN_PASSWORD",[70,359,360,361],{},"Cuenta que crea la tarea ",[20,362,363],{},"db:seed_admin",[70,365,366],{},[20,367,368],{},"server\u002Ftasks\u002Fdb\u002Fseed_admin.ts",[255,370,372],{"id":371},"opcionales","Opcionales",[46,374,375,386],{},[49,376,377],{},[52,378,379,381,384],{},[55,380,267],{},[55,382,383],{},"Para qué y sin ella",[55,385,272],{},[65,387,388,406,429,447,467,484,504,542,562,593,611,634,651,666],{},[52,389,390,395,402],{},[70,391,392],{},[20,393,394],{},"NUXT_NITRO_PRESET",[70,396,397,398,401],{},"Preset de Nitro; con ",[20,399,400],{},"node-server"," (el del repo) el pool de Drizzle se cachea por proceso",[70,403,404],{},[20,405,289],{},[52,407,408,422,425],{},[70,409,410,354,413,354,416,354,419],{},[20,411,412],{},"NUXT_DB_POOL_MAX",[20,414,415],{},"_IDLE_TIMEOUT",[20,417,418],{},"_CONNECT_TIMEOUT",[20,420,421],{},"_MAX_LIFETIME",[70,423,424],{},"Ajuste del pool de postgres-js (segundos); sin ellas, 10 conexiones y timeouts 20\u002F10\u002F1800 s",[70,426,427],{},[20,428,289],{},[52,430,431,436,439],{},[70,432,433],{},[20,434,435],{},"NUXT_REDIS_URL",[70,437,438],{},"Redis como almacenamiento secundario de Better Auth; sin ella (o si Redis cae) todo va contra la base de datos",[70,440,441,290,444],{},[20,442,443],{},"server\u002Futils\u002Fsecondary-storage.ts",[20,445,446],{},"server\u002Fapi\u002Fadmin\u002Fsystem\u002Fhealth.get.ts",[52,448,449,454,457],{},[70,450,451],{},[20,452,453],{},"NUXT_RESEND_API_KEY",[70,455,456],{},"Correos transaccionales; sin clave se registran pero no se envían",[70,458,459,290,462,290,465],{},[20,460,461],{},"server\u002Futils\u002Fmails-templates.ts",[20,463,464],{},"server\u002Fworkflows\u002Fnodes\u002Femail.node.ts",[20,466,446],{},[52,468,469,474,477],{},[70,470,471],{},[20,472,473],{},"NUXT_APP_NAME",[70,475,476],{},"Nombre visible en correos y comunicaciones (el de la interfaz sale de i18n)",[70,478,479,290,481],{},[20,480,461],{},[20,482,483],{},"server\u002Femails\u002Fcommunication.ts",[52,485,486,491,498],{},[70,487,488],{},[20,489,490],{},"NUXT_APP_NOTIFY_EMAIL",[70,492,493,494,497],{},"Remitente ",[20,495,496],{},"From"," de los correos y de los nodos Email",[70,499,500,290,502],{},[20,501,461],{},[20,503,464],{},[52,505,506,523,529],{},[70,507,508,354,511,354,514,354,517,354,520],{},[20,509,510],{},"NUXT_APP_S3_ENDPOINT",[20,512,513],{},"_REGION",[20,515,516],{},"_ACCESS_KEY",[20,518,519],{},"_SECRET_KEY",[20,521,522],{},"_BUCKET_NAME",[70,524,525,526,323],{},"Documentos, fotos, adjuntos y exportaciones; sin ellas las subidas quedan apagadas (región por defecto ",[20,527,528],{},"us-east-1",[70,530,531,290,534,290,537,290,540],{},[20,532,533],{},"server\u002Futils\u002Fcreate-s3-client.ts",[20,535,536],{},"server\u002Futils\u002Fget-presigned.ts",[20,538,539],{},"server\u002Fapi\u002Fupload\u002F*",[20,541,446],{},[52,543,544,549,552],{},[70,545,546],{},[20,547,548],{},"NUXT_APP_S3_BACKUP_BUCKET_NAME",[70,550,551],{},"Bucket dedicado a los backups de base de datos del dashboard admin; sin él los backups quedan apagados (requiere la sección S3 de arriba)",[70,553,554,290,557,290,560],{},[20,555,556],{},"server\u002Futils\u002Fdatabase-backup.ts",[20,558,559],{},"server\u002Fapi\u002Fadmin\u002Fbackups\u002F*",[20,561,446],{},[52,563,564,572,589],{},[70,565,566,354,569],{},[20,567,568],{},"NUXT_BACKUP_DATABASE_URL",[20,570,571],{},"NUXT_BACKUP_PG_DUMP_PATH",[70,573,574,575,578,579,581,582,585,586,588],{},"Backups: conexión directa para ",[20,576,577],{},"pg_dump"," (si la principal es pooled) y ruta del binario; sin ellas se usa ",[20,580,281],{}," quitándole ",[20,583,584],{},"-pooler"," y el ",[20,587,577],{}," del PATH",[70,590,591],{},[20,592,556],{},[52,594,595,600,603],{},[70,596,597],{},[20,598,599],{},"NUXT_WORKFLOW_ENCRYPTION_KEY",[70,601,602],{},"Cifrado AES-256-GCM de las credenciales de los nodos; sin ella, guardar credenciales falla",[70,604,605,290,608],{},[20,606,607],{},"server\u002Futils\u002Fcrypto.ts",[20,609,610],{},"server\u002Futils\u002Fworkflow-credential.ts",[52,612,613,624,627],{},[70,614,615,354,618,354,621],{},[20,616,617],{},"NUXT_DEEPSEEK_API_KEY",[20,619,620],{},"_MODEL",[20,622,623],{},"_BASE_URL",[70,625,626],{},"Asistente de workflows con IA; sin clave responde \"not configured\"",[70,628,629,290,632],{},[20,630,631],{},"server\u002Futils\u002Fdeepseek.ts",[20,633,446],{},[52,635,636,644,647],{},[70,637,638,354,641],{},[20,639,640],{},"NUXT_APP_GOOGLE_CLIENT_ID",[20,642,643],{},"NUXT_APP_GOOGLE_CLIENT_SECRET",[70,645,646],{},"Login con Google; sin claves el proveedor solo emite un warning al arrancar",[70,648,649],{},[20,650,319],{},[52,652,653,658,661],{},[70,654,655],{},[20,656,657],{},"NUXT_GOOGLE_MAPS_SERVER_KEY",[70,659,660],{},"Geocodificación en el servidor (autocomplete, place details, timezone)",[70,662,663],{},[20,664,665],{},"server\u002Fapi\u002Fgoogle\u002F*.get.ts",[52,667,668,673,676],{},[70,669,670],{},[20,671,672],{},"NUXT_PUBLIC_GOOGLE_MAPS_CLIENT_KEY",[70,674,675],{},"Key pública del selector de ubicación (restringida por referrer)",[70,677,678],{},[20,679,680],{},"app\u002Fcomponents\u002Fplan\u002FLocationPicker.vue",[682,683,684],"note",{},[11,685,686,687,316,690,693,694,696,697,700,701,704,705,27],{},"Los ",[15,688,689],{},"backups de base de datos",[20,691,692],{},"\u002Fapp\u002Fadmin\u002Fdashboard",") necesitan además el binario ",[20,695,577],{}," (versión ≥ a la del servidor PostgreSQL) en la máquina que corre la app: en local ",[20,698,699],{},"brew install postgresql@17"," o ",[20,702,703],{},"apt install postgresql-client-17","; en el deploy lo instala ",[20,706,707],{},"nixpacks.toml",[682,709,710],{},[11,711,712,715,716,719,720,723,724,726,727,290,730,290,733,290,736,316,739,742,743,27],{},[20,713,714],{},"runtimeConfig"," lee algunas variables que hoy ",[15,717,718],{},"no tienen consumidores",", así que no hacen falta para arrancar: ",[20,721,722],{},"BETTER_AUTH_URL"," (el baseURL sale de ",[20,725,330],{},"), ",[20,728,729],{},"NUXT_RESEND_WEBHOOK_SECRET",[20,731,732],{},"NUXT_ADMIN_USER_IDS",[20,734,735],{},"NUXT_APP_CONTACT_EMAIL",[20,737,738],{},"NODE_ENV",[20,740,741],{},"public.appEnv",") y ",[20,744,745],{},"NUXT_PUBLIC_SITE_URL",[747,748,749],"warning",{},[11,750,751,752,754,755,758],{},"El ",[20,753,303],{}," local, el de dev y el de producción deben ser ",[15,756,757],{},"distintos",". Ese secreto firma sesiones y enlaces mágicos: si se filtra, hay que rotarlo y todos los enlaces pendientes dejan de valer.",[41,760,762],{"id":761},"_3-migra-la-base-de-datos","3. Migra la base de datos",[132,764,766],{"className":134,"code":765,"language":136,"meta":137,"style":137},"pnpm db:migrate    # aplica las migraciones pendientes\npnpm db:generate   # genera una migración después de cambiar el schema\npnpm studio        # abre Drizzle Studio para inspeccionar datos\n",[20,767,768,779,789],{"__ignoreMap":137},[141,769,770,772,775],{"class":143,"line":144},[141,771,17],{"class":147},[141,773,774],{"class":150}," db:migrate",[141,776,778],{"class":777},"sHwdD","    # aplica las migraciones pendientes\n",[141,780,781,783,786],{"class":143,"line":177},[141,782,17],{"class":147},[141,784,785],{"class":150}," db:generate",[141,787,788],{"class":777},"   # genera una migración después de cambiar el schema\n",[141,790,791,793,796],{"class":143,"line":183},[141,792,17],{"class":147},[141,794,795],{"class":150}," studio",[141,797,798],{"class":777},"        # abre Drizzle Studio para inspeccionar datos\n",[41,800,802],{"id":801},"_4-crea-la-cuenta-admin","4. Crea la cuenta admin",[11,804,805,806,808,809,811,812,814],{},"El template no tiene registro público: la primera cuenta se siembra con la tarea ",[20,807,363],{},", que lee ",[20,810,353],{}," y ",[20,813,357],{}," del entorno. Con el servidor de desarrollo corriendo, en otra terminal:",[132,816,818],{"className":134,"code":817,"language":136,"meta":137,"style":137},"curl -X POST http:\u002F\u002Flocalhost:3000\u002F_nitro\u002Ftasks\u002Fdb:seed_admin\n",[20,819,820],{"__ignoreMap":137},[141,821,822,825,828,831],{"class":143,"line":144},[141,823,824],{"class":147},"curl",[141,826,827],{"class":150}," -X",[141,829,830],{"class":150}," POST",[141,832,833],{"class":150}," http:\u002F\u002Flocalhost:3000\u002F_nitro\u002Ftasks\u002Fdb:seed_admin\n",[11,835,836,837,840,841,844,845,848],{},"La tarea es idempotente: si el usuario ya existe, no hace nada. La lista completa de tareas está en ",[20,838,839],{},"GET \u002F_nitro\u002Ftasks",". Esa cuenta es también la que usa la suite de Playwright (",[20,842,843],{},"E2E_EMAIL"," \u002F ",[20,846,847],{},"E2E_PASSWORD",", con las credenciales del seed como fallback).",[41,850,852],{"id":851},"_5-arranca","5. Arranca",[132,854,856],{"className":134,"code":855,"language":136,"meta":137,"style":137},"pnpm dev              # http:\u002F\u002Flocalhost:3000\npnpm test:e2e:smoke   # smoke de Playwright sobre las páginas principales\npnpm lint             # ESLint (es el único formatter del repo)\n",[20,857,858,868,878],{"__ignoreMap":137},[141,859,860,862,865],{"class":143,"line":144},[141,861,17],{"class":147},[141,863,864],{"class":150}," dev",[141,866,867],{"class":777},"              # http:\u002F\u002Flocalhost:3000\n",[141,869,870,872,875],{"class":143,"line":177},[141,871,17],{"class":147},[141,873,874],{"class":150}," test:e2e:smoke",[141,876,877],{"class":777},"   # smoke de Playwright sobre las páginas principales\n",[141,879,880,882,885],{"class":143,"line":183},[141,881,17],{"class":147},[141,883,884],{"class":150}," lint",[141,886,887],{"class":777},"             # ESLint (es el único formatter del repo)\n",[41,889,891],{"id":890},"siguientes-pasos","Siguientes pasos",[893,894,895,903,914],"ul",{},[896,897,898,902],"li",{},[120,899,901],{"href":900},"\u002Fdocs\u002Fbranching","Ramas y flujo de trabajo",": cómo crear una feature, un fix o un hotfix.",[896,904,905,909,910,913],{},[120,906,908],{"href":907},"\u002Fdocs\u002Fdesign-system","Design system",": los tokens, las clases ",[20,911,912],{},".ds-*"," y las reglas de UI.",[896,915,916,920],{},[120,917,919],{"href":918},"\u002Fdocs\u002Fdeploy","Deploy y CI\u002FCD",": Dokploy, entornos y migraciones.",[922,923,924],"style",{},"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);}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 .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}",{"title":137,"searchDepth":177,"depth":177,"links":926},[927,928,929,933,934,935,936],{"id":43,"depth":177,"text":44},{"id":129,"depth":177,"text":130},{"id":154,"depth":177,"text":155,"children":930},[931,932],{"id":257,"depth":183,"text":258},{"id":371,"depth":183,"text":372},{"id":761,"depth":177,"text":762},{"id":801,"depth":177,"text":802},{"id":851,"depth":177,"text":852},{"id":890,"depth":177,"text":891},"Requisitos, variables de entorno y primer arranque, con comandos listos para copiar y pegar.","md",{},{"icon":941},"i-lucide-rocket","\u002Fdocs\u002Fsetup",{"title":6,"description":937},"docs\u002F1.setup","mC17EK2qAGvDDaZfxgx3mH1-l9fA1olnFExN6c7bcLo",{"id":947,"title":901,"body":948,"description":1880,"extension":938,"meta":1881,"navigation":1882,"path":900,"seo":1884,"stem":1885,"__hash__":1886},"docs\u002Fdocs\u002F2.branching.md",{"type":8,"value":949,"toc":1868},[950,969,1077,1085,1089,1159,1163,1186,1190,1371,1375,1388,1453,1457,1464,1524,1537,1541,1598,1645,1649,1686,1690,1762,1773,1777,1865],[11,951,952,953,811,956,959,960,962,963,965,966,968],{},"Dos ramas permanentes (",[20,954,955],{},"main",[20,957,958],{},"dev",") más ramas cortas de trabajo. ",[20,961,958],{}," es la rama de integración y se despliega sola en el entorno dev; ",[20,964,955],{}," es producción y solo recibe lo que ya pasó por ",[20,967,958],{}," (o un hotfix).",[46,970,971,984],{},[49,972,973],{},[52,974,975,978,981],{},[55,976,977],{},"Rama",[55,979,980],{},"Entorno",[55,982,983],{},"Reglas",[65,985,986,1001,1023,1042,1058],{},[52,987,988,992,995],{},[70,989,990],{},[20,991,955],{},[70,993,994],{},"Producción",[70,996,997,998,1000],{},"Protegida. Solo llega código que pasó por ",[20,999,958],{},". Siempre desplegable.",[52,1002,1003,1007,1013],{},[70,1004,1005],{},[20,1006,958],{},[70,1008,1009,1010,323],{},"Entorno dev (por ejemplo ",[20,1011,1012],{},"dev.tudominio.com",[70,1014,1015,1016,811,1019,1022],{},"Protegida. Integra ",[20,1017,1018],{},"feature\u002F*",[20,1020,1021],{},"fix\u002F*",". Cada merge dispara el despliegue de dev.",[52,1024,1025,1030,1033],{},[70,1026,1027],{},[20,1028,1029],{},"feature\u002F\u003Cslug>",[70,1031,1032],{},"—",[70,1034,1035,1036,1038,1039,1041],{},"Nueva funcionalidad. Sale de ",[20,1037,958],{},", PR a ",[20,1040,958],{},". Corta (días, no semanas).",[52,1043,1044,1049,1051],{},[70,1045,1046],{},[20,1047,1048],{},"fix\u002F\u003Cslug>",[70,1050,1032],{},[70,1052,1053,1054,1038,1056,27],{},"Corrección de un bug. Sale de ",[20,1055,958],{},[20,1057,958],{},[52,1059,1060,1065,1067],{},[70,1061,1062],{},[20,1063,1064],{},"hotfix\u002F\u003Cslug>",[70,1066,1032],{},[70,1068,1069,1070,1038,1072,1074,1075,27],{},"Bug crítico en producción. Sale de ",[20,1071,955],{},[20,1073,955],{}," y se sincroniza a ",[20,1076,958],{},[132,1078,1083],{"className":1079,"code":1081,"language":1082,"meta":137},[1080],"language-text","feature\u002F* · fix\u002F* ──PR──▶ dev ──PR release──▶ main\n   (corta)              (entorno dev)        (producción)\n","text",[20,1084,1081],{"__ignoreMap":137},[41,1086,1088],{"id":1087},"reglas-de-oro","Reglas de oro",[1090,1091,1092,1107,1113,1119,1130,1140],"ol",{},[896,1093,1094,1102,1103,1106],{},[15,1095,1096,1097,1099,1100],{},"Nunca se commitea directo a ",[20,1098,955],{}," ni a ",[20,1101,958],{},": todo llega por PR con el check ",[20,1104,1105],{},"Lint & build"," en verde.",[896,1108,1109,1112],{},[15,1110,1111],{},"Una rama = un propósito."," No mezcles un refactor con una feature ni dos features en la misma rama.",[896,1114,1115,1118],{},[15,1116,1117],{},"Ramas cortas."," Si algo lleva semanas, divídelo en entregas pequeñas que se integren por separado.",[896,1120,1121,1126,1127,1129],{},[15,1122,1123,1125],{},[20,1124,958],{}," siempre desplegable."," Es lo que ve el resto del equipo en el entorno dev; lo que se rompe se arregla con ",[20,1128,1021],{}," o se revierte cuanto antes.",[896,1131,1132,1135,1136,1139],{},[15,1133,1134],{},"El flujo verificado a mano se persiste como spec de Playwright"," en ",[20,1137,1138],{},"tests\u002Fe2e\u002F",". Un chequeo manual que no quedó como spec no cuenta como cobertura.",[896,1141,1142,1145,1146,844,1149,844,1152,1155,1156,1158],{},[15,1143,1144],{},"Migraciones expand\u002Fcontract",": nunca ",[20,1147,1148],{},"DROP",[20,1150,1151],{},"RENAME",[20,1153,1154],{},"NOT NULL"," en el mismo deploy que todavía usa la forma vieja (ver ",[120,1157,919],{"href":918},").",[41,1160,1162],{"id":1161},"nombres-de-rama","Nombres de rama",[893,1164,1165,1173,1179],{},[896,1166,1167,290,1170,27],{},[20,1168,1169],{},"feature\u002Fforms-export-excel",[20,1171,1172],{},"fix\u002Fcalendar-dst-rango",[896,1174,1175,1176,27],{},"Con ticket delante si existe: ",[20,1177,1178],{},"feature\u002F123-forms-export-excel",[896,1180,1181,1182,1185],{},"Minúsculas, guiones, sin espacios ni acentos. El slug describe el resultado (",[20,1183,1184],{},"export-excel","), no la acción.",[41,1187,1189],{"id":1188},"nueva-feature-paso-a-paso","Nueva feature, paso a paso",[132,1191,1193],{"className":134,"code":1192,"language":136,"meta":137,"style":137},"# 1. Parte de un dev actualizado\ngit switch dev\ngit pull origin dev\n\n# 2. Crea la rama\ngit switch -c feature\u002Fforms-export-excel\n\n# 3. Implementa. El pre-commit arregla el lint de lo staged automáticamente.\n\n# 4. Antes de subir, corre el spec del flujo tocado (la suite completa no hace falta aquí)\npnpm exec playwright test tests\u002Fe2e\u002Fapp\u002Fforms.spec.ts\n\n# 5. Sube: el hook pre-push corre la suite completa\ngit push -u origin feature\u002Fforms-export-excel\n\n# 6. Abre el PR hacia dev\ngh pr create --base dev --title \"...\" --body \"...\"\n\n# 7. CI en verde → merge con squash → dev se despliega solo.\n# 8. Verifica en el entorno dev.\n",[20,1194,1195,1200,1211,1223,1227,1232,1244,1248,1253,1257,1262,1278,1282,1288,1303,1308,1314,1354,1359,1365],{"__ignoreMap":137},[141,1196,1197],{"class":143,"line":144},[141,1198,1199],{"class":777},"# 1. Parte de un dev actualizado\n",[141,1201,1202,1205,1208],{"class":143,"line":177},[141,1203,1204],{"class":147},"git",[141,1206,1207],{"class":150}," switch",[141,1209,1210],{"class":150}," dev\n",[141,1212,1213,1215,1218,1221],{"class":143,"line":183},[141,1214,1204],{"class":147},[141,1216,1217],{"class":150}," pull",[141,1219,1220],{"class":150}," origin",[141,1222,1210],{"class":150},[141,1224,1225],{"class":143,"line":190},[141,1226,187],{"emptyLinePlaceholder":186},[141,1228,1229],{"class":143,"line":196},[141,1230,1231],{"class":777},"# 2. Crea la rama\n",[141,1233,1234,1236,1238,1241],{"class":143,"line":202},[141,1235,1204],{"class":147},[141,1237,1207],{"class":150},[141,1239,1240],{"class":150}," -c",[141,1242,1243],{"class":150}," feature\u002Fforms-export-excel\n",[141,1245,1246],{"class":143,"line":207},[141,1247,187],{"emptyLinePlaceholder":186},[141,1249,1250],{"class":143,"line":213},[141,1251,1252],{"class":777},"# 3. Implementa. El pre-commit arregla el lint de lo staged automáticamente.\n",[141,1254,1255],{"class":143,"line":219},[141,1256,187],{"emptyLinePlaceholder":186},[141,1258,1259],{"class":143,"line":224},[141,1260,1261],{"class":777},"# 4. Antes de subir, corre el spec del flujo tocado (la suite completa no hace falta aquí)\n",[141,1263,1264,1266,1269,1272,1275],{"class":143,"line":230},[141,1265,17],{"class":147},[141,1267,1268],{"class":150}," exec",[141,1270,1271],{"class":150}," playwright",[141,1273,1274],{"class":150}," test",[141,1276,1277],{"class":150}," tests\u002Fe2e\u002Fapp\u002Fforms.spec.ts\n",[141,1279,1280],{"class":143,"line":236},[141,1281,187],{"emptyLinePlaceholder":186},[141,1283,1285],{"class":143,"line":1284},13,[141,1286,1287],{"class":777},"# 5. Sube: el hook pre-push corre la suite completa\n",[141,1289,1291,1293,1296,1299,1301],{"class":143,"line":1290},14,[141,1292,1204],{"class":147},[141,1294,1295],{"class":150}," push",[141,1297,1298],{"class":150}," -u",[141,1300,1220],{"class":150},[141,1302,1243],{"class":150},[141,1304,1306],{"class":143,"line":1305},15,[141,1307,187],{"emptyLinePlaceholder":186},[141,1309,1311],{"class":143,"line":1310},16,[141,1312,1313],{"class":777},"# 6. Abre el PR hacia dev\n",[141,1315,1317,1320,1323,1326,1329,1331,1334,1338,1341,1344,1347,1349,1351],{"class":143,"line":1316},17,[141,1318,1319],{"class":147},"gh",[141,1321,1322],{"class":150}," pr",[141,1324,1325],{"class":150}," create",[141,1327,1328],{"class":150}," --base",[141,1330,864],{"class":150},[141,1332,1333],{"class":150}," --title",[141,1335,1337],{"class":1336},"sMK4o"," \"",[141,1339,1340],{"class":150},"...",[141,1342,1343],{"class":1336},"\"",[141,1345,1346],{"class":150}," --body",[141,1348,1337],{"class":1336},[141,1350,1340],{"class":150},[141,1352,1353],{"class":1336},"\"\n",[141,1355,1357],{"class":143,"line":1356},18,[141,1358,187],{"emptyLinePlaceholder":186},[141,1360,1362],{"class":143,"line":1361},19,[141,1363,1364],{"class":777},"# 7. CI en verde → merge con squash → dev se despliega solo.\n",[141,1366,1368],{"class":143,"line":1367},20,[141,1369,1370],{"class":777},"# 8. Verifica en el entorno dev.\n",[255,1372,1374],{"id":1373},"release-a-producción","Release a producción",[11,1376,1377,1378,1380,1381,1384,1385,1387],{},"Cuando lo integrado en ",[20,1379,958],{}," está estable, se promociona con un PR ",[20,1382,1383],{},"dev → main"," (merge commit, sin squash, para conservar la historia de ",[20,1386,958],{},"):",[132,1389,1391],{"className":134,"code":1390,"language":136,"meta":137,"style":137},"git switch dev && git pull origin dev\ngh pr create --base main --head dev --title \"Release: \u003Cresumen>\" --body \"...\"\n# CI en verde → merge → deploy de producción con health check\n",[20,1392,1393,1413,1448],{"__ignoreMap":137},[141,1394,1395,1397,1399,1401,1404,1407,1409,1411],{"class":143,"line":144},[141,1396,1204],{"class":147},[141,1398,1207],{"class":150},[141,1400,864],{"class":150},[141,1402,1403],{"class":1336}," &&",[141,1405,1406],{"class":147}," git",[141,1408,1217],{"class":150},[141,1410,1220],{"class":150},[141,1412,1210],{"class":150},[141,1414,1415,1417,1419,1421,1423,1426,1429,1431,1433,1435,1438,1440,1442,1444,1446],{"class":143,"line":177},[141,1416,1319],{"class":147},[141,1418,1322],{"class":150},[141,1420,1325],{"class":150},[141,1422,1328],{"class":150},[141,1424,1425],{"class":150}," main",[141,1427,1428],{"class":150}," --head",[141,1430,864],{"class":150},[141,1432,1333],{"class":150},[141,1434,1337],{"class":1336},[141,1436,1437],{"class":150},"Release: \u003Cresumen>",[141,1439,1343],{"class":1336},[141,1441,1346],{"class":150},[141,1443,1337],{"class":1336},[141,1445,1340],{"class":150},[141,1447,1353],{"class":1336},[141,1449,1450],{"class":143,"line":183},[141,1451,1452],{"class":777},"# CI en verde → merge → deploy de producción con health check\n",[41,1454,1456],{"id":1455},"fix-de-bug-paso-a-paso","Fix de bug, paso a paso",[11,1458,1459,1460,1463],{},"Igual que una feature, con ",[20,1461,1462],{},"fix\u002F"," y con el spec de regresión: primero el spec que reproduce el bug (falla), después el arreglo, después el spec en verde.",[132,1465,1467],{"className":134,"code":1466,"language":136,"meta":137,"style":137},"git switch dev && git pull origin dev\ngit switch -c fix\u002Fcalendar-dst-rango\n# 1) spec que reproduce el bug  2) arreglo mínimo  3) spec en verde\ngit push -u origin fix\u002Fcalendar-dst-rango   # pre-push: suite completa\n# PR a dev → CI → squash merge → entorno dev\n",[20,1468,1469,1487,1498,1503,1519],{"__ignoreMap":137},[141,1470,1471,1473,1475,1477,1479,1481,1483,1485],{"class":143,"line":144},[141,1472,1204],{"class":147},[141,1474,1207],{"class":150},[141,1476,864],{"class":150},[141,1478,1403],{"class":1336},[141,1480,1406],{"class":147},[141,1482,1217],{"class":150},[141,1484,1220],{"class":150},[141,1486,1210],{"class":150},[141,1488,1489,1491,1493,1495],{"class":143,"line":177},[141,1490,1204],{"class":147},[141,1492,1207],{"class":150},[141,1494,1240],{"class":150},[141,1496,1497],{"class":150}," fix\u002Fcalendar-dst-rango\n",[141,1499,1500],{"class":143,"line":183},[141,1501,1502],{"class":777},"# 1) spec que reproduce el bug  2) arreglo mínimo  3) spec en verde\n",[141,1504,1505,1507,1509,1511,1513,1516],{"class":143,"line":190},[141,1506,1204],{"class":147},[141,1508,1295],{"class":150},[141,1510,1298],{"class":150},[141,1512,1220],{"class":150},[141,1514,1515],{"class":150}," fix\u002Fcalendar-dst-rango",[141,1517,1518],{"class":777},"   # pre-push: suite completa\n",[141,1520,1521],{"class":143,"line":196},[141,1522,1523],{"class":777},"# PR a dev → CI → squash merge → entorno dev\n",[11,1525,1526,1527,1530,1531,1533,1534,1536],{},"Un fix normal ",[15,1528,1529],{},"no"," va directo a ",[20,1532,955],{},": ",[20,1535,955],{}," solo recibe lo que ya pasó por el entorno dev (la excepción es el hotfix).",[41,1538,1540],{"id":1539},"hotfix-bug-crítico-en-producción","Hotfix (bug crítico en producción)",[132,1542,1544],{"className":134,"code":1543,"language":136,"meta":137,"style":137},"git switch main && git pull origin main\ngit switch -c hotfix\u002Flogin-callback\n# arreglo mínimo + spec de regresión\ngit push -u origin hotfix\u002Flogin-callback\n# PR a main (excepción deliberada: no pasa por dev) → CI → merge → deploy de producción\n",[20,1545,1546,1565,1576,1581,1593],{"__ignoreMap":137},[141,1547,1548,1550,1552,1554,1556,1558,1560,1562],{"class":143,"line":144},[141,1549,1204],{"class":147},[141,1551,1207],{"class":150},[141,1553,1425],{"class":150},[141,1555,1403],{"class":1336},[141,1557,1406],{"class":147},[141,1559,1217],{"class":150},[141,1561,1220],{"class":150},[141,1563,1564],{"class":150}," main\n",[141,1566,1567,1569,1571,1573],{"class":143,"line":177},[141,1568,1204],{"class":147},[141,1570,1207],{"class":150},[141,1572,1240],{"class":150},[141,1574,1575],{"class":150}," hotfix\u002Flogin-callback\n",[141,1577,1578],{"class":143,"line":183},[141,1579,1580],{"class":777},"# arreglo mínimo + spec de regresión\n",[141,1582,1583,1585,1587,1589,1591],{"class":143,"line":190},[141,1584,1204],{"class":147},[141,1586,1295],{"class":150},[141,1588,1298],{"class":150},[141,1590,1220],{"class":150},[141,1592,1575],{"class":150},[141,1594,1595],{"class":143,"line":196},[141,1596,1597],{"class":777},"# PR a main (excepción deliberada: no pasa por dev) → CI → merge → deploy de producción\n",[747,1599,1600,1610],{},[11,1601,1602,1603,1606,1607,1609],{},"Después del hotfix hay que ",[15,1604,1605],{},"cerrar el ciclo",", o ",[20,1608,958],{}," reintroducirá el bug en la próxima release:",[132,1611,1613],{"className":134,"code":1612,"language":136,"meta":137,"style":137},"git switch dev\ngit merge main   # o un PR main → dev\ngit push origin dev\n",[20,1614,1615,1623,1635],{"__ignoreMap":137},[141,1616,1617,1619,1621],{"class":143,"line":144},[141,1618,1204],{"class":147},[141,1620,1207],{"class":150},[141,1622,1210],{"class":150},[141,1624,1625,1627,1630,1632],{"class":143,"line":177},[141,1626,1204],{"class":147},[141,1628,1629],{"class":150}," merge",[141,1631,1425],{"class":150},[141,1633,1634],{"class":777},"   # o un PR main → dev\n",[141,1636,1637,1639,1641,1643],{"class":143,"line":183},[141,1638,1204],{"class":147},[141,1640,1295],{"class":150},[141,1642,1220],{"class":150},[141,1644,1210],{"class":150},[41,1646,1648],{"id":1647},"commits","Commits",[893,1650,1651,1676,1683],{},[896,1652,1653,1654,1657,1658,844,1661,844,1664,844,1667,844,1670,844,1673,27],{},"Formato recomendado (no obligatorio): ",[20,1655,1656],{},"tipo: descripción",", con ",[20,1659,1660],{},"feat",[20,1662,1663],{},"fix",[20,1665,1666],{},"chore",[20,1668,1669],{},"docs",[20,1671,1672],{},"refactor",[20,1674,1675],{},"test",[896,1677,1678,1679,1682],{},"Título corto; el cuerpo explica ",[15,1680,1681],{},"por qué",", no el qué (el diff ya dice el qué).",[896,1684,1685],{},"El pre-commit pasa ESLint sobre lo staged: no hace falta un commit aparte para formato.",[41,1687,1689],{"id":1688},"pull-requests","Pull requests",[893,1691,1692,1698],{},[896,1693,1694,1695,27],{},"Título y descripción: qué cambia y ",[15,1696,1697],{},"cómo probarlo",[896,1699,1700,1701],{},"Checklist antes de pedir review:\n",[893,1702,1705,1718,1737,1746,1756],{"className":1703},[1704],"contains-task-list",[896,1706,1709,1713,1714,1717],{"className":1707},[1708],"task-list-item",[1710,1711],"input",{"disabled":186,"type":1712},"checkbox"," Spec de Playwright del flujo tocado (o ",[20,1715,1716],{},"pnpm test:e2e:smoke",") corriendo en local.",[896,1719,1721,1723,1724,1727,1728,844,1731,844,1734,27],{"className":1720},[1708],[1710,1722],{"disabled":186,"type":1712}," ",[20,1725,1726],{},"pnpm lint"," limpio y, si hay texto visible, i18n en ",[20,1729,1730],{},"en",[20,1732,1733],{},"es",[20,1735,1736],{},"pt",[896,1738,1740,1742,1743,1158],{"className":1739},[1708],[1710,1741],{"disabled":186,"type":1712}," Entidad nueva: eventos de dominio, audit log y triggers (ver ",[20,1744,1745],{},"AGENTS.md",[896,1747,1749,1751,1752,1755],{"className":1748},[1708],[1710,1750],{"disabled":186,"type":1712}," Migración: expand\u002Fcontract, generada con ",[20,1753,1754],{},"pnpm db:generate"," en el mismo PR.",[896,1757,1759,1761],{"className":1758},[1708],[1710,1760],{"disabled":186,"type":1712}," PR pequeño (≤ ~400 líneas) cuando sea posible.",[11,1763,1764,1765,811,1767,1769,1770,1772],{},"Protege ",[20,1766,955],{},[20,1768,958],{}," en GitHub (Settings → Branches) exigiendo el check ",[20,1771,1105],{}," y prohibiendo force push.",[41,1774,1776],{"id":1775},"qué-corre-y-cuándo","Qué corre y cuándo",[46,1778,1779,1792],{},[49,1780,1781],{},[52,1782,1783,1786,1789],{},[55,1784,1785],{},"Momento",[55,1787,1788],{},"Qué corre",[55,1790,1791],{},"Se salta con",[65,1793,1794,1817,1831,1841,1854],{},[52,1795,1796,1801,1811],{},[70,1797,1798],{},[20,1799,1800],{},"git commit",[70,1802,1803,1806,1807,1810],{},[20,1804,1805],{},"lint-staged"," (ESLint ",[20,1808,1809],{},"--fix"," sobre lo staged)",[70,1812,1813,1816],{},[20,1814,1815],{},"--no-verify"," (excepcional)",[52,1818,1819,1824,1827],{},[70,1820,1821],{},[20,1822,1823],{},"git push",[70,1825,1826],{},"Suite Playwright completa",[70,1828,1829],{},[20,1830,39],{},[52,1832,1833,1836,1839],{},[70,1834,1835],{},"PR abierto",[70,1837,1838],{},"CI: lint + build (bloqueante), typecheck (informativo)",[70,1840,1032],{},[52,1842,1843,1848,1851],{},[70,1844,1845,1846],{},"Push\u002Fmerge a ",[20,1847,958],{},[70,1849,1850],{},"CI + despliegue del entorno dev",[70,1852,1853],{},"Interruptor de deploy apagado",[52,1855,1856,1860,1863],{},[70,1857,1845,1858],{},[20,1859,955],{},[70,1861,1862],{},"CI + despliegue de producción",[70,1864,1853],{},[922,1866,1867],{},"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":137,"searchDepth":177,"depth":177,"links":1869},[1870,1871,1872,1875,1876,1877,1878,1879],{"id":1087,"depth":177,"text":1088},{"id":1161,"depth":177,"text":1162},{"id":1188,"depth":177,"text":1189,"children":1873},[1874],{"id":1373,"depth":183,"text":1374},{"id":1455,"depth":177,"text":1456},{"id":1539,"depth":177,"text":1540},{"id":1647,"depth":177,"text":1648},{"id":1688,"depth":177,"text":1689},{"id":1775,"depth":177,"text":1776},"El modelo de dos ramas permanentes, los pasos para features y fixes, y qué corre en cada gate.",{},{"icon":1883},"i-lucide-git-branch",{"title":901,"description":1880},"docs\u002F2.branching","JtoFFeCq-PMGZU48vBQd97v7vwEONKAl6f1GsnlUeYY",{"id":1888,"title":908,"body":1889,"description":2963,"extension":938,"meta":2964,"navigation":2965,"path":907,"seo":2967,"stem":2968,"__hash__":2969},"docs\u002Fdocs\u002F3.design-system.md",{"type":8,"value":1890,"toc":2947},[1891,1898,1924,1928,1992,1996,2000,2093,2099,2167,2190,2216,2220,2225,2366,2380,2384,2388,2391,2486,2490,2528,2532,2538,2680,2746,2750,2900,2904,2944],[11,1892,1893,1894,1897],{},"El look del template es ",[15,1895,1896],{},"Claude Amber",": lienzo crema, acento terracota, radios generosos y títulos con serif. La regla que lo sostiene todo es una sola:",[1899,1900,1901],"blockquote",{},[11,1902,1903,1906,1907,1910,1911,1913,1914,290,1917,290,1920,1923],{},[15,1904,1905],{},"Nada hardcodea un color."," Cada valor visual vive en un token de ",[20,1908,1909],{},"app\u002Fassets\u002Fcss\u002Fmain.css"," y se consume con una clase ",[20,1912,912],{}," o una utilidad semántica (",[20,1915,1916],{},"bg-default",[20,1918,1919],{},"border-default",[20,1921,1922],{},"text-muted","). Como claro y oscuro tienen su propio bloque de tokens, un cambio se hace una vez y se ve bien en los dos modos.",[41,1925,1927],{"id":1926},"dónde-vive-cada-cosa","Dónde vive cada cosa",[46,1929,1930,1943],{},[49,1931,1932],{},[52,1933,1934,1937,1940],{},[55,1935,1936],{},"Pieza",[55,1938,1939],{},"Archivo",[55,1941,1942],{},"Rol",[65,1944,1945,1959,1979],{},[52,1946,1947,1952,1956],{},[70,1948,1949,1950],{},"Tokens y clases ",[20,1951,912],{},[70,1953,1954],{},[20,1955,1909],{},[70,1957,1958],{},"La única fuente de colores, radios, sombras y tipografías",[52,1960,1961,1964,1969],{},[70,1962,1963],{},"Temas globales de componentes",[70,1965,1966],{},[20,1967,1968],{},"app\u002Fapp.config.ts",[70,1970,1971,1972,290,1975,1978],{},"Router de slots de Nuxt UI (",[20,1973,1974],{},"ui.card",[20,1976,1977],{},"ui.modal",", …)",[52,1980,1981,1984,1989],{},[70,1982,1983],{},"Guía completa (repo)",[70,1985,1986],{},[20,1987,1988],{},"DESIGN_SYSTEM.md",[70,1990,1991],{},"Recetas, verificación y troubleshooting paso a paso",[41,1993,1995],{"id":1994},"los-tres-niveles","Los tres niveles",[255,1997,1999],{"id":1998},"_1-tokens","1. Tokens",[893,2001,2002,2027,2044,2066],{},[896,2003,2004,1533,2007,2010,2011,2014,2015,2018,2019,2022,2023,2026],{},[15,2005,2006],{},"Tipografía",[20,2008,2009],{},"--font-sans"," (Outfit) para todo el texto de interfaz, ",[20,2012,2013],{},"--font-heading"," (Fraunces) solo para títulos reales (",[20,2016,2017],{},"h1…h6",", títulos de page card, modal y navbar), ",[20,2020,2021],{},"--font-mono"," (Geist Mono) para código e identificadores. Si un título se reutiliza como etiqueta pequeña, añade ",[20,2024,2025],{},"font-sans"," a esa instancia.",[896,2028,2029,2032,2033,2036,2037,1135,2040,2043],{},[15,2030,2031],{},"Acento",": la escala ",[20,2034,2035],{},"--color-claude-50…950"," (el 500 es el terracota de marca) más ",[20,2038,2039],{},"ui.colors.primary = 'claude'",[20,2041,2042],{},"app.config.ts",". No hay un segundo color de marca.",[896,2045,2046,1533,2049,290,2052,811,2055,2058,2059,2062,2063,27],{},[15,2047,2048],{},"Superficies",[20,2050,2051],{},"--ds-card",[20,2053,2054],{},"--ds-panel",[20,2056,2057],{},"--ds-field",", con valor claro en ",[20,2060,2061],{},":root"," y oscuro en ",[20,2064,2065],{},".dark",[896,2067,2068,1533,2071,290,2074,290,2077,2080,2081,844,2084,844,2087,844,2089,2092],{},[15,2069,2070],{},"Semánticos",[20,2072,2073],{},"--ui-bg",[20,2075,2076],{},"--ui-border",[20,2078,2079],{},"--ui-text*"," se sobrescriben en ambos modos. ",[20,2082,2083],{},"success",[20,2085,2086],{},"info",[20,2088,747],{},[20,2090,2091],{},"error"," se quedan como vienen: son señales de estado y deben seguir siendo reconocibles.",[255,2094,2096,2097],{"id":2095},"_2-clases-ds","2. Clases ",[20,2098,912],{},[46,2100,2101,2114],{},[49,2102,2103],{},[52,2104,2105,2108,2111],{},[55,2106,2107],{},"Clase",[55,2109,2110],{},"Efecto",[55,2112,2113],{},"Cuándo usarla",[65,2115,2116,2129,2142],{},[52,2117,2118,2123,2126],{},[70,2119,2120],{},[20,2121,2122],{},"ds-card",[70,2124,2125],{},"Fondo de tarjeta + borde de 1px + sombra suave",[70,2127,2128],{},"Tarjetas y page cards",[52,2130,2131,2136,2139],{},[70,2132,2133],{},[20,2134,2135],{},"ds-panel",[70,2137,2138],{},"Fondo elevado + borde de 1px",[70,2140,2141],{},"Modales, popovers, dropdowns, selects, toasts, tooltips",[52,2143,2144,2149,2152],{},[70,2145,2146],{},[20,2147,2148],{},"ds-field",[70,2150,2151],{},"Fondo de campo",[70,2153,2154,290,2157,2160,2161,844,2164],{},[20,2155,2156],{},"UInput",[20,2158,2159],{},"UTextarea"," y triggers de ",[20,2162,2163],{},"USelect",[20,2165,2166],{},"USelectMenu",[11,2168,2169,2170,2176,2177,290,2179,290,2182,2185,2186,2189],{},"Están declaradas ",[15,2171,2172,2173],{},"fuera de cualquier ",[20,2174,2175],{},"@layer",", y por eso ganan a las utilidades de Tailwind (",[20,2178,1916],{},[20,2180,2181],{},"bg-elevated",[20,2183,2184],{},"shadow-lg",") sin ",[20,2187,2188],{},"!important",". Dos consecuencias:",[893,2191,2192,2202],{},[896,2193,2194,2195,2197,2198,2201],{},"No las muevas a ",[20,2196,2175],{}," ni las conviertas a ",[20,2199,2200],{},"@utility",": perderían esa prioridad.",[896,2203,2204,2205,316,2208,2211,2212,2215],{},"Al ser CSS plano ",[15,2206,2207],{},"no aceptan variantes",[20,2209,2210],{},"md:ds-panel"," no existe). Si necesitas una variante, escribe una regla ",[20,2213,2214],{},"@media"," explícita.",[255,2217,2219],{"id":2218},"_3-temas-de-componentes","3. Temas de componentes",[11,2221,2222,2224],{},[20,2223,1968],{}," solo enruta slots hacia tokens y clases; nunca declara colores literales:",[132,2226,2230],{"className":2227,"code":2228,"language":2229,"meta":137,"style":137},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","export default defineAppConfig({\n  ui: {\n    colors: { primary: 'claude', neutral: 'stone' },\n    card: { slots: { root: 'ds-card', title: 'font-heading' } }\n  }\n})\n","ts",[20,2231,2232,2252,2264,2306,2353,2358],{"__ignoreMap":137},[141,2233,2234,2238,2241,2245,2249],{"class":143,"line":144},[141,2235,2237],{"class":2236},"s7zQu","export",[141,2239,2240],{"class":2236}," default",[141,2242,2244],{"class":2243},"s2Zo4"," defineAppConfig",[141,2246,2248],{"class":2247},"sTEyZ","(",[141,2250,2251],{"class":1336},"{\n",[141,2253,2254,2258,2261],{"class":143,"line":177},[141,2255,2257],{"class":2256},"swJcz","  ui",[141,2259,2260],{"class":1336},":",[141,2262,2263],{"class":1336}," {\n",[141,2265,2266,2269,2271,2274,2277,2279,2282,2285,2288,2291,2294,2296,2298,2301,2303],{"class":143,"line":183},[141,2267,2268],{"class":2256},"    colors",[141,2270,2260],{"class":1336},[141,2272,2273],{"class":1336}," {",[141,2275,2276],{"class":2256}," primary",[141,2278,2260],{"class":1336},[141,2280,2281],{"class":1336}," '",[141,2283,2284],{"class":150},"claude",[141,2286,2287],{"class":1336},"'",[141,2289,2290],{"class":1336},",",[141,2292,2293],{"class":2256}," neutral",[141,2295,2260],{"class":1336},[141,2297,2281],{"class":1336},[141,2299,2300],{"class":150},"stone",[141,2302,2287],{"class":1336},[141,2304,2305],{"class":1336}," },\n",[141,2307,2308,2311,2313,2315,2318,2320,2322,2325,2327,2329,2331,2333,2335,2338,2340,2342,2345,2347,2350],{"class":143,"line":190},[141,2309,2310],{"class":2256},"    card",[141,2312,2260],{"class":1336},[141,2314,2273],{"class":1336},[141,2316,2317],{"class":2256}," slots",[141,2319,2260],{"class":1336},[141,2321,2273],{"class":1336},[141,2323,2324],{"class":2256}," root",[141,2326,2260],{"class":1336},[141,2328,2281],{"class":1336},[141,2330,2122],{"class":150},[141,2332,2287],{"class":1336},[141,2334,2290],{"class":1336},[141,2336,2337],{"class":2256}," title",[141,2339,2260],{"class":1336},[141,2341,2281],{"class":1336},[141,2343,2344],{"class":150},"font-heading",[141,2346,2287],{"class":1336},[141,2348,2349],{"class":1336}," }",[141,2351,2352],{"class":1336}," }\n",[141,2354,2355],{"class":143,"line":196},[141,2356,2357],{"class":1336},"  }\n",[141,2359,2360,2363],{"class":143,"line":202},[141,2361,2362],{"class":1336},"}",[141,2364,2365],{"class":2247},")\n",[11,2367,2368,2369,2372,2373,2376,2377,2379],{},"Para ajustar ",[15,2370,2371],{},"una sola instancia"," no toques el global: usa la prop ",[20,2374,2375],{},":ui=\"{ slot: '...' }\""," sobre esa instancia. Y recuerda que las ",[20,2378,912],{}," ganan a las utilidades: para anular una superficie puntual necesitas una regla propia.",[41,2381,2383],{"id":2382},"patrones-de-la-casa","Patrones de la casa",[255,2385,2387],{"id":2386},"card-con-cabecera-de-icono","Card con cabecera de icono",[11,2389,2390],{},"El patrón que usan las páginas reales (icono en squircle, título de una línea, subtítulo de una):",[132,2392,2396],{"className":2393,"code":2394,"language":2395,"meta":137,"style":137},"language-vue shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u003CUPageCard variant=\"subtle\">\n  \u003Ctemplate #header>\n    \u003Cdiv class=\"flex items-center gap-4 p-1\">\n      \u003Cdiv class=\"flex items-center justify-center w-11 h-11 rounded-xl bg-primary\u002F10 shrink-0\">\n        \u003CUIcon name=\"i-lucide-lock-keyhole\" class=\"w-6 h-6 text-primary\" \u002F>\n      \u003C\u002Fdiv>\n      \u003Cdiv>\n        \u003Ch3 class=\"text-base font-semibold\">Título\u003C\u002Fh3>\n        \u003Cp class=\"text-sm text-muted\">Una frase de subtítulo\u003C\u002Fp>\n      \u003C\u002Fdiv>\n    \u003C\u002Fdiv>\n  \u003C\u002Ftemplate>\n\u003C\u002FUPageCard>\n","vue",[20,2397,2398,2423,2428,2433,2438,2443,2448,2453,2458,2463,2467,2472,2477],{"__ignoreMap":137},[141,2399,2400,2403,2406,2410,2413,2415,2418,2420],{"class":143,"line":144},[141,2401,2402],{"class":1336},"\u003C",[141,2404,2405],{"class":2256},"UPageCard",[141,2407,2409],{"class":2408},"spNyl"," variant",[141,2411,2412],{"class":1336},"=",[141,2414,1343],{"class":1336},[141,2416,2417],{"class":150},"subtle",[141,2419,1343],{"class":1336},[141,2421,2422],{"class":1336},">\n",[141,2424,2425],{"class":143,"line":177},[141,2426,2427],{"class":2247},"  \u003Ctemplate #header>\n",[141,2429,2430],{"class":143,"line":183},[141,2431,2432],{"class":2247},"    \u003Cdiv class=\"flex items-center gap-4 p-1\">\n",[141,2434,2435],{"class":143,"line":190},[141,2436,2437],{"class":2247},"      \u003Cdiv class=\"flex items-center justify-center w-11 h-11 rounded-xl bg-primary\u002F10 shrink-0\">\n",[141,2439,2440],{"class":143,"line":196},[141,2441,2442],{"class":2247},"        \u003CUIcon name=\"i-lucide-lock-keyhole\" class=\"w-6 h-6 text-primary\" \u002F>\n",[141,2444,2445],{"class":143,"line":202},[141,2446,2447],{"class":2247},"      \u003C\u002Fdiv>\n",[141,2449,2450],{"class":143,"line":207},[141,2451,2452],{"class":2247},"      \u003Cdiv>\n",[141,2454,2455],{"class":143,"line":213},[141,2456,2457],{"class":2247},"        \u003Ch3 class=\"text-base font-semibold\">Título\u003C\u002Fh3>\n",[141,2459,2460],{"class":143,"line":219},[141,2461,2462],{"class":2247},"        \u003Cp class=\"text-sm text-muted\">Una frase de subtítulo\u003C\u002Fp>\n",[141,2464,2465],{"class":143,"line":224},[141,2466,2447],{"class":2247},[141,2468,2469],{"class":143,"line":230},[141,2470,2471],{"class":2247},"    \u003C\u002Fdiv>\n",[141,2473,2474],{"class":143,"line":236},[141,2475,2476],{"class":2247},"  \u003C\u002Ftemplate>\n",[141,2478,2479,2482,2484],{"class":143,"line":1284},[141,2480,2481],{"class":1336},"\u003C\u002F",[141,2483,2405],{"class":2256},[141,2485,2422],{"class":1336},[255,2487,2489],{"id":2488},"formulario","Formulario",[11,2491,2492,85,2495,2498,2499,811,2502,2505,2506,2509,2510,811,2513,2516,2517,2520,2521,2523,2524,2527],{},[20,2493,2494],{},"\u003CUForm class=\"space-y-5\">",[20,2496,2497],{},"UFormField"," con ",[20,2500,2501],{},":label",[20,2503,2504],{},":description"," arriba del campo → ",[20,2507,2508],{},"UInput class=\"w-full\""," → fila de submit a la derecha con ",[20,2511,2512],{},":loading",[20,2514,2515],{},":disabled"," enlazados al estado de la acción. El ",[20,2518,2519],{},"help"," de ",[20,2522,2497],{}," es el que va ",[15,2525,2526],{},"debajo"," del input.",[255,2529,2531],{"id":2530},"estado-de-acción-regla-del-proyecto","Estado de acción (regla del proyecto)",[11,2533,2534,2535,2260],{},"Toda acción asíncrona declara un ref con nombre de verbo, se protege contra doble clic y se resetea en ",[20,2536,2537],{},"finally",[132,2539,2541],{"className":2227,"code":2540,"language":2229,"meta":137,"style":137},"const saving = ref(false)\n\nasync function save() {\n  if (saving.value) return\n  saving.value = true\n  try {\n    await saveMutation.mutateAsync(data)\n  } finally {\n    saving.value = false\n  }\n}\n",[20,2542,2543,2564,2568,2584,2605,2620,2627,2647,2657,2671,2675],{"__ignoreMap":137},[141,2544,2545,2548,2551,2553,2556,2558,2562],{"class":143,"line":144},[141,2546,2547],{"class":2408},"const",[141,2549,2550],{"class":2247}," saving ",[141,2552,2412],{"class":1336},[141,2554,2555],{"class":2243}," ref",[141,2557,2248],{"class":2247},[141,2559,2561],{"class":2560},"sfNiH","false",[141,2563,2365],{"class":2247},[141,2565,2566],{"class":143,"line":177},[141,2567,187],{"emptyLinePlaceholder":186},[141,2569,2570,2573,2576,2579,2582],{"class":143,"line":183},[141,2571,2572],{"class":2408},"async",[141,2574,2575],{"class":2408}," function",[141,2577,2578],{"class":2243}," save",[141,2580,2581],{"class":1336},"()",[141,2583,2263],{"class":1336},[141,2585,2586,2589,2591,2594,2596,2599,2602],{"class":143,"line":190},[141,2587,2588],{"class":2236},"  if",[141,2590,316],{"class":2256},[141,2592,2593],{"class":2247},"saving",[141,2595,27],{"class":1336},[141,2597,2598],{"class":2247},"value",[141,2600,2601],{"class":2256},") ",[141,2603,2604],{"class":2236},"return\n",[141,2606,2607,2610,2612,2614,2617],{"class":143,"line":196},[141,2608,2609],{"class":2247},"  saving",[141,2611,27],{"class":1336},[141,2613,2598],{"class":2247},[141,2615,2616],{"class":1336}," =",[141,2618,2619],{"class":2560}," true\n",[141,2621,2622,2625],{"class":143,"line":202},[141,2623,2624],{"class":2236},"  try",[141,2626,2263],{"class":1336},[141,2628,2629,2632,2635,2637,2640,2642,2645],{"class":143,"line":207},[141,2630,2631],{"class":2236},"    await",[141,2633,2634],{"class":2247}," saveMutation",[141,2636,27],{"class":1336},[141,2638,2639],{"class":2243},"mutateAsync",[141,2641,2248],{"class":2256},[141,2643,2644],{"class":2247},"data",[141,2646,2365],{"class":2256},[141,2648,2649,2652,2655],{"class":143,"line":213},[141,2650,2651],{"class":1336},"  }",[141,2653,2654],{"class":2236}," finally",[141,2656,2263],{"class":1336},[141,2658,2659,2662,2664,2666,2668],{"class":143,"line":219},[141,2660,2661],{"class":2247},"    saving",[141,2663,27],{"class":1336},[141,2665,2598],{"class":2247},[141,2667,2616],{"class":1336},[141,2669,2670],{"class":2560}," false\n",[141,2672,2673],{"class":143,"line":224},[141,2674,2357],{"class":1336},[141,2676,2677],{"class":143,"line":230},[141,2678,2679],{"class":1336},"}\n",[132,2681,2683],{"className":2393,"code":2682,"language":2395,"meta":137,"style":137},"\u003CUButton :loading=\"saving\" :disabled=\"saving\" @click=\"save\">Guardar\u003C\u002FUButton>\n",[20,2684,2685],{"__ignoreMap":137},[141,2686,2687,2689,2692,2695,2698,2700,2702,2704,2706,2708,2711,2713,2715,2717,2719,2722,2725,2727,2729,2732,2734,2737,2740,2742,2744],{"class":143,"line":144},[141,2688,2402],{"class":1336},[141,2690,2691],{"class":2256},"UButton",[141,2693,2694],{"class":1336}," :",[141,2696,2697],{"class":2408},"loading",[141,2699,2412],{"class":1336},[141,2701,1343],{"class":1336},[141,2703,2593],{"class":2247},[141,2705,1343],{"class":1336},[141,2707,2694],{"class":1336},[141,2709,2710],{"class":2408},"disabled",[141,2712,2412],{"class":1336},[141,2714,1343],{"class":1336},[141,2716,2593],{"class":2247},[141,2718,1343],{"class":1336},[141,2720,2721],{"class":1336}," @",[141,2723,2724],{"class":2408},"click",[141,2726,2412],{"class":1336},[141,2728,1343],{"class":1336},[141,2730,2731],{"class":2247},"save",[141,2733,1343],{"class":1336},[141,2735,2736],{"class":1336},">",[141,2738,2739],{"class":2247},"Guardar",[141,2741,2481],{"class":1336},[141,2743,2691],{"class":2256},[141,2745,2422],{"class":1336},[41,2747,2749],{"id":2748},"qué-no-hacer","Qué no hacer",[132,2751,2753],{"className":2393,"code":2752,"language":2395,"meta":137,"style":137},"\u003C!-- ❌ Colores y sombras literales, se rompen en el modo contrario -->\n\u003Cdiv class=\"bg-white text-black shadow-[0_1px_3px_rgba(0,0,0,0.2)]\">…\u003C\u002Fdiv>\n\n\u003C!-- ✅ Superficie del sistema + utilidades semánticas -->\n\u003Cdiv class=\"ds-card rounded-lg p-5 text-highlighted\">…\u003C\u002Fdiv>\n\n\u003C!-- ❌ Un segundo acento inventado -->\n\u003CUBadge class=\"bg-purple-500\">…\u003C\u002FUBadge>\n\n\u003C!-- ✅ El acento es `primary` (o un color de estado para señales) -->\n\u003CUBadge color=\"primary\">…\u003C\u002FUBadge>\n",[20,2754,2755,2760,2790,2794,2799,2826,2830,2835,2863,2867,2872],{"__ignoreMap":137},[141,2756,2757],{"class":143,"line":144},[141,2758,2759],{"class":777},"\u003C!-- ❌ Colores y sombras literales, se rompen en el modo contrario -->\n",[141,2761,2762,2764,2767,2770,2772,2774,2777,2779,2781,2784,2786,2788],{"class":143,"line":177},[141,2763,2402],{"class":1336},[141,2765,2766],{"class":2256},"div",[141,2768,2769],{"class":2408}," class",[141,2771,2412],{"class":1336},[141,2773,1343],{"class":1336},[141,2775,2776],{"class":150},"bg-white text-black shadow-[0_1px_3px_rgba(0,0,0,0.2)]",[141,2778,1343],{"class":1336},[141,2780,2736],{"class":1336},[141,2782,2783],{"class":2247},"…",[141,2785,2481],{"class":1336},[141,2787,2766],{"class":2256},[141,2789,2422],{"class":1336},[141,2791,2792],{"class":143,"line":183},[141,2793,187],{"emptyLinePlaceholder":186},[141,2795,2796],{"class":143,"line":190},[141,2797,2798],{"class":777},"\u003C!-- ✅ Superficie del sistema + utilidades semánticas -->\n",[141,2800,2801,2803,2805,2807,2809,2811,2814,2816,2818,2820,2822,2824],{"class":143,"line":196},[141,2802,2402],{"class":1336},[141,2804,2766],{"class":2256},[141,2806,2769],{"class":2408},[141,2808,2412],{"class":1336},[141,2810,1343],{"class":1336},[141,2812,2813],{"class":150},"ds-card rounded-lg p-5 text-highlighted",[141,2815,1343],{"class":1336},[141,2817,2736],{"class":1336},[141,2819,2783],{"class":2247},[141,2821,2481],{"class":1336},[141,2823,2766],{"class":2256},[141,2825,2422],{"class":1336},[141,2827,2828],{"class":143,"line":202},[141,2829,187],{"emptyLinePlaceholder":186},[141,2831,2832],{"class":143,"line":207},[141,2833,2834],{"class":777},"\u003C!-- ❌ Un segundo acento inventado -->\n",[141,2836,2837,2839,2842,2844,2846,2848,2851,2853,2855,2857,2859,2861],{"class":143,"line":213},[141,2838,2402],{"class":1336},[141,2840,2841],{"class":2256},"UBadge",[141,2843,2769],{"class":2408},[141,2845,2412],{"class":1336},[141,2847,1343],{"class":1336},[141,2849,2850],{"class":150},"bg-purple-500",[141,2852,1343],{"class":1336},[141,2854,2736],{"class":1336},[141,2856,2783],{"class":2247},[141,2858,2481],{"class":1336},[141,2860,2841],{"class":2256},[141,2862,2422],{"class":1336},[141,2864,2865],{"class":143,"line":219},[141,2866,187],{"emptyLinePlaceholder":186},[141,2868,2869],{"class":143,"line":224},[141,2870,2871],{"class":777},"\u003C!-- ✅ El acento es `primary` (o un color de estado para señales) -->\n",[141,2873,2874,2876,2878,2881,2883,2885,2888,2890,2892,2894,2896,2898],{"class":143,"line":230},[141,2875,2402],{"class":1336},[141,2877,2841],{"class":2256},[141,2879,2880],{"class":2408}," color",[141,2882,2412],{"class":1336},[141,2884,1343],{"class":1336},[141,2886,2887],{"class":150},"primary",[141,2889,1343],{"class":1336},[141,2891,2736],{"class":1336},[141,2893,2783],{"class":2247},[141,2895,2481],{"class":1336},[141,2897,2841],{"class":2256},[141,2899,2422],{"class":1336},[41,2901,2903],{"id":2902},"verificación","Verificación",[893,2905,2906,2912,2917,2934],{},[896,2907,2908,2909,27],{},"Cambia con el toggle de tema (menú del usuario o controles de apariencia de las páginas públicas): un cambio está hecho solo cuando se ve bien en ",[15,2910,2911],{},"claro y oscuro",[896,2913,2914,2916],{},[20,2915,1726],{}," no valida colores; la prueba real es el navegador.",[896,2918,2919,2920,2520,2923,2926,2927,2930,2931,1158],{},"Si tocaste tokens, revisa también el ",[20,2921,2922],{},"theme-color",[20,2924,2925],{},"app\u002Fapp.vue"," (claro ",[20,2928,2929],{},"#faf9f5",", oscuro ",[20,2932,2933],{},"#1f1e1b",[896,2935,2936,2937,2940,2941,2943],{},"Para colores nuevos: la paleta necesita los 11 pasos (",[20,2938,2939],{},"50…950",") y se registra como alias en ",[20,2942,2042],{},", no como hex suelto.",[922,2945,2946],{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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);}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}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}",{"title":137,"searchDepth":177,"depth":177,"links":2948},[2949,2950,2956,2961,2962],{"id":1926,"depth":177,"text":1927},{"id":1994,"depth":177,"text":1995,"children":2951},[2952,2953,2955],{"id":1998,"depth":183,"text":1999},{"id":2095,"depth":183,"text":2954},"2. Clases .ds-*",{"id":2218,"depth":183,"text":2219},{"id":2382,"depth":177,"text":2383,"children":2957},[2958,2959,2960],{"id":2386,"depth":183,"text":2387},{"id":2488,"depth":183,"text":2489},{"id":2530,"depth":183,"text":2531},{"id":2748,"depth":177,"text":2749},{"id":2902,"depth":177,"text":2903},"Los tres niveles del sistema (tokens, clases .ds-*, temas de componentes) y las reglas para no salirse de él.",{},{"icon":2966},"i-lucide-swatch-book",{"title":908,"description":2963},"docs\u002F3.design-system","9vXJbrcAL9-_3STXPmoRz1HQo69Px5jGVG3X-v8-cMM",{"id":2971,"title":919,"body":2972,"description":3765,"extension":938,"meta":3766,"navigation":3767,"path":918,"seo":3769,"stem":3770,"__hash__":3771},"docs\u002Fdocs\u002F4.deploy.md",{"type":8,"value":2973,"toc":3754},[2974,2987,3031,3037,3041,3044,3049,3123,3128,3181,3190,3196,3210,3307,3354,3363,3367,3385,3402,3406,3413,3464,3544,3609,3613,3620,3649,3672,3676,3689,3719,3723,3752],[11,2975,2976,2977,2980,2981,2983,2984,2986],{},"El despliegue corre sobre ",[15,2978,2979],{},"Dokploy",", disparado por GitHub Actions después de un CI en verde. Hay dos entornos: producción (rama ",[20,2982,955],{},") y dev (rama ",[20,2985,958],{},", con su propio dominio y su propia base de datos).",[46,2988,2989,2997],{},[49,2990,2991],{},[52,2992,2993,2995],{},[55,2994,1785],{},[55,2996,1788],{},[65,2998,2999,3014,3022],{},[52,3000,3001,3004],{},[70,3002,3003],{},"PR",[70,3005,3006,3007,3009,3010,3013],{},"CI: ",[20,3008,1726],{}," + ",[20,3011,3012],{},"pnpm build"," (bloqueantes) y typecheck informativo",[52,3015,3016,3020],{},[70,3017,1845,3018],{},[20,3019,958],{},[70,3021,1850],{},[52,3023,3024,3028],{},[70,3025,1845,3026],{},[20,3027,955],{},[70,3029,3030],{},"CI + despliegue de producción con health check",[132,3032,3035],{"className":3033,"code":3034,"language":1082,"meta":137},[1080],"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",[20,3036,3034],{"__ignoreMap":137},[41,3038,3040],{"id":3039},"activar-el-despliegue","Activar el despliegue",[11,3042,3043],{},"Los workflows vienen apagados; se encienden con variables y secretos del repositorio (Settings → Secrets and variables → Actions).",[11,3045,3046],{},[15,3047,3048],{},"Variables",[46,3050,3051,3062],{},[49,3052,3053],{},[52,3054,3055,3057,3060],{},[55,3056,267],{},[55,3058,3059],{},"Ejemplo",[55,3061,63],{},[65,3063,3064,3079,3094,3108],{},[52,3065,3066,3071,3076],{},[70,3067,3068],{},[20,3069,3070],{},"DOKPLOY_DEPLOY_ENABLED",[70,3072,3073],{},[20,3074,3075],{},"true",[70,3077,3078],{},"Enciende el deploy de producción",[52,3080,3081,3086,3091],{},[70,3082,3083],{},[20,3084,3085],{},"HEALTHCHECK_URL",[70,3087,3088],{},[20,3089,3090],{},"https:\u002F\u002Ftudominio.com\u002Fapi\u002Fhealth",[70,3092,3093],{},"Verifica el rollout",[52,3095,3096,3101,3105],{},[70,3097,3098],{},[20,3099,3100],{},"DOKPLOY_DEV_DEPLOY_ENABLED",[70,3102,3103],{},[20,3104,3075],{},[70,3106,3107],{},"Enciende el deploy del entorno dev",[52,3109,3110,3115,3120],{},[70,3111,3112],{},[20,3113,3114],{},"DEV_HEALTHCHECK_URL",[70,3116,3117],{},[20,3118,3119],{},"https:\u002F\u002Fdev.tudominio.com\u002Fapi\u002Fhealth",[70,3121,3122],{},"Verifica el rollout de dev",[11,3124,3125],{},[15,3126,3127],{},"Secretos",[46,3129,3130,3139],{},[49,3131,3132],{},[52,3133,3134,3137],{},[55,3135,3136],{},"Secret",[55,3138,63],{},[65,3140,3141,3151,3161,3171],{},[52,3142,3143,3148],{},[70,3144,3145],{},[20,3146,3147],{},"DOKPLOY_WEBHOOK_URL",[70,3149,3150],{},"Webhook de la app de producción en Dokploy",[52,3152,3153,3158],{},[70,3154,3155],{},[20,3156,3157],{},"PRODUCTION_DATABASE_URL",[70,3159,3160],{},"Aplica migraciones antes del deploy (si falta, ese paso se salta)",[52,3162,3163,3168],{},[70,3164,3165],{},[20,3166,3167],{},"DOKPLOY_DEV_WEBHOOK_URL",[70,3169,3170],{},"Webhook de la app dev",[52,3172,3173,3178],{},[70,3174,3175],{},[20,3176,3177],{},"DEV_DATABASE_URL",[70,3179,3180],{},"Migraciones de la base de dev",[747,3182,3183],{},[11,3184,3185,3186,3189],{},"Elige ",[15,3187,3188],{},"un solo mecanismo",": o el auto-deploy de Dokploy (al hacer push) o el workflow. Con los dos activos, cada merge despliega dos veces.",[41,3191,3193,3194,323],{"id":3192},"el-entorno-dev-devtudominiocom","El entorno dev (",[20,3195,1012],{},[11,3197,3198,3199,3201,3202,2520,3206,3209],{},"Una segunda aplicación en Dokploy que sirve la rama ",[20,3200,958],{},", con base de datos propia. Los pasos completos están en la sección ",[3203,3204,3205],"em",{},"Entorno dev",[20,3207,3208],{},"DEPLOYMENT.md","; en resumen:",[1090,3211,3212,3223,3243,3257,3271,3282],{},[896,3213,3214,3217,3218,3220,3221,27],{},[15,3215,3216],{},"Base de datos",": una rama (branch) de Neon para ",[20,3219,958],{},", creada desde la principal. Su connection string será ",[20,3222,3177],{},[896,3224,3225,3228,3229,3231,3232,3235,3236,3239,3240,27],{},[15,3226,3227],{},"Aplicación en Dokploy",": mismo repo, branch ",[20,3230,958],{},", build con Nixpacks, comando de arranque ",[20,3233,3234],{},"node .output\u002Fserver\u002Findex.mjs"," y puerto ",[20,3237,3238],{},"3000",". Health check en ",[20,3241,3242],{},"\u002Fapi\u002Fhealth",[896,3244,3245,1533,3248,3250,3251,3253,3254,3256],{},[15,3246,3247],{},"Variables de la app dev",[20,3249,281],{}," (rama dev), ",[20,3252,303],{}," propio y ",[20,3255,330],{}," apuntando al dominio de dev. Better Auth usa esa URL como baseURL: magic links, invitaciones y callbacks deben apuntar ahí.",[896,3258,3259,3262,3263,3266,3267,3270],{},[15,3260,3261],{},"Dominio",": agrega el host en Dokploy (HTTPS con Let's Encrypt) y crea un registro DNS ",[20,3264,3265],{},"A"," apuntando a la IP del servidor (o ",[20,3268,3269],{},"CNAME"," al dominio raíz).",[896,3272,3273,3276,3277,3279,3280,27],{},[15,3274,3275],{},"Automatización",": pega el webhook en el secreto ",[20,3278,3167],{}," y enciende ",[20,3281,3100],{},[896,3283,3284,1533,3287,3009,3290,3293,3294,844,3296,3298,3299,3302,3303,3306],{},[15,3285,3286],{},"E2E remoto (opcional)",[20,3288,3289],{},"E2E_ENABLED=true",[20,3291,3292],{},"E2E_BASE_URL"," y los secretos ",[20,3295,843],{},[20,3297,847],{}," de una cuenta ",[20,3300,3301],{},"owner"," de dev. La suite ",[15,3304,3305],{},"escribe y borra datos",": apúntala solo a dev.",[132,3308,3310],{"className":134,"code":3309,"language":136,"meta":137,"style":137},"# 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",[20,3311,3312,3317,3332,3342],{"__ignoreMap":137},[141,3313,3314],{"class":143,"line":144},[141,3315,3316],{"class":777},"# Primera vez: crea la rama dev desde un main que ya tenga los workflows\n",[141,3318,3319,3321,3323,3325,3327,3329],{"class":143,"line":177},[141,3320,1204],{"class":147},[141,3322,1207],{"class":150},[141,3324,1425],{"class":150},[141,3326,1403],{"class":1336},[141,3328,1406],{"class":147},[141,3330,3331],{"class":150}," pull\n",[141,3333,3334,3336,3338,3340],{"class":143,"line":183},[141,3335,1204],{"class":147},[141,3337,1207],{"class":150},[141,3339,1240],{"class":150},[141,3341,1210],{"class":150},[141,3343,3344,3346,3348,3350,3352],{"class":143,"line":190},[141,3345,1204],{"class":147},[141,3347,1295],{"class":150},[141,3349,1298],{"class":150},[141,3351,1220],{"class":150},[141,3353,1210],{"class":150},[29,3355,3356],{},[11,3357,3358,3359,3362],{},"Atajo interactivo: ",[20,3360,3361],{},".\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.",[255,3364,3366],{"id":3365},"variables-por-entorno","Variables por entorno",[11,3368,3369,3370,3373,3374,3377,3378,3381,3382,27],{},"Cada aplicación de Dokploy tiene su propio ",[15,3371,3372],{},"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 (",[20,3375,3376],{},"${{project.VAR}}","), del entorno (",[20,3379,3380],{},"${{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 ",[15,3383,3384],{},"servicio",[11,3386,3387,3388,3390,3391,3394,3395,3397,3398,3401],{},"Guardar cambios en la pestaña ",[3203,3389,3372],{}," no toca el contenedor en marcha: lanza un ",[15,3392,3393],{},"Deploy"," después de editar. ",[20,3396,330],{}," además se lee al construir (i18n ",[20,3399,3400],{},"baseUrl","), así que defínela antes del primer build.",[41,3403,3405],{"id":3404},"páginas-estáticas-prerender","Páginas estáticas (prerender)",[11,3407,3408,3409,3412],{},"Las páginas públicas se generan en el build y se sirven como archivos estáticos desde ",[20,3410,3411],{},".output\u002Fpublic","; el resto (dashboard, auth, API) sigue renderizándose en el servidor.",[46,3414,3415,3425],{},[49,3416,3417],{},[52,3418,3419,3422],{},[55,3420,3421],{},"Ruta",[55,3423,3424],{},"Cómo se sirve",[65,3426,3427,3441,3454],{},[52,3428,3429,3434],{},[70,3430,3431],{},[20,3432,3433],{},"\u002F",[70,3435,3436,3437,3440],{},"Estática (HTML + ",[20,3438,3439],{},"_payload.json","), sin coste SSR",[52,3442,3443,3451],{},[70,3444,3445,3009,3448],{},[20,3446,3447],{},"\u002Fdocs",[20,3449,3450],{},"\u002Fdocs\u002F**",[70,3452,3453],{},"Estática, una por archivo Markdown",[52,3455,3456,3459],{},[70,3457,3458],{},"Todo lo demás",[70,3460,3461,3462],{},"SSR en ",[20,3463,3234],{},[893,3465,3466,3501,3515,3527,3534],{},[896,3467,3468,3469,316,3472,3474,3475,290,3478,290,3481,811,3484,2498,3487,3490,3491,3494,3495,811,3498,27],{},"La lista vive en ",[20,3470,3471],{},"routeRules",[20,3473,338],{},"): ",[20,3476,3477],{},"'\u002F'",[20,3479,3480],{},"'\u002F_payload.json'",[20,3482,3483],{},"'\u002Fdocs'",[20,3485,3486],{},"'\u002Fdocs\u002F**'",[20,3488,3489],{},"prerender: true",", y un catch-all ",[20,3492,3493],{},"'\u002F**': { prerender: false }"," que mantiene al crawler fuera de ",[20,3496,3497],{},"\u002Fapp",[20,3499,3500],{},"\u002Fauth",[896,3502,3503,3506,3507,3510,3511,3514],{},[15,3504,3505],{},"Agregar una sección no requiere tocar la config",": el crawler (",[20,3508,3509],{},"crawlLinks",") descubre los archivos nuevos de ",[20,3512,3513],{},"content\u002Fdocs\u002F"," desde los enlaces del índice.",[896,3516,3517,3522,3523,3526],{},[15,3518,3519,3520],{},"El build pasa sin ",[20,3521,161],{}," (CI no tiene secretos): auth, colas y Resend se protegen con ",[20,3524,3525],{},"import.meta.prerender",". No hay nada que configurar.",[896,3528,3529,3530,3533],{},"El HTML se genera en inglés; el idioma del visitante (cookie ",[20,3531,3532],{},"i18n_locale",") se aplica en el cliente inmediatamente después de la hidratación, sin recargar.",[896,3535,3536,3537,3539,3540,1135,3542,27],{},"Si en el futuro agregas otra página pública, dale su propia regla ",[20,3538,3489],{}," (el catch-all la bloquearía) y verificá que exista su ",[20,3541,3439],{},[20,3543,3411],{},[132,3545,3547],{"className":134,"code":3546,"language":136,"meta":137,"style":137},"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",[20,3548,3549,3559,3578],{"__ignoreMap":137},[141,3550,3551,3553,3556],{"class":143,"line":144},[141,3552,17],{"class":147},[141,3554,3555],{"class":150}," build",[141,3557,3558],{"class":777},"                              # 13 rutas prerenderizadas\n",[141,3560,3561,3563,3566,3569,3572,3575],{"class":143,"line":177},[141,3562,2248],{"class":1336},[141,3564,3565],{"class":147},"nohup",[141,3567,3568],{"class":150}," node",[141,3570,3571],{"class":150}," .output\u002Fserver\u002Findex.mjs",[141,3573,3574],{"class":1336}," &)",[141,3576,3577],{"class":777}," # sirve .output: estáticas + SSR\n",[141,3579,3580,3583,3586,3589,3591,3594,3596,3599,3602,3604,3606],{"class":143,"line":183},[141,3581,3582],{"class":147},"mv",[141,3584,3585],{"class":150}," .env",[141,3587,3588],{"class":150}," .env.ci-bak",[141,3590,1403],{"class":1336},[141,3592,3593],{"class":147}," pnpm",[141,3595,3555],{"class":150},[141,3597,3598],{"class":1336},";",[141,3600,3601],{"class":147}," mv",[141,3603,3588],{"class":150},[141,3605,3585],{"class":150},[141,3607,3608],{"class":777},"   # la prueba de CI, sin secretos\n",[41,3610,3612],{"id":3611},"migraciones-expandcontract","Migraciones (expand\u002Fcontract)",[11,3614,3615,3616,3619],{},"El paso de migraciones corre ",[15,3617,3618],{},"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:",[1090,3621,3622,3631,3637,3643],{},[896,3623,3624,3627,3628,1158],{},[15,3625,3626],{},"Expand",": agrega (columna nullable, tabla nueva, índice ",[20,3629,3630],{},"CONCURRENTLY",[896,3632,3633,3636],{},[15,3634,3635],{},"Migrar código",": despliega la versión que escribe ambos formatos o que usa lo nuevo.",[896,3638,3639,3642],{},[15,3640,3641],{},"Backfill",": rellena datos con un script o una tarea, fuera del deploy.",[896,3644,3645,3648],{},[15,3646,3647],{},"Contract",": borra lo viejo (NOT NULL, drop) recién en un deploy posterior.",[132,3650,3652],{"className":134,"code":3651,"language":136,"meta":137,"style":137},"pnpm db:generate   # después de cambiar el schema\npnpm db:migrate    # lo aplica también el workflow de deploy\n",[20,3653,3654,3663],{"__ignoreMap":137},[141,3655,3656,3658,3660],{"class":143,"line":144},[141,3657,17],{"class":147},[141,3659,785],{"class":150},[141,3661,3662],{"class":777},"   # después de cambiar el schema\n",[141,3664,3665,3667,3669],{"class":143,"line":177},[141,3666,17],{"class":147},[141,3668,774],{"class":150},[141,3670,3671],{"class":777},"    # lo aplica también el workflow de deploy\n",[41,3673,3675],{"id":3674},"backups-de-la-base-de-datos","Backups de la base de datos",[11,3677,3678,3679,3681,3682,3685,3686,3688],{},"El dashboard admin (",[20,3680,692],{},") genera backups manuales: un job de pg-boss corre ",[20,3683,3684],{},"pg_dump --format=custom"," y sube el dump al bucket dedicado (",[20,3687,548],{},"). Dos requisitos de despliegue:",[893,3690,3691,3705],{},[896,3692,3693,3698,3699,316,3701,3704],{},[15,3694,3695,3697],{},[20,3696,577],{}," en la imagen",": lo instala ",[20,3700,707],{},[20,3702,3703],{},"postgresql_17","); debe ser una versión ≥ a la del servidor PostgreSQL.",[896,3706,3707,3710,3711,3713,3714,3716,3717,27],{},[15,3708,3709],{},"Conexión directa",": si ",[20,3712,281],{}," es la pooled de Neon (",[20,3715,584],{},"), el dump deriva la conexión directa automáticamente; también se puede fijar ",[20,3718,568],{},[41,3720,3722],{"id":3721},"salud-y-rollback","Salud y rollback",[893,3724,3725,3733,3743],{},[896,3726,3727,316,3730,3732],{},[15,3728,3729],{},"Liveness",[20,3731,3242],{},"): público y barato, no toca la base de datos. Es el que usan Dokploy y el paso final del workflow.",[896,3734,3735,3738,3739,3742],{},[15,3736,3737],{},"Rollback",": Dokploy conserva los deployments anteriores; ",[3203,3740,3741],{},"Redeploy"," de la revisión previa. Gracias a expand\u002Fcontract, la versión anterior del código sigue siendo compatible con el esquema.",[896,3744,3745,316,3748,3751],{},[15,3746,3747],{},"Salud profunda",[20,3749,3750],{},"\u002Fapi\u002Fadmin\u002Fsystem\u002Fhealth","): base de datos, Redis, colas, backups y DeepSeek, solo para administradores.",[922,3753,1867],{},{"title":137,"searchDepth":177,"depth":177,"links":3755},[3756,3757,3761,3762,3763,3764],{"id":3039,"depth":177,"text":3040},{"id":3192,"depth":177,"text":3758,"children":3759},"El entorno dev (dev.tudominio.com)",[3760],{"id":3365,"depth":183,"text":3366},{"id":3404,"depth":177,"text":3405},{"id":3611,"depth":177,"text":3612},{"id":3674,"depth":177,"text":3675},{"id":3721,"depth":177,"text":3722},"El pipeline completo (hooks, CI, Dokploy), los dos entornos y las reglas de migración y rollback.",{},{"icon":3768},"i-lucide-cloud-upload",{"title":919,"description":3765},"docs\u002F4.deploy","by8vZKFapKTtLYmtwIroIGfuZVvC_Iu-HCfYlALIdbc",{"id":3773,"title":3774,"body":3775,"description":5158,"extension":938,"meta":5159,"navigation":186,"path":5160,"seo":5161,"stem":5166,"__hash__":5167},"docs\u002Fdocs\u002F5.customers.md","Customers y portal de clientes",{"type":8,"value":3776,"toc":5135},[3777,3792,3798,3802,3876,3880,3888,3938,3950,3954,3975,4051,4062,4066,4128,4145,4151,4207,4210,4242,4251,4255,4259,4336,4348,4352,4609,4635,4639,4728,4732,4857,4861,4890,4937,4952,4956,4999,5013,5017,5132],[11,3778,3779,3780,3783,3784,3787,3788,3791],{},"Cada organización puede tener ",[15,3781,3782],{},"customers"," (sus clientes) y cada customer puede tener ",[15,3785,3786],{},"usuarios propios con acceso a un portal separado",". La clave del diseño: esos usuarios ",[15,3789,3790],{},"no son miembros de la organización"," — no aparecen en el equipo, no cuentan para el límite de miembros y todas las rutas internas los rechazan por defecto.",[132,3793,3796],{"className":3794,"code":3795,"language":1082,"meta":137},[1080],"Organización  (members: owner \u002F org_admin \u002F member)\n├── Categorías de clientes  (etiquetas N:M definidas por la organización)\n└── Customer  (nombre, email, estado, asignado a…)\n    └── Usuarios del portal  (customer_manager \u002F customer_user)  ← no son members\n",[20,3797,3795],{"__ignoreMap":137},[41,3799,3801],{"id":3800},"roles","Roles",[46,3803,3804,3816],{},[49,3805,3806],{},[52,3807,3808,3810,3813],{},[55,3809,1942],{},[55,3811,3812],{},"Quién es",[55,3814,3815],{},"Puede",[65,3817,3818,3833,3846,3863],{},[52,3819,3820,3827,3830],{},[70,3821,3822,844,3824],{},[20,3823,3301],{},[20,3825,3826],{},"org_admin",[70,3828,3829],{},"Staff de la organización",[70,3831,3832],{},"Crear\u002Feditar\u002Fborrar customers, gestionar sus usuarios e invitaciones",[52,3834,3835,3840,3843],{},[70,3836,3837],{},[20,3838,3839],{},"member",[70,3841,3842],{},"Cualquier otro miembro",[70,3844,3845],{},"Ver customers y sus usuarios (solo lectura)",[52,3847,3848,3853,3856],{},[70,3849,3850],{},[20,3851,3852],{},"customer_manager",[70,3854,3855],{},"Usuario del portal con mando",[70,3857,3858,3859,3862],{},"Gestionar los usuarios de ",[15,3860,3861],{},"su"," customer (invitar, rol, quitar) y su propia cuenta",[52,3864,3865,3870,3873],{},[70,3866,3867],{},[20,3868,3869],{},"customer_user",[70,3871,3872],{},"Usuario del portal básico",[70,3874,3875],{},"Su propia cuenta; nada más",[41,3877,3879],{"id":3878},"uso-lado-organización-staff","Uso: lado organización (staff)",[11,3881,3882,3883,2260],{},"Todos los clientes viven en ",[15,3884,3885],{},[20,3886,3887],{},"\u002Fapp\u002Fcustomers",[1090,3889,3890,3907,3924],{},[896,3891,3892,3895,3896,3899,3900,3902,3903,3906],{},[15,3893,3894],{},"Nuevo cliente",": pide nombre, email y (opcional) nombre del contacto. Al crearlo, la organización genera automáticamente ",[15,3897,3898],{},"su primer usuario"," — un ",[20,3901,3852],{},", con cuenta sin contraseña — y le envía ",[15,3904,3905],{},"una"," invitación.",[896,3908,3909,316,3912,3915,3916,3919,3920,3923],{},[15,3910,3911],{},"Detalle del cliente",[20,3913,3914],{},"\u002Fapp\u002Fcustomers\u002F[id]","): pestaña ",[3203,3917,3918],{},"Overview"," (nombre, email, estado, asignado) y pestaña ",[3203,3921,3922],{},"Users"," con los usuarios del portal y las invitaciones pendientes (reenviar \u002F cancelar).",[896,3925,3926,3929,3930,3933,3934,3937],{},[15,3927,3928],{},"Borrado",": se rechaza con ",[20,3931,3932],{},"409"," mientras el cliente tenga usuarios aceptados (",[20,3935,3936],{},"customer_has_users","). Las invitaciones pendientes desaparecen con el cliente.",[747,3939,3940],{},[11,3941,751,3942,3945,3946,3949],{},[15,3943,3944],{},"último manager"," de un cliente no puede quitarse ni degradarse ",[3203,3947,3948],{},"desde el portal"," — la regla protege al cliente de quedarse sin nadie que gestione sus usuarios. El staff de la organización sí puede quitarlo (es el camino para poder borrar el cliente).",[41,3951,3953],{"id":3952},"categorías-de-clientes","Categorías de clientes",[11,3955,3956,3957,3960,3961,3964,3965,2520,3968,3970,3971,3974],{},"Cada organización define ",[15,3958,3959],{},"sus propias categorías"," (etiquetas) y un cliente puede llevar ",[15,3962,3963],{},"una o más",". Se gestionan desde el slideover ",[15,3966,3967],{},"«Categorías»",[20,3969,3887],{}," y se asignan en la tarjeta ",[3203,3972,3973],{},"Categories"," del detalle del cliente.",[893,3976,3977,3983,3994,4014,4030,4044],{},[896,3978,3979,3982],{},[15,3980,3981],{},"Crear, renombrar, recolorear y borrar",": solo owner \u002F org_admin. Cualquier miembro ve la columna, el filtro y los badges en modo lectura.",[896,3984,3985,3988,3989,2498,3991,1158],{},[15,3986,3987],{},"Nombre único por organización"," sin distinguir mayúsculas (índice único parcial → ",[20,3990,3932],{},[20,3992,3993],{},"code: 'duplicate_name'",[896,3995,3996,3999,4000,290,4002,290,4004,290,4006,290,4008,290,4010,4013],{},[15,3997,3998],{},"Color",": un token de la paleta de Nuxt UI (",[20,4001,2887],{},[20,4003,2086],{},[20,4005,2083],{},[20,4007,747],{},[20,4009,2091],{},[20,4011,4012],{},"neutral","), nunca un hex — los badges siguen el tema claro\u002Foscuro sin trabajo extra.",[896,4015,4016,4019,4020,4022,4023,4026,4027,27],{},[15,4017,4018],{},"Borrar una categoría la quita en cascada"," de todos los clientes que la llevan; el diálogo de confirmación dice a cuántos afecta. Ese borrado ",[15,4021,1529],{}," emite un evento por cliente: el evento ",[20,4024,4025],{},"customer_category.deleted"," lleva ",[20,4028,4029],{},"customersCount",[896,4031,4032,4033,4036,4037,4040,4041,27],{},"El listado de clientes se puede ",[15,4034,4035],{},"filtrar por categoría"," (checkbox con contadores vivos) y la columna ",[3203,4038,4039],{},"Categorías"," muestra hasta 2 badges + ",[20,4042,4043],{},"+n",[896,4045,4046,4047,4050],{},"Las categorías son ",[15,4048,4049],{},"metadata interna",": el portal del cliente no las muestra.",[11,4052,4053,4054,4057,4058,4061],{},"La asignación es un ",[15,4055,4056],{},"full-state sync",": la tarjeta envía la selección completa (",[20,4059,4060],{},"PUT \u002Fapi\u002Fcustomer\u002F[id]\u002Fcategories","), el servidor la contrasta contra la organización y calcula el diff — solo las transiciones escriben y emiten eventos. Re-guardar la misma selección no hace nada.",[41,4063,4065],{"id":4064},"flujo-de-invitación","Flujo de invitación",[4067,4068,4069,4073,4083,4087,4100,4104,4115,4119],"steps",{},[255,4070,4072],{"id":4071},"la-cuenta-se-crea-primero","La cuenta se crea primero",[11,4074,4075,4076,316,4079,4082],{},"Si el email no existe, se crea la cuenta ",[15,4077,4078],{},"sin contraseña",[20,4080,4081],{},"mustCompleteProfile","). Si ya existe, se reutiliza.",[255,4084,4086],{"id":4085},"una-sola-fila-antes-del-email","Una sola fila, antes del email",[11,4088,4089,4090,1723,4093,4095,4096,4099],{},"La invitación se persiste en ",[20,4091,4092],{},"customer_invitation",[15,4094,3618],{}," de intentar el envío. Un fallo de entrega no pierde la invitación: la API responde con ",[20,4097,4098],{},"emailSent: false"," y la UI avisa para reenviarla.",[255,4101,4103],{"id":4102},"un-solo-email","Un solo email",[11,4105,4106,4107,4110,4111,4114],{},"Cuenta nueva (o sin contraseña) → magic link con copy de invitación (",[20,4108,4109],{},"customer-invitation-signin","), que inicia sesión y aterriza en la aceptación. Cuenta con contraseña → email de invitación normal (",[20,4112,4113],{},"customer-invitation",") con enlace a la aceptación.",[255,4116,4118],{"id":4117},"aceptación","Aceptación",[11,4120,4121,4124,4125,27],{},[20,4122,4123],{},"\u002Fauth\u002Fcustomer-invitation?invitationId=…"," valida que la invitación esté pendiente, vigente y dirigida al email de la sesión. Al aceptar se crea el vínculo y el usuario entra a ",[20,4126,4127],{},"\u002Fportal",[11,4129,4130,4131,4134,4135,4138,4139,844,4142,1158],{},"Las invitaciones ",[15,4132,4133],{},"caducan en 7 días",". Solo puede haber ",[15,4136,4137],{},"una pendiente por cliente y email"," (índice único parcial); reenviar reutiliza la fila y extiende la fecha. Rechazar o cancelar se registra (",[20,4140,4141],{},"invitation_rejected",[20,4143,4144],{},"invitation_cancelled",[41,4146,4148,4149,323],{"id":4147},"el-portal-portal","El portal (",[20,4150,4127],{},[46,4152,4153,4166],{},[49,4154,4155],{},[52,4156,4157,4160,4163],{},[55,4158,4159],{},"Página",[55,4161,4162],{},"Quién la ve",[55,4164,4165],{},"Contenido",[65,4167,4168,4180,4195],{},[52,4169,4170,4174,4177],{},[70,4171,4172],{},[20,4173,4127],{},[70,4175,4176],{},"Cualquier usuario",[70,4178,4179],{},"Saludo, ficha de su cliente, invitaciones pendientes y accesos rápidos",[52,4181,4182,4187,4192],{},[70,4183,4184],{},[20,4185,4186],{},"\u002Fportal\u002Fusers",[70,4188,4189,4190],{},"Solo ",[20,4191,3852],{},[70,4193,4194],{},"Los usuarios de su customer: invitar, cambiar rol, quitar, reenviar\u002Fcancelar",[52,4196,4197,4202,4204],{},[70,4198,4199],{},[20,4200,4201],{},"\u002Fportal\u002Fsettings",[70,4203,4176],{},[70,4205,4206],{},"Perfil (nombre), cambio de email, crear\u002Fcambiar contraseña y sesiones activas",[11,4208,4209],{},"Reglas de navegación (middleware global):",[893,4211,4212,4225,4232],{},[896,4213,4214,4215,4218,4219,4222,4223,27],{},"Un usuario ",[15,4216,4217],{},"solo cliente"," que visite ",[20,4220,4221],{},"\u002Fapp\u002F**"," es redirigido a ",[20,4224,4127],{},[896,4226,4227,4228,4231],{},"Un ",[15,4229,4230],{},"miembro"," sin vínculo de cliente no entra al portal. Alguien con invitación pendiente va a la página de aceptación.",[896,4233,4234,4236,4237,4239,4240,27],{},[20,4235,4186],{}," exige rol ",[20,4238,3852],{},"; el resto es redirigido a ",[20,4241,4127],{},[682,4243,4244],{},[11,4245,4246,4247,4250],{},"Un mismo usuario puede ser cliente de varios customers (incluso de organizaciones distintas). La sesión resuelve el ",[15,4248,4249],{},"vínculo más antiguo"," de forma determinista; un selector de customer es una extensión futura, el modelo ya la soporta.",[41,4252,4254],{"id":4253},"referencia-técnica","Referencia técnica",[255,4256,4258],{"id":4257},"modelo-de-datos","Modelo de datos",[46,4260,4261,4273],{},[49,4262,4263],{},[52,4264,4265,4268,4270],{},[55,4266,4267],{},"Tabla",[55,4269,63],{},[55,4271,4272],{},"Claves",[65,4274,4275,4291,4306,4321],{},[52,4276,4277,4281,4284],{},[70,4278,4279],{},[20,4280,3869],{},[70,4282,4283],{},"Vínculo usuario ↔ customer con rol",[70,4285,4286,4287,4290],{},"Único ",[20,4288,4289],{},"(customerId, userId)","; FK en cascada",[52,4292,4293,4297,4300],{},[70,4294,4295],{},[20,4296,4092],{},[70,4298,4299],{},"Ledger de invitaciones (estado, expiración, quién invitó)",[70,4301,4302,4303],{},"Único parcial ",[20,4304,4305],{},"(customerId, lower(email)) where pending",[52,4307,4308,4313,4316],{},[70,4309,4310],{},[20,4311,4312],{},"customer_category",[70,4314,4315],{},"Etiquetas definidas por la organización",[70,4317,4286,4318],{},[20,4319,4320],{},"(organizationId, lower(name))",[52,4322,4323,4328,4331],{},[70,4324,4325],{},[20,4326,4327],{},"customer_category_link",[70,4329,4330],{},"Asignación N:M cliente ↔ categoría",[70,4332,4286,4333,4290],{},[20,4334,4335],{},"(customerId, categoryId)",[682,4337,4338],{},[11,4339,4340,4341,4344,4345,4347],{},"La invitación es ",[15,4342,4343],{},"nuestra",", no de Better Auth: el endpoint de aceptación del plugin de organización crearía un ",[20,4346,3839],{},", y aquí el usuario no debe ser miembro.",[255,4349,4351],{"id":4350},"api","API",[46,4353,4354,4366],{},[49,4355,4356],{},[52,4357,4358,4361,4363],{},[55,4359,4360],{},"Método",[55,4362,3421],{},[55,4364,4365],{},"Quién",[65,4367,4368,4383,4397,4411,4428,4441,4456,4470,4482,4497,4515,4533,4549,4564,4578,4592],{},[52,4369,4370,4375,4380],{},[70,4371,4372],{},[20,4373,4374],{},"GET",[70,4376,4377],{},[20,4378,4379],{},"\u002Fapi\u002Fcustomer",[70,4381,4382],{},"Cualquier miembro (paginado, filtros)",[52,4384,4385,4390,4394],{},[70,4386,4387],{},[20,4388,4389],{},"POST",[70,4391,4392],{},[20,4393,4379],{},[70,4395,4396],{},"owner \u002F org_admin (crea + invita)",[52,4398,4399,4403,4408],{},[70,4400,4401],{},[20,4402,4374],{},[70,4404,4405],{},[20,4406,4407],{},"\u002Fapi\u002Fcustomer\u002F[id]",[70,4409,4410],{},"Cualquier miembro",[52,4412,4413,4421,4425],{},[70,4414,4415,844,4418],{},[20,4416,4417],{},"PATCH",[20,4419,4420],{},"DELETE",[70,4422,4423],{},[20,4424,4407],{},[70,4426,4427],{},"owner \u002F org_admin",[52,4429,4430,4434,4439],{},[70,4431,4432],{},[20,4433,4389],{},[70,4435,4436],{},[20,4437,4438],{},"\u002Fapi\u002Fcustomer\u002F[id]\u002Fassign",[70,4440,4427],{},[52,4442,4443,4448,4453],{},[70,4444,4445],{},[20,4446,4447],{},"PUT",[70,4449,4450],{},[20,4451,4452],{},"\u002Fapi\u002Fcustomer\u002F[id]\u002Fcategories",[70,4454,4455],{},"owner \u002F org_admin (selección completa)",[52,4457,4458,4462,4467],{},[70,4459,4460],{},[20,4461,4374],{},[70,4463,4464],{},[20,4465,4466],{},"\u002Fapi\u002Fcustomer-categories",[70,4468,4469],{},"Cualquier miembro (con contadores)",[52,4471,4472,4476,4480],{},[70,4473,4474],{},[20,4475,4389],{},[70,4477,4478],{},[20,4479,4466],{},[70,4481,4427],{},[52,4483,4484,4490,4495],{},[70,4485,4486,844,4488],{},[20,4487,4417],{},[20,4489,4420],{},[70,4491,4492],{},[20,4493,4494],{},"\u002Fapi\u002Fcustomer-categories\u002F[id]",[70,4496,4427],{},[52,4498,4499,4503,4508],{},[70,4500,4501],{},[20,4502,4374],{},[70,4504,4505],{},[20,4506,4507],{},"\u002Fapi\u002Fcustomer\u002F[id]\u002Fusers",[70,4509,4510,4511,4514],{},"Miembros ",[15,4512,4513],{},"y"," el manager del customer",[52,4516,4517,4521,4526],{},[70,4518,4519],{},[20,4520,4389],{},[70,4522,4523],{},[20,4524,4525],{},"\u002Fapi\u002Fcustomer\u002F[id]\u002Fusers\u002Finvitations",[70,4527,4528,4529,4532],{},"owner \u002F org_admin ",[15,4530,4531],{},"o"," su manager",[52,4534,4535,4541,4546],{},[70,4536,4537,844,4539],{},[20,4538,4389],{},[20,4540,4420],{},[70,4542,4543],{},[20,4544,4545],{},"\u002Fapi\u002Fcustomer\u002F[id]\u002Fusers\u002Finvitations\u002F[invitationId]…",[70,4547,4548],{},"igual que la anterior",[52,4550,4551,4557,4562],{},[70,4552,4553,844,4555],{},[20,4554,4417],{},[20,4556,4420],{},[70,4558,4559],{},[20,4560,4561],{},"\u002Fapi\u002Fcustomer\u002F[id]\u002Fusers\u002F[customerUserId]",[70,4563,4548],{},[52,4565,4566,4570,4575],{},[70,4567,4568],{},[20,4569,4374],{},[70,4571,4572],{},[20,4573,4574],{},"\u002Fapi\u002Fportal\u002Fcustomer",[70,4576,4577],{},"El propio usuario del portal",[52,4579,4580,4584,4589],{},[70,4581,4582],{},[20,4583,4374],{},[70,4585,4586],{},[20,4587,4588],{},"\u002Fapi\u002Fportal\u002Finvitations",[70,4590,4591],{},"Cualquier cuenta con sesión (por email)",[52,4593,4594,4598,4606],{},[70,4595,4596],{},[20,4597,4389],{},[70,4599,4600,354,4603],{},[20,4601,4602],{},"\u002Fapi\u002Fportal\u002Finvitations\u002F[id]\u002Faccept",[20,4604,4605],{},"…\u002Freject",[70,4607,4608],{},"El destinatario de la invitación",[11,4610,4611,4612,1533,4615,290,4618,290,4621,290,4624,290,4626,290,4629,290,4632,27],{},"Los rechazos viajan como códigos en ",[20,4613,4614],{},"error.data.code",[20,4616,4617],{},"already_invited",[20,4619,4620],{},"already_user",[20,4622,4623],{},"last_manager",[20,4625,3936],{},[20,4627,4628],{},"invitation_not_found",[20,4630,4631],{},"invitation_expired",[20,4633,4634],{},"invitation_wrong_recipient",[255,4636,4638],{"id":4637},"invariantes-aplicadas-en-servidor","Invariantes (aplicadas en servidor)",[1090,4640,4641,4657,4665,4674,4680,4686,4692,4700,4719],{},[896,4642,4643,4646,4647,4649,4650,290,4653,4656],{},[15,4644,4645],{},"Sin membership",": nunca añadas usuarios de portal a ",[20,4648,3839],{},". Su superficie es ",[20,4651,4652],{},"\u002Fportal\u002F**",[20,4654,4655],{},"\u002Fapi\u002Fuser\u002F**"," y las rutas compartidas de usuarios del cliente.",[896,4658,4659,1533,4662,4664],{},[15,4660,4661],{},"La fila primero, el email después",[20,4663,4098],{}," es un aviso, no un error; nunca una invitación perdida.",[896,4666,4667,4670,4671,4673],{},[15,4668,4669],{},"Crear un cliente crea su primer manager",": una invitación ",[20,4672,3852],{}," sale con la creación; un fallo no revierte el cliente.",[896,4675,4676,4679],{},[15,4677,4678],{},"Una pendiente por (cliente, email)","; reenviar reutiliza la fila y conserva el rol.",[896,4681,4682,4685],{},[15,4683,4684],{},"Última manager",": se protege cuando actúa el propio cliente; el staff de la organización puede desvincular o degradar.",[896,4687,4688,4691],{},[15,4689,4690],{},"Borrado bloqueado"," con usuarios aceptados (409); las invitaciones pendientes caen con el cliente.",[896,4693,4694,1533,4697,4699],{},[15,4695,4696],{},"Asignación = full-state sync",[20,4698,4060],{}," recibe la selección completa; ids ajenos a la organización (o borrados entre la carga y el guardado) se descartan en vez de fallar.",[896,4701,4702,1533,4708,4711,4712,4715,4716,4718],{},[15,4703,4704,4705],{},"Filtro por categoría con ",[20,4706,4707],{},"EXISTS",[20,4709,4710],{},"categoryId"," no es una columna de ",[20,4713,4714],{},"customer","; el listado lo resuelve con ",[20,4717,4707],{}," sobre el vínculo para devolver cada fila una sola vez.",[896,4720,4721,4724,4725,4727],{},[15,4722,4723],{},"Borrar categoría nunca bloquea",": el vínculo cae en cascada; no hay ",[20,4726,3932],{}," por uso.",[255,4729,4731],{"id":4730},"emails-y-eventos","Emails y eventos",[893,4733,4734,4749,4770,4796,4837],{},[896,4735,4736,4737,811,4739,4741,4742,4745,4746,1158],{},"Claves nuevas en la capa MJML: ",[20,4738,4113],{},[20,4740,4109],{},". Se pueden revisar en ",[20,4743,4744],{},"\u002Fapi\u002Fadmin\u002Femails\u002Fpreview"," (con ",[20,4747,4748],{},"?key=…&locale=es",[896,4750,4751,4752,290,4755,290,4758,290,4761,290,4764,290,4767,27],{},"Triggers para workflows: ",[20,4753,4754],{},"customer.user_invited",[20,4756,4757],{},"customer.user_joined",[20,4759,4760],{},"customer.user_removed",[20,4762,4763],{},"customer.user_role_changed",[20,4765,4766],{},"customer.invitation_cancelled",[20,4768,4769],{},"customer.invitation_rejected",[896,4771,4772,4773,290,4776,290,4779,4782,4783,290,4786,844,4789,4792,4793,1158],{},"Triggers de categorías: ",[20,4774,4775],{},"customer_category.created",[20,4777,4778],{},".updated",[20,4780,4781],{},".deleted"," y, ",[15,4784,4785],{},"uno por transición",[20,4787,4788],{},"customer.category_assigned",[20,4790,4791],{},"customer.category_unassigned"," (filtrables por ",[20,4794,4795],{},"$json.categoryName",[896,4797,4798,4799,1533,4802,290,4805,290,4808,290,4811,290,4814,290,4817,290,4819,290,4821,4824,4825,1533,4828,290,4831,290,4834,27],{},"Auditoría con ",[20,4800,4801],{},"category: 'customer'",[20,4803,4804],{},"user_invited",[20,4806,4807],{},"user_joined",[20,4809,4810],{},"user_removed",[20,4812,4813],{},"user_role_changed",[20,4815,4816],{},"invitation_resent",[20,4818,4144],{},[20,4820,4141],{},[20,4822,4823],{},"categories_updated","; y con ",[20,4826,4827],{},"category: 'customer_category'",[20,4829,4830],{},"created",[20,4832,4833],{},"updated",[20,4835,4836],{},"deleted",[896,4838,4839,4840,290,4843,290,4846,290,4849,4852,4853,4856],{},"El contexto de sesión expone ",[20,4841,4842],{},"customerId",[20,4844,4845],{},"customerRole",[20,4847,4848],{},"customerName",[20,4850,4851],{},"customerOrganizationName"," (los mezcla el plugin ",[20,4854,4855],{},"customSession"," junto al de organización).",[41,4858,4860],{"id":4859},"pruebas","Pruebas",[132,4862,4864],{"className":134,"code":4863,"language":136,"meta":137,"style":137},"# Los tres recorridos de la feature\npnpm exec playwright test tests\u002Fe2e\u002Fapp\u002Fcustomers.spec.ts tests\u002Fe2e\u002Fapp\u002Fcustomer-portal.spec.ts tests\u002Fe2e\u002Fapp\u002Fcustomer-categories.spec.ts\n",[20,4865,4866,4871],{"__ignoreMap":137},[141,4867,4868],{"class":143,"line":144},[141,4869,4870],{"class":777},"# Los tres recorridos de la feature\n",[141,4872,4873,4875,4877,4879,4881,4884,4887],{"class":143,"line":177},[141,4874,17],{"class":147},[141,4876,1268],{"class":150},[141,4878,1271],{"class":150},[141,4880,1274],{"class":150},[141,4882,4883],{"class":150}," tests\u002Fe2e\u002Fapp\u002Fcustomers.spec.ts",[141,4885,4886],{"class":150}," tests\u002Fe2e\u002Fapp\u002Fcustomer-portal.spec.ts",[141,4888,4889],{"class":150}," tests\u002Fe2e\u002Fapp\u002Fcustomer-categories.spec.ts\n",[46,4891,4892,4902],{},[49,4893,4894],{},[52,4895,4896,4899],{},[55,4897,4898],{},"Spec",[55,4900,4901],{},"Qué cubre",[65,4903,4904,4914,4927],{},[52,4905,4906,4911],{},[70,4907,4908],{},[20,4909,4910],{},"customers.spec.ts",[70,4912,4913],{},"Alta con invitación automática, acciones de invitación, edición de estado y borrado desde la UI",[52,4915,4916,4921],{},[70,4917,4918],{},[20,4919,4920],{},"customer-portal.spec.ts",[70,4922,4923,4924],{},"Invitación → magic link → aceptación → portal → guardas de rol → regla de borrado. El token del magic link se lee de la tabla ",[20,4925,4926],{},"verification",[52,4928,4929,4934],{},[70,4930,4931],{},[20,4932,4933],{},"customer-categories.spec.ts",[70,4935,4936],{},"Categoría creada desde el slideover, asignada desde el detalle, badge y filtro en el índice, renombrado y borrado en cascada — con la API como fuente de verdad",[29,4938,4939],{},[11,4940,4941,4942,4944,4945,4948,4949,27],{},"El recorrido del portal necesita acceso a la base de datos (",[20,4943,281],{},"): sin ella el spec se ",[15,4946,4947],{},"salta"," (por ejemplo en CI contra un entorno remoto). El helper vive en ",[20,4950,4951],{},"tests\u002Fe2e\u002Futils\u002Fdb.ts",[255,4953,4955],{"id":4954},"probarlo-a-mano","Probarlo a mano",[1090,4957,4958,4964,4967,4976,4991],{},[896,4959,4960,4961,4963],{},"Crea un customer en ",[20,4962,3887],{}," con un email al que puedas acceder.",[896,4965,4966],{},"Abre la invitación desde ese correo (o lee el token del magic link como hace el spec) y acéptala.",[896,4968,4969,4970,700,4973,4975],{},"Dentro del portal, entra a ",[15,4971,4972],{},"Account",[15,4974,3922],{}," — verás la cabecera del portal, sin nada del panel de staff.",[896,4977,4978,4979,4981,4982,4984,4985,4987,4988,4990],{},"Como ",[20,4980,3852],{},", invita a una segunda persona desde ",[20,4983,4186],{}," y repite la aceptación para comprobar que un ",[20,4986,3869],{}," no ve ",[3203,4989,3922],{}," ni puede abrir la ruta.",[896,4992,4993,4994,1135,4996,4998],{},"De vuelta en el staff: abre ",[15,4995,4039],{},[20,4997,3887],{},", crea una, asígnala desde el detalle de un cliente y filtra la lista por ella.",[747,5000,5001],{},[11,5002,5003,5004,5007,5008,5010,5011,27],{},"Con una API key real de Resend en modo de pruebas, los envíos a direcciones que no sean la de la cuenta se rechazan con 4xx: la invitación queda pendiente y ",[20,5005,5006],{},"emailSent"," es ",[20,5009,2561],{}," (el comportamiento correcto). En ese entorno, permite experimentar con tu propio email o usa el token de ",[20,5012,4926],{},[41,5014,5016],{"id":5015},"mapa-de-archivos","Mapa de archivos",[46,5018,5019,5028],{},[49,5020,5021],{},[52,5022,5023,5025],{},[55,5024,1936],{},[55,5026,5027],{},"Dónde",[65,5029,5030,5043,5059,5072,5082,5092,5106,5122],{},[52,5031,5032,5035],{},[70,5033,5034],{},"Esquema",[70,5036,5037,290,5040],{},[20,5038,5039],{},"server\u002Fdatabase\u002Fschema\u002FcustomerUser.ts",[20,5041,5042],{},"server\u002Fdatabase\u002Fschema\u002FcustomerCategory.ts",[52,5044,5045,5048],{},[70,5046,5047],{},"Reglas e invitaciones",[70,5049,5050,290,5053,290,5056],{},[20,5051,5052],{},"server\u002Futils\u002Fcustomer-users.ts",[20,5054,5055],{},"server\u002Futils\u002Fcustomer-portal.ts",[20,5057,5058],{},"server\u002Futils\u002Fcustomer-categories.ts",[52,5060,5061,5064],{},[70,5062,5063],{},"API staff y compartida",[70,5065,5066,290,5069],{},[20,5067,5068],{},"server\u002Fapi\u002Fcustomer\u002F**",[20,5070,5071],{},"server\u002Fapi\u002Fcustomer-categories\u002F**",[52,5073,5074,5077],{},[70,5075,5076],{},"API del portal",[70,5078,5079],{},[20,5080,5081],{},"server\u002Fapi\u002Fportal\u002F**",[52,5083,5084,5087],{},[70,5085,5086],{},"Emails",[70,5088,5089],{},[20,5090,5091],{},"server\u002Femails\u002Ftemplates\u002Fcustomer-invitation{,-signin}.ts",[52,5093,5094,5097],{},[70,5095,5096],{},"UI de staff",[70,5098,5099,290,5102,5105],{},[20,5100,5101],{},"app\u002Fpages\u002Fapp\u002Fcustomers\u002F**",[20,5103,5104],{},"app\u002Fcomponents\u002Fcustomers\u002F**"," (slideover de categorías, selector y swatches)",[52,5107,5108,5111],{},[70,5109,5110],{},"UI del portal",[70,5112,5113,290,5116,290,5119],{},[20,5114,5115],{},"app\u002Flayouts\u002Fportal.vue",[20,5117,5118],{},"app\u002Fpages\u002Fportal\u002F**",[20,5120,5121],{},"app\u002Fpages\u002Fauth\u002Fcustomer-invitation\u002Findex.vue",[52,5123,5124,5127],{},[70,5125,5126],{},"Middleware",[70,5128,5129],{},[20,5130,5131],{},"app\u002Fmiddleware\u002Fauth.global.ts",[922,5133,5134],{},"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 .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":137,"searchDepth":177,"depth":177,"links":5136},[5137,5138,5139,5140,5146,5148,5154,5157],{"id":3800,"depth":177,"text":3801},{"id":3878,"depth":177,"text":3879},{"id":3952,"depth":177,"text":3953},{"id":4064,"depth":177,"text":4065,"children":5141},[5142,5143,5144,5145],{"id":4071,"depth":183,"text":4072},{"id":4085,"depth":183,"text":4086},{"id":4102,"depth":183,"text":4103},{"id":4117,"depth":183,"text":4118},{"id":4147,"depth":177,"text":5147},"El portal (\u002Fportal)",{"id":4253,"depth":177,"text":4254,"children":5149},[5150,5151,5152,5153],{"id":4257,"depth":183,"text":4258},{"id":4350,"depth":183,"text":4351},{"id":4637,"depth":183,"text":4638},{"id":4730,"depth":183,"text":4731},{"id":4859,"depth":177,"text":4860,"children":5155},[5156],{"id":4954,"depth":183,"text":4955},{"id":5015,"depth":177,"text":5016},"[object Object]",{},"\u002Fdocs\u002Fcustomers",{"title":3774,"description":5162},{"Clientes con categorías propias de la organización y usuarios de portal":5163,"navigation":5164},"roles, invitaciones, API, eventos de dominio y pruebas end-to-end.",{"icon":5165},"i-lucide-users","docs\u002F5.customers","Sl5R9bgEMfUd9IU_Kpzu7-_EV179H4Fmw_7OGeYatfA",[5169],{"title":5170,"path":3447,"stem":1669,"children":5171,"page":5177},"Docs",[5172,5173,5174,5175,5176],{"title":6,"path":942,"stem":944,"icon":941},{"title":901,"path":900,"stem":1885,"icon":1883},{"title":908,"path":907,"stem":2968,"icon":2966},{"title":919,"path":918,"stem":3770,"icon":3768},{"title":3774,"path":5160,"stem":5166},false,1790184042651]