From 2da2933bb3d287254999854e7e5d3c38a965255c Mon Sep 17 00:00:00 2001 From: Brisa Date: Tue, 30 Jun 2026 16:01:52 -0300 Subject: [PATCH] actualizar gitignore y readme --- .gitignore | 3 +- readme.md | 170 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 172 insertions(+), 1 deletion(-) create mode 100644 readme.md diff --git a/.gitignore b/.gitignore index 5c9c564..5bbb41e 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,3 @@ # Configuración local y credenciales -config.php \ No newline at end of file +config.php +logs-sistema-lapecosa/ diff --git a/readme.md b/readme.md new file mode 100644 index 0000000..0d77508 --- /dev/null +++ b/readme.md @@ -0,0 +1,170 @@ +# Sistema Web - La Pecosa Rotisería + +Sistema web para la rotisería **La Pecosa** (Paraná, Entre Ríos). El proyecto está compuesto por un sitio público donde los clientes pueden ver el catálogo de productos y armar un pedido, y un panel de administración para la gestión interna del negocio (productos, categorías, pedidos y copias de seguridad). + +## Tecnologías + +- **Backend:** PHP 8.x +- **Base de datos:** MySQL / MariaDB +- **Frontend:** HTML5, CSS3 y JavaScript +- **Servidor de desarrollo:** Apache (XAMPP, WampServer o Laragon) +- **Control de versiones:** Git + +## Estructura del proyecto + +``` +pecosa/ +├── index.php Página principal del sitio público +├── productos.php Catálogo de productos y armado del pedido +├── carrito.php Carrito de compras +├── gestionar_carrito.php Lógica para agregar, quitar y actualizar ítems del carrito +├── formulario_entrega.php Datos de entrega del pedido +├── procesar_pago.php Procesamiento del pago / confirmación del pedido +├── verificar_promo.php Validación de promociones existentes (duración 24hs) +├── login.php Inicio de sesión de usuarios +├── registro.php Registro de nuevos usuarios +├── recuperar_contraseña.php Recuperación de contraseña +├── logout.php Cierre de sesión +├── captcha.php Generación del captcha de seguridad +├── ayuda.php Página de ayuda del sitio público +├── privacidad.php Política de privacidad +├── consultar_bot.php Endpoint del asistente virtual / chatbot +├── importar_csv.php Importación de productos desde CSV +├── productos.csv Archivo de ejemplo para la carga masiva de productos +├── script.js Lógica de interfaz del sitio (carrito, slider, etc.) +├── diseño.css Estilos generales del sitio público +├── db.php Conexión a la base de datos +├── config_example.php Plantilla de configuración (copiar a config.php) +├── config.php Configuración real (no se versiona) +├── css Archivos descargados en la carpeta .zip de font awesome + ├── all.min.css + ├── ... el resto de archivos descargados en la carpeta .zip de font awesome +├── webfonts Archivos descargados en la carpeta .zip de font awesome +│ +├── admin/ Panel de administración +│ ├── dashboard.php Tablero principal del panel +│ ├── sidebar.php Menú lateral del panel +│ ├── inventario.php Gestión de productos y stock +│ ├── pedidos.php Listado y seguimiento de pedidos +│ ├── cambiar_estado.php Actualización del estado de un pedido +│ ├── procesar_manual.php Carga manual de pedidos +│ ├── ver_detalle.php Detalle de un pedido +│ ├── obtener_detalle.php Consulta de datos de un pedido +│ ├── imprimir_ticket.php Generación del ticket de un pedido +│ ├── buscar_clientes.php Búsqueda de clientes en sección Pedidos activos +│ ├── promo.php Gestión de promociones +│ ├── chart.js Archivo para generación de tablas de artículos más vendidos +│ ├── importar_csv.php Importación de productos desde CSV (admin) +│ ├── asistente.php Configuración del asistente virtual +│ ├── ayuda_admin.php Ayuda del panel de administración +│ ├── backup.php Generación de copias de seguridad +│ ├── descargar_file.php Descarga de archivos y respaldos +│ ├── admin_style.css Estilos del panel de administración +│ ├── backups_files/ Copias de seguridad de la base de datos (.zip) +│ └── comprobantes/ Comprobantes generados por el sistema +│ +├── imagenes/ Recursos gráficos del sitio (logo, banners, etc.) +├── img/ Imágenes de productos +├── logs-sistema-lapecosa/ Registros de actividad del sistema +└── README.md +``` + +## Requisitos previos + +Antes de comenzar, asegúrate de tener instalado en tu entorno local: + +- Un servidor local con soporte para PHP 8.x y MySQL/MariaDB (XAMPP, WampServer o Laragon). +- Git. +- Un editor de código (por ejemplo, Visual Studio Code). + +## 1. Clonar el proyecto + +Abre la terminal (o Git Bash) en la carpeta pública de tu servidor local y ejecuta: + +```bash +git clone https://github.com/brisagarcia03/Proyecto-TI.git pecosa +``` + +Reemplaza la URL por la de tu repositorio. Luego ingresa a la carpeta del proyecto: + +```bash +cd pecosa +``` + +## 2. Configuración de la conexión + +El proyecto incluye un archivo de ejemplo con la configuración de la base de datos. Para activarlo: + +1. Ubica el archivo `config_example.php` en la raíz del proyecto. +2. Haz una copia y renómbrala como `config.php`. +3. Abre `config.php` con tu editor y completa los datos de tu servidor local: + +```php +