# jakasri1974-netizen/coin-lift architecture

> Architecture diagram of the GitHub repository jakasri1974-netizen/coin-lift, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jakasri1974-netizen/coin-lift
- Repository: https://github.com/jakasri1974-netizen/coin-lift

## Overview

CrypLift is a Web3 creator-campaign collaboration platform. Projects publish campaigns; creators discover and apply; project teams review applications, and accepted work proceeds through collaboration, messaging, agreement, performance tracking, and payment. The React client calls an Express API, with Socket.IO supporting live chat and notifications. The README documents verification and moderation capabilities as well. Some subsystem links are based on README workflow documentation because their source was not sampled; these are identified by their evidence paths.

Main entry points: [`backend/routes`](https://github.com/jakasri1974-netizen/coin-lift/tree/main/backend/routes) (API Routes), [`src/App.jsx`](https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/App.jsx) (React App), [`src/services/api.js`](https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/services/api.js) (API Client), [`backend/controllers/applicationController.js`](https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/controllers/applicationController.js) (Application Review)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web Client"]
  node_app["React App<br/>[App.jsx]"]
  node_auth["Auth Context<br/>[AuthContext.jsx]"]
  node_api["API Client<br/>[api.js]"]
  node_socketclient["Socket Client<br/>[socket.js]"]
  node_discoveryui["Discovery Pages<br/>[CreatorsPage.jsx]"]
  node_campaignui["Campaign Pages<br/>[CampaignsPage.jsx]"]
  node_dashboardui["Role Dashboards<br/>[DashboardPage.jsx]"]
  node_chatui["Messaging UI<br/>[MessagesPage.jsx]"]
  node_agreementui["Agreement UI<br/>[AgreementsPage.jsx]"]
  node_analyticsui["Analytics Pages"]
end

subgraph group_core["Campaign Workflow"]
  node_campaigns["Campaigns and Profiles"]
  node_applications["Application Review"]
  node_applicationdata["Applications<br/>[Application.js]"]
  node_collaborations["Collaborations<br/>[Collaboration.js]"]
end

subgraph group_collaboration["Collaboration Tools"]
  node_chat["Chat Controller<br/>[chatController.js]"]
  node_socketserver["Realtime Socket Server<br/>[socketServer.js]"]
  node_agreements["Digital Agreements"]
  node_analytics["Campaign Analytics"]
end

subgraph group_operations["Trust and Operations"]
  node_payments["Escrow Payments"]
  node_paymentservice["Payment Service<br/>[paymentService.js]"]
  node_verification["Verification Workflow"]
  node_admin["Moderation and Audit<br/>[adminController.js]"]
end

subgraph group_runtime["Backend Runtime"]
  node_server["Express Server<br/>[server.js]"]
  node_routes["API Routes"]
  node_authmw["Authentication<br/>[authMiddleware.js]"]
  node_dbconfig["Database Connection<br/>[db.js]"]
  node_mongo[("MongoDB")]
  node_fallback[("Memory Fallback<br/>[memoryStore.js]")]
end

node_participants(("Projects and Creators"))

node_participants -->|"use"| node_app
node_app -->|"provides context"| node_auth
node_auth -->|"calls auth services"| node_api
node_auth -->|"connects on login"| node_socketclient
node_app -->|"routes to"| node_discoveryui
node_app -->|"routes to"| node_campaignui
node_app -->|"routes to"| node_dashboardui
node_app -->|"routes to"| node_chatui
node_app -->|"routes to"| node_agreementui
node_app -->|"routes to"| node_analyticsui
node_discoveryui -.->|"requests data"| node_api
node_campaignui -.->|"requests campaigns"| node_api
node_dashboardui -->|"requests data"| node_api
node_chatui -.->|"requests messages"| node_api
node_agreementui -.->|"requests agreements"| node_api
node_analyticsui -.->|"requests metrics"| node_api
node_api -->|"HTTP requests"| node_server
node_socketclient -->|"opens socket"| node_socketserver
node_server -->|"mounts routes"| node_routes
node_routes -->|"protects endpoints"| node_authmw
node_routes -->|"routes campaign requests"| node_campaigns
node_routes -->|"routes applications"| node_applications
node_applications -->|"persists applications"| node_applicationdata
node_applications -->|"creates accepted work"| node_collaborations
node_applications -->|"coordinates conversation"| node_chat
node_applications -->|"starts agreement flow"| node_agreements
node_routes -->|"routes chat"| node_chat
node_chat -->|"emits notifications"| node_socketserver
node_routes -->|"routes agreements"| node_agreements
node_agreements -->|"emits notifications"| node_socketserver
node_routes -.->|"routes analytics"| node_analytics
node_routes -.->|"routes payments"| node_payments
node_payments -->|"delegates payment work"| node_paymentservice
node_routes -->|"routes verification"| node_verification
node_routes -->|"routes moderation"| node_admin
node_server -->|"connects database"| node_dbconfig
node_dbconfig -->|"connects"| node_mongo
node_authmw -->|"loads user"| node_mongo
node_authmw -->|"loads user offline"| node_fallback
node_chat -->|"reads and writes chat"| node_mongo
node_chat -->|"uses offline data"| node_fallback
node_admin -->|"reads and writes records"| node_mongo
node_admin -->|"uses offline data"| node_fallback
node_verification -->|"stores verification"| node_mongo
node_payments -->|"stores payment state"| node_mongo

click node_app "https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/App.jsx"
click node_auth "https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/context/AuthContext.jsx"
click node_api "https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/services/api.js"
click node_socketclient "https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/services/socket.js"
click node_discoveryui "https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/pages/CreatorsPage.jsx"
click node_campaignui "https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/pages/CampaignsPage.jsx"
click node_dashboardui "https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/pages/DashboardPage.jsx"
click node_chatui "https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/pages/MessagesPage.jsx"
click node_agreementui "https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/pages/AgreementsPage.jsx"
click node_analyticsui "https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/pages/CampaignAnalyticsPage.jsx"
click node_server "https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/server.js"
click node_routes "https://github.com/jakasri1974-netizen/coin-lift/tree/main/backend/routes"
click node_authmw "https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/middleware/authMiddleware.js"
click node_dbconfig "https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/config/db.js"
click node_fallback "https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/utils/memoryStore.js"
click node_campaigns "https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/controllers/campaignController.js"
click node_applications "https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/controllers/applicationController.js"
click node_applicationdata "https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/models/Application.js"
click node_collaborations "https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/models/Collaboration.js"
click node_chat "https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/controllers/chatController.js"
click node_socketserver "https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/sockets/socketServer.js"
click node_agreements "https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/controllers/agreementController.js"
click node_analytics "https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/controllers/analyticsController.js"
click node_payments "https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/controllers/paymentController.js"
click node_paymentservice "https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/services/paymentService.js"
click node_verification "https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/controllers/verificationController.js"
click node_admin "https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/controllers/adminController.js"

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_app,node_auth,node_api,node_socketclient,node_discoveryui,node_campaignui,node_dashboardui,node_chatui,node_agreementui,node_analyticsui toneBlue
class node_campaigns,node_applications,node_applicationdata,node_collaborations toneAmber
class node_chat,node_socketserver,node_agreements,node_analytics toneMint
class node_payments,node_paymentservice,node_verification,node_admin toneRose
class node_server,node_routes,node_authmw,node_dbconfig,node_mongo,node_fallback,node_participants toneIndigo
```

## Components

### Web Client

- [React App](https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/App.jsx): `src/App.jsx`
- [Auth Context](https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [API Client](https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/services/api.js): `src/services/api.js`
- [Socket Client](https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/services/socket.js): `src/services/socket.js`
- [Discovery Pages](https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/pages/CreatorsPage.jsx): `src/pages/CreatorsPage.jsx`
- [Campaign Pages](https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/pages/CampaignsPage.jsx): `src/pages/CampaignsPage.jsx`
- [Role Dashboards](https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/pages/DashboardPage.jsx): `src/pages/DashboardPage.jsx`
- [Messaging UI](https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/pages/MessagesPage.jsx): `src/pages/MessagesPage.jsx`
- [Agreement UI](https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/pages/AgreementsPage.jsx): `src/pages/AgreementsPage.jsx`
- [Analytics Pages](https://github.com/jakasri1974-netizen/coin-lift/blob/main/src/pages/CampaignAnalyticsPage.jsx): `src/pages/CampaignAnalyticsPage.jsx`

### Campaign Workflow

- [Campaigns and Profiles](https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/controllers/campaignController.js): `backend/controllers/campaignController.js`
- [Application Review](https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/controllers/applicationController.js): `backend/controllers/applicationController.js`
- [Applications](https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/models/Application.js): `backend/models/Application.js`
- [Collaborations](https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/models/Collaboration.js): `backend/models/Collaboration.js`

### Collaboration Tools

- [Chat Controller](https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/controllers/chatController.js): `backend/controllers/chatController.js`
- [Realtime Socket Server](https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/sockets/socketServer.js): `backend/sockets/socketServer.js`
- [Digital Agreements](https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/controllers/agreementController.js): `backend/controllers/agreementController.js`
- [Campaign Analytics](https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/controllers/analyticsController.js): `backend/controllers/analyticsController.js`

### Trust and Operations

- [Escrow Payments](https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/controllers/paymentController.js): `backend/controllers/paymentController.js`
- [Payment Service](https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/services/paymentService.js): `backend/services/paymentService.js`
- [Verification Workflow](https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/controllers/verificationController.js): `backend/controllers/verificationController.js`
- [Moderation and Audit](https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/controllers/adminController.js): `backend/controllers/adminController.js`

### Backend Runtime

- [Express Server](https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/server.js): `backend/server.js`
- [API Routes](https://github.com/jakasri1974-netizen/coin-lift/tree/main/backend/routes): `backend/routes`
- [Authentication](https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [Database Connection](https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/config/db.js): `backend/config/db.js`
- **MongoDB**
- [Memory Fallback](https://github.com/jakasri1974-netizen/coin-lift/blob/main/backend/utils/memoryStore.js): `backend/utils/memoryStore.js`

### Other components

- **Projects and Creators**

## Connections

- Projects and Creators → React App: use (evidence: `README.md`)
- React App → Auth Context: provides context (evidence: `src/App.jsx`)
- Auth Context → API Client: calls auth services (evidence: `src/context/AuthContext.jsx`)
- Auth Context → Socket Client: connects on login (evidence: `src/context/AuthContext.jsx`)
- React App → Discovery Pages: routes to (evidence: `src/App.jsx`)
- React App → Campaign Pages: routes to (evidence: `src/App.jsx`)
- React App → Role Dashboards: routes to (evidence: `src/App.jsx`)
- React App → Messaging UI: routes to (evidence: `src/App.jsx`)
- React App → Agreement UI: routes to (evidence: `src/App.jsx`)
- React App → Analytics Pages: routes to (evidence: `src/App.jsx`)
- Discovery Pages → API Client: requests data
- Campaign Pages → API Client: requests campaigns
- Role Dashboards → API Client: requests data (evidence: `src/pages/DashboardPage.jsx`)
- Messaging UI → API Client: requests messages
- Agreement UI → API Client: requests agreements
- Analytics Pages → API Client: requests metrics
- API Client → Express Server: HTTP requests (evidence: `src/services/api.js`)
- Socket Client → Realtime Socket Server: opens socket (evidence: `src/services/socket.js`)
- Express Server → API Routes: mounts routes (evidence: `backend/server.js`)
- API Routes → Authentication: protects endpoints (evidence: `backend/routes/adminRoutes.js`)
- API Routes → Campaigns and Profiles: routes campaign requests (evidence: `backend/routes/campaignRoutes.js`)
- API Routes → Application Review: routes applications (evidence: `backend/routes/campaignRoutes.js`)
- Application Review → Applications: persists applications (evidence: `backend/controllers/applicationController.js`)
- Application Review → Collaborations: creates accepted work (evidence: `README.md`)
- Application Review → Chat Controller: coordinates conversation (evidence: `backend/controllers/applicationController.js`)
- Application Review → Digital Agreements: starts agreement flow (evidence: `backend/controllers/applicationController.js`)
- API Routes → Chat Controller: routes chat (evidence: `backend/routes/chatRoutes.js`)
- Chat Controller → Realtime Socket Server: emits notifications (evidence: `backend/controllers/chatController.js`)
- API Routes → Digital Agreements: routes agreements (evidence: `backend/routes/agreementRoutes.js`)
- Digital Agreements → Realtime Socket Server: emits notifications (evidence: `backend/controllers/agreementController.js`)
- API Routes → Campaign Analytics: routes analytics
- API Routes → Escrow Payments: routes payments
- Escrow Payments → Payment Service: delegates payment work (evidence: `backend/controllers/paymentController.js`)
- API Routes → Verification Workflow: routes verification (evidence: `backend/routes/verificationRoutes.js`)
- API Routes → Moderation and Audit: routes moderation (evidence: `backend/routes/adminRoutes.js`)
- Express Server → Database Connection: connects database (evidence: `backend/server.js`)
- Database Connection → MongoDB: connects (evidence: `backend/config/db.js`)
- Authentication → MongoDB: loads user (evidence: `backend/middleware/authMiddleware.js`)
- Authentication → Memory Fallback: loads user offline (evidence: `backend/middleware/authMiddleware.js`)
- Chat Controller → MongoDB: reads and writes chat (evidence: `backend/controllers/chatController.js`)
- Chat Controller → Memory Fallback: uses offline data (evidence: `backend/controllers/chatController.js`)
- Moderation and Audit → MongoDB: reads and writes records (evidence: `backend/controllers/adminController.js`)
- Moderation and Audit → Memory Fallback: uses offline data (evidence: `backend/controllers/adminController.js`)
- Verification Workflow → MongoDB: stores verification (evidence: `backend/controllers/verificationController.js`)
- Escrow Payments → MongoDB: stores payment state (evidence: `backend/controllers/paymentController.js`)
