Frontend ERP de práctica construido con Angular 21 standalone para consumir microservicios mediante gateway.
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.
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.
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
Desde la carpeta del proyecto:
cd C:\ms1\ProyectosMS2026\erpng
ng serveAbrir:
http://localhost:4200
También se puede usar:
npm startporque en package.json el script start ejecuta ng serve.
- Entrar a
/productos. - La app redirige a
/authsi no hay sesión. - Iniciar sesión con un usuario válido del microservicio
auth. - Angular guarda el
accessToken. - Volver a
/productos. - El interceptor agrega el JWT al request.
- El gateway permite consumir
/api/v1/productos.
| 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 |
/auth Login
/categorias Práctica base de CRUD
/productos Ruta protegida con JWT
Comandos sugeridos cuando quieras verificar:
npm run build
npm test -- --watch=falseACTIVIDAD_AUTH_PRODUCTOS.md: login, JWT, guard, interceptor y CRUD de productos.ACTIVIDAD_CATEGORIAS_ESTANDAR.md: refactor de categorías al estándar de servicios.