# nithin0553/applywise architecture

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

- Interactive diagram: https://gitdiagram.com/nithin0553/applywise
- Repository: https://github.com/nithin0553/applywise

## Overview

ApplyWise is an early-stage web resume-customization and job-application assistant. Its documented trust rule is that generated content should be grounded in career evidence reviewed and approved by the user. The only sampled end-to-end capability implemented here is account registration, login, and session validation; the README says feature implementation is still to start. The graph therefore separates working authentication from product areas named in the tree, without implying those areas are implemented or connected. Evidence is limited to the README, file tree, and sampled source/index; planned-feature internals are not shown.

Main entry points: [`apps/api/app/modules/auth/router.py`](https://github.com/nithin0553/applywise/blob/main/apps/api/app/modules/auth/router.py) (Auth routes), [`apps/api/app/modules/auth/service.py`](https://github.com/nithin0553/applywise/blob/main/apps/api/app/modules/auth/service.py) (Auth use cases), [`apps/api/app/db/session.py`](https://github.com/nithin0553/applywise/blob/main/apps/api/app/db/session.py) (DB session), [`apps/web/src/App.tsx`](https://github.com/nithin0553/applywise/blob/main/apps/web/src/App.tsx) (App shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web client"]
  node_app["App shell<br/>[App.tsx]"]
  node_authui["Auth forms<br/>[LoginForm.tsx]"]
  node_register["Registration form<br/>[RegisterForm.tsx]"]
  node_authstate["Auth state<br/>[AuthContext.tsx]"]
  node_authclient["Auth API client<br/>[api.ts]"]
end

subgraph group_api["API foundation"]
  node_api["FastAPI app<br/>[main.py]"]
  node_routes["Auth routes<br/>[router.py]"]
  node_usecase["Auth use cases<br/>[service.py]"]
  node_security["Password and tokens<br/>[security.py]"]
  node_authorization["Auth dependencies<br/>[dependencies.py]"]
  node_userrecord["User model<br/>[models.py]"]
  node_dbsession["DB session<br/>[session.py]"]
  node_settings["Runtime settings<br/>[config.py]"]
end

subgraph group_product["Product capabilities"]
  node_evidence["Career evidence"]
  node_documents["Resume documents"]
  node_jobanalysis["Job analysis"]
  node_matching["Job matching"]
  node_generation["Grounded generation"]
  node_verification["Verification"]
  node_tailoring["Resume tailoring"]
  node_sharing["Resume sharing"]
  node_applications["Applications"]
end

node_user(("Job seeker"))
node_database[("Relational database")]

node_user -->|"uses"| node_app
node_app -->|"renders"| node_authui
node_app -->|"renders"| node_register
node_authui -->|"uses"| node_authstate
node_register -->|"uses"| node_authstate
node_authstate -->|"calls"| node_authclient
node_api -->|"mounts"| node_routes
node_routes -->|"calls"| node_usecase
node_routes -->|"creates token"| node_security
node_usecase -->|"hashes and verifies"| node_security
node_routes -->|"requires current user"| node_authorization
node_authorization -->|"looks up user"| node_usecase
node_usecase -->|"queries and creates"| node_userrecord
node_routes -->|"requests session"| node_dbsession
node_authorization -->|"requests session"| node_dbsession
node_dbsession -->|"reads database URL"| node_settings
node_dbsession -.->|"connects"| node_database
node_userrecord -.->|"persists users"| node_database
node_evidence -.->|"grounding required"| node_generation
node_documents -.->|"product area"| node_tailoring

click node_app "https://github.com/nithin0553/applywise/blob/main/apps/web/src/App.tsx"
click node_authui "https://github.com/nithin0553/applywise/blob/main/apps/web/src/features/auth/LoginForm.tsx"
click node_register "https://github.com/nithin0553/applywise/blob/main/apps/web/src/features/auth/RegisterForm.tsx"
click node_authstate "https://github.com/nithin0553/applywise/blob/main/apps/web/src/features/auth/AuthContext.tsx"
click node_authclient "https://github.com/nithin0553/applywise/blob/main/apps/web/src/features/auth/api.ts"
click node_api "https://github.com/nithin0553/applywise/blob/main/apps/api/app/main.py"
click node_routes "https://github.com/nithin0553/applywise/blob/main/apps/api/app/modules/auth/router.py"
click node_usecase "https://github.com/nithin0553/applywise/blob/main/apps/api/app/modules/auth/service.py"
click node_security "https://github.com/nithin0553/applywise/blob/main/apps/api/app/modules/auth/security.py"
click node_authorization "https://github.com/nithin0553/applywise/blob/main/apps/api/app/modules/auth/dependencies.py"
click node_userrecord "https://github.com/nithin0553/applywise/blob/main/apps/api/app/modules/auth/models.py"
click node_dbsession "https://github.com/nithin0553/applywise/blob/main/apps/api/app/db/session.py"
click node_settings "https://github.com/nithin0553/applywise/blob/main/apps/api/app/core/config.py"
click node_evidence "https://github.com/nithin0553/applywise/tree/main/apps/api/app/modules/evidence"
click node_documents "https://github.com/nithin0553/applywise/tree/main/apps/api/app/modules/documents"
click node_jobanalysis "https://github.com/nithin0553/applywise/tree/main/apps/api/app/modules/job_analysis"
click node_matching "https://github.com/nithin0553/applywise/tree/main/apps/api/app/modules/matching"
click node_generation "https://github.com/nithin0553/applywise/tree/main/apps/api/app/modules/generation"
click node_verification "https://github.com/nithin0553/applywise/tree/main/apps/api/app/modules/verification"
click node_tailoring "https://github.com/nithin0553/applywise/tree/main/apps/web/src/features/tailoring"
click node_sharing "https://github.com/nithin0553/applywise/tree/main/apps/api/app/modules/sharing"
click node_applications "https://github.com/nithin0553/applywise/tree/main/apps/api/app/modules/applications"

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_authui,node_register,node_authstate,node_authclient toneBlue
class node_api,node_routes,node_usecase,node_security,node_authorization,node_userrecord,node_dbsession,node_settings,node_database toneAmber
class node_evidence,node_documents,node_jobanalysis,node_matching,node_generation,node_verification,node_tailoring,node_sharing,node_applications toneMint
class node_user toneIndigo
```

## Components

### Web client

- [App shell](https://github.com/nithin0553/applywise/blob/main/apps/web/src/App.tsx): `apps/web/src/App.tsx`
- [Auth forms](https://github.com/nithin0553/applywise/blob/main/apps/web/src/features/auth/LoginForm.tsx): `apps/web/src/features/auth/LoginForm.tsx`
- [Registration form](https://github.com/nithin0553/applywise/blob/main/apps/web/src/features/auth/RegisterForm.tsx): `apps/web/src/features/auth/RegisterForm.tsx`
- [Auth state](https://github.com/nithin0553/applywise/blob/main/apps/web/src/features/auth/AuthContext.tsx): `apps/web/src/features/auth/AuthContext.tsx`
- [Auth API client](https://github.com/nithin0553/applywise/blob/main/apps/web/src/features/auth/api.ts): `apps/web/src/features/auth/api.ts`

### API foundation

- [FastAPI app](https://github.com/nithin0553/applywise/blob/main/apps/api/app/main.py): `apps/api/app/main.py`
- [Auth routes](https://github.com/nithin0553/applywise/blob/main/apps/api/app/modules/auth/router.py): `apps/api/app/modules/auth/router.py`
- [Auth use cases](https://github.com/nithin0553/applywise/blob/main/apps/api/app/modules/auth/service.py): `apps/api/app/modules/auth/service.py`
- [Password and tokens](https://github.com/nithin0553/applywise/blob/main/apps/api/app/modules/auth/security.py): `apps/api/app/modules/auth/security.py`
- [Auth dependencies](https://github.com/nithin0553/applywise/blob/main/apps/api/app/modules/auth/dependencies.py): `apps/api/app/modules/auth/dependencies.py`
- [User model](https://github.com/nithin0553/applywise/blob/main/apps/api/app/modules/auth/models.py): `apps/api/app/modules/auth/models.py`
- [DB session](https://github.com/nithin0553/applywise/blob/main/apps/api/app/db/session.py): `apps/api/app/db/session.py`
- [Runtime settings](https://github.com/nithin0553/applywise/blob/main/apps/api/app/core/config.py): `apps/api/app/core/config.py`

### Product capabilities

- [Career evidence](https://github.com/nithin0553/applywise/tree/main/apps/api/app/modules/evidence): `apps/api/app/modules/evidence`
- [Resume documents](https://github.com/nithin0553/applywise/tree/main/apps/api/app/modules/documents): `apps/api/app/modules/documents`
- [Job analysis](https://github.com/nithin0553/applywise/tree/main/apps/api/app/modules/job_analysis): `apps/api/app/modules/job_analysis`
- [Job matching](https://github.com/nithin0553/applywise/tree/main/apps/api/app/modules/matching): `apps/api/app/modules/matching`
- [Grounded generation](https://github.com/nithin0553/applywise/tree/main/apps/api/app/modules/generation): `apps/api/app/modules/generation`
- [Verification](https://github.com/nithin0553/applywise/tree/main/apps/api/app/modules/verification): `apps/api/app/modules/verification`
- [Resume tailoring](https://github.com/nithin0553/applywise/tree/main/apps/web/src/features/tailoring): `apps/web/src/features/tailoring`
- [Resume sharing](https://github.com/nithin0553/applywise/tree/main/apps/api/app/modules/sharing): `apps/api/app/modules/sharing`
- [Applications](https://github.com/nithin0553/applywise/tree/main/apps/api/app/modules/applications): `apps/api/app/modules/applications`

### Other components

- **Job seeker**
- **Relational database**

## Connections

- Job seeker → App shell: uses (evidence: `README.md`)
- App shell → Auth forms: renders (evidence: `apps/web/src/App.tsx`)
- App shell → Registration form: renders (evidence: `apps/web/src/App.tsx`)
- Auth forms → Auth state: uses (evidence: `apps/web/src/features/auth/LoginForm.tsx`)
- Registration form → Auth state: uses (evidence: `apps/web/src/features/auth/RegisterForm.tsx`)
- Auth state → Auth API client: calls (evidence: `apps/web/src/features/auth/AuthContext.tsx`)
- FastAPI app → Auth routes: mounts (evidence: `apps/api/app/main.py`)
- Auth routes → Auth use cases: calls (evidence: `apps/api/app/modules/auth/router.py`)
- Auth routes → Password and tokens: creates token (evidence: `apps/api/app/modules/auth/router.py`)
- Auth use cases → Password and tokens: hashes and verifies (evidence: `apps/api/app/modules/auth/service.py`)
- Auth routes → Auth dependencies: requires current user (evidence: `apps/api/app/modules/auth/router.py`)
- Auth dependencies → Auth use cases: looks up user (evidence: `apps/api/app/modules/auth/dependencies.py`)
- Auth use cases → User model: queries and creates (evidence: `apps/api/app/modules/auth/service.py`)
- Auth routes → DB session: requests session (evidence: `apps/api/app/modules/auth/router.py`)
- Auth dependencies → DB session: requests session (evidence: `apps/api/app/modules/auth/dependencies.py`)
- DB session → Runtime settings: reads database URL (evidence: `apps/api/app/db/session.py`)
- DB session → Relational database: connects
- User model → Relational database: persists users
- Career evidence → Grounded generation: grounding required (evidence: `README.md`)
- Resume documents → Resume tailoring: product area (evidence: `README.md`)
