Vivanda

Campo	Valor
Cliente	Supermercados Peruanos
Activos	Vivanda Web, Vivanda Admin, API Vivanda
Estado documental	Consolidado desde documentos Confluence exportados
Hosting	Pendiente de confirmar
Dominio	Pendiente de confirmar

Componentes

Componente	Tecnología documentada
Vivanda Web	Next.js 13, Node.js 18.20.2, Nginx
Vivanda Admin	Next.js 13, Node.js 18.20.2, NextAuth, reCAPTCHA, Nginx
API Vivanda	Laravel 10, PHP 8.2.16, PostgreSQL 14, Nginx

Variables principales

Vivanda Web

NEXT_PUBLIC_API_URL
NEXT_PUBLIC_URL

Vivanda Admin

NEXT_PUBLIC_API_URL
NEXTAUTH_URL
NEXTAUTH_SECRET
NEXT_PUBLIC_RECAPTCHA_SITE_KEY
NEXT_PUBLIC_API_UBIGEO_DEPARTMENT
NEXT_PUBLIC_API_UBIGEO_PROVINCE

Secretos

No versionar valores reales de NEXTAUTH_SECRET, claves reCAPTCHA ni credenciales. Mantener solo el nombre de la variable.

API Vivanda

DB_CONNECTION=pgsql
DB_HOST
DB_PORT
DB_DATABASE
DB_USERNAME
DB_PASSWORD
MAIL_DRIVER=smtp
MAIL_HOST
MAIL_PORT
MAIL_USERNAME
MAIL_PASSWORD
MAIL_FROM_ADDRESS

Despliegue Web / Admin

Pasos base:

npm install
npm run build

Se documenta Nginx como proxy inverso hacia las aplicaciones Next.js. La configuración debe ajustar dominio y puerto de ejecución según ambiente.

Despliegue API

La API se documenta como Laravel con PostgreSQL y configuración .env. Para actualizaciones se registran comandos de limpieza de caché:

php artisan cache:clear
php artisan route:clear
php artisan config:clear

Validación post-publicación

Prueba	Resultado esperado
Web carga por dominio	OK
Admin carga por dominio	OK
API responde	OK
HTTPS activo	OK
Variables configuradas	OK
Nginx sin errores	OK
Logs sin errores críticos	OK

Pendientes

• Confirmar dominio público vigente.
• Confirmar servidor y ruta de publicación.
• Confirmar método actual de ejecución de Next.js.
• Confirmar si API usa colas, storage o tareas programadas.
• Confirmar política de backups de PostgreSQL.