# mosobea/sitetrack architecture

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

- Interactive diagram: https://gitdiagram.com/mosobea/sitetrack
- Repository: https://github.com/mosobea/sitetrack

## Overview

SiteTrack is a construction-project management API: users register or log in, then work with projects and project tasks through authenticated endpoints. Project and task services enforce role- and ownership-based access while providing CRUD; task listing also supports status/assignee filters and pagination. Prisma persists users, projects, and tasks in PostgreSQL. The README also describes future issues, RFIs, comments, a React frontend, and photo uploads, but marks these as unimplemented. Connections reflect excerpts, the source index, or README; unsampled module wiring is not inferred.

Main entry points: [`src/app.module.ts`](https://github.com/mosobea/sitetrack/blob/main/src/app.module.ts) (Application Modules), [`src/auth/auth.controller.ts`](https://github.com/mosobea/sitetrack/blob/main/src/auth/auth.controller.ts) (Auth Endpoints), [`src/projects/projects.controller.ts`](https://github.com/mosobea/sitetrack/blob/main/src/projects/projects.controller.ts) (Project Endpoints), [`src/tasks/tasks.controller.ts`](https://github.com/mosobea/sitetrack/blob/main/src/tasks/tasks.controller.ts) (Task Endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["API Runtime"]
  node_bootstrap["NestJS Bootstrap<br/>[main.ts]"]
  node_app["Application Modules<br/>[app.module.ts]"]
  node_future["Planned Site Workflows"]
end

subgraph group_identity["Identity and Access"]
  node_authapi["Auth Endpoints<br/>[auth.controller.ts]"]
  node_authservice["Registration and Login<br/>[auth.service.ts]"]
  node_access["JWT and Role Guards"]
end

subgraph group_projects["Project Management"]
  node_projectapi["Project Endpoints"]
  node_projectservice["Project Rules and CRUD"]
end

subgraph group_tasks["Task Management"]
  node_taskapi["Task Endpoints"]
  node_taskservice["Task Rules and CRUD<br/>[tasks.service.ts]"]
end

subgraph group_persistence["Persistence"]
  node_prisma["Prisma Client<br/>[prisma.service.ts]"]
  node_postgres[("PostgreSQL")]
end

node_user(("Team Member"))

node_user -->|"registers or logs in"| node_authapi
node_bootstrap -->|"starts"| node_app
node_app -->|"registers"| node_authapi
node_app -->|"registers"| node_projectapi
node_app -->|"registers"| node_taskapi
node_authapi -->|"calls"| node_authservice
node_authservice -->|"reads and writes users"| node_prisma
node_authapi -->|"guards profile route"| node_access
node_user -->|"manages projects"| node_projectapi
node_projectapi -->|"guards endpoints"| node_access
node_projectapi -->|"calls"| node_projectservice
node_projectservice -->|"reads and writes projects"| node_prisma
node_user -->|"manages tasks"| node_taskapi
node_taskapi -->|"guards endpoints"| node_access
node_taskapi -->|"calls"| node_taskservice
node_taskservice -->|"reads and writes tasks"| node_prisma
node_prisma -->|"connects through adapter"| node_postgres
node_user -.->|"planned capabilities"| node_future

click node_bootstrap "https://github.com/mosobea/sitetrack/blob/main/src/main.ts"
click node_app "https://github.com/mosobea/sitetrack/blob/main/src/app.module.ts"
click node_authapi "https://github.com/mosobea/sitetrack/blob/main/src/auth/auth.controller.ts"
click node_authservice "https://github.com/mosobea/sitetrack/blob/main/src/auth/auth.service.ts"
click node_access "https://github.com/mosobea/sitetrack/tree/main/src/auth/guards"
click node_projectapi "https://github.com/mosobea/sitetrack/blob/main/src/projects/projects.controller.ts"
click node_projectservice "https://github.com/mosobea/sitetrack/blob/main/src/projects/projects.service.ts"
click node_taskapi "https://github.com/mosobea/sitetrack/blob/main/src/tasks/tasks.controller.ts"
click node_taskservice "https://github.com/mosobea/sitetrack/blob/main/src/tasks/tasks.service.ts"
click node_prisma "https://github.com/mosobea/sitetrack/blob/main/src/prisma/prisma.service.ts"

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_bootstrap,node_app,node_future toneBlue
class node_authapi,node_authservice,node_access toneAmber
class node_projectapi,node_projectservice toneMint
class node_taskapi,node_taskservice toneRose
class node_prisma,node_postgres,node_user toneIndigo
```

## Components

### API Runtime

- [NestJS Bootstrap](https://github.com/mosobea/sitetrack/blob/main/src/main.ts): `src/main.ts`
- [Application Modules](https://github.com/mosobea/sitetrack/blob/main/src/app.module.ts): `src/app.module.ts`
- **Planned Site Workflows**

### Identity and Access

- [Auth Endpoints](https://github.com/mosobea/sitetrack/blob/main/src/auth/auth.controller.ts): `src/auth/auth.controller.ts`
- [Registration and Login](https://github.com/mosobea/sitetrack/blob/main/src/auth/auth.service.ts): `src/auth/auth.service.ts`
- [JWT and Role Guards](https://github.com/mosobea/sitetrack/tree/main/src/auth/guards): `src/auth/guards`

### Project Management

- [Project Endpoints](https://github.com/mosobea/sitetrack/blob/main/src/projects/projects.controller.ts): `src/projects/projects.controller.ts`
- [Project Rules and CRUD](https://github.com/mosobea/sitetrack/blob/main/src/projects/projects.service.ts): `src/projects/projects.service.ts`

### Task Management

- [Task Endpoints](https://github.com/mosobea/sitetrack/blob/main/src/tasks/tasks.controller.ts): `src/tasks/tasks.controller.ts`
- [Task Rules and CRUD](https://github.com/mosobea/sitetrack/blob/main/src/tasks/tasks.service.ts): `src/tasks/tasks.service.ts`

### Persistence

- [Prisma Client](https://github.com/mosobea/sitetrack/blob/main/src/prisma/prisma.service.ts): `src/prisma/prisma.service.ts`
- **PostgreSQL**

### Other components

- **Team Member**

## Connections

- Team Member → Auth Endpoints: registers or logs in (evidence: `README.md`)
- NestJS Bootstrap → Application Modules: starts (evidence: `src/main.ts`)
- Application Modules → Auth Endpoints: registers (evidence: `src/app.module.ts`)
- Application Modules → Project Endpoints: registers (evidence: `src/app.module.ts`)
- Application Modules → Task Endpoints: registers (evidence: `src/app.module.ts`)
- Auth Endpoints → Registration and Login: calls (evidence: `src/auth/auth.controller.ts`)
- Registration and Login → Prisma Client: reads and writes users (evidence: `src/auth/auth.service.ts`)
- Auth Endpoints → JWT and Role Guards: guards profile route (evidence: `src/auth/auth.controller.ts`)
- Team Member → Project Endpoints: manages projects (evidence: `README.md`)
- Project Endpoints → JWT and Role Guards: guards endpoints (evidence: `src/projects/projects.controller.ts`)
- Project Endpoints → Project Rules and CRUD: calls (evidence: `src/projects/projects.controller.ts`)
- Project Rules and CRUD → Prisma Client: reads and writes projects (evidence: `src/projects/projects.service.ts`)
- Team Member → Task Endpoints: manages tasks (evidence: `README.md`)
- Task Endpoints → JWT and Role Guards: guards endpoints (evidence: `src/tasks/tasks.controller.ts`)
- Task Endpoints → Task Rules and CRUD: calls (evidence: `src/tasks/tasks.controller.ts`)
- Task Rules and CRUD → Prisma Client: reads and writes tasks (evidence: `src/tasks/tasks.service.ts`)
- Prisma Client → PostgreSQL: connects through adapter (evidence: `src/prisma/prisma.service.ts`)
- Team Member → Planned Site Workflows: planned capabilities (evidence: `README.md`)
