How jhonycreativo/pos-platform-microservices works
This repository is a NestJS microservices application with a Next.js web client: the visible backend flow covers login, token creation, gateway-proxied user operations, and user persistence. User permissions and role/permission administration are distinct domain capabilities. The web tree shows login and dashboard pages, but sampled evidence does not establish their API calls. Backend service calls and persistence are supported by excerpts; unsampled proxy-to-service links are left out.
Main entry points: users/users.controller.ts Gateway routes · auth.service.ts Login service · users/users.controller.ts User controller · users.service.ts User service
Components 18
Web client
- Login page
apps/web/src/app/login/page.tsx - Dashboard pages
apps/web/src/app/(dashboard) - API client
apps/web/src/lib/api.ts
API gateway
- Gateway routes
apps/gateway-api/src/modules/users/users.controller.ts - User proxy
apps/gateway-api/src/modules/users/users.proxy.ts - Auth routes
apps/gateway-api/src/modules/auth/auth.controller.ts - Auth proxy
apps/gateway-api/src/modules/auth/auth.proxy.ts - JWT guard
apps/gateway-api/src/security/jwt.guard.ts - JWT strategy
apps/gateway-api/src/security/jwt.strategy.ts
Authentication
- Auth controller
apps/auth-service/src/auth/auth.controller.ts - Login service
apps/auth-service/src/auth/auth.service.ts
User domain
- User controller
apps/users-service/src/users/users.controller.ts - User service
apps/users-service/src/users/users.service.ts - Role administration
apps/users-service/src/roles - Permission administration
apps/users-service/src/permissions
Persistence
- Prisma adapter
apps/users-service/src/prisma/prisma.service.ts - PostgreSQL
Other components
- User
Connections 10
- User → Login page: enters credentials
apps/web/src/app/login/page.tsx - User → Dashboard pages: views dashboard
apps/web/src/app/(dashboard)/page.tsx - Auth routes → Auth proxy: delegates to
apps/gateway-api/src/modules/auth/auth.controller.ts - Gateway routes → User proxy: delegates to
apps/gateway-api/src/modules/users/users.controller.ts - Gateway routes → JWT guard: guards routes
apps/gateway-api/src/modules/users/users.controller.ts - Auth controller → Login service: calls login
apps/auth-service/src/auth/auth.controller.ts - Login service → User controller: requests credentials and permissions
apps/auth-service/src/auth/auth.service.ts - User controller → User service: delegates requests
apps/users-service/src/users/users.controller.ts - User service → Prisma adapter: reads and writes
apps/users-service/src/users/users.service.ts - Prisma adapter → PostgreSQL: connects through adapter
apps/users-service/src/prisma/prisma.service.ts