Medusa — Backend (EcommerceV2Backend)¶
Backend de comercio de Compulandia sobre Medusa v2.15.5: API de tienda, API de administración y dashboard de admin en un solo servicio, con PostgreSQL y Redis, desplegado como imagen Docker desde GHCR a runners self-hosted.
Repositorio: https://github.com/CompulandiaTI/EcommerceV2Backend
Por dónde empezar¶
| Documento | Para qué |
|---|---|
| Arquitectura | Componentes, dependencias externas, diagrama y flujo de despliegue |
| Arquitectura de la plataforma | Mapa transversal de los tres sistemas (backend, storefront y CMS): componentes, contratos, flujos y riesgos |
| Runbook | Deploy, logs, rollback y las fallas frecuentes con evidencia |
| Troubleshooting | Catálogo largo de errores puntuales y su resolución |
| Decisiones (ADR) | Por qué el pipeline y el arranque son como son |
Requisitos¶
Serie de documentos estáticos que reconstruyen, por partes, el requisito funcional detrás de lo que está implementado. Se escriben a partir del inventario del backend, no de una especificación previa.
| Documento | Alcance | Estado |
|---|---|---|
| RF-000 — Plataforma base de comercio | Capacidades que Medusa v2.15.5 provee de fábrica, sin desarrollo propio | producción |
| RF-001 — Pago por transferencia bancaria | Cierre de pedido sin cobro confirmado y captura manual | producción |
| RF-002 — Descuento por medio de pago | Promoción atada a la transferencia bancaria, aplicada y retirada sin código | desarrollo |
| RF-003 — Pago con Bancard QR | QR sobre el carrito, pedido al confirmar el pago (ADR-0006), vencimiento por job | desarrollo |
| RF-004 — Estado de pago en tiempo real | Canal SSE que empuja el cambio de estado al storefront | desarrollo |
| RF-005 — Flete calculado | Tarifa por caja, ciudad y categoría; cobertura y plazo por transportista | desarrollo |
| RF-006 — Administración de envíos y geozonas | Widgets y rutas para configurar cajas, precios, categorías y ciudades | desarrollo |
| RF-007 — Notificaciones por correo | Plantillas propias en castellano sobre suscriptores de eventos | desarrollo |
| RF-008 — Listas de precios | Administración de variantes, vigencia diaria y precio por región | producción |
| RF-009 — Autenticación con Google | Provider stock configurado junto al de email y contraseña | desarrollo |
| RF-010 — Intentos de pago en el admin | Vista de intentos de todas las pasarelas, acciones y resumen diario | desarrollo |
| RF-011 — Pago con tarjeta por Bancard vPOS | Formulario de Bancard embebido en el checkout, pedido al confirmar el pago | desarrollo |
Documentación complementaria¶
- Estándares — configuración de CI/CD con runners self-hosted y guías de despliegue del proyecto.
- Modelo de intentos de pago — la pieza común a las pasarelas que confirman el pago por su cuenta (Bancard QR y vPOS).
- Integraciones — contratos con Bancard QR, Bancard vPOS, el proveedor de fulfillment MC Group y el storefront.
- Análisis — fotos en el tiempo: split server/worker, upgrade a 2.15.5, widgets de administración de envíos, pago con tarjeta por Bancard vPOS embebido.
Buena parte de la documentación de
integraciones/yanalisis/es previa a este estándar y está publicada con nota de vigencia por confirmar: describe módulos que no están en las ramas publicadas del repositorio. Leer esa nota antes de tomarla como fuente de verdad.