# sharadwowevents/booklist-v2 architecture

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

- Interactive diagram: https://gitdiagram.com/sharadwowevents/booklist-v2
- Repository: https://github.com/sharadwowevents/booklist-v2

## Overview

MyDeepwork is a React/Express productivity workspace backed by MongoDB. A user enters through the web app, authenticates, and works with lists, rich notes and drawings, CRM, or journal features; the frontend context manages workspace state and uses an API client to reach backend endpoints. The backend also exposes sharing, administration, notifications, chat, audio, and MCP capabilities. Several subsystems are represented by their exact source directories because their implementation excerpts were not sampled; links to them are included only where the README or indexed references support them.

Main entry points: [`backend/src/server.js`](https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/server.js) (Express API), [`frontend/src/App.jsx`](https://github.com/sharadwowevents/booklist-v2/blob/main/frontend/src/App.jsx) (App shell), [`backend/src/controllers/adminController.js`](https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/controllers/adminController.js) (Admin operations), [`backend/src/services/auditLogService.js`](https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/services/auditLogService.js) (Audit logging)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Workspace frontend"]
  node_app["App shell<br/>[App.jsx]"]
  node_context["Workspace state<br/>[AppContext.jsx]"]
  node_api["API client<br/>[api.js]"]
  node_lists["Lists and todos<br/>[ListView.jsx]"]
  node_notes["Notes and inking<br/>[NoteView.jsx]"]
  node_crm["CRM workspace<br/>[CrmView.jsx]"]
  node_journal["Journal<br/>[JournalView.jsx]"]
  node_login["Authentication UI<br/>[Login.jsx]"]
  node_adminui["Admin dashboard<br/>[AdminPanel.jsx]"]
end

subgraph group_core["Workspace and sharing"]
  node_board["Board operations<br/>[boardController.js]"]
  node_share["Publishing and sharing<br/>[shareController.js]"]
end

subgraph group_services["Additional capabilities"]
  node_admin["Admin operations<br/>[adminController.js]"]
  node_chat["Chat assistant<br/>[chatController.js]"]
  node_notifications["Notifications"]
  node_crmapi["CRM operations<br/>[crmController.js]"]
  node_mcp["MCP interface"]
  node_ollama["Ollama integration<br/>[ollamaService.js]"]
end

subgraph group_platform["Backend platform"]
  node_backend["Express API<br/>[server.js]"]
  node_auth["Authentication<br/>[authController.js]"]
  node_mongo[("MongoDB<br/>[db.js]")]
  node_audit["Audit logging<br/>[auditLogService.js]"]
  node_backup["Backup service<br/>[backupService.js]"]
  node_email["Email delivery<br/>[emailService.js]"]
end

node_user(("Workspace user"))

node_user -->|"uses workspace"| node_app
node_app -->|"provides state"| node_context
node_app -->|"renders"| node_lists
node_app -->|"renders"| node_notes
node_app -->|"renders"| node_crm
node_app -->|"renders"| node_journal
node_app -->|"renders"| node_login
node_app -->|"renders"| node_adminui
node_context -->|"calls"| node_api
node_api -->|"sends API requests"| node_backend
node_backend -->|"connects"| node_mongo
node_backend -->|"mounts auth routes"| node_auth
node_backend -->|"mounts board routes"| node_board
node_backend -->|"mounts share routes"| node_share
node_backend -->|"mounts admin routes"| node_admin
node_backend -->|"mounts CRM routes"| node_crmapi
node_backend -->|"mounts chat routes"| node_chat
node_backend -->|"mounts notification routes"| node_notifications
node_backend -->|"sets up MCP"| node_mcp
node_backend -->|"starts scheduler"| node_backup
node_backend -->|"records actions"| node_audit
node_auth -->|"sends reset email"| node_email
node_auth -->|"records auth events"| node_audit
node_board -->|"records changes"| node_audit
node_admin -->|"creates backup"| node_backup
node_admin -->|"records admin actions"| node_audit
node_admin -->|"sends reset email"| node_email
node_chat -.->|"uses model"| node_ollama
node_notifications -.->|"delivers updates"| node_user

click node_app "https://github.com/sharadwowevents/booklist-v2/blob/main/frontend/src/App.jsx"
click node_context "https://github.com/sharadwowevents/booklist-v2/blob/main/frontend/src/context/AppContext.jsx"
click node_api "https://github.com/sharadwowevents/booklist-v2/blob/main/frontend/src/services/api.js"
click node_lists "https://github.com/sharadwowevents/booklist-v2/blob/main/frontend/src/components/ListView.jsx"
click node_notes "https://github.com/sharadwowevents/booklist-v2/blob/main/frontend/src/components/NoteView.jsx"
click node_crm "https://github.com/sharadwowevents/booklist-v2/blob/main/frontend/src/components/CrmView.jsx"
click node_journal "https://github.com/sharadwowevents/booklist-v2/blob/main/frontend/src/components/JournalView.jsx"
click node_login "https://github.com/sharadwowevents/booklist-v2/blob/main/frontend/src/components/Login.jsx"
click node_adminui "https://github.com/sharadwowevents/booklist-v2/blob/main/frontend/src/components/AdminPanel.jsx"
click node_backend "https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/server.js"
click node_auth "https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/controllers/authController.js"
click node_board "https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/controllers/boardController.js"
click node_share "https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/controllers/shareController.js"
click node_admin "https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/controllers/adminController.js"
click node_chat "https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/controllers/chatController.js"
click node_notifications "https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/controllers/notificationController.js"
click node_crmapi "https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/controllers/crmController.js"
click node_mcp "https://github.com/sharadwowevents/booklist-v2/tree/main/backend/src/mcp"
click node_mongo "https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/config/db.js"
click node_audit "https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/services/auditLogService.js"
click node_backup "https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/services/backupService.js"
click node_email "https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/services/emailService.js"
click node_ollama "https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/services/ollamaService.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_context,node_api,node_lists,node_notes,node_crm,node_journal,node_login,node_adminui,node_user toneBlue
class node_board,node_share toneAmber
class node_admin,node_chat,node_notifications,node_crmapi,node_mcp,node_ollama toneMint
class node_backend,node_auth,node_mongo,node_audit,node_backup,node_email toneRose
```

## Components

### Workspace frontend

- [App shell](https://github.com/sharadwowevents/booklist-v2/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Workspace state](https://github.com/sharadwowevents/booklist-v2/blob/main/frontend/src/context/AppContext.jsx): `frontend/src/context/AppContext.jsx`
- [API client](https://github.com/sharadwowevents/booklist-v2/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Lists and todos](https://github.com/sharadwowevents/booklist-v2/blob/main/frontend/src/components/ListView.jsx): `frontend/src/components/ListView.jsx`
- [Notes and inking](https://github.com/sharadwowevents/booklist-v2/blob/main/frontend/src/components/NoteView.jsx): `frontend/src/components/NoteView.jsx`
- [CRM workspace](https://github.com/sharadwowevents/booklist-v2/blob/main/frontend/src/components/CrmView.jsx): `frontend/src/components/CrmView.jsx`
- [Journal](https://github.com/sharadwowevents/booklist-v2/blob/main/frontend/src/components/JournalView.jsx): `frontend/src/components/JournalView.jsx`
- [Authentication UI](https://github.com/sharadwowevents/booklist-v2/blob/main/frontend/src/components/Login.jsx): `frontend/src/components/Login.jsx`
- [Admin dashboard](https://github.com/sharadwowevents/booklist-v2/blob/main/frontend/src/components/AdminPanel.jsx): `frontend/src/components/AdminPanel.jsx`

### Workspace and sharing

- [Board operations](https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/controllers/boardController.js): `backend/src/controllers/boardController.js`
- [Publishing and sharing](https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/controllers/shareController.js): `backend/src/controllers/shareController.js`

### Additional capabilities

- [Admin operations](https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/controllers/adminController.js): `backend/src/controllers/adminController.js`
- [Chat assistant](https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/controllers/chatController.js): `backend/src/controllers/chatController.js`
- [Notifications](https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/controllers/notificationController.js): `backend/src/controllers/notificationController.js`
- [CRM operations](https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/controllers/crmController.js): `backend/src/controllers/crmController.js`
- [MCP interface](https://github.com/sharadwowevents/booklist-v2/tree/main/backend/src/mcp): `backend/src/mcp`
- [Ollama integration](https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/services/ollamaService.js): `backend/src/services/ollamaService.js`

### Backend platform

- [Express API](https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/server.js): `backend/src/server.js`
- [Authentication](https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/controllers/authController.js): `backend/src/controllers/authController.js`
- [MongoDB](https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/config/db.js): `backend/src/config/db.js`
- [Audit logging](https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/services/auditLogService.js): `backend/src/services/auditLogService.js`
- [Backup service](https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/services/backupService.js): `backend/src/services/backupService.js`
- [Email delivery](https://github.com/sharadwowevents/booklist-v2/blob/main/backend/src/services/emailService.js): `backend/src/services/emailService.js`

### Other components

- **Workspace user**

## Connections

- Workspace user → App shell: uses workspace
- App shell → Workspace state: provides state (evidence: `frontend/src/App.jsx`)
- App shell → Lists and todos: renders (evidence: `frontend/src/App.jsx`)
- App shell → Notes and inking: renders (evidence: `frontend/src/App.jsx`)
- App shell → CRM workspace: renders (evidence: `frontend/src/App.jsx`)
- App shell → Journal: renders (evidence: `frontend/src/App.jsx`)
- App shell → Authentication UI: renders (evidence: `frontend/src/App.jsx`)
- App shell → Admin dashboard: renders (evidence: `frontend/src/App.jsx`)
- Workspace state → API client: calls (evidence: `frontend/src/context/AppContext.jsx`)
- API client → Express API: sends API requests
- Express API → MongoDB: connects (evidence: `backend/src/server.js`)
- Express API → Authentication: mounts auth routes (evidence: `backend/src/server.js`)
- Express API → Board operations: mounts board routes (evidence: `backend/src/server.js`)
- Express API → Publishing and sharing: mounts share routes (evidence: `backend/src/server.js`)
- Express API → Admin operations: mounts admin routes (evidence: `backend/src/server.js`)
- Express API → CRM operations: mounts CRM routes (evidence: `backend/src/server.js`)
- Express API → Chat assistant: mounts chat routes (evidence: `backend/src/server.js`)
- Express API → Notifications: mounts notification routes (evidence: `backend/src/server.js`)
- Express API → MCP interface: sets up MCP (evidence: `backend/src/server.js`)
- Express API → Backup service: starts scheduler (evidence: `backend/src/server.js`)
- Express API → Audit logging: records actions
- Authentication → Email delivery: sends reset email (evidence: `backend/src/controllers/authController.js`)
- Authentication → Audit logging: records auth events (evidence: `backend/src/controllers/authController.js`)
- Board operations → Audit logging: records changes (evidence: `backend/src/controllers/boardController.js`)
- Admin operations → Backup service: creates backup (evidence: `backend/src/controllers/adminController.js`)
- Admin operations → Audit logging: records admin actions (evidence: `backend/src/controllers/adminController.js`)
- Admin operations → Email delivery: sends reset email (evidence: `backend/src/controllers/adminController.js`)
- Chat assistant → Ollama integration: uses model
- Notifications → Workspace user: delivers updates
