# mehdi220320/backenddeploycowriter architecture

> Architecture diagram of the GitHub repository mehdi220320/backenddeploycowriter, 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/mehdi220320/backenddeploycowriter
- Repository: https://github.com/mehdi220320/backenddeploycowriter

## Overview

CoWriter is a collaborative-writing API. Users authenticate and join rooms; room members create books, contribute chapter versions, vote, and confirm chapters as the book progresses. The graph separates API routing, identity, room collaboration, writing workflows, and persistence/integrations. Edges reflect shown route mounts and controller/service/model references; unsampled implementations are represented only where the source index establishes those references.

Main entry points: [`services/bookService.js`](https://github.com/mehdi220320/backenddeploycowriter/blob/main/services/bookService.js) (Book Service), [`services/chapterService.js`](https://github.com/mehdi220320/backenddeploycowriter/blob/main/services/chapterService.js) (Chapter Service), [`app.js`](https://github.com/mehdi220320/backenddeploycowriter/blob/main/app.js) (API Application), [`services/UserService.js`](https://github.com/mehdi220320/backenddeploycowriter/blob/main/services/UserService.js) (User Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API Layer"]
  node_app["API Application<br/>[app.js]"]
  node_authroutes["Auth Routes<br/>[authRoutes.js]"]
  node_userroutes["User Routes<br/>[userRoutes.js]"]
  node_roomroutes["Room Routes<br/>[roomRoutes.js]"]
  node_bookroutes["Book Routes<br/>[bookRoutes.js]"]
  node_chapterroutes["Chapter Routes<br/>[chapterRoutes.js]"]
  node_paraphraseroutes["Paraphrase Routes"]
  node_textroutes["Text Routes<br/>[text.routes.js]"]
end

subgraph group_identity["Identity"]
  node_authcontroller["Authentication<br/>[authController.js]"]
  node_usercontroller["User Management<br/>[UserController.js]"]
  node_userservice["User Service<br/>[UserService.js]"]
end

subgraph group_rooms["Room Collaboration"]
  node_roomcontroller["Room Management<br/>[roomController.js]"]
  node_roomservice["Room Service<br/>[roomService.js]"]
  node_upload["Cover Upload"]
end

subgraph group_writing["Writing Workflow"]
  node_bookcontroller["Book Management<br/>[bookController.js]"]
  node_bookservice["Book Service<br/>[bookService.js]"]
  node_chaptercontroller["Chapter Management"]
  node_chapterservice["Chapter Service<br/>[chapterService.js]"]
  node_paraphrasecontroller["Paraphrase"]
  node_paraphraseservice["Paraphrase Service"]
  node_textcontroller["Text Generation<br/>[text.Controller.js]"]
  node_geminiservice["Gemini Service<br/>[geminiService.js]"]
end

subgraph group_data["Persistence and Integrations"]
  node_usermodel[("User Records<br/>[User.js]")]
  node_roommodel[("Room Records<br/>[Room.js]")]
  node_bookmodel[("Book Records<br/>[Book.js]")]
  node_chaptermodel[("Chapter Records<br/>[Chapter.js]")]
  node_versionmodel[("Chapter Versions<br/>[ChapterVersion.js]")]
  node_votemodel[("Votes<br/>[Vote.js]")]
  node_uploads[("Uploaded Files")]
end

node_user(("User"))
node_google{{"Google Identity"}}

node_user -->|"sends requests"| node_app
node_app -->|"mounts"| node_authroutes
node_app -->|"mounts"| node_userroutes
node_app -->|"mounts"| node_roomroutes
node_app -->|"mounts"| node_bookroutes
node_app -->|"mounts"| node_chapterroutes
node_app -->|"mounts"| node_textroutes
node_app -->|"serves files"| node_uploads
node_authroutes -->|"routes to"| node_authcontroller
node_userroutes -->|"routes to"| node_usercontroller
node_roomroutes -->|"routes to"| node_roomcontroller
node_roomroutes -->|"processes cover"| node_upload
node_bookroutes -->|"routes to"| node_bookcontroller
node_bookroutes -->|"processes cover"| node_upload
node_chapterroutes -->|"routes to"| node_chaptercontroller
node_paraphraseroutes -->|"routes to"| node_paraphrasecontroller
node_textroutes -->|"routes to"| node_textcontroller
node_authcontroller -->|"uses"| node_userservice
node_authcontroller -->|"queries"| node_usermodel
node_authcontroller -->|"verifies identity"| node_google
node_usercontroller -->|"uses"| node_userservice
node_userservice -->|"reads and writes"| node_usermodel
node_roomcontroller -->|"uses"| node_roomservice
node_roomservice -->|"reads and writes"| node_roommodel
node_bookcontroller -->|"uses"| node_bookservice
node_bookservice -->|"looks up room"| node_roomservice
node_bookservice -->|"looks up creator"| node_userservice
node_bookservice -->|"creates chapters"| node_chapterservice
node_bookservice -->|"reads and writes"| node_bookmodel
node_bookservice -->|"queries"| node_roommodel
node_bookservice -->|"queries"| node_chaptermodel
node_bookservice -->|"queries"| node_versionmodel
node_chaptercontroller -->|"uses"| node_chapterservice
node_chapterservice -->|"reads and writes"| node_chaptermodel
node_chapterservice -->|"reads and updates"| node_bookmodel
node_chapterservice -->|"stores submissions"| node_versionmodel
node_chapterservice -->|"records votes"| node_votemodel
node_chapterservice -->|"looks up creator"| node_usermodel
node_chapterservice -->|"uses"| node_bookservice
node_chapterservice -->|"uses"| node_userservice
node_paraphrasecontroller -->|"uses"| node_paraphraseservice
node_textcontroller -->|"uses"| node_geminiservice

click node_app "https://github.com/mehdi220320/backenddeploycowriter/blob/main/app.js"
click node_authroutes "https://github.com/mehdi220320/backenddeploycowriter/blob/main/routes/authRoutes.js"
click node_userroutes "https://github.com/mehdi220320/backenddeploycowriter/blob/main/routes/userRoutes.js"
click node_roomroutes "https://github.com/mehdi220320/backenddeploycowriter/blob/main/routes/roomRoutes.js"
click node_bookroutes "https://github.com/mehdi220320/backenddeploycowriter/blob/main/routes/bookRoutes.js"
click node_chapterroutes "https://github.com/mehdi220320/backenddeploycowriter/blob/main/routes/chapterRoutes.js"
click node_paraphraseroutes "https://github.com/mehdi220320/backenddeploycowriter/blob/main/routes/paraphraseRoutes.js"
click node_textroutes "https://github.com/mehdi220320/backenddeploycowriter/blob/main/routes/text.routes.js"
click node_authcontroller "https://github.com/mehdi220320/backenddeploycowriter/blob/main/controllers/authController.js"
click node_usercontroller "https://github.com/mehdi220320/backenddeploycowriter/blob/main/controllers/UserController.js"
click node_userservice "https://github.com/mehdi220320/backenddeploycowriter/blob/main/services/UserService.js"
click node_usermodel "https://github.com/mehdi220320/backenddeploycowriter/blob/main/models/User.js"
click node_roomcontroller "https://github.com/mehdi220320/backenddeploycowriter/blob/main/controllers/roomController.js"
click node_roomservice "https://github.com/mehdi220320/backenddeploycowriter/blob/main/services/roomService.js"
click node_roommodel "https://github.com/mehdi220320/backenddeploycowriter/blob/main/models/Room.js"
click node_upload "https://github.com/mehdi220320/backenddeploycowriter/blob/main/middlewares/uploadMiddleware.js"
click node_bookcontroller "https://github.com/mehdi220320/backenddeploycowriter/blob/main/controllers/bookController.js"
click node_bookservice "https://github.com/mehdi220320/backenddeploycowriter/blob/main/services/bookService.js"
click node_bookmodel "https://github.com/mehdi220320/backenddeploycowriter/blob/main/models/Book.js"
click node_chaptercontroller "https://github.com/mehdi220320/backenddeploycowriter/blob/main/controllers/chapterController.js"
click node_chapterservice "https://github.com/mehdi220320/backenddeploycowriter/blob/main/services/chapterService.js"
click node_chaptermodel "https://github.com/mehdi220320/backenddeploycowriter/blob/main/models/Chapter.js"
click node_versionmodel "https://github.com/mehdi220320/backenddeploycowriter/blob/main/models/ChapterVersion.js"
click node_votemodel "https://github.com/mehdi220320/backenddeploycowriter/blob/main/models/Vote.js"
click node_paraphrasecontroller "https://github.com/mehdi220320/backenddeploycowriter/blob/main/controllers/paraphraseController.js"
click node_paraphraseservice "https://github.com/mehdi220320/backenddeploycowriter/blob/main/services/paraphraseService.js"
click node_textcontroller "https://github.com/mehdi220320/backenddeploycowriter/blob/main/controllers/text.Controller.js"
click node_geminiservice "https://github.com/mehdi220320/backenddeploycowriter/blob/main/services/geminiService.js"
click node_uploads "https://github.com/mehdi220320/backenddeploycowriter/tree/main/uploads"

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_authroutes,node_userroutes,node_roomroutes,node_bookroutes,node_chapterroutes,node_paraphraseroutes,node_textroutes,node_user toneBlue
class node_authcontroller,node_usercontroller,node_userservice toneAmber
class node_roomcontroller,node_roomservice,node_upload toneMint
class node_bookcontroller,node_bookservice,node_chaptercontroller,node_chapterservice,node_paraphrasecontroller,node_paraphraseservice,node_textcontroller,node_geminiservice toneRose
class node_usermodel,node_roommodel,node_bookmodel,node_chaptermodel,node_versionmodel,node_votemodel,node_uploads,node_google toneIndigo
```

## Components

### API Layer

- [API Application](https://github.com/mehdi220320/backenddeploycowriter/blob/main/app.js): `app.js`
- [Auth Routes](https://github.com/mehdi220320/backenddeploycowriter/blob/main/routes/authRoutes.js): `routes/authRoutes.js`
- [User Routes](https://github.com/mehdi220320/backenddeploycowriter/blob/main/routes/userRoutes.js): `routes/userRoutes.js`
- [Room Routes](https://github.com/mehdi220320/backenddeploycowriter/blob/main/routes/roomRoutes.js): `routes/roomRoutes.js`
- [Book Routes](https://github.com/mehdi220320/backenddeploycowriter/blob/main/routes/bookRoutes.js): `routes/bookRoutes.js`
- [Chapter Routes](https://github.com/mehdi220320/backenddeploycowriter/blob/main/routes/chapterRoutes.js): `routes/chapterRoutes.js`
- [Paraphrase Routes](https://github.com/mehdi220320/backenddeploycowriter/blob/main/routes/paraphraseRoutes.js): `routes/paraphraseRoutes.js`
- [Text Routes](https://github.com/mehdi220320/backenddeploycowriter/blob/main/routes/text.routes.js): `routes/text.routes.js`

### Identity

- [Authentication](https://github.com/mehdi220320/backenddeploycowriter/blob/main/controllers/authController.js): `controllers/authController.js`
- [User Management](https://github.com/mehdi220320/backenddeploycowriter/blob/main/controllers/UserController.js): `controllers/UserController.js`
- [User Service](https://github.com/mehdi220320/backenddeploycowriter/blob/main/services/UserService.js): `services/UserService.js`

### Room Collaboration

- [Room Management](https://github.com/mehdi220320/backenddeploycowriter/blob/main/controllers/roomController.js): `controllers/roomController.js`
- [Room Service](https://github.com/mehdi220320/backenddeploycowriter/blob/main/services/roomService.js): `services/roomService.js`
- [Cover Upload](https://github.com/mehdi220320/backenddeploycowriter/blob/main/middlewares/uploadMiddleware.js): `middlewares/uploadMiddleware.js`

### Writing Workflow

- [Book Management](https://github.com/mehdi220320/backenddeploycowriter/blob/main/controllers/bookController.js): `controllers/bookController.js`
- [Book Service](https://github.com/mehdi220320/backenddeploycowriter/blob/main/services/bookService.js): `services/bookService.js`
- [Chapter Management](https://github.com/mehdi220320/backenddeploycowriter/blob/main/controllers/chapterController.js): `controllers/chapterController.js`
- [Chapter Service](https://github.com/mehdi220320/backenddeploycowriter/blob/main/services/chapterService.js): `services/chapterService.js`
- [Paraphrase](https://github.com/mehdi220320/backenddeploycowriter/blob/main/controllers/paraphraseController.js): `controllers/paraphraseController.js`
- [Paraphrase Service](https://github.com/mehdi220320/backenddeploycowriter/blob/main/services/paraphraseService.js): `services/paraphraseService.js`
- [Text Generation](https://github.com/mehdi220320/backenddeploycowriter/blob/main/controllers/text.Controller.js): `controllers/text.Controller.js`
- [Gemini Service](https://github.com/mehdi220320/backenddeploycowriter/blob/main/services/geminiService.js): `services/geminiService.js`

### Persistence and Integrations

- [User Records](https://github.com/mehdi220320/backenddeploycowriter/blob/main/models/User.js): `models/User.js`
- [Room Records](https://github.com/mehdi220320/backenddeploycowriter/blob/main/models/Room.js): `models/Room.js`
- [Book Records](https://github.com/mehdi220320/backenddeploycowriter/blob/main/models/Book.js): `models/Book.js`
- [Chapter Records](https://github.com/mehdi220320/backenddeploycowriter/blob/main/models/Chapter.js): `models/Chapter.js`
- [Chapter Versions](https://github.com/mehdi220320/backenddeploycowriter/blob/main/models/ChapterVersion.js): `models/ChapterVersion.js`
- [Votes](https://github.com/mehdi220320/backenddeploycowriter/blob/main/models/Vote.js): `models/Vote.js`
- [Uploaded Files](https://github.com/mehdi220320/backenddeploycowriter/tree/main/uploads): `uploads`

### Other components

- **User**
- **Google Identity**

## Connections

- User → API Application: sends requests (evidence: `app.js`)
- API Application → Auth Routes: mounts (evidence: `app.js`)
- API Application → User Routes: mounts (evidence: `app.js`)
- API Application → Room Routes: mounts (evidence: `app.js`)
- API Application → Book Routes: mounts (evidence: `app.js`)
- API Application → Chapter Routes: mounts (evidence: `app.js`)
- API Application → Text Routes: mounts (evidence: `app.js`)
- API Application → Uploaded Files: serves files (evidence: `app.js`)
- Auth Routes → Authentication: routes to (evidence: `routes/authRoutes.js`)
- User Routes → User Management: routes to (evidence: `routes/userRoutes.js`)
- Room Routes → Room Management: routes to (evidence: `routes/roomRoutes.js`)
- Room Routes → Cover Upload: processes cover (evidence: `routes/roomRoutes.js`)
- Book Routes → Book Management: routes to (evidence: `routes/bookRoutes.js`)
- Book Routes → Cover Upload: processes cover (evidence: `routes/bookRoutes.js`)
- Chapter Routes → Chapter Management: routes to (evidence: `routes/chapterRoutes.js`)
- Paraphrase Routes → Paraphrase: routes to (evidence: `routes/paraphraseRoutes.js`)
- Text Routes → Text Generation: routes to (evidence: `routes/text.routes.js`)
- Authentication → User Service: uses (evidence: `controllers/authController.js`)
- Authentication → User Records: queries (evidence: `controllers/authController.js`)
- Authentication → Google Identity: verifies identity (evidence: `controllers/authController.js`)
- User Management → User Service: uses (evidence: `controllers/UserController.js`)
- User Service → User Records: reads and writes (evidence: `services/UserService.js`)
- Room Management → Room Service: uses (evidence: `controllers/roomController.js`)
- Room Service → Room Records: reads and writes (evidence: `services/roomService.js`)
- Book Management → Book Service: uses (evidence: `controllers/bookController.js`)
- Book Service → Room Service: looks up room (evidence: `services/bookService.js`)
- Book Service → User Service: looks up creator (evidence: `services/bookService.js`)
- Book Service → Chapter Service: creates chapters (evidence: `services/bookService.js`)
- Book Service → Book Records: reads and writes (evidence: `services/bookService.js`)
- Book Service → Room Records: queries (evidence: `services/bookService.js`)
- Book Service → Chapter Records: queries (evidence: `services/bookService.js`)
- Book Service → Chapter Versions: queries (evidence: `services/bookService.js`)
- Chapter Management → Chapter Service: uses (evidence: `controllers/chapterController.js`)
- Chapter Service → Chapter Records: reads and writes (evidence: `services/chapterService.js`)
- Chapter Service → Book Records: reads and updates (evidence: `services/chapterService.js`)
- Chapter Service → Chapter Versions: stores submissions (evidence: `services/chapterService.js`)
- Chapter Service → Votes: records votes (evidence: `services/chapterService.js`)
- Chapter Service → User Records: looks up creator (evidence: `services/chapterService.js`)
- Chapter Service → Book Service: uses (evidence: `services/chapterService.js`)
- Chapter Service → User Service: uses (evidence: `services/chapterService.js`)
- Paraphrase → Paraphrase Service: uses (evidence: `controllers/paraphraseController.js`)
- Text Generation → Gemini Service: uses (evidence: `controllers/text.Controller.js`)
