# swetha289swe/project-tracker architecture

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

## Overview

Smart Project Tracker is a FastAPI service for user registration and management, projects, and project memberships. Clients call the mounted API routers; handlers validate request and response data, use database-session dependencies, and perform operations on SQLAlchemy models. The visible registration flow additionally hashes passwords. The source index identifies project CRUD modules and their dependencies, but the README is empty, so broader product capabilities and some implementation details cannot be confirmed.

Main entry points: [`src/app/main.py`](https://github.com/swetha289swe/project-tracker/blob/main/src/app/main.py) (FastAPI app), [`src/app/routers/auth.py`](https://github.com/swetha289swe/project-tracker/blob/main/src/app/routers/auth.py) (Registration), [`src/app/routers/users.py`](https://github.com/swetha289swe/project-tracker/blob/main/src/app/routers/users.py) (User management), [`src/app/core/deps.py`](https://github.com/swetha289swe/project-tracker/blob/main/src/app/core/deps.py) (DB dependency)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API entry"]
  node_app["FastAPI app<br/>[main.py]"]
end

subgraph group_identity["User identity"]
  node_auth["Registration<br/>[auth.py]"]
  node_security["Password hashing<br/>[security.py]"]
  node_users["User management<br/>[users.py]"]
  node_user_schema["User schemas<br/>[user.py]"]
  node_user_model["User model<br/>[user.py]"]
end

subgraph group_projects["Project management"]
  node_projects["Project API<br/>[project.py]"]
  node_members["Membership API<br/>[project_members.py]"]
  node_project_schema["Project schemas<br/>[project.py]"]
  node_project_model["Project models<br/>[project.py]"]
end

subgraph group_persistence["Persistence"]
  node_deps["DB dependency<br/>[deps.py]"]
  node_session["Session factory<br/>[session.py]"]
  node_config["Settings<br/>[config.py]"]
  node_base["ORM base<br/>[base.py]"]
  node_database[("SQL database")]
end

node_client(("API client"))

node_client -->|"sends requests"| node_app
node_app -->|"mounts router"| node_auth
node_app -->|"mounts router"| node_users
node_app -->|"mounts router"| node_projects
node_app -->|"mounts router"| node_members
node_auth -->|"hashes password"| node_security
node_auth -->|"gets session"| node_deps
node_auth -->|"queries and saves"| node_user_model
node_auth -->|"validates and returns"| node_user_schema
node_users -->|"gets session"| node_deps
node_users -->|"queries and updates"| node_user_model
node_users -->|"checks associations"| node_project_model
node_users -->|"validates and returns"| node_user_schema
node_projects -->|"gets session"| node_deps
node_projects -->|"queries and updates"| node_project_model
node_projects -->|"validates and returns"| node_project_schema
node_members -->|"gets session"| node_deps
node_members -->|"queries and saves"| node_project_model
node_members -->|"validates and returns"| node_project_schema
node_deps -->|"creates session"| node_session
node_session -->|"reads settings"| node_config
node_session -.->|"connects to"| node_database
node_user_model -->|"inherits mapping"| node_base
node_project_model -->|"inherits mapping"| node_base
node_security -->|"reads settings"| node_config

click node_app "https://github.com/swetha289swe/project-tracker/blob/main/src/app/main.py"
click node_auth "https://github.com/swetha289swe/project-tracker/blob/main/src/app/routers/auth.py"
click node_security "https://github.com/swetha289swe/project-tracker/blob/main/src/app/core/security.py"
click node_users "https://github.com/swetha289swe/project-tracker/blob/main/src/app/routers/users.py"
click node_user_schema "https://github.com/swetha289swe/project-tracker/blob/main/src/app/schemas/user.py"
click node_user_model "https://github.com/swetha289swe/project-tracker/blob/main/src/app/models/user.py"
click node_projects "https://github.com/swetha289swe/project-tracker/blob/main/src/app/routers/project.py"
click node_members "https://github.com/swetha289swe/project-tracker/blob/main/src/app/routers/project_members.py"
click node_project_schema "https://github.com/swetha289swe/project-tracker/blob/main/src/app/schemas/project.py"
click node_project_model "https://github.com/swetha289swe/project-tracker/blob/main/src/app/models/project.py"
click node_deps "https://github.com/swetha289swe/project-tracker/blob/main/src/app/core/deps.py"
click node_session "https://github.com/swetha289swe/project-tracker/blob/main/src/app/db/session.py"
click node_config "https://github.com/swetha289swe/project-tracker/blob/main/src/app/core/config.py"
click node_base "https://github.com/swetha289swe/project-tracker/blob/main/src/app/db/base.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_app,node_client toneBlue
class node_auth,node_security,node_users,node_user_schema,node_user_model toneAmber
class node_projects,node_members,node_project_schema,node_project_model toneMint
class node_deps,node_session,node_config,node_base,node_database toneRose
```

## Components

### API entry

- [FastAPI app](https://github.com/swetha289swe/project-tracker/blob/main/src/app/main.py): `src/app/main.py`

### User identity

- [Registration](https://github.com/swetha289swe/project-tracker/blob/main/src/app/routers/auth.py): `src/app/routers/auth.py`
- [Password hashing](https://github.com/swetha289swe/project-tracker/blob/main/src/app/core/security.py): `src/app/core/security.py`
- [User management](https://github.com/swetha289swe/project-tracker/blob/main/src/app/routers/users.py): `src/app/routers/users.py`
- [User schemas](https://github.com/swetha289swe/project-tracker/blob/main/src/app/schemas/user.py): `src/app/schemas/user.py`
- [User model](https://github.com/swetha289swe/project-tracker/blob/main/src/app/models/user.py): `src/app/models/user.py`

### Project management

- [Project API](https://github.com/swetha289swe/project-tracker/blob/main/src/app/routers/project.py): `src/app/routers/project.py`
- [Membership API](https://github.com/swetha289swe/project-tracker/blob/main/src/app/routers/project_members.py): `src/app/routers/project_members.py`
- [Project schemas](https://github.com/swetha289swe/project-tracker/blob/main/src/app/schemas/project.py): `src/app/schemas/project.py`
- [Project models](https://github.com/swetha289swe/project-tracker/blob/main/src/app/models/project.py): `src/app/models/project.py`

### Persistence

- [DB dependency](https://github.com/swetha289swe/project-tracker/blob/main/src/app/core/deps.py): `src/app/core/deps.py`
- [Session factory](https://github.com/swetha289swe/project-tracker/blob/main/src/app/db/session.py): `src/app/db/session.py`
- [Settings](https://github.com/swetha289swe/project-tracker/blob/main/src/app/core/config.py): `src/app/core/config.py`
- [ORM base](https://github.com/swetha289swe/project-tracker/blob/main/src/app/db/base.py): `src/app/db/base.py`
- **SQL database**

### Other components

- **API client**

## Connections

- API client → FastAPI app: sends requests (evidence: `src/app/main.py`)
- FastAPI app → Registration: mounts router (evidence: `src/app/main.py`)
- FastAPI app → User management: mounts router (evidence: `src/app/main.py`)
- FastAPI app → Project API: mounts router (evidence: `src/app/main.py`)
- FastAPI app → Membership API: mounts router (evidence: `src/app/main.py`)
- Registration → Password hashing: hashes password (evidence: `src/app/routers/auth.py`)
- Registration → DB dependency: gets session (evidence: `src/app/routers/auth.py`)
- Registration → User model: queries and saves (evidence: `src/app/routers/auth.py`)
- Registration → User schemas: validates and returns (evidence: `src/app/routers/auth.py`)
- User management → DB dependency: gets session (evidence: `src/app/routers/users.py`)
- User management → User model: queries and updates (evidence: `src/app/routers/users.py`)
- User management → Project models: checks associations (evidence: `src/app/routers/users.py`)
- User management → User schemas: validates and returns (evidence: `src/app/routers/users.py`)
- Project API → DB dependency: gets session (evidence: `src/app/routers/project.py`)
- Project API → Project models: queries and updates (evidence: `src/app/routers/project.py`)
- Project API → Project schemas: validates and returns (evidence: `src/app/routers/project.py`)
- Membership API → DB dependency: gets session (evidence: `src/app/routers/project_members.py`)
- Membership API → Project models: queries and saves (evidence: `src/app/routers/project_members.py`)
- Membership API → Project schemas: validates and returns (evidence: `src/app/routers/project_members.py`)
- DB dependency → Session factory: creates session (evidence: `src/app/core/deps.py`)
- Session factory → Settings: reads settings (evidence: `src/app/db/session.py`)
- Session factory → SQL database: connects to
- User model → ORM base: inherits mapping (evidence: `src/app/models/user.py`)
- Project models → ORM base: inherits mapping (evidence: `src/app/models/project.py`)
- Password hashing → Settings: reads settings (evidence: `src/app/core/security.py`)
