Subir archivos a "/"
This commit is contained in:
@@ -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.
|
||||||
Reference in New Issue
Block a user