Preparación para producción

This commit is contained in:
remaster 2026-06-15 11:15:16 -06:00
parent c94c8f8b69
commit 0ede185f90
26 changed files with 6109 additions and 5627 deletions

11
.gitignore vendored
View file

@ -1,7 +1,10 @@
# Códigos QR generados (regenerables con generate_qrs.py) # Códigos QR generados (regenerables)
output/ output/
# Cache CSV generado desde MariaDB (no versionar)
# Sistema / temporales qr_data.csv
# Configuración por entorno (no versionar credenciales)
config/config.local.php
config/config.production.php
# Sistema
.DS_Store .DS_Store
*.xlsx *.xlsx
qr_data.csv

26
.htaccess Normal file
View file

@ -0,0 +1,26 @@
RewriteEngine On
RewriteBase /camp/mtto_record/
# Bloquear acceso directo a carpetas internas
RewriteRule ^config/ - [F,L]
RewriteRule ^sql/ - [F,L]
RewriteRule ^includes/ - [F,L]
# Bloquear archivos sensibles en la raíz web
<FilesMatch "^(install\.php|generate_qrs\.py|backup_produccion\.sql|\.gitignore|\.env)$">
Require all denied
</FilesMatch>
<FilesMatch "\.(sql|py|csv|example\.php|local\.php|production\.php)$">
Require all denied
</FilesMatch>
# Evitar listado de directorios
Options -Indexes
# Cabeceras básicas de seguridad
<IfModule mod_headers.c>
Header set X-Content-Type-Options "nosniff"
Header set X-Frame-Options "SAMEORIGIN"
Header set Referrer-Policy "strict-origin-when-cross-origin"
</IfModule>

View file

@ -1,109 +0,0 @@
modulo,ubicacion
PLP,T-72-11
PLP,T-72-12
PLP,T-73-11
PLP,T-73-12
PLP,T-74-11
PLP,T-74-12
PLP,T-75-11
PLP,T-75-12
PLP,T-76-11
PLP,T-76-12
PLP,T-77-11
PLP,T-77-12
PLP,T-78-11
PLP,T-78-12
PLP,T-79-11
PLP,T-79-12
PLP,T-80-11
PLP,T-80-12
PLP,T-81-11
PLP,T-81-12
PLP,T-82-11
PLP,T-82-12
PLP,T-83-11
PLP,T-83-12
PLP,T-84-11
PLP,T-84-12
PLP,T-85-11
PLP,T-85-12
PLP,T-86-11
PLP,T-86-12
PLP,T-87-11
PLP,T-87-12
PLP,T-88-11
PLP,T-88-12
PLP,T-89-11
PLP,T-89-12
PLP,T-90-11
PLP,T-90-12
PLP,T-91-11
PLP,T-91-12
PLP,T-92-11
PLP,T-92-12
PLP,T-93-11
PLP,T-93-12
PLP,T-94-11
PLP,T-94-12
PLP,T-95-11
PLP,T-95-12
PLP,T-96-11
PLP,T-96-12
PLP,T-97-11
PLP,T-97-12
PLP,T-98-11
PLP,T-98-12
PLP,T-99-11
PLP,T-99-12
PLP,T-100-11
PLP,T-100-12
PLP,T-101-11
PLP,T-101-12
PLP,T-102-11
PLP,T-102-12
PLP,T-103-11
PLP,T-103-12
PLP,T-104-11
PLP,T-104-12
PALAPA,CAMINO ROJO
PALAPA,SALTILLITO
PALAPA,SANTA FE
PALAPA,CHILE COLORADO
PALAPA,NOCHE BUENA
PALAPA,PEÑASQUITO
PALAPA,SALA DIVERSIDAD
CANCHA,CAMPO FUT BOOL
BAÑO PÚBLICO,BAÑO PÚBLICO #1
BAÑO PÚBLICO,BAÑO PÚBLICO #2
BAÑO PÚBLICO,BAÑO PÚBLICO #3
BAÑO PÚBLICO,BAÑO PÚBLICO #4
BAÑO PÚBLICO,BAÑO PÚBLICO #5
CAMPAMENTO,SALA DE LACTANCIA
EDIF.6A,GYM #1
EDIF.6A,BAÑOS GYM #1
EDIF.6A,GYM #2
EDIF.6A,BAÑOS GYM #2
EDIF.6A,AREA TECHADA
EDIF.6A,LAVANDERIA
EDIF.6A,MANTENIMIENTO CAMPAMENTO
EDIF.6A,OFC. TRANSPORTES
EDIF.6A,MONITOREO TRANSPORTES
EDIF.6A,RECURSOS HUMANOS
EDIF.6A,RH RECEPCIÓN Y PASILLOS
EDIF.6A,RH BAÑOS
EDIF.6A,OXO Y TIENDA
EDIF.6A,OXO CAMARA DE REFRIGERACIÓN
EDIF.6A,BODEGA RH
CAMPAMENTO,CINE
CAMPAMENTO,SUM# 1 SALA USOS MULTUPLES
CAMPAMENTO,SUM# 2 SALA USOS MULTUPLES
CAMPAMENTO,SERVICIO MÉDICO
CAMPAMENTO,SALAS TV MOD. E´S
CAMPAMENTO,CAPILLA
CAMPAMENTO,PLANTA EMBOTELLADORA
CAMPAMENTO,SPORT LOUNCH
CAMPAMENTO,TRAINING CENTER
CAMPAMENTO,COMEDOR
CAMPAMENTO,ALMACÉN ALIMENTOS
CAMPAMENTO,CAJERO # 1
CAMPAMENTO,CAJERO # 2
1 modulo ubicacion
2 PLP T-72-11
3 PLP T-72-12
4 PLP T-73-11
5 PLP T-73-12
6 PLP T-74-11
7 PLP T-74-12
8 PLP T-75-11
9 PLP T-75-12
10 PLP T-76-11
11 PLP T-76-12
12 PLP T-77-11
13 PLP T-77-12
14 PLP T-78-11
15 PLP T-78-12
16 PLP T-79-11
17 PLP T-79-12
18 PLP T-80-11
19 PLP T-80-12
20 PLP T-81-11
21 PLP T-81-12
22 PLP T-82-11
23 PLP T-82-12
24 PLP T-83-11
25 PLP T-83-12
26 PLP T-84-11
27 PLP T-84-12
28 PLP T-85-11
29 PLP T-85-12
30 PLP T-86-11
31 PLP T-86-12
32 PLP T-87-11
33 PLP T-87-12
34 PLP T-88-11
35 PLP T-88-12
36 PLP T-89-11
37 PLP T-89-12
38 PLP T-90-11
39 PLP T-90-12
40 PLP T-91-11
41 PLP T-91-12
42 PLP T-92-11
43 PLP T-92-12
44 PLP T-93-11
45 PLP T-93-12
46 PLP T-94-11
47 PLP T-94-12
48 PLP T-95-11
49 PLP T-95-12
50 PLP T-96-11
51 PLP T-96-12
52 PLP T-97-11
53 PLP T-97-12
54 PLP T-98-11
55 PLP T-98-12
56 PLP T-99-11
57 PLP T-99-12
58 PLP T-100-11
59 PLP T-100-12
60 PLP T-101-11
61 PLP T-101-12
62 PLP T-102-11
63 PLP T-102-12
64 PLP T-103-11
65 PLP T-103-12
66 PLP T-104-11
67 PLP T-104-12
68 PALAPA CAMINO ROJO
69 PALAPA SALTILLITO
70 PALAPA SANTA FE
71 PALAPA CHILE COLORADO
72 PALAPA NOCHE BUENA
73 PALAPA PEÑASQUITO
74 PALAPA SALA DIVERSIDAD
75 CANCHA CAMPO FUT BOOL
76 BAÑO PÚBLICO BAÑO PÚBLICO #1
77 BAÑO PÚBLICO BAÑO PÚBLICO #2
78 BAÑO PÚBLICO BAÑO PÚBLICO #3
79 BAÑO PÚBLICO BAÑO PÚBLICO #4
80 BAÑO PÚBLICO BAÑO PÚBLICO #5
81 CAMPAMENTO SALA DE LACTANCIA
82 EDIF.6A GYM #1
83 EDIF.6A BAÑOS GYM #1
84 EDIF.6A GYM #2
85 EDIF.6A BAÑOS GYM #2
86 EDIF.6A AREA TECHADA
87 EDIF.6A LAVANDERIA
88 EDIF.6A MANTENIMIENTO CAMPAMENTO
89 EDIF.6A OFC. TRANSPORTES
90 EDIF.6A MONITOREO TRANSPORTES
91 EDIF.6A RECURSOS HUMANOS
92 EDIF.6A RH RECEPCIÓN Y PASILLOS
93 EDIF.6A RH BAÑOS
94 EDIF.6A OXO Y TIENDA
95 EDIF.6A OXO CAMARA DE REFRIGERACIÓN
96 EDIF.6A BODEGA RH
97 CAMPAMENTO CINE
98 CAMPAMENTO SUM# 1 SALA USOS MULTUPLES
99 CAMPAMENTO SUM# 2 SALA USOS MULTUPLES
100 CAMPAMENTO SERVICIO MÉDICO
101 CAMPAMENTO SALAS TV MOD. E´S
102 CAMPAMENTO CAPILLA
103 CAMPAMENTO PLANTA EMBOTELLADORA
104 CAMPAMENTO SPORT LOUNCH
105 CAMPAMENTO TRAINING CENTER
106 CAMPAMENTO COMEDOR
107 CAMPAMENTO ALMACÉN ALIMENTOS
108 CAMPAMENTO CAJERO # 1
109 CAMPAMENTO CAJERO # 2

394
README.md
View file

@ -1,9 +1,11 @@
# Sistema de Mantenimiento por QR — Campamento # Sistema de Mantenimiento por QR — Campamento
Sistema web para registrar actividades de mantenimiento en un campamento minero. Reemplaza el flujo anterior basado en **Microsoft Forms** por una aplicación propia en **PHP + MySQL/MariaDB**, con códigos QR físicos en cada ubicación. Sistema web para registrar actividades de mantenimiento en un campamento minero. Reemplaza el flujo anterior basado en **Microsoft Forms** por una aplicación propia en **PHP + MariaDB**, con códigos QR físicos en cada ubicación.
Al escanear un QR, el técnico abre un formulario con **módulo** y **habitación ya prellenados**. Solo debe indicar la **empresa** que realizó el servicio y el **tipo de servicio** correspondiente. Al escanear un QR, el técnico abre un formulario con **módulo** y **habitación ya prellenados**. Solo debe indicar la **empresa** que realizó el servicio y el **tipo de servicio** correspondiente.
**Producción:** `https://penasquitoapps.newmont.com/camp/mtto_record/`
--- ---
## ¿Qué problema resuelve? ## ¿Qué problema resuelve?
@ -11,16 +13,16 @@ Al escanear un QR, el técnico abre un formulario con **módulo** y **habitació
- Evita que el personal escriba manualmente el lugar (errores de captura). - Evita que el personal escriba manualmente el lugar (errores de captura).
- Centraliza todos los registros en una base de datos consultable. - Centraliza todos los registros en una base de datos consultable.
- Permite **renombrar módulos y habitaciones** sin reimprimir QR, gracias a identificadores únicos estables. - Permite **renombrar módulos y habitaciones** sin reimprimir QR, gracias a identificadores únicos estables.
- Genera etiquetas QR con el **mismo estilo visual** de la versión anterior (color azul `#132A7C`, logo `NEM.png`, pie con nombre del lugar). - Genera etiquetas QR con el mismo estilo visual de la versión anterior (color `#132A7C`, logo `NEM.png`, pie con nombre del lugar).
--- ---
## Arquitectura general ## Arquitectura
``` ```
┌─────────────┐ escaneo ┌──────────────────┐ ┌─────────────┐ escaneo ┌──────────────────┐
│ QR físico │ ───────────────► │ formulario.php │ │ QR físico │ ───────────────► │ formulario.php │
│ en campo │ ?u=UB-00001 │ (formulario) │ │ en campo │ ?u=UB-00001 │ (público) │
└─────────────┘ └────────┬─────────┘ └─────────────┘ └────────┬─────────┘
│ POST │ POST
▼ ▼
@ -40,144 +42,235 @@ Al escanear un QR, el técnico abre un formulario con **módulo** y **habitació
## Requisitos ## Requisitos
| Componente | Versión / detalle | | Componente | Detalle |
|------------|-------------------| |------------|---------|
| PHP | 8.0+ (extensiones `pdo_mysql`, `mbstring`) | | PHP | 8.0+ (`pdo_mysql`, `mbstring`) |
| MariaDB / MySQL | localhost | | MariaDB / MySQL | Base `mantenimiento_campamento` |
| Python 3 | Solo para generar QR (`qrcode`, `Pillow`) | | Python 3 | Solo para generar QR (`qrcode`, `Pillow`) |
| Servidor web | Apache, Nginx o `php -S` | | Servidor web | Apache con `.htaccess` (producción) o `php -S` (local) |
--- ---
## Instalación ## Datos actuales
### 1. Base de datos | Concepto | Cantidad |
|----------|----------|
| Módulos / áreas | 25 |
| Ubicaciones | 2 628 |
| Empresas | 4 (SODEXO, REYSAP, MTTO CAMP, SmartService) |
| Servicios | 7 (por empresa) |
Editar credenciales en `config/config.php` si es necesario: Los datos viven en **MariaDB**. Respaldo completo en `sql/backup_produccion.sql`.
```php ---
define('DB_HOST', 'localhost');
define('DB_NAME', 'mantenimiento_campamento'); ## Configuración
define('DB_USER', 'root');
define('DB_PASS', 'R3m4st3r'); Archivo principal: `config/config.php`
define('BASE_URL', 'http://localhost:8080'); // Ajustar a su URL real
| Constante | Producción | Local |
|-----------|------------|-------|
| `BASE_URL` | `https://penasquitoapps.newmont.com/camp/mtto_record` | `http://localhost:8080` |
| `APP_BASE_PATH` | `/camp/mtto_record` | — |
| `APP_ENV` | `production` (automático) | `local` (si existe `config.local.php`) |
### Archivos de entorno
| Archivo | Uso | ¿Versionar? |
|---------|-----|-------------|
| `config/config.php` | Valores por defecto + producción | Sí |
| `config/config.local.php` | Overrides de desarrollo local | **No** (`.gitignore`) |
| `config/config.production.php` | Credenciales BD del servidor Newmont | **No** (`.gitignore`) |
| `config/config.local.example.php` | Plantilla para local | Sí |
| `config/config.production.example.php` | Plantilla para producción | Sí |
---
## Despliegue en producción
### 1. Preparar paquete (en local)
```bash
./scripts/prepare_deploy.sh
``` ```
### 2. Ejecutar instalador Genera:
- `sql/backup_produccion.sql` — respaldo completo de la BD
- `qr_data.csv` — URLs con dominio de producción
Abrir en el navegador o ejecutar por CLI: ### 2. Subir al servidor
``` Copiar el proyecto a la ruta `/camp/mtto_record/` del servidor web.
http://localhost:8080/install.php
**Subir:** código fuente, `NEM.png`, `sql/backup_produccion.sql`, `.htaccess`
**No subir:** `config/config.local.php`, `.git/`, `.DS_Store`
**Crear en el servidor:**
```bash
cp config/config.production.example.php config/config.production.php
# Editar credenciales MariaDB del entorno Newmont
``` ```
El instalador: ### 3. Importar base de datos
- Crea la base de datos y tablas. ```bash
- **2 518 ubicaciones** desde `data.csv` (archivo original del proyecto). # Si la BD no existe:
- Ubicaciones adicionales con `php import_faltantes.php` desde `Faltantes.csv`. mysql -u USUARIO -p < sql/schema.sql
- Asigna códigos únicos a cada módulo (`MOD-001`…) y ubicación (`UB-00001`…).
- Carga catálogos de **empresas** y **servicios**.
- Crea el usuario administrador inicial.
- Genera `qr_data.csv` para el script de QR.
### 3. Dependencias Python (QR) # Datos completos:
mysql -u USUARIO -p mantenimiento_campamento < sql/backup_produccion.sql
```
### 4. Permisos
```bash
mkdir -p output
chmod 755 output/
# El usuario del servidor web debe poder escribir en output/ y crear qr_data.csv
```
### 5. Verificar
| URL | Esperado |
|-----|----------|
| `/camp/mtto_record/admin/login.php` | Pantalla de login |
| `/camp/mtto_record/formulario.php?u=UB-00001` | Formulario público |
| `/camp/mtto_record/install.php` | **403** (bloqueado en producción) |
### 6. Post-despliegue
1. Iniciar sesión (`admin` / `admin123`) y **cambiar la contraseña** en Usuarios.
2. **Admin → Códigos QR → Generar todos** (PNG con URL de producción).
3. Probar escaneo de un QR real.
---
## Desarrollo local
### 1. Configuración
```bash
cp config/config.local.example.php config/config.local.php
```
Esto activa `APP_ENV=local` y `BASE_URL=http://localhost:8080`.
### 2. Base de datos
Importar el respaldo o usar el instalador:
```bash
mysql -u root -p mantenimiento_campamento < sql/backup_produccion.sql
```
O abrir `http://localhost:8080/install.php` (solo funciona con `APP_ENV=local`).
### 3. Servidor de desarrollo
```bash
cd /ruta/al/proyecto
php -S localhost:8080 -t .
```
> El servidor debe estar **corriendo** mientras se prueba. Si Safari muestra *"Can't connect to the server"*, ejecute el comando anterior.
### 4. Dependencias Python (QR)
```bash ```bash
pip3 install 'qrcode[pil]' pillow pip3 install 'qrcode[pil]' pillow
``` ```
### 4. Iniciar servidor (desarrollo)
```bash
php -S localhost:8080 -t .
```
--- ---
## Acceso al sistema ## Acceso al sistema
| Rol | URL | Credenciales iniciales | | Rol | URL producción | Credenciales iniciales |
|-----|-----|------------------------| |-----|----------------|------------------------|
| **Administración** | `/admin/login.php` | Usuario: `admin` / Contraseña: `admin123` | | **Administración** | `/camp/mtto_record/admin/login.php` | `admin` / `admin123` |
| **Formulario (QR)** | `/formulario.php?u=UB-00001` | Sin login (público) | | **Formulario (QR)** | `/camp/mtto_record/formulario.php?u=UB-00001` | Sin login |
> Cambie la contraseña de `admin` en **Admin → Usuarios** después del primer acceso. ---
## Panel de administración
Ruta: `/admin/` (requiere login)
| Sección | Función |
|---------|---------|
| **Panel** | Estadísticas, registros recientes, accesos rápidos |
| **Registros** | Consulta y filtrado por módulo, empresa, fechas |
| **Módulos** | Crear, editar nombres, activar/desactivar |
| **Ubicaciones** | Crear (una o varias), editar, filtrar, **eliminar** |
| **Empresas** | Gestionar contratistas, **eliminar** |
| **Servicios** | Servicios por empresa, **eliminar** |
| **Códigos QR** | Listado, vista previa, descarga individual, ZIP masivo, generación |
| **Usuarios** | Crear, editar, desactivar, **eliminar** |
### Confirmación antes de eliminar
Toda acción destructiva (eliminar registros de catálogo, generar QR masivo) muestra un **modal de confirmación** bilingüe (ES/EN) antes de ejecutarse.
### Reglas de eliminación
- **Ubicaciones, empresas y servicios** con registros de mantenimiento asociados **no se pueden eliminar** (usar desactivar).
- Al eliminar una ubicación se borra también su PNG en `output/` y se actualiza `qr_data.csv`.
- Al eliminar una empresa se eliminan también sus servicios (CASCADE).
--- ---
## Flujo del técnico en campo ## Flujo del técnico en campo
1. Escanea el QR pegado en la ubicación. 1. Escanea el QR pegado en la ubicación.
2. Se abre el formulario con datos automáticos: 2. Se abre el formulario con **módulo** y **habitación** prellenados.
- **Módulo** (ej. PLP) 3. Selecciona **Empresa** → aparecen los **servicios** de esa empresa.
- **Habitación / ubicación** (ej. T-72-1) 4. Opcional: nombre del técnico y observaciones.
3. Selecciona **Empresa** (SODEXO, REYSAP, MTTO CAMP, SmartService). 5. Envía → el registro queda en la BD.
4. Aparecen los **servicios** disponibles para esa empresa (lógica condicional).
5. Opcional: nombre del técnico y observaciones.
6. Envía → el registro queda guardado en la base de datos.
--- ---
## Panel de administración ## Identificadores únicos
Ruta base: `/admin/`
| Sección | Función |
|---------|---------|
| **Panel** | Estadísticas, registros recientes, accesos rápidos |
| **Registros** | Consulta y filtrado por módulo, empresa, fechas y búsqueda libre |
| **Módulos** | Ver, editar nombres, activar/desactivar y **crear nuevos módulos** |
| **Ubicaciones** | Ver, editar, filtrar y **crear nuevas habitaciones** (una o varias por lote) |
| **Empresas** | Gestionar empresas contratistas |
| **Servicios** | Gestionar servicios por empresa (aparecen condicionalmente en el formulario) |
| **Códigos QR** | Vista previa, exportar CSV, generar etiquetas PNG |
| **Usuarios** | Crear, editar, desactivar y eliminar accesos al panel |
Todas las páginas admin requieren **inicio de sesión**.
---
## Identificadores únicos (clave del diseño)
Cada módulo y ubicación tiene un **código permanente** independiente del nombre visible:
| Entidad | Código ejemplo | Nombre editable | En el QR | | Entidad | Código ejemplo | Nombre editable | En el QR |
|---------|----------------|-----------------|----------| |---------|----------------|-----------------|----------|
| Módulo | `MOD-001` | PLP | No (solo en BD) | | Módulo | `MOD-001` | PLP | No |
| Ubicación | `UB-00001` | T-72-1 | Sí (`?u=UB-00001`) | | Ubicación | `UB-00001` | T-72-1 | Sí (`?u=UB-00001`) |
**Ventaja:** si mañana "PLP" pasa a llamarse "Campamento Norte", solo se edita el nombre en el panel. El QR impreso sigue apuntando a `UB-00001` sin regenerar nada. Si se renombra un módulo o habitación, el QR impreso **no requiere regenerarse**.
Al crear nuevos módulos o ubicaciones, el sistema asigna automáticamente el siguiente código disponible (`MOD-020`, `UB-02519`, etc.).
--- ---
## Generación de códigos QR ## Códigos QR
### Desde el panel ### Desde el panel
**Admin → Códigos QR → Generar QR** **Admin → Códigos QR**
- Filtrar por módulo, búsqueda, solo pendientes
- **Ver** — modal con vista previa
- **Descargar** — PNG individual por ubicación
- **ZIP masivo** — todos los QR (respeta filtro de módulo)
- **Seleccionar + Descargar** — ZIP de ubicaciones elegidas
- **Generar todos** — ejecuta `generate_qrs.py` (pide confirmación)
### Desde terminal ### Desde terminal
```bash ```bash
# Primero exportar CSV desde el panel, o:
php -r "require 'config/config.php'; require 'config/database.php'; require 'includes/functions.php'; regenerateQrCsv(getDB());"
python3 generate_qrs.py python3 generate_qrs.py
``` ```
### Formato de cada etiqueta ### Formato de etiqueta
- Color QR: `#132A7C` - Color QR: `#132A7C`
- Logo `NEM.png` centrado (corrección de errores alta) - Logo `NEM.png` centrado
- Pie de imagen: `Módulo | Habitación` (ej. `PLP | T-72-1`) - Pie: `Módulo | Habitación`
- Archivo PNG en `output/`, nombre: `Módulo_Habitación.png` - Archivo: `output/Módulo_Habitación.png`
- Si hay colisión de nombre (mismo módulo + misma habitación), se añade el código: `…_UB-01121.png` - Colisión de nombre: se añade el código (`…_UB-01121.png`)
### Archivo de datos `qr_data.csv` se genera automáticamente desde la BD. No se versiona.
`qr_data.csv` contiene columnas: `codigo`, `modulo`, `ubicacion`, `url`
Se regenera al instalar, exportar desde el panel o al crear ubicaciones nuevas.
--- ---
@ -187,12 +280,12 @@ Base: `mantenimiento_campamento`
| Tabla | Descripción | | Tabla | Descripción |
|-------|-------------| |-------|-------------|
| `modulos` | Áreas del campamento (PLP, COCINA, 100´s, etc.) | | `modulos` | Áreas del campamento |
| `ubicaciones` | Habitaciones, trailas, equipos, etc. (vinculadas a un módulo) | | `ubicaciones` | Habitaciones, trailas, equipos (vinculadas a un módulo) |
| `empresas` | Contratistas (SODEXO, REYSAP, …) | | `empresas` | Contratistas |
| `servicios` | Tipos de servicio por empresa | | `servicios` | Tipos de servicio por empresa |
| `registros` | Cada actividad de mantenimiento registrada | | `registros` | Actividades de mantenimiento registradas |
| `usuarios` | Accesos al panel de administración | | `usuarios` | Accesos al panel admin |
--- ---
@ -200,8 +293,8 @@ Base: `mantenimiento_campamento`
``` ```
autofillqr/ autofillqr/
├── admin/ # Panel de administración ├── admin/ # Panel de administración
│ ├── index.php # Dashboard │ ├── index.php # Dashboard
│ ├── login.php / logout.php │ ├── login.php / logout.php
│ ├── registros.php │ ├── registros.php
│ ├── modulos.php │ ├── modulos.php
@ -209,98 +302,69 @@ autofillqr/
│ ├── empresas.php │ ├── empresas.php
│ ├── servicios.php │ ├── servicios.php
│ ├── usuarios.php │ ├── usuarios.php
│ ├── qrs.php │ ├── qrs.php # Gestión QR (vista, descarga, ZIP)
│ ├── download_qr.php # Descarga individual y masiva
│ ├── generate_qrs.php │ ├── generate_qrs.php
│ └── export_qr.php │ └── export_qr.php
├── api/ ├── api/
│ ├── guardar.php # Guarda registro del formulario │ ├── guardar.php # Guarda registro del formulario
│ └── servicios.php # API JSON: servicios por empresa │ └── servicios.php # JSON: servicios por empresa
├── assets/css/ # Estilos ├── assets/
├── assets/js/ # JS formulario y admin │ ├── css/ # style.css, admin.css
│ └── js/ # formulario.js, admin.js, admin-qrs.js
├── config/ ├── config/
│ ├── config.php # Configuración general │ ├── config.php
│ └── database.php # Conexión PDO │ ├── config.local.example.php
├── includes/ # Header, auth, funciones │ ├── config.production.example.php
├── sql/ # Esquema e migraciones │ └── database.php
├── formulario.php # Formulario público (entrada QR) ├── includes/ # Header, auth, funciones, bootstrap
├── install.php # Instalador ├── scripts/
├── import_faltantes.php # Importar ubicaciones desde Faltantes.csv │ └── prepare_deploy.sh # Preparar paquete de producción
├── generate_qrs.py # Generador de etiquetas PNG ├── sql/
├── data.csv # Datos originales (importación inicial) │ ├── schema.sql
├── Faltantes.csv # Ubicaciones adicionales (módulo, habitación) │ └── backup_produccion.sql
├── qr_data.csv # URLs actuales para QR (generado) ├── .htaccess # Seguridad Apache (producción)
├── NEM.png # Logo del campamento ├── formulario.php # Formulario público (entrada QR)
└── output/ # QR generados (PNG) ├── install.php # Instalador (solo APP_ENV=local)
├── generate_qrs.py # Generador PNG
├── NEM.png # Logo
└── output/ # QR generados (PNG, no versionar)
``` ```
--- ---
## Catálogos precargados ## Seguridad
### Empresas | Medida | Detalle |
|--------|---------|
- SODEXO | `APP_ENV=production` | Oculta errores PHP al usuario |
- REYSAP | Sesión HTTPS | Cookies `Secure`, `HttpOnly`, `SameSite=Lax` |
- MTTO CAMP | `install.php` | Bloqueado en producción (403) |
- SmartService | `.htaccess` | Bloquea acceso web a `config/`, `sql/`, `includes/`, `.sql`, `.py`, `.csv` |
| Admin | Requiere login; contraseñas con `password_hash()` (bcrypt) |
### Servicios por empresa | Formulario | Público (sin login) |
| Empresa | Servicios |
|---------|-----------|
| SODEXO | Limpieza / Supervisión, Fumigación |
| REYSAP | Servicio de Mantenimiento |
| MTTO CAMP | Mtto Preventivo, Mtto Correctivo |
| SmartService | Mtto Cocina |
Todos editables desde el panel admin.
---
## Datos importados
Desde `data.csv` (formato original de Microsoft Forms):
- **19 módulos / áreas** iniciales + adicionales vía `Faltantes.csv`
- **2 628 ubicaciones** (2 518 base + 108 faltantes)
---
## Importar ubicaciones faltantes
Archivo `Faltantes.csv` con columnas `modulo,ubicacion` (UTF-8):
```bash
php import_faltantes.php
```
O desde el navegador (requiere login admin): `/import_faltantes.php`
--- ---
## Notas técnicas ## Notas técnicas
- Zona horaria: `America/Hermosillo` - Zona horaria: `America/Hermosillo`
- Contraseñas de usuarios: hash con `password_hash()` (bcrypt) - Los POST del admin procesan datos antes de enviar HTML
- El formulario público no requiere autenticación; el panel admin sí - Codificación BD: UTF-8 (`utf8mb4`)
- Los POST del admin procesan datos **antes** de enviar HTML (evita errores de headers) - Interfaz admin: español; confirmaciones bilingües ES/EN
- Codificación CSV original: ISO-8859-1; la BD usa UTF-8
--- ---
## Resumen rápido de comandos ## Comandos rápidos
```bash ```bash
# Instalar (navegador) # Desarrollo local
open http://localhost:8080/install.php
# Importar ubicaciones faltantes
php import_faltantes.php
# Servidor desarrollo
php -S localhost:8080 -t . php -S localhost:8080 -t .
# Generar todos los QR # Preparar despliegue
./scripts/prepare_deploy.sh
# Generar QR (tras exportar CSV desde panel)
python3 generate_qrs.py python3 generate_qrs.py
``` ```
@ -308,4 +372,4 @@ python3 generate_qrs.py
## English summary ## English summary
Web-based maintenance logging system for a mining camp. QR codes at each physical location open a pre-filled form (module + room). Staff selects contractor company and service type. Data is stored in MariaDB and managed through a password-protected admin panel. Unique stable IDs (`UB-XXXXX`) allow renaming locations without reprinting QR codes. PNG labels use brand color `#132A7C` and embedded `NEM.png` logo. Web-based maintenance logging for a mining camp. QR codes at each location open a pre-filled form (module + room). Staff selects contractor and service type. Data in MariaDB, managed via password-protected admin at `https://penasquitoapps.newmont.com/camp/mtto_record/`. Stable IDs (`UB-XXXXX`) allow renaming without reprinting QR. Admin supports CRUD with delete confirmation, individual/bulk QR download, and PNG generation with brand color `#132A7C` and `NEM.png` logo.

View file

@ -88,7 +88,8 @@ require_once __DIR__ . '/../includes/admin_header.php';
<td class="text-nowrap"> <td class="text-nowrap">
<button type="submit" class="btn btn-sm btn-primary">Guardar</button> <button type="submit" class="btn btn-sm btn-primary">Guardar</button>
</form> </form>
<form method="post" class="d-inline" onsubmit="return confirm('¿Eliminar la empresa «<?= h($e['nombre']) ?>» y todos sus servicios?');"> <form method="post" class="d-inline"
data-confirm="<?= h('¿Eliminar la empresa «' . $e['nombre'] . '» y todos sus servicios? Esta acción no se puede deshacer.') ?>">
<input type="hidden" name="action" value="delete"> <input type="hidden" name="action" value="delete">
<input type="hidden" name="id" value="<?= (int) $e['id'] ?>"> <input type="hidden" name="id" value="<?= (int) $e['id'] ?>">
<button type="submit" class="btn btn-sm btn-outline-danger" title="Eliminar"> <button type="submit" class="btn btn-sm btn-outline-danger" title="Eliminar">

View file

@ -1,8 +1,10 @@
<?php <?php
require_once __DIR__ . '/../config/config.php';
if (session_status() === PHP_SESSION_NONE) { if (session_status() === PHP_SESSION_NONE) {
session_start(); session_start();
} }
require_once __DIR__ . '/../config/config.php';
require_once __DIR__ . '/../includes/functions.php'; require_once __DIR__ . '/../includes/functions.php';
require_once __DIR__ . '/../includes/auth.php'; require_once __DIR__ . '/../includes/auth.php';

View file

@ -71,7 +71,11 @@ if (is_dir($outputDir)) {
$totalQrFiles = count(array_filter(scandir($outputDir), fn($f) => str_ends_with($f, '.png'))); $totalQrFiles = count(array_filter(scandir($outputDir), fn($f) => str_ends_with($f, '.png')));
} }
$modulos = $db->query('SELECT id, nombre FROM modulos WHERE activo = 1 ORDER BY nombre')->fetchAll(); $modulos = $db->query('SELECT id, nombre FROM modulos WHERE activo = 1 ORDER BY nombre')->fetchAll();
$qrDataExists = file_exists(dirname(__DIR__) . '/qr_data.csv'); $qrDataPath = dirname(__DIR__) . '/qr_data.csv';
if (!is_file($qrDataPath)) {
regenerateQrCsv($db);
}
$qrDataExists = is_file($qrDataPath);
$logoExists = file_exists(dirname(__DIR__) . '/NEM.png'); $logoExists = file_exists(dirname(__DIR__) . '/NEM.png');
$flash = getFlash(); $flash = getFlash();
@ -89,7 +93,10 @@ $topbarActions = '
<a href="' . h($bulkUrl) . '" class="btn btn-outline-primary btn-sm"> <a href="' . h($bulkUrl) . '" class="btn btn-outline-primary btn-sm">
<span class="material-symbols-outlined align-middle" style="font-size:18px">folder_zip</span> ZIP masivo <span class="material-symbols-outlined align-middle" style="font-size:18px">folder_zip</span> ZIP masivo
</a> </a>
<form method="post" action="generate_qrs.php" class="d-inline" onsubmit="return confirm(\'¿Generar todos los QR? Puede tardar varios minutos.\');"> <form method="post" action="generate_qrs.php" class="d-inline"
data-confirm="¿Generar todos los QR? Puede tardar varios minutos. / Generate all QR codes? This may take several minutes."
data-confirm-btn="Generar / Generate"
data-confirm-class="btn-primary">
<button type="submit" class="btn btn-primary btn-sm"> <button type="submit" class="btn btn-primary btn-sm">
<span class="material-symbols-outlined align-middle" style="font-size:18px">qr_code_2</span> Generar todos <span class="material-symbols-outlined align-middle" style="font-size:18px">qr_code_2</span> Generar todos
</button> </button>

View file

@ -118,7 +118,8 @@ require_once __DIR__ . '/../includes/admin_header.php';
<td class="text-nowrap"> <td class="text-nowrap">
<button type="submit" class="btn btn-sm btn-primary">Guardar</button> <button type="submit" class="btn btn-sm btn-primary">Guardar</button>
</form> </form>
<form method="post" class="d-inline" onsubmit="return confirm('¿Eliminar el servicio «<?= h($s['nombre']) ?>»?');"> <form method="post" class="d-inline"
data-confirm="<?= h('¿Eliminar el servicio «' . $s['nombre'] . '»? Esta acción no se puede deshacer.') ?>">
<input type="hidden" name="action" value="delete"> <input type="hidden" name="action" value="delete">
<input type="hidden" name="id" value="<?= (int) $s['id'] ?>"> <input type="hidden" name="id" value="<?= (int) $s['id'] ?>">
<button type="submit" class="btn btn-sm btn-outline-danger" title="Eliminar"> <button type="submit" class="btn btn-sm btn-outline-danger" title="Eliminar">

View file

@ -204,7 +204,8 @@ require_once __DIR__ . '/../includes/admin_header.php';
<td class="text-nowrap"> <td class="text-nowrap">
<button type="submit" class="btn btn-sm btn-primary">Guardar</button> <button type="submit" class="btn btn-sm btn-primary">Guardar</button>
</form> </form>
<form method="post" class="d-inline" onsubmit="return confirm('¿Eliminar la ubicación <?= h($u['codigo']) ?>? Esta acción no se puede deshacer.');"> <form method="post" class="d-inline"
data-confirm="<?= h('¿Eliminar la ubicación ' . $u['codigo'] . ' («' . $u['nombre'] . '»)? Esta acción no se puede deshacer.') ?>">
<input type="hidden" name="action" value="delete"> <input type="hidden" name="action" value="delete">
<input type="hidden" name="id" value="<?= (int) $u['id'] ?>"> <input type="hidden" name="id" value="<?= (int) $u['id'] ?>">
<button type="submit" class="btn btn-sm btn-outline-danger" title="Eliminar"> <button type="submit" class="btn btn-sm btn-outline-danger" title="Eliminar">

View file

@ -163,7 +163,8 @@ require_once __DIR__ . '/../includes/admin_header.php';
</form> </form>
<td> <td>
<?php if ((int) $u['id'] !== $current['id']): ?> <?php if ((int) $u['id'] !== $current['id']): ?>
<form method="post" onsubmit="return confirm('¿Eliminar usuario <?= h($u['usuario']) ?>?');"> <form method="post"
data-confirm="<?= h('¿Eliminar el usuario «' . $u['usuario'] . '»? Esta acción no se puede deshacer.') ?>">
<input type="hidden" name="action" value="delete"> <input type="hidden" name="action" value="delete">
<input type="hidden" name="id" value="<?= (int) $u['id'] ?>"> <input type="hidden" name="id" value="<?= (int) $u['id'] ?>">
<button type="submit" class="btn btn-sm btn-outline-danger">Eliminar</button> <button type="submit" class="btn btn-sm btn-outline-danger">Eliminar</button>

View file

@ -6,4 +6,69 @@ document.addEventListener('DOMContentLoaded', function () {
sidebar.classList.toggle('show'); sidebar.classList.toggle('show');
}); });
} }
var modalEl = document.getElementById('confirmActionModal');
var msgEl = document.getElementById('confirmActionMessage');
var okBtn = document.getElementById('confirmActionOk');
var pendingForm = null;
var modal = modalEl && window.bootstrap ? bootstrap.Modal.getOrCreateInstance(modalEl) : null;
function submitConfirmed(form) {
form.dataset.confirmed = '1';
if (typeof form.requestSubmit === 'function') {
form.requestSubmit();
} else {
form.submit();
}
}
document.querySelectorAll('form[data-confirm]').forEach(function (form) {
form.addEventListener('submit', function (e) {
if (form.dataset.confirmed === '1') {
delete form.dataset.confirmed;
return;
}
e.preventDefault();
var message = form.getAttribute('data-confirm') || '¿Confirma esta acción? / Confirm this action?';
if (!modal) {
if (window.confirm(message)) {
submitConfirmed(form);
}
return;
}
pendingForm = form;
if (msgEl) {
msgEl.textContent = message;
}
var btnLabel = form.getAttribute('data-confirm-btn') || 'Eliminar / Delete';
var btnClass = form.getAttribute('data-confirm-class') || 'btn-danger';
if (okBtn) {
okBtn.textContent = btnLabel;
okBtn.className = 'btn ' + btnClass;
}
modal.show();
});
});
if (okBtn) {
okBtn.addEventListener('click', function () {
if (pendingForm) {
var form = pendingForm;
pendingForm = null;
modal.hide();
submitConfirmed(form);
}
});
}
if (modalEl) {
modalEl.addEventListener('hidden.bs.modal', function () {
pendingForm = null;
});
}
}); });

View file

@ -0,0 +1,12 @@
<?php
/**
* Copie este archivo como config.local.php para desarrollo local.
* config.local.php no se versiona en git.
*/
define('BASE_URL', 'http://localhost:8080');
// Opcional: credenciales distintas en local
// define('DB_HOST', 'localhost');
// define('DB_USER', 'root');
// define('DB_PASS', 'R3m4st3r');

View file

@ -2,16 +2,72 @@
/** /**
* Configuración general del sistema de mantenimiento * Configuración general del sistema de mantenimiento
*/ */
define('DB_HOST', 'localhost');
define('DB_NAME', 'mantenimiento_campamento');
define('DB_USER', 'root');
define('DB_PASS', 'R3m4st3r');
define('DB_CHARSET', 'utf8mb4');
// Cambiar según la URL donde esté alojada la aplicación if (!defined('DB_HOST')) {
define('BASE_URL', 'http://localhost:8080'); define('DB_HOST', 'localhost');
}
if (!defined('DB_NAME')) {
define('DB_NAME', 'mantenimiento_campamento');
}
if (!defined('DB_USER')) {
define('DB_USER', 'root');
}
if (!defined('DB_PASS')) {
define('DB_PASS', 'R3m4st3r');
}
if (!defined('DB_CHARSET')) {
define('DB_CHARSET', 'utf8mb4');
}
define('APP_NAME', 'Mantenimiento Campamento'); /** Ruta en el servidor (sin barra final). Ej: /camp/mtto_record */
define('APP_VERSION', '1.0.0'); if (!defined('APP_BASE_PATH')) {
define('APP_BASE_PATH', '/camp/mtto_record');
}
if (file_exists(__DIR__ . '/config.production.php')) {
require_once __DIR__ . '/config.production.php';
}
if (file_exists(__DIR__ . '/config.local.php')) {
require_once __DIR__ . '/config.local.php';
}
if (!defined('APP_ENV')) {
define('APP_ENV', file_exists(__DIR__ . '/config.local.php') ? 'local' : 'production');
}
/**
* URL pública de la aplicación (sin barra final).
* Producción: https://penasquitoapps.newmont.com/camp/mtto_record
* Desarrollo: copie config.local.example.php → config.local.php
*/
if (!defined('BASE_URL')) {
define('BASE_URL', 'https://penasquitoapps.newmont.com/camp/mtto_record');
}
if (!defined('APP_NAME')) {
define('APP_NAME', 'Mantenimiento Campamento');
}
if (!defined('APP_VERSION')) {
define('APP_VERSION', '1.0.0');
}
date_default_timezone_set('America/Hermosillo'); date_default_timezone_set('America/Hermosillo');
if (APP_ENV === 'production') {
ini_set('display_errors', '0');
ini_set('display_startup_errors', '0');
error_reporting(E_ALL);
ini_set('log_errors', '1');
if (session_status() === PHP_SESSION_NONE) {
ini_set('session.cookie_httponly', '1');
ini_set('session.cookie_secure', '1');
ini_set('session.use_strict_mode', '1');
ini_set('session.cookie_samesite', 'Lax');
}
} else {
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
error_reporting(E_ALL);
}

View file

@ -0,0 +1,14 @@
<?php
/**
* Credenciales del servidor de producción.
* Copie este archivo como config.production.php en el servidor.
* NO suba config.local.php a producción.
*/
// define('DB_HOST', 'localhost');
// define('DB_NAME', 'mantenimiento_campamento');
// define('DB_USER', 'mtto_user');
// define('DB_PASS', 'contraseña_segura');
// Opcional: forzar entorno
// define('APP_ENV', 'production');

2519
data.csv

File diff suppressed because it is too large Load diff

View file

@ -21,7 +21,7 @@ os.makedirs(OUTPUT_DIR, exist_ok=True)
if not os.path.exists(CSV_FILE): if not os.path.exists(CSV_FILE):
print(f"Error: no se encontró '{CSV_FILE}'.") print(f"Error: no se encontró '{CSV_FILE}'.")
print("Ejecute install.php o exporte desde el panel admin.") print("Use Admin → Códigos QR → Generar todos, o exporte CSV desde el panel.")
raise SystemExit(1) raise SystemExit(1)
logo = None logo = None

View file

@ -1,45 +0,0 @@
<?php
/**
* Importa ubicaciones desde Faltantes.csv (columnas: módulo, habitación).
* CLI: php import_faltantes.php
* Web: requiere sesión admin.
*/
set_time_limit(120);
require_once __DIR__ . '/config/config.php';
require_once __DIR__ . '/config/database.php';
require_once __DIR__ . '/includes/functions.php';
$isCli = PHP_SAPI === 'cli';
if (!$isCli) {
require_once __DIR__ . '/includes/auth.php';
requireAdmin();
}
$csvPath = __DIR__ . '/Faltantes.csv';
try {
$db = getDB();
$result = importModuloUbicacionCsv($db, $csvPath);
$msg = sprintf(
'Importación completada: %d módulo(s) nuevo(s), %d ubicación(es) creada(s), %d omitida(s) (ya existían).',
$result['modulos_nuevos'],
$result['creadas'],
$result['omitidas']
);
if ($isCli) {
echo $msg . PHP_EOL;
exit(0);
}
flash('success', $msg);
} catch (Throwable $e) {
if ($isCli) {
fwrite(STDERR, 'Error: ' . $e->getMessage() . PHP_EOL);
exit(1);
}
flash('danger', 'Error al importar: ' . $e->getMessage());
}
redirect(BASE_URL . '/admin/ubicaciones.php');

View file

@ -1,8 +1,10 @@
<?php <?php
require_once __DIR__ . '/../config/config.php';
if (session_status() === PHP_SESSION_NONE) { if (session_status() === PHP_SESSION_NONE) {
session_start(); session_start();
} }
require_once __DIR__ . '/../config/config.php';
require_once __DIR__ . '/functions.php'; require_once __DIR__ . '/functions.php';
require_once __DIR__ . '/auth.php'; require_once __DIR__ . '/auth.php';

View file

@ -4,6 +4,25 @@
</footer> </footer>
</div> </div>
</div> </div>
<div class="modal fade" id="confirmActionModal" tabindex="-1" aria-labelledby="confirmActionTitle" aria-hidden="true">
<div class="modal-dialog modal-dialog-centered">
<div class="modal-content">
<div class="modal-header">
<h5 class="modal-title" id="confirmActionTitle">Confirmar / Confirm</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Cerrar"></button>
</div>
<div class="modal-body">
<p id="confirmActionMessage" class="mb-0"></p>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Cancelar / Cancel</button>
<button type="button" class="btn btn-danger" id="confirmActionOk">Eliminar / Delete</button>
</div>
</div>
</div>
</div>
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js"></script>
<script src="<?= BASE_URL ?>/assets/js/admin.js"></script> <script src="<?= BASE_URL ?>/assets/js/admin.js"></script>
<?php if (!empty($extraJs)): ?> <?php if (!empty($extraJs)): ?>

View file

@ -99,137 +99,6 @@ function seedEmpresasServicios(PDO $db, bool $onlyIfEmpty = false): void
} }
} }
function importDataCsv(PDO $db, string $path): array
{
if (!file_exists($path)) {
throw new RuntimeException('No se encontró ' . basename($path));
}
$moduloMap = [];
$modCounter = 0;
$ubCounter = 0;
$stmtMod = $db->prepare('INSERT INTO modulos (codigo, nombre) VALUES (?, ?)');
$stmtUb = $db->prepare('INSERT INTO ubicaciones (codigo, modulo_id, nombre) VALUES (?, ?, ?)');
$fh = fopen($path, 'r');
fgetcsv($fh, 0, ',', '"', '\\');
$db->beginTransaction();
try {
while (($row = fgetcsv($fh, 0, ',', '"', '\\')) !== false) {
if (empty($row[0])) {
continue;
}
$modNombre = trim(mb_convert_encoding($row[2], 'UTF-8', 'ISO-8859-1'));
$ubNombre = trim(mb_convert_encoding($row[4], 'UTF-8', 'ISO-8859-1'));
if (!isset($moduloMap[$modNombre])) {
$modCounter++;
$modCodigo = sprintf('MOD-%03d', $modCounter);
$stmtMod->execute([$modCodigo, $modNombre]);
$moduloMap[$modNombre] = (int) $db->lastInsertId();
}
$ubCounter++;
$ubCodigo = sprintf('UB-%05d', $ubCounter);
$stmtUb->execute([$ubCodigo, $moduloMap[$modNombre], $ubNombre]);
}
$db->commit();
} catch (Throwable $e) {
$db->rollBack();
throw $e;
} finally {
fclose($fh);
}
return ['modulos' => $modCounter, 'ubicaciones' => $ubCounter];
}
/**
* Importa CSV módulo,ubicación (p. ej. Faltantes.csv: R1,R2).
* @return array{modulos_nuevos: int, creadas: int, omitidas: int}
*/
function importModuloUbicacionCsv(PDO $db, string $path): array
{
if (!file_exists($path)) {
throw new RuntimeException('No se encontró ' . basename($path));
}
$stmtModByName = $db->prepare('SELECT id FROM modulos WHERE nombre = ?');
$stmtInsMod = $db->prepare('INSERT INTO modulos (codigo, nombre) VALUES (?, ?)');
$stmtExists = $db->prepare('
SELECT u.id FROM ubicaciones u
JOIN modulos m ON m.id = u.modulo_id
WHERE m.nombre = ? AND u.nombre = ?
');
$stmtInsUb = $db->prepare('INSERT INTO ubicaciones (codigo, modulo_id, nombre) VALUES (?, ?, ?)');
$modulosNuevos = 0;
$creadas = 0;
$omitidas = 0;
$fh = fopen($path, 'r');
$first = fgetcsv($fh, 0, ',', '"', '\\');
$hasHeader = $first && in_array(strtoupper(trim($first[0] ?? '')), ['R1', 'MODULO', 'MÓDULO', 'MODULE'], true);
$db->beginTransaction();
try {
if (!$hasHeader && $first) {
$rows = [$first];
} else {
$rows = [];
}
while (($row = fgetcsv($fh, 0, ',', '"', '\\')) !== false) {
$rows[] = $row;
}
foreach ($rows as $row) {
if (count($row) < 2) {
continue;
}
$modNombre = trim($row[0]);
$ubNombre = trim($row[1]);
if ($modNombre === '' || $ubNombre === '') {
continue;
}
$stmtModByName->execute([$modNombre]);
$moduloId = $stmtModByName->fetchColumn();
if (!$moduloId) {
$codigo = nextModuloCodigo($db);
$stmtInsMod->execute([$codigo, $modNombre]);
$moduloId = (int) $db->lastInsertId();
$modulosNuevos++;
} else {
$moduloId = (int) $moduloId;
}
$stmtExists->execute([$modNombre, $ubNombre]);
if ($stmtExists->fetchColumn()) {
$omitidas++;
continue;
}
$ubCodigo = nextUbicacionCodigo($db);
$stmtInsUb->execute([$ubCodigo, $moduloId, $ubNombre]);
$creadas++;
}
$db->commit();
} catch (Throwable $e) {
$db->rollBack();
throw $e;
} finally {
fclose($fh);
}
if ($creadas > 0) {
regenerateQrCsv($db);
}
return ['modulos_nuevos' => $modulosNuevos, 'creadas' => $creadas, 'omitidas' => $omitidas];
}
function safeQrFilename(string $text): string function safeQrFilename(string $text): string
{ {
return preg_replace('/[\\\\\/:*?"<>|]/', '-', $text); return preg_replace('/[\\\\\/:*?"<>|]/', '-', $text);

View file

@ -1,8 +1,10 @@
<?php <?php
require_once __DIR__ . '/../config/config.php';
if (session_status() === PHP_SESSION_NONE) { if (session_status() === PHP_SESSION_NONE) {
session_start(); session_start();
} }
require_once __DIR__ . '/../config/config.php';
require_once __DIR__ . '/functions.php'; require_once __DIR__ . '/functions.php';
$currentPage = basename($_SERVER['PHP_SELF'], '.php'); $currentPage = basename($_SERVER['PHP_SELF'], '.php');

View file

@ -1,3 +1,3 @@
<?php <?php
header('Location: admin/index.php'); header('Location: ' . (defined('BASE_URL') ? BASE_URL : '') . '/admin/index.php');
exit; exit;

View file

@ -1,10 +1,20 @@
<?php <?php
/** /**
* Instalación: crea la BD, importa data.csv y genera códigos únicos estables. * Instalación: crea la BD, catálogos y usuario admin.
* Ejecutar una sola vez: http://localhost/autofillqr/install.php * Solo disponible en entorno local (APP_ENV=local).
* En producción importe sql/backup_produccion.sql
*/ */
set_time_limit(300); set_time_limit(300);
require_once __DIR__ . '/config/config.php'; require_once __DIR__ . '/config/config.php';
if (APP_ENV === 'production') {
http_response_code(403);
header('Content-Type: text/plain; charset=utf-8');
echo "Instalación deshabilitada en producción.\n";
echo "Importe sql/backup_produccion.sql y acceda al panel admin.\n";
exit;
}
require_once __DIR__ . '/config/database.php'; require_once __DIR__ . '/config/database.php';
require_once __DIR__ . '/includes/functions.php'; require_once __DIR__ . '/includes/functions.php';
@ -25,10 +35,10 @@ try {
$countModulos = (int) $db->query('SELECT COUNT(*) FROM modulos')->fetchColumn(); $countModulos = (int) $db->query('SELECT COUNT(*) FROM modulos')->fetchColumn();
if ($countModulos > 0) { if ($countModulos > 0) {
$messages[] = 'Los datos ya estaban importados. No se repite la importación.'; $countUb = (int) $db->query('SELECT COUNT(*) FROM ubicaciones')->fetchColumn();
$messages[] = "Datos existentes: {$countModulos} módulo(s), {$countUb} ubicación(es).";
} else { } else {
$stats = importDataCsv($db, __DIR__ . '/data.csv'); $messages[] = 'Base vacía. Agregue módulos y ubicaciones desde el panel admin o restaure un respaldo SQL.';
$messages[] = "Importados {$stats['modulos']} módulos y {$stats['ubicaciones']} ubicaciones desde data.csv.";
} }
seedEmpresasServicios($db, true); seedEmpresasServicios($db, true);
@ -39,7 +49,7 @@ try {
} }
regenerateQrCsv($db); regenerateQrCsv($db);
$messages[] = "Archivo qr_data.csv generado para el script de QR's."; $messages[] = 'Archivo qr_data.csv generado desde la base de datos.';
} catch (Throwable $e) { } catch (Throwable $e) {
if (isset($db) && $db->inTransaction()) { if (isset($db) && $db->inTransaction()) {

File diff suppressed because it is too large Load diff

36
scripts/prepare_deploy.sh Executable file
View file

@ -0,0 +1,36 @@
#!/bin/bash
# Prepara artefactos para despliegue en producción.
set -e
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
cd "$ROOT"
LOCAL="$ROOT/config/config.local.php"
LOCAL_BAK="$ROOT/config/config.local.php.bak"
echo "→ Exportando base de datos..."
mysqldump -u root -pR3m4st3r mantenimiento_campamento > sql/backup_produccion.sql
if [ -f "$LOCAL" ]; then
mv "$LOCAL" "$LOCAL_BAK"
fi
echo "→ Generando qr_data.csv con URL de producción..."
php -r "
require '$ROOT/config/config.php';
require '$ROOT/config/database.php';
require '$ROOT/includes/functions.php';
regenerateQrCsv(getDB());
echo 'qr_data.csv → ' . BASE_URL . PHP_EOL;
"
if [ -f "$LOCAL_BAK" ]; then
mv "$LOCAL_BAK" "$LOCAL"
fi
echo ""
echo "Listo para desplegar en:"
echo " https://penasquitoapps.newmont.com/camp/mtto_record/"
echo ""
echo "NO subir: config/config.local.php"
echo "Sí crear en servidor: config/config.production.php (ver config.production.example.php)"
echo "Importar en servidor: mysql ... < sql/backup_produccion.sql"

2964
sql/backup_produccion.sql Normal file

File diff suppressed because it is too large Load diff