commit 7d881e8b7e25f1a0c3815654fc21215c4e1c83dc Author: alumnos_ti Date: Tue Jun 23 23:35:06 2026 +0000 Subir archivos a "/" diff --git a/README_PARA_COPIAR.md b/README_PARA_COPIAR.md new file mode 100644 index 0000000..1a93871 --- /dev/null +++ b/README_PARA_COPIAR.md @@ -0,0 +1,164 @@ +# MOVEON - Plataforma de Carpooling + +MOVEON es una aplicacion web PHP/MySQL para gestionar viajes compartidos. Permite que pasajeros busquen y reserven viajes, que conductores publiquen recorridos y que administradores controlen usuarios, vehiculos, reportes, soporte, backups y estadisticas del sistema. + +## Tecnologias utilizadas + +- PHP con PDO +- MySQL / MariaDB +- Apache mediante XAMPP +- HTML, CSS y JavaScript +- Backups SQL y paquete de recuperacion desde el panel administrador + +## Requisitos + +- XAMPP instalado +- Apache y MySQL activos +- PHP 8.x o compatible +- Navegador web moderno +- Base de datos MySQL llamada `carpooling` + +## Instalacion y ejecucion local + +1. Copiar o clonar el proyecto en: + +```text +C:\xampp\htdocs\proyecto_taller +``` + +2. Iniciar Apache y MySQL desde XAMPP. + +3. Crear la base de datos: + +```sql +CREATE DATABASE carpooling CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; +``` + +4. Si la base esta vacia, importar `basededatos_definitiva.sql` o un backup SQL generado desde el panel. + +Si ya existe una base con datos, no reimportar `basededatos_definitiva.sql` encima. Primero hacer backup y despues ejecutar: + +```text +database/actualizar_base_actual.sql +``` + +5. Revisar la configuracion de conexion en: + +```text +config/database.php +``` + +Tambien se incluye una plantilla: + +```text +config/database.example.php +``` + +6. Abrir el sistema en: + +```text +http://localhost/proyecto_taller/public/ +``` + +## Configuracion + +Archivos principales: + +- `config/database.php`: conexion a MySQL. +- `config/app.php`: configuracion general del sistema. +- `.env.example`: variables de referencia para reconstruir el entorno. +- `config/database.example.php`: plantilla de conexion. +- `config/app.example.php`: plantilla de configuracion general. + +Los pagos online estan desactivados en esta version mediante `PAYMENTS_ENABLED = false`. + +## Estructura del proyecto + +```text +public/ Pantallas publicas y paneles del sistema +public/admin/ Panel administrativo +public/conductor/ Funciones del conductor +public/reservas/ Reservas del pasajero +core/ Logica compartida +config/ Configuracion del sistema +docs/ Documentacion tecnica y de usuario +basededatos_definitiva.sql +database/actualizar_base_actual.sql +database/seed_admin_demo.php +``` + +## Base de datos + +El sistema utiliza tablas como: + +- `Usuarios` +- `Conductores` +- `Vehiculos` +- `Publicaciones` +- `Reservas` +- `Pasajeros` +- `PasajerosReservas` +- `Reportes` +- `ReportesPasajeros` +- `Soporte` +- `Notificaciones` +- `BusquedasViajes` + +Archivos relacionados: + +- `basededatos_definitiva.sql`: estructura completa para una instalacion nueva. +- `database/actualizar_base_actual.sql`: actualiza una base vieja sin borrar datos. +- `database/seed_admin_demo.php`: carga datos de prueba para desarrollo o demostracion. + +## Roles del sistema + +### Administrador + +Gestiona usuarios, conductores, vehiculos, viajes, reportes, soporte, backups y reportes gerenciales. + +### Conductor + +Administra su perfil, vehiculos, viajes publicados, pasajeros y reportes posteriores al viaje. + +### Pasajero + +Busca viajes, reserva pasajes, confirma llegada, califica conductores y puede reportar problemas. + +## Backups y recuperacion ante desastres + +Desde el panel administrador se puede descargar: + +- Backup SQL de la base de datos. +- Paquete de recuperacion con: + - SQL + - `README_RESTAURACION.txt` + - `MANIFEST.txt` + - `config/database.example.php` + - `config/app.example.php` + - `.env.example` + +Para restaurar el sistema desde cero se necesita: + +1. Codigo fuente del proyecto. +2. Base de datos o backup SQL. +3. Archivos de configuracion. +4. Archivos subidos por usuarios si existieran fuera de la base. +5. Entorno XAMPP o equivalente. + +## Documentacion adicional + +La documentacion completa esta en la carpeta `docs/`: + +- [Manual de desarrollo](docs/MANUAL_DESARROLLO.md) +- [Manual de usuario por perfiles](docs/MANUAL_USUARIO.md) +- [Manual administrativo](docs/MANUAL_ADMIN.md) +- [Recuperacion ante desastres](docs/RECUPERACION_ANTE_DESASTRES.md) + +## Mantenimiento + +Antes de hacer cambios importantes se recomienda: + +1. Exportar SQL desde el panel. +2. Exportar paquete de recuperacion. +3. Guardar una copia del proyecto. +4. Probar login, reservas, reportes y panel admin despues de modificar el sistema.