Skip to content
261distPublic

About

Cliente Angular 21 como frontend ERP desacoplado que consume capacidades de una plataforma de microservicios

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

erpng

Frontend ERP de práctica construido con Angular 21 standalone para consumir microservicios mediante gateway.

Estado Actual

La aplicación ya tiene una primera integración funcional con:

  • Rutas standalone.
  • Consumo HTTP mediante provideHttpClient().
  • Gateway centralizado en environment.ts.
  • Login contra el microservicio auth.
  • Persistencia básica del token JWT en localStorage.
  • Interceptor HTTP para enviar Authorization: Bearer <token>.
  • Guard para proteger la ruta /productos.
  • CRUD de productos desde el microservicio producto.
  • CRUD de categorías como práctica base, estandarizado con servicio propio.
  • Selector de categorías en el formulario de productos.

Modelo de Autenticación Actual

Esta etapa usa un modelo simple y didáctico:

Angular /auth
  -> POST http://localhost:7091/auth/login
  -> recibe accessToken
  -> guarda JWT en localStorage
  -> consume endpoints protegidos con Bearer token

Importante: el microservicio auth actual no es un servidor OAuth2/OIDC. Es un servicio propio con Spring Security que valida usuario/contraseña y genera un JWT.

Librerías relevantes del backend actual:

spring-boot-starter-security
jjwt-api
jjwt-impl
jjwt-jackson

Para una etapa futura con OAuth2/OIDC se recomienda usar Keycloak. En ese caso Angular ya no mostraría este formulario propio como flujo principal, sino que redirigiría al proveedor de identidad y volvería a la SPA mediante Authorization Code + PKCE.

Backend Esperado

Antes de probar el frontend, deben estar levantados los servicios necesarios:

Servicio Puerto directo Uso desde Angular
Gateway 7091 Sí
Auth 8041 No directo
Producto 9091 No directo
Catalogo 8081 No directo

El frontend consume siempre el gateway:

http://localhost:7091

Endpoints usados:

POST http://localhost:7091/auth/login
GET  http://localhost:7091/api/v1/productos
GET  http://localhost:7091/api/v1/categorias

Ejecutar

Desde la carpeta del proyecto:

cd C:\ms1\ProyectosMS2026\erpng
ng serve

Abrir:

http://localhost:4200

También se puede usar:

npm start

porque en package.json el script start ejecuta ng serve.

Flujo de Prueba

  1. Entrar a /productos.
  2. La app redirige a /auth si no hay sesión.
  3. Iniciar sesión con un usuario válido del microservicio auth.
  4. Angular guarda el accessToken.
  5. Volver a /productos.
  6. El interceptor agrega el JWT al request.
  7. El gateway permite consumir /api/v1/productos.

Archivos Clave

Archivo Responsabilidad
src/environments/environment.ts URL base del gateway
src/app/core/services/api.service.ts Construcción de URLs hacia el gateway
src/app/core/auth/auth.service.ts Login, sesión, token, roles y logout
src/app/core/auth/auth.interceptor.ts Agrega el header Authorization
src/app/core/auth/auth.guard.ts Protege rutas que requieren login
src/app/auth/auth.ts Pantalla de login
src/app/productos/productos.service.ts Consumo de productos
src/app/productos/productos.ts Listado de productos
src/app/app.routes.ts Rutas públicas y protegidas
src/app/app.config.ts Providers globales de router y HTTP

Rutas

/auth        Login
/categorias  Práctica base de CRUD
/productos   Ruta protegida con JWT

Validación Manual

Comandos sugeridos cuando quieras verificar:

npm run build
npm test -- --watch=false

Material de Práctica

  • ACTIVIDAD_AUTH_PRODUCTOS.md: login, JWT, guard, interceptor y CRUD de productos.
  • ACTIVIDAD_CATEGORIAS_ESTANDAR.md: refactor de categorías al estándar de servicios.

About

Cliente Angular 21 como frontend ERP desacoplado que consume capacidades de una plataforma de microservicios

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages