How 0xkoat/backend-gerance works
SecOps is a multi-tenant API for provisioning users and tenants, controlling access to external security tools, and providing ticketing with stored and live notifications. The main workflow is: a user authenticates, platform and tenant administrators configure subscriptions and endpoints, and an authorized user launches a module via redirect; users can also raise tickets and receive updates. PostgreSQL stores tenant-scoped records and audit/notification state. The graph reflects README-documented behavior and shown source references; some subsystem internals were not sampled, so uncertain links are omitted.
Main entry points: prisma.service.ts Prisma Client · module-access.service.ts Module Access · auth.service.ts Authentication · tickets.service.ts Ticket Management
Components 20
Identity & Users
- Auth API
src/auth/auth.controller.ts - Authentication
src/auth/auth.service.ts - JWT Strategy
src/auth/jwt.strategy.ts - User API
src/users/users.controller.ts - User Management
src/users/users.service.ts
Tenant Administration
- Tenant API
src/tenants/tenants.controller.ts - Tenant Management
src/tenants/tenants.service.ts
Module Access
- Module APIs
src/module-access/modules.controller.ts - Endpoint Admin API
src/module-access/module-endpoints.controller.ts - Module Access
src/module-access/module-access.service.ts - Analyst Level Rules
src/module-access/module-levels.ts
Tickets & Events
- Ticket API
src/tickets/tickets.controller.ts - Ticket Management
src/tickets/tickets.service.ts - Notifications
src/tickets/notifications.service.ts - Live Event API
src/events/events.controller.ts - Event Delivery
src/events/events.service.ts
Persistence
- Prisma Client
src/prisma/prisma.service.ts - PostgreSQL
Other components
- Frontend BFF
- Security Modules
Connections 27
- Frontend BFF → Auth API: requests auth
README.md - Auth API → Authentication: calls
src/auth/auth.controller.ts - Authentication → User Management: looks up users
src/auth/auth.service.ts - Authentication → Prisma Client: manages refresh tokens
src/auth/auth.service.ts - Authentication → JWT Strategy: builds claims
src/auth/auth.service.ts - Frontend BFF → User API: manages accounts
README.md - User API → User Management: calls
src/users/users.controller.ts - User Management → Prisma Client: reads and writes
src/users/users.service.ts - Frontend BFF → Tenant API: administers tenants
README.md - Tenant API → Tenant Management: calls
src/tenants/tenants.controller.ts - Tenant Management → Prisma Client: reads and writes
src/tenants/tenants.service.ts - Frontend BFF → Module APIs: requests module launch
README.md - Module APIs → Module Access: dispatches access
src/module-access/modules.controller.ts - Endpoint Admin API → Module Access: manages endpoints
src/module-access/module-endpoints.controller.ts - Module Access → Analyst Level Rules: checks levels
src/module-access/module-access.service.ts - Module Access → Prisma Client: checks access and records launches
src/module-access/module-access.service.ts - Module Access → Security Modules: redirects to configured product
README.md - Frontend BFF → Ticket API: raises and tracks tickets
README.md - Ticket API → Ticket Management: dispatches ticket actions
src/tickets/tickets.controller.ts - Ticket Management → Notifications: creates notifications
src/tickets/tickets.service.ts - Ticket Management → Prisma Client: stores tickets
src/tickets/tickets.service.ts - Notifications → Prisma Client: stores notifications
src/tickets/notifications.service.ts - Notifications → Event Delivery: publishes updates
src/tickets/notifications.service.ts - Frontend BFF → Live Event API: opens event stream
README.md - Live Event API → Event Delivery: streams events
src/events/events.controller.ts - Event Delivery → PostgreSQL: persists application state
README.md - Prisma Client → PostgreSQL: queries
src/prisma/prisma.service.ts