# sisayie/cv-studio architecture

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

- Interactive diagram: https://gitdiagram.com/sisayie/cv-studio
- Repository: https://github.com/sisayie/cv-studio

## Overview

CV Studio lets users register or sign in, manage multiple structured CVs, edit content with language and template choices, preview, and import or export CVs. The React application calls a Django REST API; authenticated backend views enforce per-user ownership and use serializers and persistent CV models. Export requests are handled separately for JSON, PDF, and DOCX. The README documents PostgreSQL in Docker and SQLite locally. Some UI and settings details were not sampled, so those capabilities are represented at the application level rather than as inferred internal modules.

Main entry points: [`backend/config/urls.py`](https://github.com/sisayie/cv-studio/blob/main/backend/config/urls.py) (API routing), [`backend/resumes/views.py`](https://github.com/sisayie/cv-studio/blob/main/backend/resumes/views.py) (CV API and import/export), [`frontend/src/api.js`](https://github.com/sisayie/cv-studio/blob/main/frontend/src/api.js) (API client), [`backend/resumes/serializers.py`](https://github.com/sisayie/cv-studio/blob/main/backend/resumes/serializers.py) (Validation and serialization)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["React application"]
  node_auth_ui["Account interface<br/>[App.jsx]"]
  node_cv_workspace["CV workspace<br/>[App.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_backend["Django API"]
  node_api_routes["API routing<br/>[urls.py]"]
  node_cv_routes["CV routes<br/>[urls.py]"]
  node_cv_api["CV API and import/export<br/>[views.py]"]
  node_registration["Registration<br/>[views.py]"]
  node_serializers["Validation and serialization<br/>[serializers.py]"]
  node_jwt_service["JWT authentication"]
end

subgraph group_data["CV persistence"]
  node_cv_model["CV records<br/>[models.py]"]
  node_database[("Relational database")]
end

subgraph group_exports["Import and export"]
  node_export_engine["Format exporters<br/>[exports.py]"]
end

node_user(("CV user"))

node_user -->|"signs in or registers"| node_auth_ui
node_user -->|"creates and edits CVs"| node_cv_workspace
node_auth_ui -->|"requests authentication"| node_api_client
node_cv_workspace -->|"manages and exports CVs"| node_api_client
node_api_client -->|"sends HTTP requests"| node_api_routes
node_api_routes -->|"routes registration"| node_registration
node_api_routes -->|"routes token requests"| node_jwt_service
node_api_routes -->|"includes CV routes"| node_cv_routes
node_cv_routes -->|"routes CV requests"| node_cv_api
node_registration -->|"validates account data"| node_serializers
node_cv_api -->|"serializes CV data"| node_serializers
node_cv_api -->|"queries and saves CVs"| node_cv_model
node_serializers -->|"defines model fields"| node_cv_model
node_cv_model -.->|"persists records"| node_database
node_cv_api -->|"dispatches export format"| node_export_engine

click node_auth_ui "https://github.com/sisayie/cv-studio/blob/main/frontend/src/App.jsx"
click node_cv_workspace "https://github.com/sisayie/cv-studio/blob/main/frontend/src/App.jsx"
click node_api_client "https://github.com/sisayie/cv-studio/blob/main/frontend/src/api.js"
click node_api_routes "https://github.com/sisayie/cv-studio/blob/main/backend/config/urls.py"
click node_cv_routes "https://github.com/sisayie/cv-studio/blob/main/backend/resumes/urls.py"
click node_cv_api "https://github.com/sisayie/cv-studio/blob/main/backend/resumes/views.py"
click node_registration "https://github.com/sisayie/cv-studio/blob/main/backend/resumes/views.py"
click node_serializers "https://github.com/sisayie/cv-studio/blob/main/backend/resumes/serializers.py"
click node_cv_model "https://github.com/sisayie/cv-studio/blob/main/backend/resumes/models.py"
click node_export_engine "https://github.com/sisayie/cv-studio/blob/main/backend/resumes/exports.py"

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_auth_ui,node_cv_workspace,node_api_client,node_user toneBlue
class node_api_routes,node_cv_routes,node_cv_api,node_registration,node_serializers,node_jwt_service toneAmber
class node_cv_model,node_database toneMint
class node_export_engine toneRose
```

## Components

### React application

- [Account interface](https://github.com/sisayie/cv-studio/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [CV workspace](https://github.com/sisayie/cv-studio/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [API client](https://github.com/sisayie/cv-studio/blob/main/frontend/src/api.js): `frontend/src/api.js`

### Django API

- [API routing](https://github.com/sisayie/cv-studio/blob/main/backend/config/urls.py): `backend/config/urls.py`
- [CV routes](https://github.com/sisayie/cv-studio/blob/main/backend/resumes/urls.py): `backend/resumes/urls.py`
- [CV API and import/export](https://github.com/sisayie/cv-studio/blob/main/backend/resumes/views.py): `backend/resumes/views.py`
- [Registration](https://github.com/sisayie/cv-studio/blob/main/backend/resumes/views.py): `backend/resumes/views.py`
- [Validation and serialization](https://github.com/sisayie/cv-studio/blob/main/backend/resumes/serializers.py): `backend/resumes/serializers.py`
- **JWT authentication**

### CV persistence

- [CV records](https://github.com/sisayie/cv-studio/blob/main/backend/resumes/models.py): `backend/resumes/models.py`
- **Relational database**

### Import and export

- [Format exporters](https://github.com/sisayie/cv-studio/blob/main/backend/resumes/exports.py): `backend/resumes/exports.py`

### Other components

- **CV user**

## Connections

- CV user → Account interface: signs in or registers (evidence: `README.md`)
- CV user → CV workspace: creates and edits CVs (evidence: `README.md`)
- Account interface → API client: requests authentication (evidence: `frontend/src/App.jsx`)
- CV workspace → API client: manages and exports CVs (evidence: `frontend/src/App.jsx`)
- API client → API routing: sends HTTP requests (evidence: `frontend/src/api.js`)
- API routing → Registration: routes registration (evidence: `backend/config/urls.py`)
- API routing → JWT authentication: routes token requests (evidence: `backend/config/urls.py`)
- API routing → CV routes: includes CV routes (evidence: `backend/config/urls.py`)
- CV routes → CV API and import/export: routes CV requests (evidence: `backend/resumes/urls.py`)
- Registration → Validation and serialization: validates account data (evidence: `backend/resumes/views.py`)
- CV API and import/export → Validation and serialization: serializes CV data (evidence: `backend/resumes/views.py`)
- CV API and import/export → CV records: queries and saves CVs (evidence: `backend/resumes/views.py`)
- Validation and serialization → CV records: defines model fields (evidence: `backend/resumes/serializers.py`)
- CV records → Relational database: persists records
- CV API and import/export → Format exporters: dispatches export format (evidence: `backend/resumes/views.py`)
