How fabioluizrodrigues/ctrl-api works
This is an Express API for managing organizations, users, businesses, people, vehicles, cities, accounts, roles, and permissions. Requests enter through the server and router, then pass route-level authentication and validation before controller handlers invoke database providers. Sign-in and sign-up are public routes; most management routes require authentication. The graph groups related handlers and providers rather than listing every CRUD operation. Evidence is limited to the README (empty), the supplied excerpts, and SOURCE INDEX references; unsampled details and uncertain provider-to-database calls are omitted.
Main entry points: routes/index.ts Route dispatch · empresas Business providers · server.ts Express server · src/index.ts Process entry
Components 22
HTTP runtime
- Process entry
src/index.ts - Express server
src/server/server.ts - Route dispatch
src/server/routes/index.ts
Security
- Token authentication
src/server/shared/middleware/EnsureAuthenticated.ts - Request validation
src/server/shared/middleware/Validation.ts - JWT service
src/server/shared/services/JWTService.ts
Domain APIs
- User identity
src/server/controllers/usuarios - Organization records
src/server/controllers/organizacoes - Business records
src/server/controllers/empresas - People records
src/server/controllers/pessoas - Fleet and cities
src/server/controllers/veiculos - Roles and permissions
src/server/controllers/permissoes - Access assignments
src/server/controllers/usuarios_permissoes - Account controls
src/server/controllers/contas
Persistence
- Organization providers
src/server/database/providers/oganizacoes - Business providers
src/server/database/providers/empresas - People providers
src/server/database/providers/pessoas - Access providers
src/server/database/providers/permissoes - Account providers
src/server/database/providers/Contas - Knex configuration
src/server/database/knex - Table names
src/server/database/ETableNames.ts
Other components
- API client
Connections 24
- API client → Express server: sends requests
- Process entry → Express server: starts
src/index.ts - Process entry → Knex configuration: runs migrations
src/index.ts - Express server → Route dispatch: mounts routes
src/server/server.ts - Route dispatch → Token authentication: guards routes
src/server/routes/index.ts - Route dispatch → Request validation: validates requests
src/server/routes/index.ts - Route dispatch → User identity: dispatches identity
src/server/routes/index.ts - Route dispatch → Organization records: dispatches requests
src/server/routes/index.ts - Route dispatch → Business records: dispatches requests
src/server/routes/index.ts - Route dispatch → People records: dispatches requests
- Route dispatch → Fleet and cities: dispatches requests
- Route dispatch → Roles and permissions: dispatches requests
src/server/routes/index.ts - Route dispatch → Access assignments: dispatches requests
src/server/routes/index.ts - Route dispatch → Account controls: dispatches requests
src/server/routes/index.ts - Token authentication → JWT service: verifies tokens
src/server/shared/middleware/EnsureAuthenticated.ts - User identity → JWT service: uses service
src/server/controllers/usuarios/SignIn.ts - Organization records → Organization providers: uses providers
src/server/controllers/organizacoes/GetAll.ts - Business records → Business providers: calls provider
src/server/controllers/empresas/Create.ts - People records → People providers: uses providers
src/server/controllers/pessoas/Create.ts - Roles and permissions → Access providers: uses providers
src/server/controllers/permissoes/GetAll.ts - Access assignments → Access providers: uses providers
- Account controls → Account providers: uses providers
src/server/controllers/contas/Create.ts - Business providers → Knex configuration: imports configuration
src/server/database/providers/empresas/Create.ts - Business providers → Table names: uses table names
src/server/database/providers/empresas/Create.ts