# cd271188/rise_ats1 architecture

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

- Interactive diagram: https://gitdiagram.com/cd271188/rise_ats1
- Repository: https://github.com/cd271188/rise_ats1

## Overview

ATS Platform is a multi-tenant applicant-tracking system, used by recruiters and Rise platform staff through a vanilla-JS web app backed by FastAPI. The main workflow is candidate entry and review, interview/status tracking, and recruiting operations such as jobs, reports, and offers. Separate branches provide CV/AI assistance, company and vendor administration, and tenant-scoped storage and security. The README documents several capabilities whose individual handlers were not sampled; those are represented at their documented subsystem paths, with uncertain wiring omitted or marked unverified.

Main entry points: [`app/main.py`](https://github.com/cd271188/rise_ats1/blob/main/app/main.py) (FastAPI app), [`app/models.py`](https://github.com/cd271188/rise_ats1/blob/main/app/models.py) (Tenant data), [`web/js/main.js`](https://github.com/cd271188/rise_ats1/blob/main/web/js/main.js) (Web app), [`app/routers/data.py`](https://github.com/cd271188/rise_ats1/blob/main/app/routers/data.py) (Recruiting routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_webapp["Web app<br/>[main.js]"]
  node_router["Hash router<br/>[router.js]"]
  node_ui["UI toolkit<br/>[ui.js]"]
  node_api_client["API client<br/>[api.js]"]
  node_candidate_ui["Candidate grid<br/>[grid.js]"]
  node_job_ui["Jobs and offers<br/>[jobs.js]"]
end

subgraph group_api["API entry points"]
  node_app["FastAPI app<br/>[main.py]"]
  node_auth_api["Auth routes<br/>[auth.py]"]
  node_data_api["Recruiting routes<br/>[data.py]"]
  node_ai_api["AI routes<br/>[ai.py]"]
  node_offer_api["Offer routes<br/>[offer.py]"]
  node_platform_api["Platform routes<br/>[platform.py]"]
end

subgraph group_recruiting["Recruiting workflow"]
  node_candidate_svc["Candidate records<br/>[candidates.py]"]
  node_interviews["Interview tracking<br/>[interviews.py]"]
  node_jobs["Job management<br/>[jobs.py]"]
  node_reports["Dashboard and reports<br/>[dashboard.py]"]
  node_lists["Lists and settings<br/>[lists.py]"]
end

subgraph group_ai["CV and AI"]
  node_cv["CV processing<br/>[cv.py]"]
  node_profiles["Candidate profiles<br/>[profiles.py]"]
  node_runtime["AI runtime<br/>[runtime.py]"]
  node_llm["Chat model<br/>[llm.py]"]
end

subgraph group_platform["Platform and tenancy"]
  node_platform_svc["Company administration<br/>[platform.py]"]
  node_auth_svc["Identity and teams<br/>[auth.py]"]
  node_tenant_data[("Tenant data<br/>[models.py]")]
  node_db["Database setup<br/>[db.py]"]
  node_tenant_guard["Tenant isolation<br/>[rls.py]"]
end

node_user(("Recruiter or staff"))

node_user -->|"uses"| node_webapp
node_webapp -->|"routes with"| node_router
node_webapp -->|"uses"| node_api_client
node_webapp -->|"loads"| node_candidate_ui
node_webapp -->|"loads"| node_job_ui
node_candidate_ui -->|"uses"| node_api_client
node_job_ui -->|"uses"| node_api_client
node_api_client -.->|"sends requests"| node_app
node_app -->|"registers"| node_auth_api
node_app -->|"registers"| node_data_api
node_app -->|"registers"| node_ai_api
node_app -->|"registers"| node_offer_api
node_app -->|"registers"| node_platform_api
node_auth_api -->|"calls"| node_auth_svc
node_data_api -->|"calls"| node_candidate_svc
node_data_api -->|"calls"| node_interviews
node_data_api -->|"calls"| node_reports
node_data_api -->|"calls"| node_lists
node_ai_api -->|"calls"| node_cv
node_ai_api -->|"calls"| node_jobs
node_offer_api -->|"uses"| node_platform_svc
node_platform_api -->|"calls"| node_platform_svc
node_candidate_svc -->|"reads and writes"| node_tenant_data
node_interviews -.->|"reads and writes"| node_tenant_data
node_jobs -.->|"reads and writes"| node_tenant_data
node_db -->|"configures ORM"| node_tenant_data
node_db -->|"installs hook"| node_tenant_guard
node_cv -->|"uses"| node_runtime
node_cv -.->|"calls"| node_llm
node_profiles -.->|"reads and writes"| node_tenant_data
node_profiles -->|"uses"| node_runtime
node_runtime -->|"constructs"| node_llm
node_auth_svc -.->|"reads and writes"| node_tenant_data
node_platform_svc -->|"reads and writes"| node_tenant_data
node_platform_svc -->|"uses"| node_auth_svc

click node_webapp "https://github.com/cd271188/rise_ats1/blob/main/web/js/main.js"
click node_router "https://github.com/cd271188/rise_ats1/blob/main/web/js/router.js"
click node_ui "https://github.com/cd271188/rise_ats1/blob/main/web/js/ui.js"
click node_api_client "https://github.com/cd271188/rise_ats1/blob/main/web/js/api.js"
click node_candidate_ui "https://github.com/cd271188/rise_ats1/blob/main/web/js/grid.js"
click node_job_ui "https://github.com/cd271188/rise_ats1/blob/main/web/js/pages/jobs.js"
click node_app "https://github.com/cd271188/rise_ats1/blob/main/app/main.py"
click node_auth_api "https://github.com/cd271188/rise_ats1/blob/main/app/routers/auth.py"
click node_data_api "https://github.com/cd271188/rise_ats1/blob/main/app/routers/data.py"
click node_ai_api "https://github.com/cd271188/rise_ats1/blob/main/app/routers/ai.py"
click node_offer_api "https://github.com/cd271188/rise_ats1/blob/main/app/routers/offer.py"
click node_platform_api "https://github.com/cd271188/rise_ats1/blob/main/app/routers/platform.py"
click node_candidate_svc "https://github.com/cd271188/rise_ats1/blob/main/app/services/candidates.py"
click node_interviews "https://github.com/cd271188/rise_ats1/blob/main/app/services/interviews.py"
click node_jobs "https://github.com/cd271188/rise_ats1/blob/main/app/services/jobs.py"
click node_reports "https://github.com/cd271188/rise_ats1/blob/main/app/services/dashboard.py"
click node_lists "https://github.com/cd271188/rise_ats1/blob/main/app/services/lists.py"
click node_cv "https://github.com/cd271188/rise_ats1/blob/main/app/services/cv.py"
click node_profiles "https://github.com/cd271188/rise_ats1/blob/main/app/services/profiles.py"
click node_runtime "https://github.com/cd271188/rise_ats1/blob/main/app/services/runtime.py"
click node_llm "https://github.com/cd271188/rise_ats1/blob/main/app/services/llm.py"
click node_platform_svc "https://github.com/cd271188/rise_ats1/blob/main/app/services/platform.py"
click node_auth_svc "https://github.com/cd271188/rise_ats1/blob/main/app/services/auth.py"
click node_tenant_data "https://github.com/cd271188/rise_ats1/blob/main/app/models.py"
click node_db "https://github.com/cd271188/rise_ats1/blob/main/app/db.py"
click node_tenant_guard "https://github.com/cd271188/rise_ats1/blob/main/app/rls.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_webapp,node_router,node_ui,node_api_client,node_candidate_ui,node_job_ui toneBlue
class node_app,node_auth_api,node_data_api,node_ai_api,node_offer_api,node_platform_api toneAmber
class node_candidate_svc,node_interviews,node_jobs,node_reports,node_lists toneMint
class node_cv,node_profiles,node_runtime,node_llm toneRose
class node_platform_svc,node_auth_svc,node_tenant_data,node_db,node_tenant_guard,node_user toneIndigo
```

## Components

### Web application

- [Web app](https://github.com/cd271188/rise_ats1/blob/main/web/js/main.js): `web/js/main.js`
- [Hash router](https://github.com/cd271188/rise_ats1/blob/main/web/js/router.js): `web/js/router.js`
- [UI toolkit](https://github.com/cd271188/rise_ats1/blob/main/web/js/ui.js): `web/js/ui.js`
- [API client](https://github.com/cd271188/rise_ats1/blob/main/web/js/api.js): `web/js/api.js`
- [Candidate grid](https://github.com/cd271188/rise_ats1/blob/main/web/js/grid.js): `web/js/grid.js`
- [Jobs and offers](https://github.com/cd271188/rise_ats1/blob/main/web/js/pages/jobs.js): `web/js/pages/jobs.js`

### API entry points

- [FastAPI app](https://github.com/cd271188/rise_ats1/blob/main/app/main.py): `app/main.py`
- [Auth routes](https://github.com/cd271188/rise_ats1/blob/main/app/routers/auth.py): `app/routers/auth.py`
- [Recruiting routes](https://github.com/cd271188/rise_ats1/blob/main/app/routers/data.py): `app/routers/data.py`
- [AI routes](https://github.com/cd271188/rise_ats1/blob/main/app/routers/ai.py): `app/routers/ai.py`
- [Offer routes](https://github.com/cd271188/rise_ats1/blob/main/app/routers/offer.py): `app/routers/offer.py`
- [Platform routes](https://github.com/cd271188/rise_ats1/blob/main/app/routers/platform.py): `app/routers/platform.py`

### Recruiting workflow

- [Candidate records](https://github.com/cd271188/rise_ats1/blob/main/app/services/candidates.py): `app/services/candidates.py`
- [Interview tracking](https://github.com/cd271188/rise_ats1/blob/main/app/services/interviews.py): `app/services/interviews.py`
- [Job management](https://github.com/cd271188/rise_ats1/blob/main/app/services/jobs.py): `app/services/jobs.py`
- [Dashboard and reports](https://github.com/cd271188/rise_ats1/blob/main/app/services/dashboard.py): `app/services/dashboard.py`
- [Lists and settings](https://github.com/cd271188/rise_ats1/blob/main/app/services/lists.py): `app/services/lists.py`

### CV and AI

- [CV processing](https://github.com/cd271188/rise_ats1/blob/main/app/services/cv.py): `app/services/cv.py`
- [Candidate profiles](https://github.com/cd271188/rise_ats1/blob/main/app/services/profiles.py): `app/services/profiles.py`
- [AI runtime](https://github.com/cd271188/rise_ats1/blob/main/app/services/runtime.py): `app/services/runtime.py`
- [Chat model](https://github.com/cd271188/rise_ats1/blob/main/app/services/llm.py): `app/services/llm.py`

### Platform and tenancy

- [Company administration](https://github.com/cd271188/rise_ats1/blob/main/app/services/platform.py): `app/services/platform.py`
- [Identity and teams](https://github.com/cd271188/rise_ats1/blob/main/app/services/auth.py): `app/services/auth.py`
- [Tenant data](https://github.com/cd271188/rise_ats1/blob/main/app/models.py): `app/models.py`
- [Database setup](https://github.com/cd271188/rise_ats1/blob/main/app/db.py): `app/db.py`
- [Tenant isolation](https://github.com/cd271188/rise_ats1/blob/main/app/rls.py): `app/rls.py`

### Other components

- **Recruiter or staff**

## Connections

- Recruiter or staff → Web app: uses
- Web app → Hash router: routes with (evidence: `web/js/main.js`)
- Web app → API client: uses (evidence: `web/js/main.js`)
- Web app → Candidate grid: loads (evidence: `web/js/main.js`)
- Web app → Jobs and offers: loads (evidence: `web/js/main.js`)
- Candidate grid → API client: uses (evidence: `web/js/grid.js`)
- Jobs and offers → API client: uses (evidence: `web/js/pages/jobs.js`)
- API client → FastAPI app: sends requests
- FastAPI app → Auth routes: registers (evidence: `app/main.py`)
- FastAPI app → Recruiting routes: registers (evidence: `app/main.py`)
- FastAPI app → AI routes: registers (evidence: `app/main.py`)
- FastAPI app → Offer routes: registers (evidence: `app/main.py`)
- FastAPI app → Platform routes: registers (evidence: `app/main.py`)
- Auth routes → Identity and teams: calls (evidence: `app/routers/auth.py`)
- Recruiting routes → Candidate records: calls (evidence: `app/routers/data.py`)
- Recruiting routes → Interview tracking: calls (evidence: `app/routers/data.py`)
- Recruiting routes → Dashboard and reports: calls (evidence: `app/routers/data.py`)
- Recruiting routes → Lists and settings: calls (evidence: `app/routers/data.py`)
- AI routes → CV processing: calls (evidence: `app/routers/ai.py`)
- AI routes → Job management: calls (evidence: `app/routers/ai.py`)
- Offer routes → Company administration: uses
- Platform routes → Company administration: calls (evidence: `app/routers/platform.py`)
- Candidate records → Tenant data: reads and writes (evidence: `app/services/candidates.py`)
- Interview tracking → Tenant data: reads and writes
- Job management → Tenant data: reads and writes
- Database setup → Tenant data: configures ORM (evidence: `app/db.py`)
- Database setup → Tenant isolation: installs hook (evidence: `app/db.py`)
- CV processing → AI runtime: uses (evidence: `app/services/cv.py`)
- CV processing → Chat model: calls (evidence: `app/services/cv.py`)
- Candidate profiles → Tenant data: reads and writes (evidence: `app/services/profiles.py`)
- Candidate profiles → AI runtime: uses (evidence: `app/services/profiles.py`)
- AI runtime → Chat model: constructs (evidence: `app/services/runtime.py`)
- Identity and teams → Tenant data: reads and writes (evidence: `app/services/auth.py`)
- Company administration → Tenant data: reads and writes (evidence: `app/services/platform.py`)
- Company administration → Identity and teams: uses (evidence: `app/services/platform.py`)
