# Encuesta de Validación ERP-BUILD

Sistema de encuestas web para validar las funcionalidades propuestas del ERP de construcción con empresas del sector.

## Requisitos

- PHP 8.2+
- Composer
- Node.js 18+
- SQLite (por defecto) o MySQL/PostgreSQL

## Instalación

```bash
# Clonar o copiar el proyecto
cd survey-erp-build

# Instalar dependencias PHP
composer install

# Instalar dependencias Node
npm install

# Copiar archivo de configuración
cp .env.example .env

# Generar clave de aplicación
php artisan key:generate

# Ejecutar migraciones
php artisan migrate

# Cargar datos iniciales (admin, módulos, códigos de demo)
php artisan db:seed

# Compilar assets
npm run build
```

## Ejecución Local

```bash
# Iniciar servidor de desarrollo
php artisan serve

# En otra terminal (para desarrollo con hot-reload)
npm run dev
```

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

## Credenciales

### Admin
- **URL**: http://localhost:8000/login
- **Email**: admin@erp-build.com
- **Password**: Admin2026!

### Códigos de Acceso de Prueba
- **DEMO2026** - Código ilimitado para pruebas
- **CONSTRUCT** - Código con límite de 100 usos

## Estructura del Proyecto

```
survey-erp-build/
├── app/
│   ├── Http/Controllers/
│   │   ├── Admin/           # Panel administrativo
│   │   └── Survey/          # Encuesta pública
│   ├── Models/              # Modelos Eloquent
│   └── Exports/             # Exportaciones Excel
├── database/
│   ├── migrations/          # Estructura de BD
│   └── seeders/             # Datos iniciales
├── resources/views/
│   ├── admin/               # Vistas del admin
│   ├── survey/              # Vistas de la encuesta
│   └── layouts/             # Layouts base
└── routes/web.php           # Rutas
```

## Funcionalidades

### Encuesta Pública (`/survey`)
1. Acceso con código
2. Datos de la empresa
3. Calificación de 16 módulos del ERP
4. Preguntas adicionales
5. Página de agradecimiento

### Panel Admin (`/admin`)
- **Dashboard**: Métricas y gráficas
- **Respuestas**: Ver y filtrar respuestas
- **Códigos**: Crear y gestionar códigos de acceso
- **Exportar**: Excel, CSV y PDF

## Módulos Evaluados (16)

1. Gestión de Proyectos y Obras
2. Presupuestos
3. Estimaciones y Generadores
4. Control de Costos
5. Subcontratistas y Destajistas
6. Inventario y Almacenes de Obra
7. Maquinaria y Equipo
8. Recursos Humanos de Obra
9. Seguridad y Salud en el Trabajo
10. Control de Calidad
11. Licitaciones y Concursos
12. Contratos de Obra
13. Contabilidad y Finanzas
14. Documentación y Expediente
15. Reportes y Analíticas
16. Aplicación Móvil

## Despliegue en Producción

### Opción 1: Hosting Compartido (cPanel)
1. Subir archivos por FTP
2. Configurar `.env` con datos de producción
3. Ejecutar migraciones vía SSH o terminal

### Opción 2: VPS (DigitalOcean, etc.)
```bash
# En el servidor
git clone <repo> /var/www/survey-erp-build
cd /var/www/survey-erp-build
composer install --optimize-autoloader --no-dev
npm install && npm run build
php artisan migrate --force
php artisan db:seed --force
php artisan config:cache
php artisan route:cache
php artisan view:cache
```

### Variables de Entorno Importantes
```env
APP_ENV=production
APP_DEBUG=false
APP_URL=https://tu-dominio.com

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_DATABASE=survey_erp
DB_USERNAME=tu_usuario
DB_PASSWORD=tu_password
```

## Soporte

Para soporte técnico o preguntas, contactar al equipo de desarrollo.

---

*ERP-BUILD - Sistema ERP para la Industria de la Construcción*