# raghvvv/tasker architecture

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

- Interactive diagram: https://gitdiagram.com/raghvvv/tasker
- Repository: https://github.com/raghvvv/tasker

## Overview

This repository is a task-management application workspace: a React frontend, Go backend, and shared Zod schemas and ts-rest/OpenAPI contracts. The documented API covers todo lifecycle, categories, comments, statistics, and attachments; the backend tree also separates routing, handlers, services, repositories, and database access. The frontend entry point currently renders a placeholder, so the user-facing workflow is not implemented in the sampled UI. Internal backend connections are shown as unverified because the available excerpts do not expose their call sites.

Main entry points: [`packages/openapi/src/contracts`](https://github.com/raghvvv/tasker/tree/main/packages/openapi/src/contracts) (API contracts), [`apps/backend/internal/handler`](https://github.com/raghvvv/tasker/tree/main/apps/backend/internal/handler) (Request handlers), [`apps/backend/internal/service/todo.go`](https://github.com/raghvvv/tasker/blob/main/apps/backend/internal/service/todo.go) (Todo services), [`apps/backend/internal/repository`](https://github.com/raghvvv/tasker/tree/main/apps/backend/internal/repository) (Repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_frontend_entry["React entry<br/>[main.tsx]"]
  node_frontend_app["App view<br/>[App.tsx]"]
  node_api_client["API client<br/>[index.ts]"]
end

subgraph group_contracts["Shared API contracts"]
  node_api_contracts["API contracts"]
  node_todo_contract["Todo endpoints<br/>[todo.ts]"]
  node_category_contract["Category endpoints<br/>[category.ts]"]
  node_comment_contract["Comment endpoints<br/>[comments.ts]"]
  node_health_contract["Health contract<br/>[health.ts]"]
  node_schemas["Domain schemas"]
end

subgraph group_http["Backend HTTP"]
  node_backend_entry["Application entry<br/>[main.go]"]
  node_server["HTTP server<br/>[server.go]"]
  node_router["API routing<br/>[router.go]"]
  node_handlers["Request handlers"]
  node_middleware["HTTP middleware"]
end

subgraph group_domain["Task domain"]
  node_todo_service["Todo services<br/>[todo.go]"]
  node_category_service["Category services<br/>[category.go]"]
  node_comment_service["Comment services<br/>[comment.go]"]
  node_auth_service["Authentication<br/>[auth.go]"]
  node_models["Domain models"]
  node_jobs["Email jobs"]
  node_email["Email delivery"]
end

subgraph group_persistence["Persistence"]
  node_repositories["Repositories"]
  node_database[("Database<br/>[database.go]")]
end

node_user(("User"))

node_user -->|"opens"| node_frontend_entry
node_frontend_entry -->|"renders"| node_frontend_app
node_api_client -->|"types requests"| node_api_contracts
node_api_contracts -->|"exports"| node_todo_contract
node_api_contracts -->|"exports"| node_category_contract
node_api_contracts -->|"exports"| node_comment_contract
node_api_contracts -->|"exports"| node_health_contract
node_todo_contract -->|"validates with"| node_schemas
node_category_contract -->|"validates with"| node_schemas
node_comment_contract -->|"validates with"| node_schemas
node_api_client -.->|"calls API"| node_backend_entry
node_backend_entry -.->|"starts"| node_server
node_server -.->|"dispatches"| node_router
node_router -.->|"routes requests"| node_handlers
node_handlers -.->|"uses"| node_middleware
node_handlers -.->|"delegates to"| node_todo_service
node_handlers -.->|"delegates to"| node_category_service
node_handlers -.->|"delegates to"| node_comment_service
node_todo_service -.->|"accesses"| node_repositories
node_category_service -.->|"accesses"| node_repositories
node_comment_service -.->|"accesses"| node_repositories
node_repositories -.->|"queries"| node_database
node_todo_service -.->|"uses"| node_models
node_category_service -.->|"uses"| node_models
node_comment_service -.->|"uses"| node_models
node_todo_service -.->|"enqueues"| node_jobs
node_jobs -.->|"sends mail"| node_email

click node_frontend_entry "https://github.com/raghvvv/tasker/blob/main/apps/frontend/src/main.tsx"
click node_frontend_app "https://github.com/raghvvv/tasker/blob/main/apps/frontend/src/App.tsx"
click node_api_client "https://github.com/raghvvv/tasker/blob/main/apps/frontend/src/api/index.ts"
click node_api_contracts "https://github.com/raghvvv/tasker/tree/main/packages/openapi/src/contracts"
click node_todo_contract "https://github.com/raghvvv/tasker/blob/main/packages/openapi/src/contracts/todo.ts"
click node_category_contract "https://github.com/raghvvv/tasker/blob/main/packages/openapi/src/contracts/category.ts"
click node_comment_contract "https://github.com/raghvvv/tasker/blob/main/packages/openapi/src/contracts/comments.ts"
click node_health_contract "https://github.com/raghvvv/tasker/blob/main/packages/openapi/src/contracts/health.ts"
click node_schemas "https://github.com/raghvvv/tasker/tree/main/packages/zod/src"
click node_backend_entry "https://github.com/raghvvv/tasker/blob/main/apps/backend/cmd/task_app/main.go"
click node_server "https://github.com/raghvvv/tasker/blob/main/apps/backend/internal/server/server.go"
click node_router "https://github.com/raghvvv/tasker/blob/main/apps/backend/internal/router/router.go"
click node_handlers "https://github.com/raghvvv/tasker/tree/main/apps/backend/internal/handler"
click node_middleware "https://github.com/raghvvv/tasker/tree/main/apps/backend/internal/middleware"
click node_todo_service "https://github.com/raghvvv/tasker/blob/main/apps/backend/internal/service/todo.go"
click node_category_service "https://github.com/raghvvv/tasker/blob/main/apps/backend/internal/service/category.go"
click node_comment_service "https://github.com/raghvvv/tasker/blob/main/apps/backend/internal/service/comment.go"
click node_auth_service "https://github.com/raghvvv/tasker/blob/main/apps/backend/internal/service/auth.go"
click node_models "https://github.com/raghvvv/tasker/tree/main/apps/backend/internal/model"
click node_repositories "https://github.com/raghvvv/tasker/tree/main/apps/backend/internal/repository"
click node_database "https://github.com/raghvvv/tasker/blob/main/apps/backend/internal/database/database.go"
click node_jobs "https://github.com/raghvvv/tasker/tree/main/apps/backend/internal/lib/job"
click node_email "https://github.com/raghvvv/tasker/tree/main/apps/backend/internal/lib/email"

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_frontend_entry,node_frontend_app,node_api_client,node_user toneBlue
class node_api_contracts,node_todo_contract,node_category_contract,node_comment_contract,node_health_contract,node_schemas toneAmber
class node_backend_entry,node_server,node_router,node_handlers,node_middleware toneMint
class node_todo_service,node_category_service,node_comment_service,node_auth_service,node_models,node_jobs,node_email toneRose
class node_repositories,node_database toneIndigo
```

## Components

### Web client

- [React entry](https://github.com/raghvvv/tasker/blob/main/apps/frontend/src/main.tsx): `apps/frontend/src/main.tsx`
- [App view](https://github.com/raghvvv/tasker/blob/main/apps/frontend/src/App.tsx): `apps/frontend/src/App.tsx`
- [API client](https://github.com/raghvvv/tasker/blob/main/apps/frontend/src/api/index.ts): `apps/frontend/src/api/index.ts`

### Shared API contracts

- [API contracts](https://github.com/raghvvv/tasker/tree/main/packages/openapi/src/contracts): `packages/openapi/src/contracts`
- [Todo endpoints](https://github.com/raghvvv/tasker/blob/main/packages/openapi/src/contracts/todo.ts): `packages/openapi/src/contracts/todo.ts`
- [Category endpoints](https://github.com/raghvvv/tasker/blob/main/packages/openapi/src/contracts/category.ts): `packages/openapi/src/contracts/category.ts`
- [Comment endpoints](https://github.com/raghvvv/tasker/blob/main/packages/openapi/src/contracts/comments.ts): `packages/openapi/src/contracts/comments.ts`
- [Health contract](https://github.com/raghvvv/tasker/blob/main/packages/openapi/src/contracts/health.ts): `packages/openapi/src/contracts/health.ts`
- [Domain schemas](https://github.com/raghvvv/tasker/tree/main/packages/zod/src): `packages/zod/src`

### Backend HTTP

- [Application entry](https://github.com/raghvvv/tasker/blob/main/apps/backend/cmd/task_app/main.go): `apps/backend/cmd/task_app/main.go`
- [HTTP server](https://github.com/raghvvv/tasker/blob/main/apps/backend/internal/server/server.go): `apps/backend/internal/server/server.go`
- [API routing](https://github.com/raghvvv/tasker/blob/main/apps/backend/internal/router/router.go): `apps/backend/internal/router/router.go`
- [Request handlers](https://github.com/raghvvv/tasker/tree/main/apps/backend/internal/handler): `apps/backend/internal/handler`
- [HTTP middleware](https://github.com/raghvvv/tasker/tree/main/apps/backend/internal/middleware): `apps/backend/internal/middleware`

### Task domain

- [Todo services](https://github.com/raghvvv/tasker/blob/main/apps/backend/internal/service/todo.go): `apps/backend/internal/service/todo.go`
- [Category services](https://github.com/raghvvv/tasker/blob/main/apps/backend/internal/service/category.go): `apps/backend/internal/service/category.go`
- [Comment services](https://github.com/raghvvv/tasker/blob/main/apps/backend/internal/service/comment.go): `apps/backend/internal/service/comment.go`
- [Authentication](https://github.com/raghvvv/tasker/blob/main/apps/backend/internal/service/auth.go): `apps/backend/internal/service/auth.go`
- [Domain models](https://github.com/raghvvv/tasker/tree/main/apps/backend/internal/model): `apps/backend/internal/model`
- [Email jobs](https://github.com/raghvvv/tasker/tree/main/apps/backend/internal/lib/job): `apps/backend/internal/lib/job`
- [Email delivery](https://github.com/raghvvv/tasker/tree/main/apps/backend/internal/lib/email): `apps/backend/internal/lib/email`

### Persistence

- [Repositories](https://github.com/raghvvv/tasker/tree/main/apps/backend/internal/repository): `apps/backend/internal/repository`
- [Database](https://github.com/raghvvv/tasker/blob/main/apps/backend/internal/database/database.go): `apps/backend/internal/database/database.go`

### Other components

- **User**

## Connections

- User → React entry: opens (evidence: `apps/frontend/src/main.tsx`)
- React entry → App view: renders (evidence: `apps/frontend/src/main.tsx`)
- API client → API contracts: types requests (evidence: `apps/frontend/src/api/index.ts`)
- API contracts → Todo endpoints: exports (evidence: `packages/openapi/src/contracts/index.ts`)
- API contracts → Category endpoints: exports (evidence: `packages/openapi/src/contracts/index.ts`)
- API contracts → Comment endpoints: exports (evidence: `packages/openapi/src/contracts/index.ts`)
- API contracts → Health contract: exports (evidence: `packages/openapi/src/contracts/index.ts`)
- Todo endpoints → Domain schemas: validates with (evidence: `packages/openapi/src/contracts/todo.ts`)
- Category endpoints → Domain schemas: validates with (evidence: `packages/openapi/src/contracts/category.ts`)
- Comment endpoints → Domain schemas: validates with (evidence: `packages/openapi/src/contracts/comments.ts`)
- API client → Application entry: calls API
- Application entry → HTTP server: starts
- HTTP server → API routing: dispatches
- API routing → Request handlers: routes requests
- Request handlers → HTTP middleware: uses
- Request handlers → Todo services: delegates to
- Request handlers → Category services: delegates to
- Request handlers → Comment services: delegates to
- Todo services → Repositories: accesses
- Category services → Repositories: accesses
- Comment services → Repositories: accesses
- Repositories → Database: queries
- Todo services → Domain models: uses
- Category services → Domain models: uses
- Comment services → Domain models: uses
- Todo services → Email jobs: enqueues
- Email jobs → Email delivery: sends mail
