NovaMarket es una plataforma POS para cadenas de minimarkets y negocios en expansión que necesitan controlar ventas, inventario, pagos y usuarios en múltiples puntos de atención.
Arquitectura de microservicios (Spring Boot 3.5, Spring Cloud, PostgreSQL, Kafka, observabilidad, Keycloak) pensada para escalar cajas, tiendas, usuarios y transacciones — no para una sola bodega aislada.
Documentación en línea: ronalcodelp.github.io/NovaMarket
| Documento | Contenido |
|---|---|
| Sitio MkDocs | Documentación renderizada (GitHub Pages) |
| Producto del curso | Definición U1/U2/U3 y stack |
| Arquitectura | Diagramas, componentes, flujos |
| Desarrollo (DEV) | Arranque local paso a paso |
| Producción (PROD) | Despliegue con Docker |
| Seguridad | Keycloak, JWT, roles |
| Observabilidad | Actuator, Prometheus, Loki, Grafana |
| Kafka y eventos | Tópicos, productores, consumidores |
| Dominio de negocio | Rubros, artículos, ventas, pagos |
| Referencia de puertos | DEV vs PROD |
Libro digital (MkDocs): carpeta docs/ — ver abajo.
Workflow: .github/workflows/docs.yml — construye MkDocs y publica en la rama gh-pages.
Pasos (una sola vez):
- Push a
main(o ejecutar Actions → Publicar documentación → Run workflow). - Esperar el check verde.
- Settings → Pages → Source: Deploy from a branch
- Branch:
gh-pages· Folder:/ (root)→ Save - About → Website:
https://ronalcodelp.github.io/NovaMarket/
Si antes falló con error 404 deployment, era porque Pages no estaba activo o se usaba GitHub Actions sin habilitarlo. Este workflow usa la rama
gh-pages(más simple).
URL: https://ronalcodelp.github.io/NovaMarket/
docker network create market-dev-net
cd keycloak ; .\start-dev.ps1
# 3 terminales infra
cd infra\config-server ; mvn spring-boot:run
cd infra\registry-server ; mvn spring-boot:run
cd infra\gateway ; mvn spring-boot:run
# Postgres + microservicios (ver docs/desarrollo.md)
cd clients\market-ng ; npm install ; ng serve- Frontend: http://localhost:4200
- Gateway: http://localhost:18080
- Keycloak: http://localhost:41880/admin
- Login demo:
cajero/cajero123
| Capa | Tecnología |
|---|---|
| Backend | Java 17, Spring Boot 3.5, Spring Cloud |
| Datos | PostgreSQL 16 |
| Mensajería | Apache Kafka (KRaft) |
| Identidad | Keycloak 25 (OIDC) |
| Frontend | Angular 21 |
| Observabilidad | Prometheus, Loki, Promtail, Grafana |
| Contenedores | Docker Compose |
NovaMarket/
├── infra/ Config Server, Eureka, Gateway, config-repo
├── keycloak/ IdP OIDC (realm novamarket)
├── services/ Microservicios de negocio
├── clients/market-ng/ SPA Angular (POS)
├── kafka/ Broker + UI + exporter
├── obs/ Prometheus, Loki, Grafana
└── docs/ Documentación del proyecto
| Capacidad | DEV | PROD |
|---|---|---|
| Login Keycloak + Angular | Sí | Sí (configurar URLs prod) |
| Gateway + Eureka + Config | Sí | Sí (Docker) |
| CRUD rubros / artículos | Sí | Sí |
| Caja (ventas + pago) | Sí | Sí |
| Circuit Breaker (articulo→rubro) | Sí | Sí |
| Kafka eventos venta/pago | Sí | Sí |
| Observabilidad centralizada | Sí | Sí |
Proyecto educativo — UPEU / curso de microservicios.