# shivaa1906/developersmeets architecture

> Architecture diagram of the GitHub repository shivaa1906/developersmeets, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shivaa1906/developersmeets
- Repository: https://github.com/shivaa1906/developersmeets

## Overview

NEXUS is a developer-company operating platform: clients submit projects, leadership reviews them, verified developers claim and propose, clients select a developer, and the work proceeds through completion, publication, and post-completion support. Developers also use a credit wallet, private community, and portfolio; clients and developers have project workspaces and chat, while leadership governs operations through administration and analytics. The graph shows documented server routing and sampled controller/service/database calls; frontend-to-API wiring and several unsampled service relationships are not inferred.

Main entry points: [`backend/src/database/db.ts`](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/database/db.ts) (PostgreSQL access), [`backend/src/server.ts`](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/server.ts) (HTTP and realtime server), [`backend/src/routes/adminRoutes.ts`](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/routes/adminRoutes.ts) (Administration routes), [`backend/src/controllers/projectController.ts`](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/controllers/projectController.ts) (Project controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Web Experience"]
  node_public["Public site<br/>[page.tsx]"]
  node_authui["Sign-in and registration<br/>[page.tsx]"]
  node_developerui["Developer directory<br/>[page.tsx]"]
  node_projectsui["Project showcase<br/>[page.tsx]"]
  node_dashboard["Client and developer dashboard<br/>[page.tsx]"]
  node_adminui["Executive administration<br/>[page.tsx]"]
end

subgraph group_entry["API Entry"]
  node_server["HTTP and realtime server<br/>[server.ts]"]
  node_authroutes["Authentication routes<br/>[authRoutes.ts]"]
  node_projectroutes["Project routes<br/>[projectRoutes.ts]"]
  node_adminroutes["Administration routes<br/>[adminRoutes.ts]"]
  node_authcontroller["Authentication controller<br/>[authController.ts]"]
end

subgraph group_marketplace["Project Lifecycle"]
  node_projectcontroller["Project controller"]
  node_projectservice["Project services<br/>[projectService.ts]"]
  node_credits["Credit ledger"]
end

subgraph group_collaboration["Collaboration"]
  node_workspace["Project workspace"]
  node_chat["Anonymous project chat<br/>[chatService.ts]"]
  node_support["Mediated support<br/>[supportService.ts]"]
  node_community["Developer community"]
  node_notifications["Notifications"]
  node_realtimeclient["Realtime client<br/>[realtime-client.ts]"]
  node_realtime["Realtime server<br/>[realtimeServer.ts]"]
end

subgraph group_governance["Platform Governance"]
  node_admincontroller["Administration controller<br/>[adminController.ts]"]
  node_analytics["Analytics controller"]
  node_database[("PostgreSQL access<br/>[db.ts]")]
end

node_visitor(("Platform users"))

node_visitor -->|"browses"| node_public
node_visitor -->|"signs in"| node_authui
node_visitor -->|"discovers developers"| node_developerui
node_visitor -->|"explores projects"| node_projectsui
node_visitor -->|"manages work"| node_dashboard
node_visitor -->|"governs platform"| node_adminui
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_projectroutes
node_server -->|"mounts"| node_adminroutes
node_server -->|"initializes"| node_realtime
node_authroutes -->|"dispatches"| node_authcontroller
node_projectroutes -->|"dispatches"| node_projectcontroller
node_adminroutes -->|"dispatches"| node_admincontroller
node_adminroutes -->|"dispatches staff operations"| node_support
node_authcontroller -->|"queries and writes"| node_database
node_projectcontroller -->|"queries and writes"| node_database
node_projectcontroller -->|"calls"| node_projectservice
node_projectservice -->|"accesses"| node_database
node_admincontroller -->|"queries and writes"| node_database
node_support -->|"queries and writes"| node_database
node_realtimeclient -->|"exchanges events"| node_realtime

click node_public "https://github.com/shivaa1906/developersmeets/blob/main/frontend/app/page.tsx"
click node_authui "https://github.com/shivaa1906/developersmeets/blob/main/frontend/app/login/page.tsx"
click node_developerui "https://github.com/shivaa1906/developersmeets/blob/main/frontend/app/developers/page.tsx"
click node_projectsui "https://github.com/shivaa1906/developersmeets/blob/main/frontend/app/projects/page.tsx"
click node_dashboard "https://github.com/shivaa1906/developersmeets/blob/main/frontend/app/dashboard/page.tsx"
click node_adminui "https://github.com/shivaa1906/developersmeets/blob/main/frontend/app/admin/page.tsx"
click node_server "https://github.com/shivaa1906/developersmeets/blob/main/backend/src/server.ts"
click node_authroutes "https://github.com/shivaa1906/developersmeets/blob/main/backend/src/routes/authRoutes.ts"
click node_projectroutes "https://github.com/shivaa1906/developersmeets/blob/main/backend/src/routes/projectRoutes.ts"
click node_adminroutes "https://github.com/shivaa1906/developersmeets/blob/main/backend/src/routes/adminRoutes.ts"
click node_authcontroller "https://github.com/shivaa1906/developersmeets/blob/main/backend/src/controllers/authController.ts"
click node_projectcontroller "https://github.com/shivaa1906/developersmeets/blob/main/backend/src/controllers/projectController.ts"
click node_projectservice "https://github.com/shivaa1906/developersmeets/blob/main/backend/src/services/projectService.ts"
click node_credits "https://github.com/shivaa1906/developersmeets/blob/main/backend/src/services/creditLedgerService.ts"
click node_workspace "https://github.com/shivaa1906/developersmeets/blob/main/backend/src/services/workspaceService.ts"
click node_chat "https://github.com/shivaa1906/developersmeets/blob/main/backend/src/services/chatService.ts"
click node_support "https://github.com/shivaa1906/developersmeets/blob/main/backend/src/services/supportService.ts"
click node_community "https://github.com/shivaa1906/developersmeets/blob/main/backend/src/services/communityService.ts"
click node_notifications "https://github.com/shivaa1906/developersmeets/blob/main/backend/src/services/notificationService.ts"
click node_admincontroller "https://github.com/shivaa1906/developersmeets/blob/main/backend/src/controllers/adminController.ts"
click node_analytics "https://github.com/shivaa1906/developersmeets/blob/main/backend/src/controllers/analyticsController.ts"
click node_database "https://github.com/shivaa1906/developersmeets/blob/main/backend/src/database/db.ts"
click node_realtimeclient "https://github.com/shivaa1906/developersmeets/blob/main/frontend/lib/realtime-client.ts"
click node_realtime "https://github.com/shivaa1906/developersmeets/blob/main/backend/src/realtime/realtimeServer.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_public,node_authui,node_developerui,node_projectsui,node_dashboard,node_adminui,node_visitor toneBlue
class node_server,node_authroutes,node_projectroutes,node_adminroutes,node_authcontroller toneAmber
class node_projectcontroller,node_projectservice,node_credits toneMint
class node_workspace,node_chat,node_support,node_community,node_notifications,node_realtimeclient,node_realtime toneRose
class node_admincontroller,node_analytics,node_database toneIndigo
```

## Components

### Web Experience

- [Public site](https://github.com/shivaa1906/developersmeets/blob/main/frontend/app/page.tsx): `frontend/app/page.tsx`
- [Sign-in and registration](https://github.com/shivaa1906/developersmeets/blob/main/frontend/app/login/page.tsx): `frontend/app/login/page.tsx`
- [Developer directory](https://github.com/shivaa1906/developersmeets/blob/main/frontend/app/developers/page.tsx): `frontend/app/developers/page.tsx`
- [Project showcase](https://github.com/shivaa1906/developersmeets/blob/main/frontend/app/projects/page.tsx): `frontend/app/projects/page.tsx`
- [Client and developer dashboard](https://github.com/shivaa1906/developersmeets/blob/main/frontend/app/dashboard/page.tsx): `frontend/app/dashboard/page.tsx`
- [Executive administration](https://github.com/shivaa1906/developersmeets/blob/main/frontend/app/admin/page.tsx): `frontend/app/admin/page.tsx`

### API Entry

- [HTTP and realtime server](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/server.ts): `backend/src/server.ts`
- [Authentication routes](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/routes/authRoutes.ts): `backend/src/routes/authRoutes.ts`
- [Project routes](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/routes/projectRoutes.ts): `backend/src/routes/projectRoutes.ts`
- [Administration routes](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/routes/adminRoutes.ts): `backend/src/routes/adminRoutes.ts`
- [Authentication controller](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/controllers/authController.ts): `backend/src/controllers/authController.ts`

### Project Lifecycle

- [Project controller](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/controllers/projectController.ts): `backend/src/controllers/projectController.ts`
- [Project services](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/services/projectService.ts): `backend/src/services/projectService.ts`
- [Credit ledger](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/services/creditLedgerService.ts): `backend/src/services/creditLedgerService.ts`

### Collaboration

- [Project workspace](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/services/workspaceService.ts): `backend/src/services/workspaceService.ts`
- [Anonymous project chat](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/services/chatService.ts): `backend/src/services/chatService.ts`
- [Mediated support](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/services/supportService.ts): `backend/src/services/supportService.ts`
- [Developer community](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/services/communityService.ts): `backend/src/services/communityService.ts`
- [Notifications](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/services/notificationService.ts): `backend/src/services/notificationService.ts`
- [Realtime client](https://github.com/shivaa1906/developersmeets/blob/main/frontend/lib/realtime-client.ts): `frontend/lib/realtime-client.ts`
- [Realtime server](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/realtime/realtimeServer.ts): `backend/src/realtime/realtimeServer.ts`

### Platform Governance

- [Administration controller](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/controllers/adminController.ts): `backend/src/controllers/adminController.ts`
- [Analytics controller](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/controllers/analyticsController.ts): `backend/src/controllers/analyticsController.ts`
- [PostgreSQL access](https://github.com/shivaa1906/developersmeets/blob/main/backend/src/database/db.ts): `backend/src/database/db.ts`

### Other components

- **Platform users**

## Connections

- Platform users → Public site: browses
- Platform users → Sign-in and registration: signs in
- Platform users → Developer directory: discovers developers
- Platform users → Project showcase: explores projects
- Platform users → Client and developer dashboard: manages work
- Platform users → Executive administration: governs platform
- HTTP and realtime server → Authentication routes: mounts
- HTTP and realtime server → Project routes: mounts
- HTTP and realtime server → Administration routes: mounts
- HTTP and realtime server → Realtime server: initializes
- Authentication routes → Authentication controller: dispatches
- Project routes → Project controller: dispatches
- Administration routes → Administration controller: dispatches
- Administration routes → Mediated support: dispatches staff operations
- Authentication controller → PostgreSQL access: queries and writes
- Project controller → PostgreSQL access: queries and writes
- Project controller → Project services: calls
- Project services → PostgreSQL access: accesses
- Administration controller → PostgreSQL access: queries and writes
- Mediated support → PostgreSQL access: queries and writes
- Realtime client → Realtime server: exchanges events