How mohamedbrzan/apexapi works
NexusCore is a REST API backend for authentication and role-based access, organization management, product catalog operations, and supporting content and monitoring domains. The main workflow is an HTTP request entering the application, passing through mounted API routes and applicable authentication or validation middleware, reaching a controller, and—where shown—business services and data models. The README also describes caching, rate limiting, logging, monitoring, pagination, filtering, and sorting. Some domain modules are represented at directory level because their source was not sampled; their internal call paths are therefore not asserted.
Main entry points: index.js API router · userRoutes.js User routes · UserController.js User controller · organizationRoutes.js Organization routes
Components 28
API application
- Application entry
index.js - API router
src/routes/index.js
Identity and access
- User routes
src/routes/userRoutes.js - User controller
src/controllers/UserController.js - User service
src/services/UserService.js - User model
src/models/User.js - Refresh tokens
src/services/TokenService.js - Token utilities
src/utils/auth.js - JWT authentication
src/middleware/IsAuthenticated.js
Catalog and organizations
- Organization routes
src/routes/organizationRoutes.js - Organization controller
src/controllers/OrganizationController.js - Organization service
src/services/OrganizationService.js - Organization model
src/models/Organization.js - Catalog routes
src/routes/productCatalogRoutes.js - Catalog controller
src/controllers/ProductCatalogController.js - Catalog service
src/services/ProductCatalogService.js - Product records
src/models/ProductCatalog.js
Domain capabilities
- Other API domains
src/controllers - Analytics and monitoring
src/controllers/AnalyticsController.js - Posts and comments
src/controllers
Request safeguards
- Request validation
src/middleware/validationMiddleware.js - Role authorization
src/middleware/roleMiddleware.js - Response sanitizers
src/utils/sanitizers.js - Error handling
src/middleware/errorMiddleware.js - Request logging
src/middleware/logging.js - Redis caching
src/middleware/cacheMiddleware.js - Rate limiting
src/middleware/rateLimiting.js
Other components
- API client
Connections 35
- API client → Application entry: sends request
- Application entry → API router: loads routes
index.js - API router → User routes: mounts
src/routes/index.js - API router → Organization routes: mounts
src/routes/index.js - API router → Catalog routes: mounts
src/routes/index.js - API router → Other API domains: mounts domain routes
src/routes/index.js - User routes → User controller: dispatches
src/routes/userRoutes.js - User routes → Request validation: validates
src/routes/userRoutes.js - User routes → JWT authentication: authenticates
src/routes/userRoutes.js - User routes → Role authorization: checks role
src/routes/userRoutes.js - User controller → User service: calls
src/controllers/UserController.js - User controller → Token utilities: generates tokens
src/controllers/UserController.js - User controller → Refresh tokens: stores refresh token
src/controllers/UserController.js - User controller → Response sanitizers: sanitizes output
src/controllers/UserController.js - User service → User model: uses
src/services/UserService.js - User service → Refresh tokens: uses
src/services/UserService.js - JWT authentication → User model: loads user
src/middleware/IsAuthenticated.js - JWT authentication → Request logging: logs failures
src/middleware/IsAuthenticated.js - Organization routes → Organization controller: dispatches
src/routes/organizationRoutes.js - Organization routes → JWT authentication: authenticates
src/routes/organizationRoutes.js - Organization routes → Request validation: validates
src/routes/organizationRoutes.js - Organization routes → Role authorization: checks role
src/routes/organizationRoutes.js - Organization controller → Organization service: calls
src/controllers/OrganizationController.js - Organization controller → Response sanitizers: sanitizes output
src/controllers/OrganizationController.js - Organization service → Organization model: uses
src/services/OrganizationService.js - Catalog routes → Catalog controller: dispatches
src/routes/productCatalogRoutes.js - Catalog routes → JWT authentication: authenticates
src/routes/productCatalogRoutes.js - Catalog routes → Request validation: validates
src/routes/productCatalogRoutes.js - Catalog controller → Catalog service: calls
src/controllers/ProductCatalogController.js - Catalog controller → Response sanitizers: sanitizes output
src/controllers/ProductCatalogController.js - Catalog service → Product records: queries
src/services/ProductCatalogService.js - Application entry → Rate limiting: configures
index.js - Application entry → Request logging: configures
index.js - API router → Error handling: registers handler
src/routes/index.js - Request validation → Request logging: logs failures
src/middleware/validationMiddleware.js