👕 BarkiOS - Sistema de Gestión de Tienda de Ropa

📌 Tabla de Contenidos

• Descripción
• Características
• Tecnologías
• Instalación
• Estructura
• Uso
• API
• Despliegue
• Contribución
• Licencia

🌟 Descripción

BarkiOS es un sistema completo para la gestión de tiendas de ropa que incluye:

• 🛒 Plataforma de e-commerce
• 📦 Gestión de inventario
• 📊 Reportes de ventas
• 👥 Sistema de clientes y perfiles

🚀 Características

Módulo	Funcionalidades
Catálogo	Búsqueda avanzada, Filtros por talla/color, Wishlist
Inventario	Alertas de stock, Gestión de proveedores
Ventas	Carrito, Checkout, Historial de compras
Clientes	Registro, Autenticación, Direcciones

🛠️ Tecnologías

Backend: PHP 8.2 + Composer  
Frontend: Bootstrap 5 + Vanilla JS  
Base de datos: MySQL 8.0  
Infraestructura: Docker + Apache  
Herramientas: phpMyAdmin, Beekeeper Studio  

💻 Instalación

Requisitos

# Verificar instalación de Docker
docker --version
docker-compose --version

Pasos

1. Clonar repositorio
2. Configurar entorno:

   cp .env.example .env

3. Iniciar contenedores:

   docker-compose up -d --build

📂 Estructura del Proyecto

BarkiOS/  
├── app/  
│   ├── Controllers/  # Lógica de negocio  
│   ├── Models/       # Entidades de DB  
│   └── Views/        # Plantillas Twig  
├── config/           # Archivos de configuración  
├── public/           # Punto de entrada  
└── docker/           # Configuración de contenedores  

🖥️ Uso

Accesos después de instalación:

URL: http://localhost:8080  
phpMyAdmin: http://localhost:8000 (root/root)  

Comandos útiles:

# Ejecutar migraciones
docker-compose exec app php migrations.php

# Ver logs
docker-compose logs -f app

🌐 API Endpoints

GET    /api/products       - Listar productos  
POST   /api/cart          - Añadir al carrito  
GET    /api/orders        - Historial de pedidos  

🚢 Despliegue

1. Configurar dominio en .env
2. Optimizar autoload:

   composer dump-autoload -o

3. Configurar HTTPS

🤝 Contribución

1. Crear issue describiendo los cambios
2. Hacer fork y crear rama (feature/nueva-funcion)
3. Enviar Pull Request

📜 Licencia

MIT License - Ver LICENSE para detalles.

---

Documentación generada para el equipo de desarrollo BarkiOS

BarkiOS