Skip to content

driano7/XocoCafe

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Logo Xoco Café

Xoco Café — Plataforma de Software y Marco de Negocio

Café de especialidad • Comercio Ético • Tecnología • Diseño


🌱 Descripción General

Xoco Café es un proyecto de café artesanal inspirado en la riqueza del café mexicano, con enfoque en sostenibilidad, diseño consciente y colaboración directa con productores locales. Situado en la Colonia Roma, Ciudad de México, el proyecto busca convertirse en un espacio cultural donde convergen calidad, comunidad, estética y comercio justo.


⭐ Propuesta de Valor

  1. Producto Diferenciado. Café de origen, de alta calidad y trazabilidad.
  2. Experiencia Sensorial y Estética. Marca refinada, menú curado y ambiente visualmente atractivo.
  3. Ética y Sostenibilidad. Comercio directo, abastecimiento responsable y operaciones transparentes.

🧱 Componentes del Proyecto

📊 Estudios e Investigación

  • Estudio financiero completo: costos iniciales, operativos y retorno proyectado.
  • Encuesta de hábitos de consumo y preferencias de menú.
  • Análisis de competencia de cafeterías en la Roma.
  • Visitas de campo y retroalimentación cualitativa.

📋 Documentación Organizacional

  • Contrato de responsabilidades.
  • Tabla de referencias legales.
  • Documentación de registro SAS.

🧾 Presupuestos

  • Presupuesto de apertura.
  • Costos operativos mensuales.
  • Proyección de ingresos por eventos.
  • Análisis de sensibilidad y escenarios óptimos.

⚙️ Operaciones y Calidad

  • Base de datos de proveedores.
  • Metodologías de control de calidad.
  • Plan de compras y abastecimiento.

💻 Sitio Web y Tecnologías

Sitio Oficial: https://xococafe.netlify.app

Tecnología Función
React.js Framework principal del front-end.
Netlify Plataforma de hosting y despliegue.
HTML5 / CSS3 Estructura y estilos base.
JavaScript ES6+ Interactividad del sitio.
Google Fonts Tipografía personalizada.
Animaciones Transiciones visuales suaves.
Diseño Responsive Experiencia optimizada en móviles.

✒️ Créditos

Equipo Fundador

  • Sergio Cortés.
  • Alejandro Galván.
  • Donovan Riaño.
  • Juan Aragón.

Desarrollo del Software

  • Desarrollador Principal: Donovan Riaño.
  • UI inicial basada y adaptada del repositorio: https://github.com/dlarroder/dalelarroder.
  • Funciones esenciales (login, reservas, flujos internos, lógica de preparación) desarrolladas por Donovan Riaño, con apoyo de herramientas de IA (Codex) y revisión manual completa.

📜 Licencia de Software — Apache License 2.0

El software de este repositorio es propiedad intelectual de Xoco Café.
Todo el código fuente, estructura y lógica del sistema fue desarrollado por:
Donovan Riaño (Desarrollador Principal).

Bajo la licencia Apache 2.0:

  • Debe mantenerse la atribución a Xoco Café.
  • Debe preservarse el crédito a Donovan Riaño como desarrollador principal.
  • Cualquier redistribución debe incluir la licencia Apache 2.0.
  • Se otorgan protecciones y derechos de patente conforme a la licencia.
  • Cualquier modificación realizada debe declararse explícitamente.

Consulta el archivo LICENSE para conocer todos los detalles legales.


Xoco Café Logo

Xoco Café — Software Platform & Business Framework

Specialty Coffee • Ethical Sourcing • Technology • Design


🌱 Overview

Xoco Café is an artisanal Mexican coffee project centered on sustainability, conscious design, and direct collaboration with coffee producers. Based in Colonia Roma, Mexico City, the project aims to become a cultural hub where quality, community, aesthetics, and fair trade converge.


⭐ Value Proposition

  1. Differentiated Product. High-quality, traceable origin coffee.
  2. Sensory & Aesthetic Experience. Curated menu, refined brand, and visually rich environment.
  3. Ethics & Sustainability. Direct trade, responsible sourcing, and transparent operations.

🧱 Project Components

📊 Research & Analysis

  • Full financial study: startup costs, operations, and projected ROI.
  • Consumer and menu survey conducted in the target district.
  • Competitive analysis of cafés in the Roma area.
  • Benchmark visits and qualitative field feedback.

📋 Organizational Documentation

  • Responsibilities agreement.
  • Legal references table.
  • SAS business registration documents.

🧾 Budgeting

  • Opening budget.
  • Monthly operational costs.
  • Projected revenue from events.
  • Sensitivity analysis and optimal budget calculations.

⚙️ Operations & Quality

  • Supplier database.
  • Quality control methodologies.
  • Procurement and supply chain plan.

💻 Website & Tech Stack

Official Website: https://xococafe.netlify.app

Technology Purpose
React.js Main front-end framework.
Netlify Deployment and hosting platform.
HTML5 / CSS3 Structure and base styling.
JavaScript ES6+ Website interactivity.
Google Fonts Typography customization.
Animations Smooth visual transitions.
Responsive Design Optimized mobile experience.

🧹 Data Retention Automation

  • Endpoint /api/cron/cleanup-inactive-users elimina cuentas y datos relacionados cuando un usuario lleva más de 12 meses sin autenticarse.
  • Protege el acceso usando el header x-cron-secret (configura CRON_SECRET en tu entorno). También acepta Authorization: Bearer <secret>.
  • Parámetros opcionales: days para ajustar el umbral de inactividad y limit para controlar el tamaño del lote por ejecución.
  • Ejemplo manual:
curl -X POST "https://tu-dominio.vercel.app/api/cron/cleanup-inactive-users?limit=50" \
  -H "x-cron-secret: $CRON_SECRET"

Programa este endpoint con Vercel Cron (o tu orquestador favorito) para ejecutarlo a diario y mantener limpia la base de datos.


✒️ Credits

Founding Team

  • Sergio Cortés.
  • Alejandro Galván.
  • Donovan Riaño.
  • Juan Aragón.

Software Development

  • Principal Developer: Donovan Riaño.
  • UI base originally forked and adapted from: https://github.com/dlarroder/dalelarroder.
  • Core system functionality (login, reservations, user flows, internal workflow, and preparation logic) developed by Donovan Riaño, with assistance from AI tools (Codex) and full manual review.

📜 Software License — Apache License 2.0

The software contained in this repository is the intellectual property of Xoco Café.
All source code, design structure, and system logic were developed and authored by:
Donovan Riaño (Principal Developer).

Under the Apache License 2.0:

  • Attribution to Xoco Café is required.
  • Credit to Donovan Riaño as the principal developer must be preserved.
  • Any redistribution must include the Apache 2.0 license.
  • Patent rights and protections are explicitly granted under this license.
  • Any modifications made to the code must be clearly stated.

Refer to the LICENSE file for full legal details.

About

⚡️ Xoco's coffeshop Website

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 91.5%
  • PLpgSQL 5.0%
  • MDX 2.2%
  • CSS 1.1%
  • Shell 0.2%