Convención para el uso de la carpeta archivos_locales_no_git, destinada a archivos de trabajo, datos exportados y recursos temporales que no deben subirse al repositorio.

2026-05-182

cacomi-daily-content

LuisDavidTF/Cacomi

Protocol for daily updates to the recommended menu and other periodic content. Trigger: When the user requests a "daily menu update" or modifies `astro_src/constants/recommendedMenu.ts`.

2026-05-152

cacomi-offline

LuisDavidTF/Cacomi

Standards and strategies for offline capabilities, network detection, and caching fallback in Cacomi.

2026-05-152

legal-compliance

LuisDavidTF/Cacomi

Ensures application changes comply with Terms & Conditions, Privacy Policy (GDPR/ARCO), and data protection standards. Trigger: Before merging PRs, when modifying data storage (db/cookies), or adding user-facing disclaimers.

2026-05-012

cacomi-git

LuisDavidTF/Cacomi

Git workflow standards, conventional commits, and Pull Request management. Trigger: When creating commits, writing PR descriptions, managing branches, or verifying code before push (CI simulation).

2026-04-292

name	cacomi-admin
description	Estándares y patrones de seguridad, integración con Koyeb, Recharts y moderación para el Panel de Administrador.

Cacomi - Admin Panel Standards

Este skill define los lineamientos estrictos y seguros que deben seguirse al desarrollar cualquier característica del Panel de Administrador de Cacomi.

1. Seguridad de Datos Sensibles y Roles

Acceso Restricto: El panel es exclusivo para el rol de ADMIN.
Admin Token de Corta Duración: Debido a la sensibilidad de los datos, NO se recomendará usar indefinidamente el JWT normal. Se debe implementar (en colaboración con el backend) un flujo donde el administrador solicite una "Elevación de Privilegios" que devuelva un Token de Administrador de muy corta duración (ej. 15-30 minutos).
Protección de Rutas: Todas las rutas dentro de /admin/* deben estar protegidas en Astro mediante Middleware y en React mediante un AdminGuard.
Cero Exposición de Credenciales: NUNCA exponer API Keys de servicios externos (como Koyeb) en el frontend.

2. Observabilidad e Integración con Koyeb

Arquitectura de Proxy: El frontend NO debe conectarse directamente a la API de Koyeb. El backend en Java será el encargado de comunicarse con Koyeb (haciendo uso de la Koyeb API REST: /v1/streams/logs/query o tail) e inyectar su API Key.
Visualizador de Logs: Crear un componente de UI similar a una terminal, que consuma los logs desde el backend proxy (/api/admin/sys/logs) y permita autoscroll, filtrado y pausa.
Métricas de Sistema (CPU/RAM): Consumir métricas desde Koyeb a través de nuestro backend y mostrarlas gráficamente.

3. Visualización de Datos con Recharts

Librería Estándar: Usar recharts para las gráficas del dashboard (uso de servidor, estadísticas de usuarios, reportes).
Diseño Premium: Las gráficas deben respetar la paleta de colores de Cacomi (tailwind 4), soportar Dark/Light mode automáticos, y poseer tooltips interactivos y animaciones fluidas (ease-in-out).

4. Gestión de Jobs (Tareas en Segundo Plano)

Control Total: Proveer una interfaz para visualizar los Jobs del backend (ej. limpieza de BD, envío de correos).
Acciones Rápidas: Incluir botones para:
- Disparar manualmente (Run Now)
- Detener/Cancelar ejecución (Stop)
- Activar/Desactivar programación (Toggle Schedule)
Feedback en Tiempo Real: Mostrar el estado último del Job (Éxito, Fallo, En progreso) con badges visuales.

5. Moderación de Contenido y Gestión de Usuarios

Reportes de Usuarios: Panel para analizar los tickets o reportes de uso inadecuado.
Acciones Destructivas: Posibilidad para eliminar usuarios, sus recetas o cualquier contenido. Toda acción de eliminación debe estar precedida de un AlertDialog (Double Confirmation) porque las acciones son de gran impacto legal y de base de datos.
Logs de Auditoría: Toda acción del administrador se asume registrada en el backend.

6. Internacionalización (i18n)

Al igual que en la app normal, TODOS los textos del panel de admin deben venir de nuestro diccionario global (SettingsContext o traducciones de Astro). NO hardcodear textos.