# bintangx2005-netizen/resume-builder architecture

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

- Interactive diagram: https://gitdiagram.com/bintangx2005-netizen/resume-builder
- Repository: https://github.com/bintangx2005-netizen/resume-builder

## Overview

Resume Builder is a web application for creating, editing, and publicly previewing resumes, with account authentication, AI-assisted writing/import, and administrator user management. The main flow is login, open the user dashboard, edit a resume, save it, then render a public preview. The graph includes the documented AI, image-upload, and admin capabilities; some client-to-server wiring is not shown in excerpts, so uncertain links are omitted.

Main entry points: [`client/src/App.jsx`](https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/App.jsx) (Route App), [`server/controllers/userControllers.js`](https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/controllers/userControllers.js) (Account Operations), [`server/server.js`](https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/server.js) (HTTP Server), [`server/routes/resumeRoutes.js`](https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/routes/resumeRoutes.js) (Resume Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Resume Web App"]
  node_app["Route App<br/>[App.jsx]"]
  node_landing["Landing Page<br/>[Home.jsx]"]
  node_dashboard["Resume Dashboard<br/>[Dashboard.jsx]"]
  node_builder["Resume Editor<br/>[ResumeBuilder.jsx]"]
  node_editorforms["Resume Forms"]
  node_previewpage["Public Preview Page<br/>[Preview.jsx]"]
  node_preview["Template Preview<br/>[ResumePreview.jsx]"]
  node_templates["Resume Templates"]
  node_api["HTTP Client<br/>[api.js]"]
end

subgraph group_server["Resume Services"]
  node_server["HTTP Server<br/>[server.js]"]
  node_resume_routes["Resume Routes<br/>[resumeRoutes.js]"]
  node_resume_controller["Resume Operations"]
  node_ai_routes["AI Routes<br/>[aiRoutes.js]"]
  node_resume_store[("Resume Records<br/>[Resume.js]")]
end

subgraph group_identity["Accounts &amp; Admin"]
  node_login["Login Page<br/>[Login.jsx]"]
  node_authstate["Auth State<br/>[authSlice.js]"]
  node_useroutes["User Routes<br/>[userRoutes.js]"]
  node_usercontroller["Account Operations<br/>[userControllers.js]"]
  node_auth_middleware["Token &amp; Role Checks<br/>[authMiddleware.js]"]
  node_user_store[("User Records<br/>[User.js]")]
  node_admin["Admin User Management<br/>[UserManagement.jsx]"]
end

subgraph group_integrations["External Integrations"]
  node_ai_controller["AI Resume Tools<br/>[aiController.js]"]
  node_ai_service["AI Provider"]
  node_imagekit["ImageKit"]
  node_email["Email Service"]
end

node_visitor(("Visitor"))
node_database[("MongoDB")]

node_visitor -->|"opens"| node_app
node_app -->|"routes to"| node_landing
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_builder
node_app -->|"routes to"| node_previewpage
node_app -->|"dispatches"| node_authstate
node_login -->|"calls"| node_api
node_login -->|"updates"| node_authstate
node_dashboard -->|"calls"| node_api
node_builder -->|"renders"| node_editorforms
node_builder -->|"renders"| node_preview
node_previewpage -->|"fetches public resume"| node_api
node_previewpage -->|"renders"| node_preview
node_preview -->|"selects template"| node_templates
node_server -->|"registers"| node_useroutes
node_server -->|"registers"| node_resume_routes
node_server -->|"registers"| node_ai_routes
node_useroutes -->|"dispatches"| node_usercontroller
node_resume_routes -->|"dispatches"| node_resume_controller
node_resume_routes -->|"dispatches"| node_usercontroller
node_ai_routes -->|"dispatches"| node_ai_controller
node_useroutes -->|"protects routes"| node_auth_middleware
node_resume_routes -->|"protects routes"| node_auth_middleware
node_ai_routes -->|"protects routes"| node_auth_middleware
node_usercontroller -->|"reads and writes"| node_user_store
node_usercontroller -->|"reads"| node_resume_store
node_usercontroller -->|"sends email"| node_email
node_resume_controller -->|"reads and writes"| node_resume_store
node_resume_controller -->|"uploads images"| node_imagekit
node_ai_controller -->|"requests completions"| node_ai_service
node_ai_controller -->|"creates resume"| node_resume_store
node_admin -->|"calls"| node_api
node_server -->|"connects"| node_database

click node_app "https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/App.jsx"
click node_landing "https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/pages/Home.jsx"
click node_login "https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/pages/Login.jsx"
click node_authstate "https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/app/features/authSlice.js"
click node_dashboard "https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/pages/Dashboard.jsx"
click node_builder "https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/pages/ResumeBuilder.jsx"
click node_editorforms "https://github.com/bintangx2005-netizen/resume-builder/tree/main/client/src/Components"
click node_previewpage "https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/pages/Preview.jsx"
click node_preview "https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/Components/ResumePreview.jsx"
click node_templates "https://github.com/bintangx2005-netizen/resume-builder/tree/main/client/src/Components/templates"
click node_api "https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/configs/api.js"
click node_server "https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/server.js"
click node_useroutes "https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/routes/userRoutes.js"
click node_usercontroller "https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/controllers/userControllers.js"
click node_resume_routes "https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/routes/resumeRoutes.js"
click node_resume_controller "https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/controllers/ResumeControllers.js"
click node_ai_routes "https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/routes/aiRoutes.js"
click node_ai_controller "https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/controllers/aiController.js"
click node_auth_middleware "https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/middlewares/authMiddleware.js"
click node_resume_store "https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/models/Resume.js"
click node_user_store "https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/models/User.js"
click node_admin "https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/pages/Admin/UserManagement.jsx"

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_landing,node_dashboard,node_builder,node_editorforms,node_previewpage,node_preview,node_templates,node_api toneBlue
class node_server,node_resume_routes,node_resume_controller,node_ai_routes,node_resume_store,node_database toneAmber
class node_login,node_authstate,node_useroutes,node_usercontroller,node_auth_middleware,node_user_store,node_admin toneMint
class node_ai_controller,node_ai_service,node_imagekit,node_email toneRose
class node_visitor toneIndigo
```

## Components

### Resume Web App

- [Route App](https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Landing Page](https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/pages/Home.jsx): `client/src/pages/Home.jsx`
- [Resume Dashboard](https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/pages/Dashboard.jsx): `client/src/pages/Dashboard.jsx`
- [Resume Editor](https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/pages/ResumeBuilder.jsx): `client/src/pages/ResumeBuilder.jsx`
- [Resume Forms](https://github.com/bintangx2005-netizen/resume-builder/tree/main/client/src/Components): `client/src/Components`
- [Public Preview Page](https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/pages/Preview.jsx): `client/src/pages/Preview.jsx`
- [Template Preview](https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/Components/ResumePreview.jsx): `client/src/Components/ResumePreview.jsx`
- [Resume Templates](https://github.com/bintangx2005-netizen/resume-builder/tree/main/client/src/Components/templates): `client/src/Components/templates`
- [HTTP Client](https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/configs/api.js): `client/src/configs/api.js`

### Resume Services

- [HTTP Server](https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/server.js): `server/server.js`
- [Resume Routes](https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/routes/resumeRoutes.js): `server/routes/resumeRoutes.js`
- [Resume Operations](https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/controllers/ResumeControllers.js): `server/controllers/ResumeControllers.js`
- [AI Routes](https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/routes/aiRoutes.js): `server/routes/aiRoutes.js`
- [Resume Records](https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/models/Resume.js): `server/models/Resume.js`

### Accounts & Admin

- [Login Page](https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/pages/Login.jsx): `client/src/pages/Login.jsx`
- [Auth State](https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/app/features/authSlice.js): `client/src/app/features/authSlice.js`
- [User Routes](https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/routes/userRoutes.js): `server/routes/userRoutes.js`
- [Account Operations](https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/controllers/userControllers.js): `server/controllers/userControllers.js`
- [Token & Role Checks](https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/middlewares/authMiddleware.js): `server/middlewares/authMiddleware.js`
- [User Records](https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/models/User.js): `server/models/User.js`
- [Admin User Management](https://github.com/bintangx2005-netizen/resume-builder/blob/main/client/src/pages/Admin/UserManagement.jsx): `client/src/pages/Admin/UserManagement.jsx`

### External Integrations

- [AI Resume Tools](https://github.com/bintangx2005-netizen/resume-builder/blob/main/server/controllers/aiController.js): `server/controllers/aiController.js`
- **AI Provider**
- **ImageKit**
- **Email Service**

### Other components

- **Visitor**
- **MongoDB**

## Connections

- Visitor → Route App: opens (evidence: `client/src/App.jsx`)
- Route App → Landing Page: routes to (evidence: `client/src/App.jsx`)
- Route App → Login Page: routes to (evidence: `client/src/App.jsx`)
- Route App → Resume Dashboard: routes to (evidence: `client/src/App.jsx`)
- Route App → Resume Editor: routes to (evidence: `client/src/App.jsx`)
- Route App → Public Preview Page: routes to (evidence: `client/src/App.jsx`)
- Route App → Auth State: dispatches (evidence: `client/src/App.jsx`)
- Login Page → HTTP Client: calls (evidence: `client/src/pages/Login.jsx`)
- Login Page → Auth State: updates (evidence: `client/src/pages/Login.jsx`)
- Resume Dashboard → HTTP Client: calls (evidence: `client/src/pages/Dashboard.jsx`)
- Resume Editor → Resume Forms: renders (evidence: `client/src/pages/ResumeBuilder.jsx`)
- Resume Editor → Template Preview: renders (evidence: `client/src/pages/ResumeBuilder.jsx`)
- Public Preview Page → HTTP Client: fetches public resume (evidence: `client/src/pages/Preview.jsx`)
- Public Preview Page → Template Preview: renders (evidence: `client/src/pages/Preview.jsx`)
- Template Preview → Resume Templates: selects template (evidence: `client/src/Components/ResumePreview.jsx`)
- HTTP Server → User Routes: registers (evidence: `server/server.js`)
- HTTP Server → Resume Routes: registers (evidence: `server/server.js`)
- HTTP Server → AI Routes: registers (evidence: `server/server.js`)
- User Routes → Account Operations: dispatches (evidence: `server/routes/userRoutes.js`)
- Resume Routes → Resume Operations: dispatches (evidence: `server/routes/resumeRoutes.js`)
- Resume Routes → Account Operations: dispatches (evidence: `server/routes/resumeRoutes.js`)
- AI Routes → AI Resume Tools: dispatches (evidence: `server/routes/aiRoutes.js`)
- User Routes → Token & Role Checks: protects routes (evidence: `server/routes/userRoutes.js`)
- Resume Routes → Token & Role Checks: protects routes (evidence: `server/routes/resumeRoutes.js`)
- AI Routes → Token & Role Checks: protects routes (evidence: `server/routes/aiRoutes.js`)
- Account Operations → User Records: reads and writes (evidence: `server/controllers/userControllers.js`)
- Account Operations → Resume Records: reads (evidence: `server/controllers/userControllers.js`)
- Account Operations → Email Service: sends email (evidence: `server/controllers/userControllers.js`)
- Resume Operations → Resume Records: reads and writes (evidence: `server/controllers/ResumeControllers.js`)
- Resume Operations → ImageKit: uploads images (evidence: `server/controllers/ResumeControllers.js`)
- AI Resume Tools → AI Provider: requests completions (evidence: `server/controllers/aiController.js`)
- AI Resume Tools → Resume Records: creates resume (evidence: `server/controllers/aiController.js`)
- Admin User Management → HTTP Client: calls (evidence: `client/src/pages/Admin/UserManagement.jsx`)
- HTTP Server → MongoDB: connects (evidence: `server/server.js`)
