PHP/Laravel PROJECT_CONTEXT.md

PROJECT_CONTEXT.md

Contexto Específico del Proyecto: Nombre del Proyecto

Proyecto: Nombre del Sistema Versión: 1.0.0 Creación: aaaa-mm-dd hh:mm Actualización: aaaa-mm-dd hh:mm

🚀 Stack Tecnológico del Proyecto

• Laravel: 12.x
• Livewire: 3.x
• Tailwind CSS: 4.x (mobile-first obligatorio)
• Alpine.js: 3.x
• Vue.js: 3.x (solo para componentes complejos)
• Base de datos: MySQL con UUIDv7
• Cache/Colas: Redis
• PHP: 8.4+ - 9.x

📊 Planes o Servicios de Monetización

Plan	Precio	Descripción
PlanA	$a-b/mes	Descripción PlanA
PlanB	$c-d/mes	Descripción PlanB
PlanX	$e-f/mes	Descripción PlanC

🏗️ Modelo de Datos Específico

• Backed Enums: Usar TINYINT UNSIGNED para todos los enums respaldados
• Estructuras JSON: Para configuraciones flexibles
• Relaciones polimórficas: Para manejar diferentes tipos de vínculos.
• Auditoría completa: created_by, updated_by, deleted_by

🔄 Integración de Datos Externos

• Vademecum:
• Otros Datos
• Sincronización: Jobs programados cada 1 hora

⚡ Estrategia de Tiempo Real

• Sólo para aquellos servicios que requieran actualizaciones en tiempo real.
• Mensajería/Eventos: WebSockets (500+ usuarios concurrentes)
• Notificaciones: Push y email para noticias, recordatorios y otros.

🤝 Sistema Social y Engagement

Sistema de amigos: Solicitudes, aceptación, bloqueo
Reviews: pacientes a médicos
Reviews: médicos a medicamentos / laboratorios farmacológicos
otros

👑 Plan Corporativo (White-label)

• Subdominio personalizado: cliente.tuquiniela.com
• Personalización: Logo, colores, nombre
• CMS básico: Noticias
• Multi-local: Gestión de varias sucursales/consultorios
• API access: Para integraciones personalizadas

📱 Mobile-First Obligatorio

• Todas las vistas deben ser responsive
• Componentes Touch-friendly
• PWA capabilities (instalable como app)
• Offline support para mensajería, consultas o cualesquiera otros requerimientos.

💳 Sistema de Pagos (Evolutivo)

• Fase 1: Asignación manual desde admin
• Fase 2: Stripe + Laravel Cashier (internacional)
• Fase 3: Pasarelas locales (pagomóvil, etc.)
• Facturación: Automática para planes Corporativos

🗺️ Roadmap MVP (Marzo 2026)

1. Semana 1-2 (Mes yy-Mes xx): Descripción de lo que se hará en la etapa.
2. Semana 3-4 (Mes yy-Mes xx): Descripción de lo que se hará en la etapa.
3. Semana 5-6 (Mes yy-Mes xx): Descripción de lo que se hará en la etapa.
4. Semana 7-8 (Mes yy-Mes xx): Descripción de lo que se hará en la etapa.
5. Semana 9-10 (Mes yy-Mes xx): Descripción de lo que se hará en la etapa.
6. Semana 11-12 (Mes yy-Mes xx): Descripción de lo que se hará en la etapa.
7. Semana 13-14 (Mes yy-Mes xx): Descripción de lo que se hará en la etapa.
8. Semana 15-16 (Mes yy-Mes xx): Descripción de lo que se hará en la etapa.

🧪 Entornos

• Desarrollo: Con datos fake (seeders completos)
• Staging: Datos reales, solo lectura
• Producción: Datos reales + monitoreo

🔐 Seguridad Específica

• Validación de horarios
• Auditoría de cambios en citas
• Backup diario de citas/historias y cualesquiera otros datos serializados.

📅 Calendario Real del Proyecto:

Evento	Fecha
Desarrollo MVP	Febrero-Mayo 2026
Beta Pública	Mayo 2026
Lanzamiento Oficial	Junio 2026
Expansión nuevos servicios	Agosto-Diciembre 2026