How lxwkxy/mobg works
MobG is a team project-management application. The intended user workflow spans sign-in, project and membership management, then tasks, comments, activity, and dashboard views. The README distinguishes implemented backend capabilities from contract-only features and a frontend that still uses local mocks; the graph reflects that boundary rather than implying a live web-to-API integration. Backend routes, guards, project persistence, and mapping are shown where excerpts or the source index support them; unsampled feature implementations are not inferred.
Main entry points: auth.ts Session and role guards · projects.ts Project routes · server.ts Auth endpoint · projectDb.ts Project data access
Components 19
Web experience
- Login and register
web/app/(auth)/login/page.tsx - Project screens
web/app/(main)/projects - Task list
web/app/(main)/mytasks/page.tsx - Dashboard
web/app/(main)/dashboard/page.tsx - Project API client
web/lib/projectApi.ts
Backend API
- Auth endpoint
backend/src/server.ts - Current user route
backend/src/routes/me.ts - Users route
backend/src/routes/users.ts - Project routes
backend/src/routes/projects.ts - API contracts
backend/src/contracts/api.ts
Identity and provisioning
- Better Auth setup
backend/src/auth.ts - Session and role guards
backend/src/middleware/auth.ts - Account provisioning
backend/src/provisioning/accounts.ts
Persistence and mapping
- Project data access
backend/src/services/projectDb.ts - Identity lookup
backend/src/services/authDb.ts - Project response mapping
backend/src/mappers/project.ts - Database helpers
backend/src/services/dbHelpers.ts
Other components
- Team member
- PostgreSQL
Connections 27
- Team member → Login and register: uses
README.md - Team member → Project screens: uses
README.md - Team member → Task list: uses
README.md - Team member → Dashboard: uses
README.md - Project screens → Project API client: uses
- Auth endpoint → Better Auth setup: dispatches
backend/src/server.ts - Auth endpoint → Current user route: routes
backend/src/server.ts - Auth endpoint → Users route: routes
backend/src/server.ts - Auth endpoint → Project routes: routes
backend/src/server.ts - Current user route → Session and role guards: guards
backend/src/routes/me.ts - Users route → Session and role guards: guards
backend/src/routes/users.ts - Project routes → Session and role guards: guards
backend/src/routes/projects.ts - Project routes → Project data access: queries
backend/src/routes/projects.ts - Project routes → Project response mapping: maps responses
backend/src/routes/projects.ts - Project routes → API contracts: types responses
backend/src/routes/projects.ts - Session and role guards → Better Auth setup: checks sessions
backend/src/middleware/auth.ts - Session and role guards → Identity lookup: resolves identity
backend/src/middleware/auth.ts - Session and role guards → Project data access: checks membership
backend/src/middleware/auth.ts - Project data access → Database helpers: uses transactions
backend/src/services/projectDb.ts - Project response mapping → Database helpers: converts IDs
backend/src/mappers/project.ts - Identity lookup → PostgreSQL: queries
backend/src/services/authDb.ts - Project data access → PostgreSQL: reads and writes
backend/src/services/projectDb.ts - Better Auth setup → PostgreSQL: stores auth data
backend/src/auth.ts - Account provisioning → Better Auth setup: creates accounts
backend/src/provisioning/accounts.ts - Account provisioning → PostgreSQL: links profiles
backend/src/provisioning/accounts.ts - Task list → API contracts: feature contract
README.md - Dashboard → API contracts: feature contract
README.md