How techaccecho/backend-service works
This monorepo provides backend APIs for BlogNET, administration, authentication/user identity, and ARG player progression; the game service is documented as reserved. Principal flows are HTTP requests through service routes and shared plugins into domain operations and Convex-backed data, or state requests through the ARG rules engine to a progression payload. The graph preserves the README’s major capabilities. Several service bootstraps and storage modules were not excerpted, so uncertain wiring is omitted or marked unverified.
Main entry points: blogs.routes.ts Blog API · state.routes.ts State API · schema.ts Convex database · users.routes.ts User routes
Components 21
API services
- Admin API
apps/admin-service/src/modules/apis/apis.routes.ts - Auth service
apps/auth-service/src - Blog API
apps/blog-service/src/modules/blogs/blogs.routes.ts - Comments and replies
apps/blog-service/src/modules/comments/comments.routes.ts - Engagement rules
apps/blog-service/src/modules/rules-of-engagement/rules-of-engagement.routes.ts - State API
apps/state-service/src/modules/state/state.routes.ts - Reserved game API
apps/game-service/src
Shared runtime
- User routes
lib/starter/src/modules/auth/users.routes.ts - Authentication hooks
lib/starter/src/modules/auth/hooks/auth.hook.ts
Domain logic
- Blog domain
lib/domain/src/blog/blog.schema.ts - Blog content
lib/domain/src/blog/blog-content.ts - User domain
lib/domain/src/user/user.schema.ts - API definitions
lib/domain/src/api/api.schema.ts - ARG rules engine
apps/state-service/src/modules/state/ArgRulesEngine.ts - Progress projection
apps/state-service/src/modules/state/ArgRulesEngine.ts
Data layer
- Convex database
lib/data/convex/schema.ts - Blog records
lib/data/convex/blogs.ts - User records
lib/data/convex/users.ts - Step definitions
lib/data/convex/stepDefinitions.ts - Player state
lib/data/convex/argPlayerStates.ts
Other components
- API clients
Connections 22
- API clients → Admin API: manage records
README.md - API clients → Blog API: use blogs
README.md - API clients → Comments and replies: comment and reply
README.md - API clients → Auth service: authenticate
README.md - API clients → State API: track progression
README.md - API clients → Reserved game API: future game use
README.md - User routes → Authentication hooks: uses hooks
lib/starter/src/modules/auth/users.routes.ts - Blog API → Blog domain: uses blog schemas
apps/blog-service/src/modules/blogs/blogs.routes.ts - Blog API → Blog content: content operations
- Comments and replies → Blog domain: returns blog data
apps/blog-service/src/modules/comments/comments.routes.ts - Admin API → API definitions: API management
- User routes → User domain: uses user commands
lib/starter/src/modules/auth/users.routes.ts - User domain → User records: queries user data
- Blog API → Blog records: reads and writes blogs
- Blog records → Convex database: persists records
- User records → Convex database: persists records
- State API → ARG rules engine: evaluates progression
apps/state-service/src/modules/state/state.routes.ts - State API → Step definitions: loads step definitions
README.md - State API → Player state: reads and updates state
README.md - ARG rules engine → Progress projection: computes payload
apps/state-service/src/modules/state/ArgRulesEngine.ts - Step definitions → Convex database: stores definitions
- Player state → Convex database: stores progression