# lamsalyusu/grpc-new-project architecture

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

- Interactive diagram: https://gitdiagram.com/lamsalyusu/grpc-new-project
- Repository: https://github.com/lamsalyusu/grpc-new-project

## Overview

This is a full-stack task-management application: users work through a static web client and an Express API, which forwards business operations to a gRPC backend that accesses the database. The principal workflow spans task requests, backend task logic, and persistence; collaboration, chat, notifications, reminders, authentication, and admin tools are additional product branches. The README documents the overall split and capabilities; source excerpts and the index verify selected wiring, while several feature-specific internals were not sampled.

Main entry points: [`server/src/server.ts`](https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/server.ts) (gRPC service host), [`server/src/repositories`](https://github.com/lamsalyusu/grpc-new-project/tree/main/server/src/repositories) (Data repositories), [`InternProject1/client/js`](https://github.com/lamsalyusu/grpc-new-project/tree/main/InternProject1/client/js) (Web client), [`server/src/handlers/authHandler.ts`](https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/handlers/authHandler.ts) (Auth handlers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web and API"]
  node_client["Web client"]
  node_express["Express app<br/>[app.ts]"]
  node_task_routes["Task routes<br/>[taskRoutes.ts]"]
  node_task_controller["Task controller<br/>[taskController.ts]"]
  node_grpc_clients["gRPC clients"]
  node_reminder_job["Reminder job<br/>[reminderJob.ts]"]
end

subgraph group_domain["Task collaboration"]
  node_socket_chat["Live task chat<br/>[chatHandler.ts]"]
  node_collaboration["Collaboration requests"]
  node_collaborators["Task collaborators"]
  node_tasks["Task management<br/>[taskService.ts]"]
  node_notifications["Notifications"]
  node_reminders["Reminder scheduling<br/>[reminderService.ts]"]
end

subgraph group_backend["gRPC business backend"]
  node_grpc_server["gRPC service host<br/>[server.ts]"]
  node_task_handlers["Task handlers<br/>[taskHandler.ts]"]
  node_auth_handlers["Auth handlers<br/>[authHandler.ts]"]
  node_repositories["Data repositories"]
  node_database[("Relational database<br/>[connection.ts]")]
end

subgraph group_platform["Identity and operations"]
  node_auth["Authentication<br/>[authService.ts]"]
  node_admin["Admin operations<br/>[adminHandler.ts]"]
end

node_user(("User"))

node_user -->|"uses"| node_client
node_client -->|"requests"| node_express
node_express -->|"mounts routes"| node_task_routes
node_task_routes -->|"dispatches"| node_task_controller
node_task_controller -->|"calls task client"| node_grpc_clients
node_grpc_clients -.->|"gRPC requests"| node_grpc_server
node_grpc_server -->|"registers"| node_task_handlers
node_grpc_server -->|"registers"| node_auth_handlers
node_grpc_server -->|"registers admin handler"| node_admin
node_task_handlers -.->|"delegates"| node_tasks
node_auth_handlers -->|"calls"| node_auth
node_auth_handlers -->|"reads user"| node_repositories
node_auth -->|"uses user repository"| node_repositories
node_tasks -->|"uses repositories"| node_repositories
node_repositories -->|"queries"| node_database
node_client -.->|"live updates"| node_socket_chat
node_grpc_server -->|"serves feature"| node_collaboration
node_grpc_server -->|"serves feature"| node_collaborators
node_grpc_server -->|"serves feature"| node_notifications
node_grpc_server -->|"serves feature"| node_reminders
node_reminder_job -.->|"schedules reminders"| node_grpc_clients

click node_client "https://github.com/lamsalyusu/grpc-new-project/tree/main/InternProject1/client/js"
click node_express "https://github.com/lamsalyusu/grpc-new-project/blob/main/InternProject1/src/app.ts"
click node_task_routes "https://github.com/lamsalyusu/grpc-new-project/blob/main/InternProject1/src/routes/taskRoutes.ts"
click node_task_controller "https://github.com/lamsalyusu/grpc-new-project/blob/main/InternProject1/src/controllers/taskController.ts"
click node_grpc_clients "https://github.com/lamsalyusu/grpc-new-project/tree/main/InternProject1/src/grpc-client"
click node_socket_chat "https://github.com/lamsalyusu/grpc-new-project/blob/main/InternProject1/src/sockets/chatHandler.ts"
click node_collaboration "https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/service/collaborationService.ts"
click node_collaborators "https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/service/taskCollaboratorServices.ts"
click node_tasks "https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/service/taskService.ts"
click node_notifications "https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/service/notificationService.ts"
click node_reminders "https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/service/reminderService.ts"
click node_reminder_job "https://github.com/lamsalyusu/grpc-new-project/blob/main/InternProject1/src/jobs/reminderJob.ts"
click node_auth "https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/service/authService.ts"
click node_admin "https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/handlers/adminHandler.ts"
click node_grpc_server "https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/server.ts"
click node_task_handlers "https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/handlers/taskHandler.ts"
click node_auth_handlers "https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/handlers/authHandler.ts"
click node_repositories "https://github.com/lamsalyusu/grpc-new-project/tree/main/server/src/repositories"
click node_database "https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/db/connection.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_client,node_express,node_task_routes,node_task_controller,node_grpc_clients,node_reminder_job,node_user toneBlue
class node_socket_chat,node_collaboration,node_collaborators,node_tasks,node_notifications,node_reminders toneAmber
class node_grpc_server,node_task_handlers,node_auth_handlers,node_repositories,node_database toneMint
class node_auth,node_admin toneRose
```

## Components

### Web and API

- [Web client](https://github.com/lamsalyusu/grpc-new-project/tree/main/InternProject1/client/js): `InternProject1/client/js`
- [Express app](https://github.com/lamsalyusu/grpc-new-project/blob/main/InternProject1/src/app.ts): `InternProject1/src/app.ts`
- [Task routes](https://github.com/lamsalyusu/grpc-new-project/blob/main/InternProject1/src/routes/taskRoutes.ts): `InternProject1/src/routes/taskRoutes.ts`
- [Task controller](https://github.com/lamsalyusu/grpc-new-project/blob/main/InternProject1/src/controllers/taskController.ts): `InternProject1/src/controllers/taskController.ts`
- [gRPC clients](https://github.com/lamsalyusu/grpc-new-project/tree/main/InternProject1/src/grpc-client): `InternProject1/src/grpc-client`
- [Reminder job](https://github.com/lamsalyusu/grpc-new-project/blob/main/InternProject1/src/jobs/reminderJob.ts): `InternProject1/src/jobs/reminderJob.ts`

### Task collaboration

- [Live task chat](https://github.com/lamsalyusu/grpc-new-project/blob/main/InternProject1/src/sockets/chatHandler.ts): `InternProject1/src/sockets/chatHandler.ts`
- [Collaboration requests](https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/service/collaborationService.ts): `server/src/service/collaborationService.ts`
- [Task collaborators](https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/service/taskCollaboratorServices.ts): `server/src/service/taskCollaboratorServices.ts`
- [Task management](https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/service/taskService.ts): `server/src/service/taskService.ts`
- [Notifications](https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/service/notificationService.ts): `server/src/service/notificationService.ts`
- [Reminder scheduling](https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/service/reminderService.ts): `server/src/service/reminderService.ts`

### gRPC business backend

- [gRPC service host](https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/server.ts): `server/src/server.ts`
- [Task handlers](https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/handlers/taskHandler.ts): `server/src/handlers/taskHandler.ts`
- [Auth handlers](https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/handlers/authHandler.ts): `server/src/handlers/authHandler.ts`
- [Data repositories](https://github.com/lamsalyusu/grpc-new-project/tree/main/server/src/repositories): `server/src/repositories`
- [Relational database](https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/db/connection.ts): `server/src/db/connection.ts`

### Identity and operations

- [Authentication](https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/service/authService.ts): `server/src/service/authService.ts`
- [Admin operations](https://github.com/lamsalyusu/grpc-new-project/blob/main/server/src/handlers/adminHandler.ts): `server/src/handlers/adminHandler.ts`

### Other components

- **User**

## Connections

- User → Web client: uses (evidence: `README.md`)
- Web client → Express app: requests (evidence: `README.md`)
- Express app → Task routes: mounts routes (evidence: `InternProject1/src/app.ts`)
- Task routes → Task controller: dispatches (evidence: `InternProject1/src/routes/taskRoutes.ts`)
- Task controller → gRPC clients: calls task client (evidence: `InternProject1/src/controllers/taskController.ts`)
- gRPC clients → gRPC service host: gRPC requests (evidence: `README.md`)
- gRPC service host → Task handlers: registers (evidence: `server/src/server.ts`)
- gRPC service host → Auth handlers: registers (evidence: `server/src/server.ts`)
- gRPC service host → Admin operations: registers admin handler (evidence: `server/src/server.ts`)
- Task handlers → Task management: delegates
- Auth handlers → Authentication: calls (evidence: `server/src/handlers/authHandler.ts`)
- Auth handlers → Data repositories: reads user (evidence: `server/src/handlers/authHandler.ts`)
- Authentication → Data repositories: uses user repository (evidence: `server/src/service/authService.ts`)
- Task management → Data repositories: uses repositories (evidence: `server/src/service/taskService.ts`)
- Data repositories → Relational database: queries (evidence: `server/src/repositories/userRepository.ts`)
- Web client → Live task chat: live updates (evidence: `README.md`)
- gRPC service host → Collaboration requests: serves feature (evidence: `server/src/server.ts`)
- gRPC service host → Task collaborators: serves feature (evidence: `server/src/server.ts`)
- gRPC service host → Notifications: serves feature (evidence: `server/src/server.ts`)
- gRPC service host → Reminder scheduling: serves feature (evidence: `server/src/server.ts`)
- Reminder job → gRPC clients: schedules reminders (evidence: `README.md`)
