# rc74a/teamdragonsapp architecture

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

## Overview

Team Dragons appears to be a job-seeker application with a FastAPI backend and a React Router frontend. Its apparent workflow is to manage job applications and profile material, then use search and AI features to support the job hunt. The sampled backend entry point registers several domain routers, and the job router documents ownership-scoped job records and analytics. The README only identifies the team hub, so feature details and most frontend-to-backend connections are inferred from filenames; those links are omitted rather than asserted.

Main entry points: [`backend/main.py`](https://github.com/rc74a/teamdragonsapp/blob/main/backend/main.py) (FastAPI App), [`backend/ai.py`](https://github.com/rc74a/teamdragonsapp/blob/main/backend/ai.py) (AI Features), [`backend/jobs.py`](https://github.com/rc74a/teamdragonsapp/blob/main/backend/jobs.py) (Job Tracking), [`frontend/app/routes.ts`](https://github.com/rc74a/teamdragonsapp/blob/main/frontend/app/routes.ts) (App Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend"]
  node_routes["App Routes<br/>[routes.ts]"]
  node_dashboard["Dashboard<br/>[dashboard.tsx]"]
  node_ai_button["AI Research"]
end

subgraph group_api["Backend API"]
  node_backend["FastAPI App<br/>[main.py]"]
end

subgraph group_domain["Job-Seeker Domains"]
  node_jobs["Job Tracking<br/>[jobs.py]"]
  node_search["Job Search<br/>[search.py]"]
  node_ai["AI Features<br/>[ai.py]"]
  node_profile["Profile<br/>[profile.py]"]
  node_experience["Experience<br/>[experience.py]"]
  node_education["Education<br/>[education.py]"]
  node_skills["Skills<br/>[skills.py]"]
  node_documents["Documents<br/>[documents.py]"]
end

subgraph group_data["Persistence"]
  node_database[("Database<br/>[database.py]")]
end

node_jobseeker(("Job Seeker"))

node_jobseeker -.->|"uses"| node_routes
node_routes -.->|"routes to"| node_dashboard
node_dashboard -->|"renders"| node_ai_button
node_backend -->|"registers"| node_jobs
node_backend -->|"registers"| node_search
node_backend -->|"registers"| node_profile
node_backend -->|"registers"| node_experience
node_backend -->|"registers"| node_education
node_backend -->|"registers"| node_skills
node_backend -->|"registers"| node_ai
node_backend -->|"imports"| node_documents
node_jobs -->|"uses"| node_database
node_ai -->|"references"| node_database
node_ai -->|"references"| node_jobs

click node_routes "https://github.com/rc74a/teamdragonsapp/blob/main/frontend/app/routes.ts"
click node_dashboard "https://github.com/rc74a/teamdragonsapp/blob/main/frontend/app/routes/dashboard.tsx"
click node_ai_button "https://github.com/rc74a/teamdragonsapp/blob/main/frontend/app/components/AIResearchButton.tsx"
click node_backend "https://github.com/rc74a/teamdragonsapp/blob/main/backend/main.py"
click node_jobs "https://github.com/rc74a/teamdragonsapp/blob/main/backend/jobs.py"
click node_search "https://github.com/rc74a/teamdragonsapp/blob/main/backend/search.py"
click node_ai "https://github.com/rc74a/teamdragonsapp/blob/main/backend/ai.py"
click node_profile "https://github.com/rc74a/teamdragonsapp/blob/main/backend/profile.py"
click node_experience "https://github.com/rc74a/teamdragonsapp/blob/main/backend/experience.py"
click node_education "https://github.com/rc74a/teamdragonsapp/blob/main/backend/education.py"
click node_skills "https://github.com/rc74a/teamdragonsapp/blob/main/backend/skills.py"
click node_documents "https://github.com/rc74a/teamdragonsapp/blob/main/backend/documents.py"
click node_database "https://github.com/rc74a/teamdragonsapp/blob/main/backend/database.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_routes,node_dashboard,node_ai_button toneBlue
class node_backend toneAmber
class node_jobs,node_search,node_ai,node_profile,node_experience,node_education,node_skills,node_documents toneMint
class node_database toneRose
class node_jobseeker toneIndigo
```

## Components

### Frontend

- [App Routes](https://github.com/rc74a/teamdragonsapp/blob/main/frontend/app/routes.ts): `frontend/app/routes.ts`
- [Dashboard](https://github.com/rc74a/teamdragonsapp/blob/main/frontend/app/routes/dashboard.tsx): `frontend/app/routes/dashboard.tsx`
- [AI Research](https://github.com/rc74a/teamdragonsapp/blob/main/frontend/app/components/AIResearchButton.tsx): `frontend/app/components/AIResearchButton.tsx`

### Backend API

- [FastAPI App](https://github.com/rc74a/teamdragonsapp/blob/main/backend/main.py): `backend/main.py`

### Job-Seeker Domains

- [Job Tracking](https://github.com/rc74a/teamdragonsapp/blob/main/backend/jobs.py): `backend/jobs.py`
- [Job Search](https://github.com/rc74a/teamdragonsapp/blob/main/backend/search.py): `backend/search.py`
- [AI Features](https://github.com/rc74a/teamdragonsapp/blob/main/backend/ai.py): `backend/ai.py`
- [Profile](https://github.com/rc74a/teamdragonsapp/blob/main/backend/profile.py): `backend/profile.py`
- [Experience](https://github.com/rc74a/teamdragonsapp/blob/main/backend/experience.py): `backend/experience.py`
- [Education](https://github.com/rc74a/teamdragonsapp/blob/main/backend/education.py): `backend/education.py`
- [Skills](https://github.com/rc74a/teamdragonsapp/blob/main/backend/skills.py): `backend/skills.py`
- [Documents](https://github.com/rc74a/teamdragonsapp/blob/main/backend/documents.py): `backend/documents.py`

### Persistence

- [Database](https://github.com/rc74a/teamdragonsapp/blob/main/backend/database.py): `backend/database.py`

### Other components

- **Job Seeker**

## Connections

- Job Seeker → App Routes: uses
- App Routes → Dashboard: routes to
- Dashboard → AI Research: renders (evidence: `frontend/app/routes/dashboard.tsx`)
- FastAPI App → Job Tracking: registers (evidence: `backend/main.py`)
- FastAPI App → Job Search: registers (evidence: `backend/main.py`)
- FastAPI App → Profile: registers (evidence: `backend/main.py`)
- FastAPI App → Experience: registers (evidence: `backend/main.py`)
- FastAPI App → Education: registers (evidence: `backend/main.py`)
- FastAPI App → Skills: registers (evidence: `backend/main.py`)
- FastAPI App → AI Features: registers (evidence: `backend/main.py`)
- FastAPI App → Documents: imports (evidence: `backend/main.py`)
- Job Tracking → Database: uses (evidence: `backend/jobs.py`)
- AI Features → Database: references (evidence: `backend/ai.py`)
- AI Features → Job Tracking: references (evidence: `backend/ai.py`)
