Tul xxx Tul

Viewing: README.md

# Proyecto vCard con Catálogo Virtual

## Descripción
Sistema minimalista de vCard con catálogo virtual y panel administrativo, pensado para presentar servicios/productos, gestionar un catálogo y mantener coherencia visual con la marca.

## Características Principales
- [x] Página principal tipo vCard con hero, beneficios y catálogo
- [x] Catálogo de productos/servicios conectado a MySQL
- [x] Panel administrativo con dashboard y CRUD básico de productos
- [x] Integración visual de redes sociales y branding personalizado
- [x] Formulario de contacto (cliente) con validaciones básicas
- [x] Diseño responsive y minimalista basado en Bootstrap 5
- [ ] API pública (pendiente)
- [ ] Módulo de pruebas y optimización final

## Tecnologías
- Frontend: HTML5, CSS3, JavaScript (Vanilla), Bootstrap 5, Font Awesome
- Backend: PHP 8+
- Base de datos: MySQL (PDO)
- Herramientas adicionales: XAMPP / phpMyAdmin para entorno local

## Estructura del Proyecto
```
/landing/
├── admin/
│   ├── index.php           # Dashboard con métricas y tabla de productos
│   ├── login.php           # Autenticación
│   ├── products.php        # CRUD de productos
│   └── assets/...          # (pendiente) recursos del panel
├── assets/
│   └── images/             # Branding, placeholders y favicons
├── includes/
│   └── config.php          # Configuración de base de datos y constantes
├── database.sql            # Script de creación de tablas y datos de ejemplo
└── index.php               # vCard pública con catálogo y formulario
```

## Instalación
1. Clonar el repositorio
2. Configurar base de datos (ver `database.sql`)
3. Configurar credenciales en `includes/config.php`
4. Acceder a `http://localhost/vcard`

## Progreso
- [x] Estructura inicial del proyecto
- [x] Diseño de la vCard + branding
- [x] Sistema de autenticación (login con sesiones)
- [x] CRUD de productos desde el panel
- [ ] Sección pública de productos (maquetado final + datos reales)
- [x] Integración visual de redes sociales y branding
- [x] Formulario de contacto (registro local de mensajes)
- [x] API pública de productos (`/api/products.php`)
- [ ] Envío real de correos (pendiente: requiere SMTP/servicio externo)
- [ ] Pruebas y optimización

## Próximos Pasos
1. **Integrar servicio de correo real** (SMTP, SendGrid, Mailgun, etc.) y actualizar `contact_submit.php` para enviar notificaciones además de guardar en BD.
2. **Panel para mensajes de contacto**: vista en `admin/` que liste los mensajes almacenados (filtrar, marcar como atendidos, eliminar).
3. **Hardening y pruebas**: agregar validaciones adicionales, sanitizar contenido rico y cubrir flujos críticos con pruebas (PHPUnit, pruebas funcionales del panel).
4. **Documentar despliegue**: pasos para mover de localhost a hosting (config de `.env`, backups de BD, separación de entornos).
5. **Monitoreo/Logs**: implementar registro de errores centralizado y alertas básicas para detectar fallas en producción.

## QA Básico / Checklist Manual
1. **Landing**
   - Verificar que el catálogo muestre los productos activos (o el estado vacío si no hay).
   - Enviar el formulario de contacto con datos válidos y confirmar el mensaje de éxito.
   - Probar formularios con datos inválidos (email erróneo, campos vacíos) y validar mensajes de error.
2. **Panel Admin**
   - Iniciar sesión con el usuario administrador y confirmar acceso al dashboard.
   - Crear/editar/eliminar un producto y comprobar que se refleja en la tabla y en la landing.
3. **API Pública**
   - Consumir `GET /api/products.php` y validar que retorne JSON con `success=true` y lista de productos.
   - Probar parámetro `?limit=3` para verificar la paginación básica.

## Licencia
MIT
User / IP	: 216.73.217.33
Host / Server	: 45.84.207.204 / aircan.me
System	: Linux lt-bnk-web1726.main-hosting.eu 5.14.0-611.36.1.el9_7.x86_64 #1 SMP PREEMPT_DYNAMIC Tue Mar 3 11:23:52 EST 2026 x86_64