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

Copiar el proyecto en C:\xampp\htdocs\proyecto_taller.
Crear una base de datos MySQL para la aplicacion, por ejemplo carpooling.
Si la base esta vacia, importar basededatos_definitiva.sql.
Revisar config/database.php y config/local.php para usuario, clave, host y nombre de base.
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.

4.0 KiB Raw Blame History