Subir archivos a "/"

2026-06-23 23:35:06 +00:00
commit 7d881e8b7e
1 changed files with 164 additions and 0 deletions
@@ -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.