# shubh00796/tenancylink-scalable-multi-tenant-project-management-backend architecture

> Architecture diagram of the GitHub repository shubh00796/tenancylink-scalable-multi-tenant-project-management-backend, 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/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend
- Repository: https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend

## Overview

TenancyLink is a multi-tenant project-management backend. The primary workflow is a REST request for project, task, user, tenant, or activity operations, handled by API controllers and application services, then persisted through repositories. The README also describes tenant-specific data routing, audit logging, analytics, configurable tenant fields, and optional caching and search integrations. The sampled sources confirm user search and its repository/mapper/specification calls; other links are included only where the README documents the architecture. Most implementation files were not sampled, so those links are documentation-based.

Main entry points: [`src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Repositories`](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/tree/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Repositories) (Data repositories), [`src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/UserSearchService.java`](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/UserSearchService.java) (User search), [`src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/UserController.java`](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/UserController.java) (User API), [`src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/ProjectServiceImpl.java`](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/ProjectServiceImpl.java) (Project services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_project_api["Project API"]
  node_task_api["Task API"]
  node_user_api["User API"]
  node_tenant_api["Tenant APIs"]
  node_config_api["Configuration API"]
  node_activity_api["Activity API"]
end

subgraph group_work["Project Work"]
  node_projects["Project services"]
  node_tasks["Task services"]
end

subgraph group_identity["Tenant And Users"]
  node_users["User services"]
  node_user_search["User search"]
  node_tenants["Tenant lifecycle"]
  node_tenant_config["Tenant configuration"]
end

subgraph group_data["Domain And Storage"]
  node_tenant_router["Tenant routing"]
  node_repositories["Data repositories"]
  node_domain["Domain entities"]
  node_user_mapper["User mapper<br/>[UserMapper.java]"]
  node_user_specs["User query specs"]
  node_tenant_db[("Tenant schemas")]
end

subgraph group_insights["Audit And Analytics"]
  node_activity["Activity logging"]
  node_analytics["Tenant analytics"]
  node_reports["Report generation"]
end

node_client(("API client"))
node_redis[("Redis cache")]
node_elastic[("Elasticsearch")]

node_client -->|"requests"| node_project_api
node_client -->|"requests"| node_task_api
node_client -->|"requests"| node_user_api
node_client -.->|"requests"| node_tenant_api
node_client -.->|"requests"| node_config_api
node_client -.->|"requests"| node_activity_api
node_project_api -->|"delegates"| node_projects
node_task_api -->|"delegates"| node_tasks
node_user_api -->|"delegates"| node_users
node_user_api -->|"searches"| node_user_search
node_tenant_api -.->|"delegates"| node_tenants
node_config_api -.->|"delegates"| node_tenant_config
node_activity_api -.->|"delegates"| node_activity
node_user_search -->|"queries"| node_repositories
node_user_search -->|"maps results"| node_user_mapper
node_user_search -->|"builds filters"| node_user_specs
node_repositories -->|"accesses"| node_domain
node_projects -->|"persists"| node_repositories
node_tasks -->|"persists"| node_repositories
node_users -->|"persists"| node_repositories
node_tenants -.->|"persists"| node_repositories
node_tenant_config -.->|"persists"| node_repositories
node_tenant_router -.->|"routes requests"| node_tenant_db
node_repositories -.->|"uses tenant context"| node_tenant_router
node_activity -.->|"records events"| node_repositories
node_analytics -.->|"reads metrics"| node_repositories
node_reports -.->|"generates reports"| node_analytics
node_projects -.->|"caches data"| node_redis
node_user_search -.->|"searches text"| node_elastic

click node_project_api "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/ProjectController.java"
click node_task_api "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/TaskController.java"
click node_user_api "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/UserController.java"
click node_tenant_api "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/TenantController.java"
click node_config_api "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/TenantConfigurationController.java"
click node_activity_api "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/UserActivityController.java"
click node_projects "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/ProjectServiceImpl.java"
click node_tasks "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/TaskServiceImpl.java"
click node_users "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/UserServiceImpl.java"
click node_user_search "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/UserSearchService.java"
click node_tenants "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/TenantServiceImpl.java"
click node_tenant_config "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/TenantConfigurationServiceImpl.java"
click node_tenant_router "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/tree/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Configs"
click node_repositories "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/tree/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Repositories"
click node_domain "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/tree/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Entities"
click node_user_mapper "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Mappers/UserMapper.java"
click node_user_specs "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Utils/UserSpecifications.java"
click node_activity "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/UserActivityServiceImpl.java"
click node_analytics "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/TenantAnalyticsService.java"
click node_reports "https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/ReportGenerationService.java"

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_project_api,node_task_api,node_user_api,node_tenant_api,node_config_api,node_activity_api,node_client toneBlue
class node_projects,node_tasks,node_redis,node_elastic toneAmber
class node_users,node_user_search,node_tenants,node_tenant_config toneMint
class node_tenant_router,node_repositories,node_domain,node_user_mapper,node_user_specs,node_tenant_db toneRose
class node_activity,node_analytics,node_reports toneIndigo
```

## Components

### REST API

- [Project API](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/ProjectController.java): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/ProjectController.java`
- [Task API](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/TaskController.java): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/TaskController.java`
- [User API](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/UserController.java): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/UserController.java`
- [Tenant APIs](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/TenantController.java): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/TenantController.java`
- [Configuration API](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/TenantConfigurationController.java): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/TenantConfigurationController.java`
- [Activity API](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/UserActivityController.java): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/UserActivityController.java`

### Project Work

- [Project services](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/ProjectServiceImpl.java): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/ProjectServiceImpl.java`
- [Task services](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/TaskServiceImpl.java): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/TaskServiceImpl.java`

### Tenant And Users

- [User services](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/UserServiceImpl.java): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/UserServiceImpl.java`
- [User search](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/UserSearchService.java): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/UserSearchService.java`
- [Tenant lifecycle](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/TenantServiceImpl.java): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/TenantServiceImpl.java`
- [Tenant configuration](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/TenantConfigurationServiceImpl.java): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/TenantConfigurationServiceImpl.java`

### Domain And Storage

- [Tenant routing](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/tree/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Configs): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Configs`
- [Data repositories](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/tree/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Repositories): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Repositories`
- [Domain entities](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/tree/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Entities): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Entities`
- [User mapper](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Mappers/UserMapper.java): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Mappers/UserMapper.java`
- [User query specs](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Utils/UserSpecifications.java): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Utils/UserSpecifications.java`
- **Tenant schemas**

### Audit And Analytics

- [Activity logging](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/UserActivityServiceImpl.java): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/UserActivityServiceImpl.java`
- [Tenant analytics](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/TenantAnalyticsService.java): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/TenantAnalyticsService.java`
- [Report generation](https://github.com/shubh00796/tenancylink-scalable-multi-tenant-project-management-backend/blob/main/src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/ReportGenerationService.java): `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/ReportGenerationService.java`

### Other components

- **API client**
- **Redis cache**
- **Elasticsearch**

## Connections

- API client → Project API: requests
- API client → Task API: requests
- API client → User API: requests
- API client → Tenant APIs: requests
- API client → Configuration API: requests
- API client → Activity API: requests
- Project API → Project services: delegates
- Task API → Task services: delegates
- User API → User services: delegates (evidence: `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/UserController.java`)
- User API → User search: searches (evidence: `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Controllers/UserController.java`)
- Tenant APIs → Tenant lifecycle: delegates
- Configuration API → Tenant configuration: delegates
- Activity API → Activity logging: delegates
- User search → Data repositories: queries (evidence: `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/UserSearchService.java`)
- User search → User mapper: maps results (evidence: `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/UserSearchService.java`)
- User search → User query specs: builds filters (evidence: `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/ServiceImplimentations/UserSearchService.java`)
- Data repositories → Domain entities: accesses (evidence: `src/main/java/com/Multi/tenant_SaaS_Project_Management_System/Repositories/TaskRepository.java`)
- Project services → Data repositories: persists
- Task services → Data repositories: persists
- User services → Data repositories: persists
- Tenant lifecycle → Data repositories: persists
- Tenant configuration → Data repositories: persists
- Tenant routing → Tenant schemas: routes requests
- Data repositories → Tenant routing: uses tenant context
- Activity logging → Data repositories: records events
- Tenant analytics → Data repositories: reads metrics
- Report generation → Tenant analytics: generates reports
- Project services → Redis cache: caches data
- User search → Elasticsearch: searches text
