Miel Rubén — Tienda online

Demo online: https://sirgprice.github.io/miel-ruben-web/

Demo local (Windows): https://github.com/SIRGPrice/miel-ruben-web/releases/latest/download/demo-local.bat

Web completa para la venta de miel, derivados de la apicultura y abejas reinas seleccionadas genéticamente. Una sola app autocontenida: Node.js + Express + SQLite, sin servicios externos de base de datos.

• Frontend estático bilingüe (ES/EN), sin frameworks, con gráficos SVG propios (composición de la miel, espectro polínico, razas de abejas, floraciones).

• Pagos solo con tarjeta mediante Stripe Payment Element (3D Secure incluido).

• Al completarse el pago: email de confirmación + factura PDF al cliente y copia al email del propietario (SMTP propio).

• Gestión de pedidos por 3 vías con la misma lógica: panel web admin, API REST y servidor MCP (controlable por cualquier modelo de IA: Claude, GPT, Gemini, modelos locales…).

• Sin logging de ningún tipo: sin analytics, sin registros de acceso, sin cookies de terceros. Solo datos de negocio (pedidos/facturas) en SQLite.

1. Requisitos

• Node.js ≥ 20

• Cuenta de Stripe (pagos con tarjeta)

• Cuenta de correo SMTP (envío de confirmaciones y facturas)

Related MCP server: Shopify MCP Server

2. Puesta en marcha local

2.1 Modo demo local (sin Stripe ni SMTP)

Para ver y probar la web al completo sin configurar ningún servicio externo (los servicios no conectados se muestran en la UI, pero el cobro se simula en el servidor):

Windows — descarga y ejecuta el lanzador

demo-local.bat: https://github.com/SIRGPrice/miel-ruben-web/releases/latest/download/demo-local.bat

1. Comprueba Node.js y Git (abre sus páginas si faltan).

2. Descarga el proyecto (o lo actualiza) en %USERPROFILE%\miel-ruben-web.

3. Instala dependencias la primera vez.

4. Sirve la web en modo demo y abre el navegador en http://localhost:3000.

La primera vez git clone pedirá tu sesión de GitHub (repo privado). Windows SmartScreen puede avisar al ejecutar un .bat descargado: "Más información → Ejecutar de todos modos".

macOS / Linux

Descarga demo-local.sh y ejecútalo:

curl -L -o demo-local.sh https://github.com/SIRGPrice/miel-ruben-web/releases/latest/download/demo-local.sh
chmod +x demo-local.sh
./demo-local.sh

(Equivale al .bat pero en shell: Node.js + Git requeridos; abre el navegador con open / xdg-open cuando el servidor esté listo.)

Si ya tienes el repo clonado, basta con:

npm install
npm run demo          # http://localhost:3000

En Windows también puedes hacer doble click en start-local.bat (instala dependencias si faltan, abre el navegador y arranca).

En modo demo:

• El checkout muestra una tarjeta ficticia (solo UI); al pagar, el pedido se registra como pagado con su factura (sin cargo real) y aparece en el panel admin y vía MCP.

• Los emails no se envían (SMTP no configurado); todo lo demás funciona.

• Panel admin: http://localhost:3000/admin.html → token demo-admin-token · MCP: http://localhost:3000/mcp → token demo-mcp-token.

• El endpoint de simulación /api/demo/* solo existe en este modo; en producción ni se registra. Nunca desplegar con DEMO_MODE=true.

2.2 Modo producción (con servicios reales)

npm install
cp .env.example .env     # rellenar las variables
npm start                # http://localhost:3000
npm test                 # 21 tests de lógica y API

3. Configuración

3.1 Datos del negocio

Todo lo editable está en config/business.json: nombre, email del propietario (ownerEmail, recibe copia de cada pedido), dirección, CIF, tipo de IVA, gastos de envío y umbral de envío gratis.

El catálogo está en public/data/products.json (productos, precios con IVA incluido, stock inicial, composiciones y espectros polínicos). Las fotos son placeholders SVG en public/assets/products/: sustituir manteniendo el nombre de archivo o actualizar el campo image.

3.2 Variables de entorno (.env)

4. Despliegue (listo para ligar a un dominio)

4.1 Render (recomendado, 1 click)

1. Subir este repo (privado) a GitHub.

2. En Render: New → Blueprint → elegir el repo. render.yaml crea el servicio con disco persistente para SQLite y genera ADMIN_TOKEN y MCP_TOKEN aleatorios.

3. Rellenar las variables sync: false (Stripe, SMTP, DOMAIN).

4. En Custom Domain: añadir el dominio y crear el registro CNAME que indica Render. HTTPS automático.

También funciona en Railway, Fly.io o cualquier VPS (npm install && npm start detrás de un proxy HTTPS).

4.2 Webhook de Stripe

En el panel de Stripe → Developers → Webhooks → Add endpoint:

• URL: https://tudominio.com/api/webhooks/stripe

• Eventos: payment_intent.succeeded y payment_intent.payment_failed

• Copiar el Signing secret en STRIPE_WEBHOOK_SECRET.

4.3 DNS y SEO

• Sustituir tudominio.com en public/robots.txt y public/sitemap.xml.

• Stripe: activar el dominio en Settings → Payment method domains.

5. Flujo de compra

1. El cliente arma la cesta y rellena sus datos de envío.

2. El servidor recalcula los importes desde el catálogo (nunca se confía en el cliente) y crea un PaymentIntent con payment_method_types: ['card'].

3. Stripe Payment Element cobra con tarjeta (3DS si aplica).

4. El webhook marca el pedido como pagado, genera la factura PDF (numeración secuencial MR-AÑO-XXXX) y envía el email de confirmación con la factura al cliente y copia al propietario.

5. El cliente ve la página de confirmación con el resumen.

6. Gestión de pedidos (propietario)

6.1 Panel web

https://tudominio.com/admin.html → introducir ADMIN_TOKEN. Pedidos (cambiar estado, cancelar, reenviar factura), KPIs y stock.

Estados: paid → preparing → shipped → delivered · cancelled.

6.2 API REST (mismo token)

GET    /api/admin/orders[?status=paid&from=...&to=...]
GET    /api/admin/orders/:id
PATCH  /api/admin/orders/:id            { "status": "shipped" }
POST   /api/admin/orders/:id/cancel
POST   /api/admin/orders/:id/resend-invoice
GET    /api/admin/stats
GET    /api/admin/products
PATCH  /api/admin/products/:id          { "stock": 25, "active": true }

Autenticación: Authorization: Bearer <ADMIN_TOKEN>.

6.3 Servidor MCP (control por cualquier IA)

Endpoint: POST /mcp · Authorization: Bearer <MCP_TOKEN> Protocolo: MCP streamable HTTP (JSON-RPC 2.0, respuestas application/json).

Herramientas expuestas:

Ejemplo de configuración en un harness compatible con MCP (Claude Code, OpenAI, LM Studio, etc.):

{
  "mcpServers": {
    "miel-ruben": {
      "url": "https://tudominio.com/mcp",
      "headers": { "Authorization": "Bearer <MCP_TOKEN>" }
    }
  }
}

Prueba rápida:

curl -X POST https://tudominio.com/mcp \
  -H "Authorization: Bearer <MCP_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

7. Estructura

├── config/business.json      # Datos del negocio (EDITAR)
├── public/
│   ├── data/products.json    # Catálogo (EDITAR)
│   ├── assets/products/      # Imágenes (placeholders SVG → sustituir)
│   ├── js/                   # i18n, carrito, charts SVG, tienda, checkout, admin
│   └── *.html                # Inicio, Tienda, Historia, Contacto, Checkout…
├── server/
│   ├── index.js              # App Express (sin logging)
│   ├── routes/               # tienda, webhook Stripe, admin, contacto
│   ├── services/             # pedidos, Stripe, SMTP, factura PDF
│   └── mcp/server.js         # Servidor MCP (control por IA)
├── test/                     # 20 tests (node --test)
└── render.yaml               # Despliegue 1 click

8. Notas

• Sin logging: la app no escribe registros ni incluye analítica. Stripe y el proveedor SMTP aplican su propia retención (fuera del código de la app).

• Los precios del catálogo incluyen IVA (tipo en business.json, 10 % por defecto); la factura desglosa la parte correspondiente.

• Reinas: la venta es estacional (abril–septiembre); gestionar disponibilidad con el campo active/stock desde el panel o vía MCP.