Below is a Markdown README you can adaptar y pegar en tu repo (puedes cambiar el nombre del repo según corresponda).
Xoco Suite — Plataforma para Restaurantes Regulados
EN · SaaS platform for restaurants and food businesses (except coffee shops), focused on operations, compliance and guest experience.
ES · Plataforma SaaS para restaurantes y giros de alimentos (excepto cafeterías), enfocada en operación, cumplimiento y experiencia de cliente.
EN
Xoco Suite is a complete software suite for restaurants and food businesses in LATAM that combines three core products:
- Xoco POS: Operational point‑of‑sale and back‑of‑house flows.
- Advanced POS Metrics: Analytics, dashboards and a dedicated compliance panel.
- Xoco Client App: Web app for guests to browse, order and book reservations.
The suite is designed with a strong focus on regulatory compliance (COFEPRIS‑oriented for Mexico), data protection (AES‑GCM + GDPR‑inspired practices) and a modern UX that works in both mobile and desktop.
ES
Xoco Suite es una suite de software para restaurantes y negocios de alimentos en LATAM que integra tres productos principales:
- Xoco POS: Punto de venta operativo y flujos de back‑of‑house.
- Métricas avanzadas del POS: Analítica, dashboards y panel dedicado a cumplimiento.
- App Cliente Xoco: Aplicación web para que los comensales exploren, hagan pedidos y reservaciones.
La suite está diseñada con un enfoque fuerte en cumplimiento regulatorio (alineado a COFEPRIS en México), protección de datos (AES‑GCM + prácticas inspiradas en GDPR) y una UX moderna tanto en móvil como en escritorio.
EN
Xoco POS is the operational core of the suite, tailored for restaurant workflows:
- Order taking, ticket handling and preparation flows in real time.
- Role‑based access (admin, cashier, kitchen, etc.).
- Basic inventory management and stock alerts.
- Multiple payment methods and tipping flows.
- Loyalty program integration using QR codes (customer ID).
ES
Xoco POS es el núcleo operativo de la suite, pensado para flujos de restaurante:
- Toma de orden, manejo de tickets y flujo de preparación en tiempo real.
- Accesos por rol (admin, caja, cocina, etc.).
- Inventario básico y alertas de stock.
- Múltiples métodos de pago y manejo de propinas.
- Integración con programa de lealtad mediante códigos QR (ID del cliente).
EN
The advanced metrics module extends the POS with analytics and a compliance‑oriented view:
- Dashboards for sales, product performance, peak hours and prep times.
- Exportable reports (e.g. CSV/Excel) for audits and internal reviews.
- A COFEPRIS‑oriented panel to help track hygiene, pests, food inventory handling and waste logs over time.
ES
El módulo de métricas avanzadas extiende el POS con analítica y una vista orientada a cumplimiento:
- Dashboards de ventas, desempeño por producto, horas pico y tiempos de preparación.
- Reportes exportables (p. ej., CSV/Excel) para auditorías y revisiones internas.
- Un panel orientado a COFEPRIS para ayudar a registrar higiene, plagas, manejo de inventario alimentario y bitácoras de residuos a lo largo del tiempo.
EN
The client‑facing application lets guests interact directly with the restaurant:
- Two optimized versions: mobile (with guided navigation) and desktop.
- Browsing of menu and experiences.
- Creation of orders and reservations from the app.
- Ability to share orders/reservations via any messaging app or download them.
ES
La aplicación de cara al cliente permite a los comensales interactuar directamente con el restaurante:
- Dos versiones optimizadas: móvil (con navegación guiada) y escritorio.
- Exploración de menú y experiencias.
- Creación de pedidos y reservaciones desde la app.
- Posibilidad de compartir pedidos/reservas por cualquier app de mensajería o descargarlos.
Plan Básico — Solo POS
EN
- Full access to Xoco POS.
- Order and ticket flows.
- Role‑based access for staff.
- Basic inventory and stock alerts.
- Loyalty program through customer QR IDs.
ES
- Acceso completo a Xoco POS.
- Flujos de órdenes y tickets.
- Accesos por rol para el staff.
- Inventario básico y alertas de stock.
- Programa de lealtad mediante QR de ID de cliente.
Plan Premium — POS + Métricas + App Cliente
EN
Includes everything in the Basic plan, plus:
- Advanced POS Metrics dashboards.
- COFEPRIS‑oriented compliance panel (hygiene, pests, food handling, waste logs, monthly views, exportable reports).
- Full Xoco Client App (mobile + desktop) for orders and reservations.
- Support for three QR types:
- Customer ID (loyalty program).
- Orders/tickets (products and tips).
- Reservations created from the client app.
ES
Incluye todo lo del plan Básico, más:
- Dashboards de métricas avanzadas del POS.
- Panel de cumplimiento orientado a COFEPRIS (higiene, plagas, manejo de alimentos, bitácoras de residuos, vistas mensuales, reportes exportables).
- App Cliente Xoco completa (móvil + escritorio) para pedidos y reservaciones.
- Soporte para tres tipos de QR:
- ID de cliente (programa de lealtad).
- Pedidos/tickets (productos y propinas).
- Reservaciones generadas desde la app de cliente.
EN
- Sensitive user data in the client app is encrypted using the AES‑GCM algorithm.
- Decryption is only possible with keys derived from staff credentials, minimizing exposure of personal data.
ES
- Los datos sensibles de usuarios en la app de cliente se cifran con el algoritmo AES‑GCM.
- El descifrado solo es posible con llaves derivadas de credenciales del staff, minimizando la exposición de datos personales.
EN
- Data management is inspired by GDPR principles: consent, purpose limitation, and retention policies.
- Infrastructure is prepared to support automatic cleanup for inactive users and controlled data export when needed.
ES
- La gestión de datos está inspirada en principios de GDPR: consentimiento, limitación de propósito y políticas de retención.
- La infraestructura está preparada para soportar limpieza automática de usuarios inactivos y exportación controlada de datos cuando sea necesario.
EN
- The POS and metrics module are being developed with Mexican COFEPRIS requirements in mind, especially for food handling and traceability.
- The compliance panel is designed to help restaurants centralize records of hygiene controls, pest management, food inventory and waste logs.
ES
- El POS y el módulo de métricas se están desarrollando teniendo en cuenta los requerimientos de COFEPRIS en México, especialmente para manejo y trazabilidad de alimentos.
- El panel de cumplimiento está diseñado para ayudar a los restaurantes a centralizar registros de controles de higiene, manejo de plagas, inventario alimentario y bitácoras de residuos.
EN
Xoco Suite supports three main types of QR codes:
- Customer ID QR: for loyalty and customer recognition.
- Order/Ticket QR: encodes products, amounts and tips.
- Reservation QR: generated from the client app when a guest books a table.
These QRs allow seamless communication between guest devices and the POS, making it easier to track orders, reservations and loyalty events.
ES
Xoco Suite soporta tres tipos principales de códigos QR:
- QR de ID de cliente: para lealtad y reconocimiento del cliente.
- QR de pedido/ticket: codifica productos, montos y propinas.
- QR de reservación: generado desde la app de cliente cuando el comensal reserva una mesa.
Estos QR permiten una comunicación fluida entre los dispositivos de los clientes y el POS, facilitando el tracking de pedidos, reservaciones y eventos de lealtad.
EN
The UI is built on top of a Tailwind CSS configuration that defines:
- Primary color palette:
primary.100–900(coffee‑toned browns) as brand colors. - State colors:
success,info,warning,dangerfor semantic feedback. - Gradients: several dark gradients for hero sections and highlights.
- Typography:
Latoas the main sans‑serif font, with optimized styles for headings, body text and code blocks.
ES
La UI se construye sobre una configuración de Tailwind CSS que define:
- Paleta primaria:
primary.100–900(tonos café) como colores de marca. - Colores de estado:
success,info,warning,dangerpara feedback semántico. - Gradientes: varios gradientes oscuros para secciones hero y elementos destacados.
- Tipografía:
Latocomo fuente sans‑serif principal, con estilos optimizados para encabezados, cuerpo de texto y bloques de código.
EN
If you are interested in testing Xoco Suite in your restaurant or food business, we can work on:
- Pilot implementations in a single location.
- Custom metric dashboards.
- Payment and loyalty integrations.
ES
Si te interesa probar Xoco Suite en tu restaurante o negocio de alimentos, podemos trabajar en:
- Implementaciones piloto en una sola sede.
- Dashboards de métricas personalizados.
- Integraciones de pagos y lealtad.
EN
Xoco Suite is developed and maintained by Donovan Riaño.
- Portfolio / Studio: link to your studio site
- Telegram:
t.me/driano7 - LinkedIn: linkedin.com/in/driano7
ES
Xoco Suite es desarrollado y mantenido por Donovan Riaño.
- Portafolio / Studio: enlace a tu sitio de estudio
- Telegram:
t.me/driano7 - LinkedIn: linkedin.com/in/driano7
Feel free to adapt this README: add installation steps, environment variables, deployment instructions or screenshots as the project evolves.
Fuentes