🛠️ Armados 2Go

Sistema integral de gestión de armado de muebles para empresas retail.

📋 Índice

• Instalación
• Variables de Entorno
• Scripts Disponibles
• Estructura del Proyecto
• Roles y Permisos
• Documentación Adicional

---

🚀 Instalación

Requisitos Previos

• Node.js 18+
• PostgreSQL 14+
• npm o yarn

Setup Inicial

# 1. Clonar repositorio
git clone https://github.com/tu-org/armados2go.git
cd armados2go

# 2. Instalar dependencias
npm install

# 3. Configurar variables de entorno
cp .env.example .env
# Editar .env con tus valores

# 4. Generar cliente Prisma
npx prisma generate

# 5. Ejecutar migraciones
npx prisma db push

# 6. Crear usuario admin inicial
npx ts-node scripts/create-superadmin.ts

# 7. Iniciar servidor de desarrollo
npm run dev

La aplicación estará disponible en http://localhost:3000

---

🔐 Variables de Entorno

Crea un archivo .env basado en .env.example:

# Base de datos
DATABASE_URL="postgresql://user:password@localhost:5432/armados2go"

# Autenticación (OBLIGATORIO en producción)
JWT_SECRET="tu-secreto-de-32-caracteres-minimo"

# Rate Limiting (Upstash Redis - opcional)
UPSTASH_REDIS_REST_URL="https://tu-redis.upstash.io"
UPSTASH_REDIS_REST_TOKEN="tu-token"

# Cloudinary (para imágenes)
CLOUDINARY_CLOUD_NAME="tu-cloud"
CLOUDINARY_API_KEY="tu-api-key"
CLOUDINARY_API_SECRET="tu-api-secret"

# Mapbox (para mapas)
NEXT_PUBLIC_MAPBOX_TOKEN="pk.tu-token-mapbox"

# Email (Resend)
RESEND_API_KEY="re_tu-api-key"

# Entorno
NODE_ENV="development"

---

📜 Scripts Disponibles

Script	Descripción
npm run dev	Inicia servidor de desarrollo
npm run build	Compila para producción
npm run start	Inicia servidor de producción
npm run lint	Ejecuta ESLint
npx prisma studio	Abre Prisma Studio (GUI de BD)
npx prisma db push	Sincroniza schema con BD
npx ts-node scripts/create-superadmin.ts	Crea usuario admin
npx ts-node scripts/audit-endpoints.ts	Audita seguridad de endpoints

---

📁 Estructura del Proyecto

armados2go/
├── app/                    # Next.js App Router
│   ├── admin/              # Páginas de administración
│   ├── armador/            # Páginas para armadores
│   ├── supervisor/         # Páginas para supervisores
│   ├── api/                # API Routes
│   └── login/              # Autenticación
├── components/             # Componentes React
│   ├── ui/                 # Componentes base (shadcn/ui)
│   └── ...                 # Componentes de negocio
├── lib/                    # Utilidades y servicios
│   ├── schemas/            # Schemas Zod
│   ├── services/           # Capa de servicios
│   └── ...                 # Helpers
├── prisma/                 # Schema de base de datos
├── docs/                   # Documentación
└── scripts/                # Scripts de utilidad

---

👥 Roles y Permisos

Rol	Descripción	Acceso
ADMIN	Control total del sistema	/admin/*
SUPERVISOR	Gestión de órdenes de sus proyectos	/supervisor/*, /admin/ordenes/*
ARMADOR	Ejecución de órdenes en campo	/armador/*

Credenciales por Defecto (desarrollo)

Admin: [email protected] / Admin123!

---

📚 Documentación Adicional

• Arquitectura Completa
• Seguridad
• API Reference
• Deployment
• Facturación

---

🔒 Seguridad

Este proyecto implementa:

• ✅ Autenticación JWT con cookies HttpOnly
• ✅ Rate limiting con Redis/in-memory
• ✅ Validación Zod en todos los endpoints
• ✅ Sanitización de inputs (DOMPurify)
• ✅ Sistema de auditoría completo
• ✅ Security headers (CSP, HSTS, etc.)
• ✅ HTTPS enforcement en producción

Ver SECURITY.md para más detalles.

---

📄 Licencia

Privado - Todos los derechos reservados