How raghvvv/tasker works
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: contracts API contracts · handler Request handlers · todo.go Todo services · repository Repositories
Components 24
Web client
- React entry
apps/frontend/src/main.tsx - App view
apps/frontend/src/App.tsx - API client
apps/frontend/src/api/index.ts
Shared API contracts
- API contracts
packages/openapi/src/contracts - Todo endpoints
packages/openapi/src/contracts/todo.ts - Category endpoints
packages/openapi/src/contracts/category.ts - Comment endpoints
packages/openapi/src/contracts/comments.ts - Health contract
packages/openapi/src/contracts/health.ts - Domain schemas
packages/zod/src
Backend HTTP
- Application entry
apps/backend/cmd/task_app/main.go - HTTP server
apps/backend/internal/server/server.go - API routing
apps/backend/internal/router/router.go - Request handlers
apps/backend/internal/handler - HTTP middleware
apps/backend/internal/middleware
Task domain
- Todo services
apps/backend/internal/service/todo.go - Category services
apps/backend/internal/service/category.go - Comment services
apps/backend/internal/service/comment.go - Authentication
apps/backend/internal/service/auth.go - Domain models
apps/backend/internal/model - Email jobs
apps/backend/internal/lib/job - Email delivery
apps/backend/internal/lib/email
Persistence
- Repositories
apps/backend/internal/repository - Database
apps/backend/internal/database/database.go
Other components
- User
Connections 27
- User → React entry: opens
apps/frontend/src/main.tsx - React entry → App view: renders
apps/frontend/src/main.tsx - API client → API contracts: types requests
apps/frontend/src/api/index.ts - API contracts → Todo endpoints: exports
packages/openapi/src/contracts/index.ts - API contracts → Category endpoints: exports
packages/openapi/src/contracts/index.ts - API contracts → Comment endpoints: exports
packages/openapi/src/contracts/index.ts - API contracts → Health contract: exports
packages/openapi/src/contracts/index.ts - Todo endpoints → Domain schemas: validates with
packages/openapi/src/contracts/todo.ts - Category endpoints → Domain schemas: validates with
packages/openapi/src/contracts/category.ts - Comment endpoints → Domain schemas: validates with
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