# ishan-gijavanekar/task-management architecture

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

- Interactive diagram: https://gitdiagram.com/ishan-gijavanekar/task-management
- Repository: https://github.com/ishan-gijavanekar/task-management

## Overview

This repository implements a Go user service, not the README’s broader task-management system: the sampled runtime exposes user and authentication operations over gRPC, backed by MongoDB. The main flows are registration/login (validate credentials, persist or retrieve a user, issue a JWT) and authenticated user management (authorize, then create/read/list/update/delete). The README also describes a Fiber HTTP layer and gRPC clients, but the supplied tree and excerpts do not show those components. Edges reflect shown calls or explicit registration; broader capabilities are not inferred.

Main entry points: [`user-service/cmd/server/main.go`](https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/cmd/server/main.go) (Service bootstrap), [`user-service/internal/transport/grpc/server.go`](https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/transport/grpc/server.go) (gRPC server), [`user-service/internal/service/auth-service.go`](https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/service/auth-service.go) (Registration and login), [`user-service/internal/repository/user_repository.go`](https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/repository/user_repository.go) (User repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime"]
  node_main["Service bootstrap<br/>[main.go]"]
  node_config["Configuration<br/>[config.go]"]
end

subgraph group_transport["gRPC transport"]
  node_grpc_server["gRPC server<br/>[server.go]"]
  node_user_handler["User handler<br/>[user-handler.go]"]
  node_auth_handler["Auth handler<br/>[auth-handler.go]"]
  node_interceptors["gRPC interceptors"]
  node_contracts["Protobuf contracts<br/>[user.proto]"]
  node_auth_contract["Auth contract<br/>[auth.proto]"]
end

subgraph group_business["User and auth"]
  node_user_service["User operations<br/>[user_service.go]"]
  node_auth_service["Registration and login<br/>[auth-service.go]"]
  node_authorization["Access control<br/>[authorization.go]"]
  node_jwt["JWT manager<br/>[jwt.go]"]
  node_domain["User domain<br/>[user.go]"]
end

subgraph group_persistence["Persistence"]
  node_repository["User repository<br/>[user_repository.go]"]
  node_mongo_connection["Mongo connection<br/>[mongodb.go]"]
end

node_client(("gRPC client"))
node_mongodb[("MongoDB")]

node_client -->|"calls RPCs"| node_grpc_server
node_main -->|"loads settings"| node_config
node_main -->|"opens connection"| node_mongo_connection
node_main -->|"creates repository"| node_repository
node_main -->|"creates service"| node_user_service
node_main -->|"creates service"| node_auth_service
node_main -->|"creates manager"| node_jwt
node_main -->|"starts server"| node_grpc_server
node_grpc_server -->|"registers handler"| node_user_handler
node_grpc_server -->|"registers handler"| node_auth_handler
node_grpc_server -->|"chains interceptors"| node_interceptors
node_grpc_server -->|"registers service"| node_contracts
node_grpc_server -->|"registers service"| node_auth_contract
node_user_handler -->|"invokes operations"| node_user_service
node_auth_handler -->|"invokes auth"| node_auth_service
node_user_handler -->|"checks access"| node_authorization
node_interceptors -->|"validates tokens"| node_jwt
node_auth_service -->|"issues tokens"| node_jwt
node_auth_service -->|"reads and writes users"| node_repository
node_user_service -->|"reads and writes users"| node_repository
node_repository -->|"uses collection"| node_mongo_connection
node_mongo_connection -.->|"connects to"| node_mongodb
node_user_service -->|"creates user records"| node_domain
node_auth_service -->|"creates user records"| node_domain
node_repository -->|"persists user records"| node_domain

click node_main "https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/cmd/server/main.go"
click node_config "https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/config/config.go"
click node_grpc_server "https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/transport/grpc/server.go"
click node_user_handler "https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/transport/grpc/user-handler.go"
click node_auth_handler "https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/transport/grpc/auth-handler.go"
click node_interceptors "https://github.com/ishan-gijavanekar/task-management/tree/master/user-service/internal/transport/grpc/interceptor"
click node_contracts "https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/api/proto/user.proto"
click node_auth_contract "https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/api/proto/auth/auth.proto"
click node_user_service "https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/service/user_service.go"
click node_auth_service "https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/service/auth-service.go"
click node_authorization "https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/auth/authorization.go"
click node_jwt "https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/auth/jwt.go"
click node_domain "https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/domain/user.go"
click node_repository "https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/repository/user_repository.go"
click node_mongo_connection "https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/database/mongodb.go"

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_main,node_config,node_client toneBlue
class node_grpc_server,node_user_handler,node_auth_handler,node_interceptors,node_contracts,node_auth_contract,node_mongodb toneAmber
class node_user_service,node_auth_service,node_authorization,node_jwt,node_domain toneMint
class node_repository,node_mongo_connection toneRose
```

## Components

### Runtime

- [Service bootstrap](https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/cmd/server/main.go): `user-service/cmd/server/main.go`
- [Configuration](https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/config/config.go): `user-service/internal/config/config.go`

### gRPC transport

- [gRPC server](https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/transport/grpc/server.go): `user-service/internal/transport/grpc/server.go`
- [User handler](https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/transport/grpc/user-handler.go): `user-service/internal/transport/grpc/user-handler.go`
- [Auth handler](https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/transport/grpc/auth-handler.go): `user-service/internal/transport/grpc/auth-handler.go`
- [gRPC interceptors](https://github.com/ishan-gijavanekar/task-management/tree/master/user-service/internal/transport/grpc/interceptor): `user-service/internal/transport/grpc/interceptor`
- [Protobuf contracts](https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/api/proto/user.proto): `user-service/api/proto/user.proto`
- [Auth contract](https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/api/proto/auth/auth.proto): `user-service/api/proto/auth/auth.proto`

### User and auth

- [User operations](https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/service/user_service.go): `user-service/internal/service/user_service.go`
- [Registration and login](https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/service/auth-service.go): `user-service/internal/service/auth-service.go`
- [Access control](https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/auth/authorization.go): `user-service/internal/auth/authorization.go`
- [JWT manager](https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/auth/jwt.go): `user-service/internal/auth/jwt.go`
- [User domain](https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/domain/user.go): `user-service/internal/domain/user.go`

### Persistence

- [User repository](https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/repository/user_repository.go): `user-service/internal/repository/user_repository.go`
- [Mongo connection](https://github.com/ishan-gijavanekar/task-management/blob/master/user-service/internal/database/mongodb.go): `user-service/internal/database/mongodb.go`

### Other components

- **gRPC client**
- **MongoDB**

## Connections

- gRPC client → gRPC server: calls RPCs (evidence: `README.md`)
- Service bootstrap → Configuration: loads settings (evidence: `user-service/cmd/server/main.go`)
- Service bootstrap → Mongo connection: opens connection (evidence: `user-service/cmd/server/main.go`)
- Service bootstrap → User repository: creates repository (evidence: `user-service/cmd/server/main.go`)
- Service bootstrap → User operations: creates service (evidence: `user-service/cmd/server/main.go`)
- Service bootstrap → Registration and login: creates service (evidence: `user-service/cmd/server/main.go`)
- Service bootstrap → JWT manager: creates manager (evidence: `user-service/cmd/server/main.go`)
- Service bootstrap → gRPC server: starts server (evidence: `user-service/cmd/server/main.go`)
- gRPC server → User handler: registers handler (evidence: `user-service/internal/transport/grpc/server.go`)
- gRPC server → Auth handler: registers handler (evidence: `user-service/internal/transport/grpc/server.go`)
- gRPC server → gRPC interceptors: chains interceptors (evidence: `user-service/internal/transport/grpc/server.go`)
- gRPC server → Protobuf contracts: registers service (evidence: `user-service/internal/transport/grpc/server.go`)
- gRPC server → Auth contract: registers service (evidence: `user-service/internal/transport/grpc/server.go`)
- User handler → User operations: invokes operations (evidence: `user-service/internal/transport/grpc/user-handler.go`)
- Auth handler → Registration and login: invokes auth (evidence: `user-service/internal/transport/grpc/auth-handler.go`)
- User handler → Access control: checks access (evidence: `user-service/internal/transport/grpc/user-handler.go`)
- gRPC interceptors → JWT manager: validates tokens (evidence: `user-service/internal/transport/grpc/interceptor/auth.go`)
- Registration and login → JWT manager: issues tokens (evidence: `user-service/internal/service/auth-service.go`)
- Registration and login → User repository: reads and writes users (evidence: `user-service/internal/service/auth-service.go`)
- User operations → User repository: reads and writes users (evidence: `user-service/internal/service/user_service.go`)
- User repository → Mongo connection: uses collection
- Mongo connection → MongoDB: connects to
- User operations → User domain: creates user records (evidence: `user-service/internal/service/user_service.go`)
- Registration and login → User domain: creates user records (evidence: `user-service/internal/service/auth-service.go`)
- User repository → User domain: persists user records (evidence: `user-service/internal/repository/user_repository.go`)
