Repositorio de continuidad para preparar el despliegue del proyecto. Conserva el historial de Garritas- hasta la versión 8944d5a, incluidas Ventas por rol, fotos locales y constancias PDF. La rama principal de este repositorio es main.
Estado: ejecución local verificada; despliegue en Railway/Supabase por preparar. Los pagos siguen simulados: Mercado Pago aún no está integrado. Los manuales históricos mantienen enlaces a los commits originales como referencia; los comandos de clonación actuales son los siguientes.
Campus Juliaca · Sistemas Distribuidos · semestre 2026-2 · Grupo 2 · Ciclo 5 G · Sección única. Descripción y temas del repositorio.
git clone https://github.com/Nikol235/Garritas-Store.git
cd Garritas-Store
Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned -Force
$env:NG_CLI_ANALYTICS = "false"Descargar la guía de arranque manual en DEV (PDF) · Comandos copiables en texto.
Clonar no copia bases de datos ni las fotos locales: su persistencia y respaldo se explican en la guía de imágenes y comprobantes.
Tienda y bienestar para mascotas en el Perú. Microservicios con Java 21 / Spring Boot 4, PostgreSQL/Flyway, Config Server, Eureka, Gateway, Kafka, Keycloak y un cliente Angular 22.
En Windows, enciende Docker Desktop y verifica que JDK 21 y Node 24 estén en PATH. Para la sustentación abre un PowerShell por aplicación y deja cada ventana abierta. Cada bloque de abajo parte de la raíz del repositorio en una ventana nueva. Este recorrido usa los Maven Wrapper, los Compose DEV y el servidor local de Angular.
Ejecuta una vez desde la raíz. Repite si modificas infra/garritas-common.
.\infra\garritas-config\mvnw.cmd -f infra/garritas-common/pom.xml -B install -DskipTestsAbre tres ventanas en este orden. Config Server debe estar listo antes de arrancar Eureka y Gateway.
cd infra/garritas-config
.\mvnw.cmd spring-boot:run '-Dspring-boot.run.profiles=native'cd infra/garritas-eureka
.\mvnw.cmd spring-boot:run '-Dspring-boot.run.profiles=dev'cd infra/garritas-gateway
.\mvnw.cmd spring-boot:run '-Dspring-boot.run.profiles=dev'Abre Eureka en http://localhost:18761. Gateway escucha en el puerto 18080. Las rutas de negocio estarán disponibles cuando arranquen y se registren sus microservicios.
Abre una ventana para Kafka y otra para Keycloak. Espera a que estén listos antes de iniciar los microservicios.
cd kafka
docker compose -f compose-dev.yml up -d --wait --wait-timeout 240cd keycloak
docker compose -f compose-dev.yml up -d --wait --wait-timeout 240Kafka UI está en http://localhost:18085. Comprueba que el clúster garritas esté conectado. El realm de Keycloak responde en http://localhost:18180/realms/garritas/.well-known/openid-configuration.
Usa ocho ventanas, una por bloque. En cada una espera que Docker arranque la base antes de ejecutar Maven. Empieza por Catálogo e inicia Pago después de Kafka.
Catálogo
cd services/garritas-catalogo-ms
docker compose -f compose-dev.yml up -d --wait --wait-timeout 120
.\mvnw.cmd spring-boot:run '-Dspring-boot.run.profiles=dev'Institución
cd services/garritas-institucion-ms
docker compose -f compose-dev.yml up -d --wait --wait-timeout 120
.\mvnw.cmd spring-boot:run '-Dspring-boot.run.profiles=dev'Usuario
cd services/garritas-usuario-ms
docker compose -f compose-dev.yml up -d --wait --wait-timeout 120
.\mvnw.cmd spring-boot:run '-Dspring-boot.run.profiles=dev'Bienestar
cd services/garritas-bienestar-ms
docker compose -f compose-dev.yml up -d --wait --wait-timeout 120
.\mvnw.cmd spring-boot:run '-Dspring-boot.run.profiles=dev'Venta
cd services/garritas-venta-ms
docker compose -f compose-dev.yml up -d --wait --wait-timeout 120
.\mvnw.cmd spring-boot:run '-Dspring-boot.run.profiles=dev'Pago
cd services/garritas-pago-ms
docker compose -f compose-dev.yml up -d --wait --wait-timeout 120
.\mvnw.cmd spring-boot:run '-Dspring-boot.run.profiles=dev'Envío
cd services/garritas-envio-ms
docker compose -f compose-dev.yml up -d --wait --wait-timeout 120
.\mvnw.cmd spring-boot:run '-Dspring-boot.run.profiles=dev'Citas
cd services/garritas-citas-ms
docker compose -f compose-dev.yml up -d --wait --wait-timeout 120
.\mvnw.cmd spring-boot:run '-Dspring-boot.run.profiles=dev'En otra ventana:
cd clients/garritas-frontend
npm.cmd ci
npm.cmd startAbre la tienda en http://localhost:4200 y verifica en Eureka que se registren los microservicios. Desde un PowerShell de comprobación consulta por Gateway:
Invoke-RestMethod -Method Get -Uri 'http://localhost:18080/api/v1/productos'Para la sustentación, abre una ventana más y levanta observabilidad después de Keycloak.
cd obs
docker compose -f compose-dev.yml up -dSi ya tenías el Compose de observabilidad en marcha antes de actualizar el repositorio, ejecuta también docker compose -f compose-dev.yml restart garritas-prometheus garritas-grafana desde obs para cargar la configuración nueva.
Abre http://localhost:13000/d/garritas-infra y entra con el usuario local admin y contraseña local-grafana, salvo que hayas configurado otra. En Garritas - Infraestructura, el panel Estado de las aplicaciones consulta las métricas de cada aplicación Spring. Usa ARRIBA si Prometheus recibe las métricas y CAÍDO si deja de recibirlas. El estado se consulta cada cinco segundos y Grafana refresca cada diez.
- Comprueba que Catálogo esté ARRIBA y que la consulta a Gateway responda.
- Pulsa Ctrl+C en el PowerShell de Catálogo. Deja su PostgreSQL en marcha. Espera el refresco de Grafana y comprueba que la tarjeta siga visible como CAÍDO. Repite la consulta a Gateway para ver el fallo de la ruta.
- En esa misma ventana, ejecuta otra vez
.\mvnw.cmd spring-boot:run '-Dspring-boot.run.profiles=dev'. Comprueba que Catálogo vuelva a ARRIBA, se registre en Eureka y la consulta a Gateway responda de nuevo.
Usa Ctrl+C en cada PowerShell de Java y Angular. Para bajar solo los contenedores de una carpeta, desde esa carpeta ejecuta docker compose -f compose-dev.yml down. Para conservar también los contenedores creados, usa docker compose -f compose-dev.yml stop. Si vas a detener Keycloak, baja primero el Compose de observabilidad. Así puedes detener únicamente lo que pertenece a la demo.
Garritas-Store/
├── .github/ # CI: compilación Java y pruebas/build de Angular
├── clients/ # garritas-frontend
├── docs/ # Arquitectura, ejecución y evidencia de validación
├── infra/ # Config Server, Eureka, Gateway y soporte técnico común
├── kafka/ # Broker Kafka y Kafka UI
├── keycloak/ # Keycloak, su PostgreSQL y el realm de demostración
├── obs/ # Prometheus, Loki, Promtail y Grafana
├── overrides/ # Personalización del sitio de documentación
├── services/ # Ocho microservicios de negocio, cada uno con PostgreSQL propio
└── uso-rapido/ # Ejemplo Python Kafka, arranque, pruebas y Compose integrado opcional
Los Compose y Dockerfiles de integración que estaban en la raíz se movieron a uso-rapido/docker/. Las herramientas están en uso-rapido/scripts/; el soporte común está en infra/garritas-common/. Las rutas de compilación y ejecución ya usan esta organización.
| Pantalla | Cliente | Administrador |
|---|---|---|
| Catálogo, nueva orden y carrito | Buscar, filtrar, seleccionar sede y comprar | Gestionar productos y categorías; no comprar |
| Sedes | Consultar sedes activas del Perú y seleccionar una | Crear, editar, activar y desactivar sedes |
| Especialistas | Consultar profesionales y sus especialidades; reservar cita | Gestionar profesionales y asignar varias especialidades |
| Mi cuenta y mascotas | Editar su perfil y gestionar sus propias mascotas | Perfil propio y administración de clientes |
| Citas | Reservar una o varias prestaciones para sus mascotas | Ver todas, confirmar y marcar atención; revisar detalle, total y duración |
| Envíos de pedidos (Venta) | Elegir y pagar el envío al comprar; consultar su despacho | Gestionar tránsito y entrega |
| Servicios por sede (Institución) | Consultar prestaciones, precios y duración | Gestionar prestaciones y ofertas por sede |
| Logística (Envío) | Consultar coberturas durante el checkout | Gestionar transportistas, zonas y coberturas |
| Planes y suscripciones (Usuario) | Contratar, renovar, cancelar y consultar períodos propios | Administrar planes y auditar suscripciones |
| Pagos y pedidos | Ver únicamente los suyos | Consultar todos |
Los permisos se verifican también en el Gateway y los microservicios. Ocultar botones no es la protección: una petición directa de un cliente intentando editar sedes o acceder a datos ajenos se rechaza.
Bienestar conserva otra relación muchos a muchos: un profesional tiene varias especialidades y una especialidad pertenece a varios profesionales. La tabla de asociación tiene clave primaria compuesta y claves foráneas. Citas valida las referencias de mascota, sede y profesional mediante llamadas HTTP con identidad propagada y límites de tiempo.
| Pareja original | Transaccional (cabecera/detalle) | Maestro | N:M |
|---|---|---|---|
| Venta–Institución | Venta / DetalleVenta | Institución | Sedes ↔ prestaciones |
| Envío–Citas | Cita / DetalleCita | Envío: logística | Transportistas ↔ zonas |
| Catálogo–Usuario (Fio) | Suscripcion / PeriodoSuscripcion en Usuario | Catálogo | Clientes ↔ planes |
Asignación, reglas, migración y demo por integrante. Contraste con las sesiones 1–11 del ingeniero.
El perfil confirma su guardado leyendo nuevamente la API. La edad de mascotas se registra en días o meses, con unidad explícita; las edades históricas en años se convierten a meses mediante migración. El despacho operativo pasa a Venta; el archivo histórico de Envío se conserva y el lanzador DEV lo migra sin duplicar ventas. Las N:M con atributos se implementan con entidades de asociación y claves foráneas locales.
Guía paso a paso, HTML copiable, PDF y fuentes por etapas. Explica cómo crear y conectar todos los componentes desde una carpeta vacía.
Guía de funciones y código: Ventas para ADMIN, Mis compras para CLIENTE, filtros y detalle; imagen principal local para productos/profesionales/sedes; constancia PDF imprimible para compras pagadas. El pago continúa simulado.
Las direcciones se abren en la máquina donde ejecutas el proyecto; no constituyen una publicación web de GitHub ni una URL externa de la nube.
| Aplicación | Dirección local | Acceso de demostración |
|---|---|---|
| Garritas Store | http://localhost:4200 |
cliente / Cliente123! |
| Kafka UI | http://localhost:18085 |
Clúster garritas |
| Keycloak | http://localhost:18180/admin/ |
admin / local-admin-change-me |
| Eureka | http://localhost:18761 |
Sin login |
| Gateway | http://localhost:18080 |
API con JWT |
| Grafana | http://localhost:13000 |
admin / local-grafana |
| Prometheus | http://localhost:19090 |
Sin login |
Administrador de la tienda: admin-store / Admin123!. Es distinto del administrador de Keycloak. Loki expone su API en 13100 y se consulta desde Grafana.
DEV incluye 16 productos para mascotas, seis sedes ficticias de Lima, Arequipa, Trujillo, Cusco y Huancayo, y profesionales/especialidades de ejemplo. Las migraciones repetibles de db/demo no sobrescriben datos existentes. El realm solo se importa cuando aún no existe. No uses estas identidades ni contraseñas de demostración para exponer el sistema en Internet.
El carrito conserva identificadores, cantidades, sede y clave de reintento, nunca tokens. El servidor determina precios, identidad y stock. La Saga reserva inventario, procesa un pago simulado y confirma o compensa. TRANSFERENCIA simula rechazo; el stock se devuelve antes de cancelar la venta.
- Ejecutar Garritas: instalación, puertos y diagnóstico.
- Construir desde cero: pasos, rutas y código completo.
- Entender arquitectura, clases, tecnologías y conexiones.
Índice y evidencias de los manuales. Se incluye un ZIP de fuentes sin dependencias/binarios, con manifiesto SHA-256; fue extraído y compilado en una carpeta nueva.
Guía completa en PDF, resumen oral de dos páginas y mapa de código con rutas/líneas exactas. Incluye once diagramas, fichas de los ocho servicios y respuestas a las siete preguntas S6–S11. Índice y verificación.
Consulta la actualización de Catálogo, Usuario, delivery y paquetes para conocer los cambios, las migraciones y sus límites.
HTML, PDF, diagramas y mapa de código. Incluye los cuatro niveles C4, responsabilidades, CRUD, Saga/Kafka, compensación, seguridad y credenciales de demostración.
Requisitos: JDK 21 completo, Node 24, Docker Compose, Git y Python 3 para las herramientas Linux/pruebas. Los ejemplos son locales; no se hacen cobros bancarios reales.
Desde la raíz:
bash uso-rapido/scripts/dev.sh build
bash uso-rapido/scripts/dev.sh all
bash uso-rapido/scripts/dev.sh statusbuild hace una compilación limpia para empaquetar también los cambios del soporte común; compila todos los servicios e instala el soporte común para permitir también arranques manuales por módulo. all inicia Kafka, Keycloak, las ocho bases de negocio, Config Server, Eureka, los ocho servicios, Gateway y Angular. Si faltan dependencias frontend, ejecuta npm ci antes de iniciar su servidor.
Observabilidad opcional:
bash uso-rapido/scripts/dev.sh observability
bash uso-rapido/scripts/dev.sh status --observabilityEl ejemplo equivalente al de Pagatu está en uso-rapido/garritas-eventos-py. Tiene productor, consumidor, requisitos y Compose. Usa un topic de demostración separado para no crear compras ficticias en la Saga real.
Con DEV iniciado:
bash uso-rapido/scripts/dev.sh test
(cd clients/garritas-frontend && npm test && npm run build)
python3 -m pip install -r uso-rapido/scripts/requirements-test.txt
CHROMIUM_PATH=/usr/bin/chromium python3 uso-rapido/scripts/domain_smoke.py
CHROMIUM_PATH=/usr/bin/chromium python3 uso-rapido/scripts/academic_smoke.py
CHROMIUM_PATH=/usr/bin/chromium python3 uso-rapido/scripts/smoke.py
CHROMIUM_PATH=/usr/bin/chromium python3 uso-rapido/scripts/consoles.pySi no usas Chromium del sistema, instala el navegador de Playwright con python3 -m playwright install chromium y omite CHROMIUM_PATH. domain_smoke.py prueba todos los dominios con ADMIN y dos CLIENTE: propiedad, permisos, asociación muchos a muchos, cita, compra y entrega. Los registros de prueba se identifican como tales; los historiales de ventas y citas se conservan.
- Guía de ejecución y diagnóstico
- Arquitectura y decisiones
- Resultados y límites de validación
- Compose integrado opcional
La documentación puede construirse con pip install -r docs/requirements.txt y mkdocs build --strict.