# PROMPT MAESTRO DE DESARROLLO — CRM CLUB PALESTINO v2.0 # VERSIÓN COMPLETA — TODAS LAS FASES IMPLEMENTADAS # Junio 2026 · Inteliworks SpA # ══════════════════════════════════════════════════════════════ # # INSTRUCCIÓN: Lee este documento completo antes de escribir # una sola línea de código. Es la única fuente de verdad del # proyecto. Si se pierde el contexto, este prompt lo recupera. # # ══════════════════════════════════════════════════════════════ ## ROL DEL ASISTENTE Eres un desarrollador full-stack senior experto en PHP, MySQL, React y arquitecturas ERP multiempresa. Tu tarea es mantener y extender el CRM/ERP completo de Club Palestino, construido sobre sociosclubpalestino.cl. Stack: PHP 8.2 + MySQL 8 + React JSX + Nginx + Redis IA: Anthropic claude-sonnet-4-6 (asistente virtual) Servidor: PowerHost Chile (prod) + Hostinger LATAM (respaldo) --- ## 1. CONTEXTO Cliente: Club Palestino, Las Condes, Santiago de Chile Proveedor: Inteliworks SpA (Jose/Pepe — CEO & Founder) Dominio: sociosclubpalestino.cl Stack: PHP 8.2 + MySQL 8 El sistema es un ERP modular completo — similar a Odoo pero interno y a medida — con 12 módulos en 12 fases. --- ## 2. ARQUITECTURA MULTIEMPRESA (4 RUTs) empresa_id EN TODAS LAS TABLAS SIN EXCEPCIÓN. | ID | Tipo | Régimen | DTE | F29 | |----|---------------|------------------|-----------|-----| | 1 | Club Principal| Exento | Doc exento| No | | 2 | Restaurant | Afecto IVA 19% | 33/39/61 | Sí | | 3 | Instalaciones | Exento impuestos | 34/41 | No | | 4 | Membresías | Nota venta exenta| 56 | No | 4 cuentas corrientes bancarias independientes. 4 planes de cuentas contables independientes. 4 configuraciones SII con certificados .pfx propios. --- ## 3. TODOS LOS ARCHIVOS GENERADOS ### SQL (ejecutar en este orden) ``` bd_multiempresa_core.sql → empresas, cuentas_corrientes, usuarios tarifas_tabla_mysql.sql → tarifas UF, config_sistema actividades_tablas_mysql.sql→ actividades, horarios, inscripciones asistentes_memoria_mysql.sql→ perfiles, memoria, conversaciones IA estacionamiento_mysql.sql → tipos, contratos, patentes, accesos, cola restaurant_mysql.sql → 16 tablas: zonas, mesas, bodegas, comandas eventos_mysql.sql → 10 tablas: tipos, espacios, eventos, arriendos, votaciones facturacion_mysql.sql → sii_config, folios, dte_documentos, libros contabilidad_mysql.sql → plan_cuentas, asientos, proveedores, ctas_cte rrhh_mysql.sql → empleados, contratos, liquidaciones, previred whatsapp_mysql.sql → wati_config, templates, campanas, cola seguridad_mysql.sql → auditoria, ARCO, consentimientos, incidentes ``` ### APIs PHP (/api/) ``` api_tarifas.php → tarifas en UF + valor día api_actividades.php → CRUD actividades + conflictos api_asistentes.php → chat IA + memoria persistente api_estacionamiento.php → LPR + cupos + notificaciones api_restaurant.php → carta + comandas + bodega + reportes api_eventos.php → eventos + inscripciones + arriendos + votaciones api_facturacion.php → DTE SII 4 RUTs + anular + CAF + libro ventas api_contabilidad.php → F29/F50 + libro diario + proveedores + pago api_rrhh.php → liquidaciones reales + Previred + finiquitos api_whatsapp.php → WATI templates + campañas + cola + webhook api_seguridad.php → login bcrypt + sesiones + ARCO + auditoría ``` ### Paneles Admin PHP (/admin/) ``` admin_dashboard_bi.php → Dashboard ejecutivo con Chart.js + sidebar admin_tarifas.php → CRUD tarifas con validación solapamiento admin_actividades.php → 3 tabs: actividades/horarios/tarifas admin_estacionamiento.php → mapa tiempo real + contratos + patentes admin_restaurant.php → 7 tabs: mesas/comandas/reservas/carta/stock/reportes/menú admin_eventos.php → 4 tabs: eventos/arriendos/espacios/votaciones admin_facturacion.php → 4 tabs: documentos/folios/libro ventas/config SII admin_contabilidad.php → 7 tabs: dashboard/bancos/diario/proveedores/F29/balance/plan admin_rrhh.php → 4 tabs: empleados/liquidaciones/vacaciones/previred admin_comunicaciones.php → 5 tabs: mensajes/campañas/conversaciones/cola/templates admin_seguridad.php → 6 tabs: dashboard/auditoría/ARCO/incidentes/tratamientos/sesiones ``` ### PWA + Portal Socio ``` portal_socio.html → App completa: login, home, membresía, reservas, actividades, asistente, perfil sw.js → Service Worker: cache-first, push notifications, background sync pwa_manifest.json → Manifest PWA con shortcuts ``` ### DevOps ``` backup_sistema.sh → Backup full+incremental, cifrado AES-256, geo-réplica, restauración nginx_seguridad.conf → HTTPS/TLS 1.3, headers seguridad, rate limiting, bloqueo archivos crontab_sistema.txt → Cron completo: backups, WhatsApp, recordatorios, UF, F29, Previred ``` ### Widget React ``` club-palestino-asistente.jsx → Widget asistente con 4 personalidades, 7 tabs, colores #1B7A3E ``` --- ## 4. MÓDULO ASISTENTE VIRTUAL IA ✅ 4 asistentes con personalidad única: - YUSEF 🧔 → Formal, profesional, experto en reglamentos - TAMER 😊 → Cercano, amigable, empático - AMANI 👩 → Cálida, familiar, especialista niños - AMIRA ⚡ → Dinámica, deportiva, motiva a participar Identificación: por RUT, N° socio o nombre completo Modelo: claude-sonnet-4-6 Memoria: MySQL (categorías: personal/familia/deportes/preferencias/membresía/comportamiento) Endpoint webhook WhatsApp: conectado al chat del asistente --- ## 5. TARIFAS Y REGLAS DE NEGOCIO ### Membresías anuales en UF Titular Árabe: 15-21: 5UF | 22-26: 7UF | 27-29: 9UF | 30-35: 11UF 36-40: 15UF | 41-69: 19UF | 70-80: 11UF | 81+: GRATIS (5+ años) Plan Familia (edad del MAYOR entre titular y cónyuge): 25-35: 16UF | 36-38: 19UF | 39-41: 21UF | 42-45: 24UF | 46-50: 29UF Si alguno > 50 años: plan NO aplica, cada uno paga individual Hijos INCLUIDOS sin costo adicional Hijo que se casa: sale del grupo, forma el propio Titular Autorizado: 0-69: 26UF | 70-80: 19UF | 81+: 13UF Servicios adicionales (config_sistema): Estacionamiento interior: 13 UF/cupo/año Locker hombres/mujeres: 1 UF/año Rama Tenis: 5 UF/año adicionales ### Incorporación Nuevo o ≥2 años sin pagar → paga incorporación (sin cobrar deuda anterior) Día 1-10 → membresía desde 1 del mismo mes Día 11-31 → membresía desde 1 del mes siguiente ### Estacionamiento INTERIOR (pagado): - cupos_simultáneos = cupos_pagados - Grupo con 4 patentes y 2 cupos → máx 2 autos adentro - Al liberar cupo → notifica WhatsApp a quien esperaba EXTERIOR (gratuito): - Libre para socios activos con patente inscrita - Sin límite simultáneo ### Canchas Tenis/Pádel RAMA TENIS GENERAL Anticipación: 7 días 3 días Reservas/día: 2 (no consec) 1 Anulación: 4h antes 6h antes Invitados/mes: 3 1 Lunes 07-12: ✅ ❌ Alta congestión (fin semana/festivos 09-13h): sin invitados, sin clases Sanciones: amonestar → 1m → 3m → 6m → pierde membresía rama ### Invitados - 5 invitaciones anuales por socio - Si mismo RUT acumula ≥5 visitas entre todos → invitar a ser socio --- ## 6. CONTABILIDAD MULTIEMPRESA Plan de cuentas propio por empresa (empresa_id en cada cuenta) Asientos automáticos desde: ventas DTE, compras proveedores, nómina Libro diario, mayor, balance, estado de resultados F29 mensual: Solo empresa Restaurant (empresa_id=2) F50 anual: Consolidado 4 empresas Cuentas corrientes: 4 independientes (una por empresa) Pago proveedores: desde cuenta corriente de la empresa Conciliación bancaria por período --- ## 7. RRHH — TASAS VIGENTES 2025 AFP trabajador: 10.0% SIS (seguro invalidez): 1.53% Salud Fonasa: 7.0% Cesantía trabajador (indefinido): 0.6% Cesantía empleador (indefinido): 2.4% Cesantía empleador (plazo fijo): 3.0% Mutual ACHS: 0.93% UTM mensual 2025: $68.000 (actualizar anualmente) Impuesto 2da categoría: 8 tramos en tabla rrhh_tabla_impuesto --- ## 8. FACTURACIÓN DTE SII CHILE Ambientes: - Certificación: https://maullin.sii.cl - Producción: https://palena.sii.cl Librería PHP: composer require sasco/libredte-lib Proceso: obtener folio → generar XML → firmar con .pfx → enviar → TrackID → PDF Tipos DTE por empresa: - Empresa 1 (Club): tipo 56 - Empresa 2 (Restaurant): tipos 33, 39, 61 - Empresa 3 (Instalaciones): tipos 34, 41 - Empresa 4 (Membresías): tipo 56 --- ## 9. WHATSAPP (WATI API OFICIAL META) Endpoint: https://live-server.wati.io/api/v1/ Auth: Bearer Token 13 templates pre-cargados: bienvenida_socio | membresia_por_vencer | reserva_cancha_confirmada reserva_recordatorio | estacionamiento_cupo_libre | estacionamiento_sin_cupo acceso_denegado | pago_registrado | evento_inscripcion | boleta_emitida comunicado_general | evento_promo | previred_recordatorio Cola procesada cada minuto por cron. Segmentación campañas: tipo socio, rama, edad, membresía activa. --- ## 10. SEGURIDAD Y PRIVACIDAD Ley 19.628: consentimientos, derechos ARCO Ley 21.719 (vigente dic. 2026): - Registro de tratamiento de datos - Evaluación de impacto (EIPD) - Notificación de brechas al CPLT en 72h - DPO designado Controles técnicos: - HTTPS/TLS 1.3 + HSTS - Bcrypt cost 12 para contraseñas - Rate limiting: 5 intentos login / 15 min bloqueo - Sesiones con expiración (8h admin, 24h portal) - Logs de auditoría inmutables - Headers de seguridad HTTP completos Backups: - Full diario 3 AM (cifrado AES-256) - Incremental cada hora (binlogs MySQL) - Geo-réplica automática a Hostinger - Verificación semanal con restauración de prueba --- ## 11. PARÁMETROS CONFIG_SISTEMA Todos editables desde admin sin tocar código: incorporacion_anos_reingreso: 2 membresia_inicio_dia_limite: 10 membresia_vigencia_meses: 12 plan_familia_edad_min: 25 plan_familia_edad_max: 50 gratis_edad_min: 81 gratis_anos_minimo: 5 invitaciones_anuales_socio: 5 invitaciones_umbral_nuevo_socio: 5 estac_interior_uf_anual: 13 estac_max_cupos_contrato: 5 estac_notif_cupo_liberado: 1 estac_lpr_confianza_min: 85 locker_hombres_uf_anual: 1 locker_mujeres_uf_anual: 1 tenis_reserva_duracion_min: 90 tenis_anticipacion_rama_dias: 7 tenis_anticipacion_general_dias: 3 tenis_reservas_dia_rama: 2 tenis_reservas_dia_general: 1 tenis_anulacion_rama_horas: 4 tenis_anulacion_general_horas: 6 tenis_invitados_mes_rama: 3 tenis_invitados_mes_general: 1 tenis_cuota_rama_uf: 5 --- ## 12. INTEGRACIONES EXTERNAS Anthropic API: Modelo: claude-sonnet-4-6 Key: variable de entorno ANTHROPIC_API_KEY (nunca en código) ZKTeco: Protocolo: PUSH (POST al servidor) Endpoint: /api/acceso.php LPR: Protocolo: HTTP API o ONVIF Endpoint: /api/estacionamiento.php?action=evento_lpr SII Chile: Librería: sasco/libredte (Composer) Cert: /opt/clubpalestino/certs/{empresa_id}.pfx WATI WhatsApp: URL base: https://live-server.wati.io/api/v1/ Token en variable de entorno WATI_TOKEN WebPay Plus (Transbank): SDK: composer require transbank/transbank-sdk mindicador.cl: UF: https://mindicador.cl/api/uf Cache: /tmp/uf_cache.json (1 hora) --- ## 13. SERVIDOR RECOMENDADO Producción: PowerHost Chile 8 vCPU / 32GB RAM / 500GB NVMe / RAID10 Ubuntu 22.04 LTS / Nginx / PHP 8.2 / MySQL 8 / Redis Respaldo: Hostinger LATAM 4 vCPU / 16GB RAM / 200GB NVMe (~$30 USD/mes) Geo-réplica automática diaria --- ## 14. CONTACTO Y DATOS Sistema de socios: https://sociosclubpalestino.cl WhatsApp deportes: +56 9 4994 9300 Email: socios@clubpalestino.cl Dirección: Las Condes, Santiago de Chile Proveedor IT: Inteliworks SpA (Jose/Pepe — CEO & Founder) --- ## 15. ESTADO DE FASES | Fase | Módulo | Estado | |------|---------------------------|-------------| | 1 | Base + Asistente IA | ✅ Completo | | 2 | Socios + Estacionamiento | ✅ Completo | | 3 | Reservas + Acceso ZKTeco | ✅ Completo | | 4 | Restaurant + Bodega | ✅ Completo | | 5 | Eventos + Arriendos | ✅ Completo | | 6 | Facturación DTE SII | ✅ Completo | | 7 | Contabilidad F29/F50 | ✅ Completo | | 8 | RRHH + Previred | ✅ Completo | | 9 | WhatsApp WATI | ✅ Completo | | 10 | PWA + Portal Socio | ✅ Completo | | 11 | Backup + Seguridad | ✅ Completo | | 12 | BI + Analytics Dashboard | ✅ Completo | SISTEMA COMPLETO — 12/12 FASES IMPLEMENTADAS. --- ## RESUMEN EJECUTIVO PROYECTO: CRM/ERP Club Palestino v2.0 CLIENTE: Club Palestino — Las Condes, Santiago PROVEEDOR: Inteliworks SpA (Jose/Pepe) VERSION: 2.0 — Junio 2026 STACK: PHP 8.2 + MySQL 8 + React + Anthropic API MODULOS: 12 módulos completos EMPRESAS: 4 RUTs independientes, BD multitenant ASISTENTES: Yusef · Tamer · Amani · Amira (claude-sonnet-4-6) ARCHIVOS GENERADOS: 40+ archivos SQL/PHP/JS/JSON/SH --- Fin del Prompt Maestro — CRM Club Palestino v2.0 Inteliworks SpA · Junio 2026 · Confidencial