Subir archivos a "/"

README.md

@@ -0,0 +1,85 @@
+# MOVEON - Plataforma de carpooling
+
+MOVEON es una aplicacion web PHP/MySQL para publicar viajes compartidos, reservar pasajes, administrar conductores, vehiculos, usuarios, reportes y soporte.
+
+## Tecnologias
+
+- PHP con PDO.
+- MySQL/MariaDB.
+- XAMPP para ejecucion local.
+- HTML, CSS y JavaScript sin framework.
+- Generacion de backups SQL desde el panel administrativo.
+
+## Requisitos
+
+- Apache y MySQL activos en XAMPP.
+- PHP 8 o compatible con PDO MySQL.
+- Navegador moderno.
+- Base de datos creada en MySQL.
+
+## Instalacion local
+
+1. Copiar el proyecto en `C:\xampp\htdocs\proyecto_taller`.
+2. Crear una base de datos MySQL para la aplicacion, por ejemplo `carpooling`.
+3. Si la base esta vacia, importar `basededatos_definitiva.sql`.
+4. Revisar `config/database.php` y `config/local.php` para usuario, clave, host y nombre de base.
+5. Abrir `http://localhost/proyecto_taller/public/`.
+
+Si ya existe una base con datos, no reimportar `basededatos_definitiva.sql` encima. Primero hacer un backup y luego ejecutar `database/actualizar_base_actual.sql`, que agrega columnas/tablas faltantes sin borrar datos.
+
+## Configuracion
+
+La configuracion principal esta en:
+
+- `config/database.php`: conexion PDO.
+- `config/app.php`: opciones generales, rutas y banderas como `PAYMENTS_ENABLED`.
+- `core/security.php`: CSRF y utilidades de seguridad.
+
+En la version actual los pagos estan ocultos/desactivados para mantener el flujo sin plataforma de cobro externa.
+
+## Estructura general
+
+- `public/`: pantallas publicas, panel de usuario, conductor y administrador.
+- `public/admin/`: dashboard, conductores, vehiculos, usuarios, viajes, reportes, soporte y backups.
+- `core/`: logica compartida de viajes, reservas, seguridad y servicios.
+- `config/`: configuracion de base de datos y aplicacion.
+- `docs/`: documentacion tecnica, usuario, administracion y recuperacion.
+- `basededatos_definitiva.sql`: estructura definitiva para crear una base nueva.
+- `database/actualizar_base_actual.sql`: migracion para actualizar una base vieja sin perder datos.
+- `database/seed_admin_demo.php`: datos de prueba para desarrollo o demostraciones.
+
+## Base de datos
+
+El sistema usa tablas como `Usuarios`, `Conductores`, `Vehiculos`, `Publicaciones`, `Reservas`, `Pasajeros`, `PasajerosReservas`, `Reportes`, `ReportesPasajeros`, `Soporte`, `Notificaciones` y tablas de confirmaciones de viaje.
+
+Los datos sensibles cargados por usuarios incluyen DNI, telefono, imagenes de DNI, foto de perfil y datos del vehiculo. Deben tratarse como informacion privada.
+
+### Instalacion nueva vs actualizacion
+
+- Instalacion nueva: crear una base vacia e importar `basededatos_definitiva.sql`.
+- Base existente: hacer backup y ejecutar `database/actualizar_base_actual.sql`.
+- Datos demo: ejecutar `database/seed_admin_demo.php` solo en entornos de prueba.
+
+No mezclar estos usos: el SQL definitivo crea la estructura completa, el script de actualizacion corrige bases viejas, y el seed carga informacion ficticia.
+
+## Roles
+
+- Administrador: gestiona usuarios, conductores, vehiculos, viajes, reportes, soporte, backups y reportes gerenciales.
+- Conductor: administra perfil, vehiculos, viajes publicados, pasajeros y reportes.
+- Pasajero: busca viajes, reserva pasajes, confirma llegada, califica y reporta problemas.
+
+## Recuperacion ante Desastres
+
+Ver `docs/RECUPERACION_ANTE_DESASTRES.md`. En resumen, para reconstruir el sistema se necesita el proyecto, la base de datos o backup SQL, archivos de configuracion y cualquier archivo subido por usuarios que no este guardado directamente en la base.
+
+Desde el dashboard administrador se puede descargar:
+
+- Un SQL de base de datos.
+- Un paquete de recuperacion con SQL, `README_RESTAURACION.txt`, `MANIFEST.txt`, `config/database.example.php`, `config/app.example.php` y `.env.example`.
+
+## Documentacion adicional
+
+- `docs/MANUAL_DESARROLLO.md`: guia para desarrolladores.
+- `docs/MANUAL_USUARIO.md`: guia por perfil.
+- `docs/MANUAL_ADMIN.md`: manual administrativo.
+- `public/admin/manual_admin.php`: manual integrado al panel.