# saksoft-training/task-management-system architecture

> Architecture diagram of the GitHub repository saksoft-training/task-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/saksoft-training/task-management-system
- Repository: https://github.com/saksoft-training/task-management-system

## Overview

##### Project type and purpose
- This is a single-page application (SPA) built with Angular (v20.3.8) for managing tasks, projects, dashboards, and user accounts. It provides features like activity feeds, charts, statistics, project CRUD, task boards, user authentication, and shared UI elements.

##### Key architectural components (based on the file structure)
a. **App Module** (src/app/app.ts, app.module.ts)
b. **Core Module** (src/app/core)
– Authentication adapters, HTTP interceptors, global configuration (app.config.ts), routing (app.routes.ts)
c. **Feature Modules** (src/app/features)
– Dashboard
– Display-Statistics-and-Overview
– Project-Management
– Task-Management
– User-Account-Management
d. **Shared Module** (src/app/shared)
– Reusable components (dialogs, loading spinner, header/footer), pipes, directives, constants, services (storage), utilities
e. **Contracts & Types** (src/app/contracts & src/types)
– Interface definitions for API payloads and domain models
f. **Assets & Styling**
g. **Build & Configuration**
– Angular CLI config (angular.json), tsconfig files, environment (vercel.json)

##### External dependencies
- REST-style backend (not present here) accessed through services in each feature module
- Third-party libraries specified in package.json (e.g., RxJS, Angular Material or similar)

##### Relationships and interactions
- **App Module** bootstraps the SPA, imports Core, Shared, and Feature modules, and configures root router
- **Core Module** provides singleton services (AuthService, AuthInterceptor) injected across features
- **Feature Modules** group related components and services; each module defines its own routing and injects shared/core services
- **Shared Module** exports UI building blocks used by all feature modules
- **HTTP Requests** flow from feature services → Core/AuthInterceptor → backend API → data models (Contracts & Types) → components
- **State Management**: either local component state or a store under src/app/store (if implemented)

##### Architectural patterns & design principles
- **Modularization**: features are isolated into lazy-loaded Angular modules
- **Separation of Concerns**: UI (components) vs. business logic (services) vs. data contracts (interfaces/types)
- **Dependency Injection**: Angular DI for services, interceptors, and configuration
- **Reusable UI**: Shared module for common UI primitives
- **Routing**: route definitions in app.routes.ts, feature-specific routing within modules

## Diagram (Mermaid)

```mermaid
flowchart TD
  subgraph "Entry Point & Bootstrap"
    HTML["index.html"]:::entry
    Main["main.ts"]:::entry
  end
  subgraph "App Module"
    AppModule["App Module"]:::config
    AppRoutes["App Routing & Configuration"]:::config
    GlobalConfig["App Config"]:::config
  end
  HTML --> AppModule
  Main --> AppModule
  AppModule --> AppRoutes
  AppModule --> GlobalConfig

  subgraph "Core Module"
    AuthAdapters["Authentication Adapters"]:::core
    HttpInterceptors["HTTP Interceptors"]:::core
  end
  AppModule --> AuthAdapters
  AppModule --> HttpInterceptors

  subgraph "Shared Module"
    SharedModule["Shared Module"]:::shared
    SharedComponents["Components"]:::shared
    SharedConstants["Constants"]:::shared
    SharedDirectives["Directives"]:::shared
    SharedEnums["Enums"]:::shared
    SharedPipes["Pipes"]:::shared
    SharedServices["Services"]:::shared
    SharedUtils["Utilities"]:::shared
  end
  AppModule --> SharedModule
  SharedModule --> SharedComponents
  SharedModule --> SharedConstants
  SharedModule --> SharedDirectives
  SharedModule --> SharedEnums
  SharedModule --> SharedPipes
  SharedModule --> SharedServices
  SharedModule --> SharedUtils

  subgraph "Dashboard Module"
    DashMod["Dashboard Module"]:::feature
    DashComps["Dashboard Components"]:::feature
    DashServ["Dashboard Services"]:::feature
  end
  AppModule --> DashMod
  DashMod --> DashComps
  DashMod --> DashServ

  subgraph "Display Statistics & Overview Module"
    DisplayMod["Display-Statistics-and-Overview Module"]:::feature
    DisplayComps["Components"]:::feature
    DisplayServ["Services"]:::feature
  end
  AppModule --> DisplayMod
  DisplayMod --> DisplayComps
  DisplayMod --> DisplayServ

  subgraph "Project Management Module"
    ProjectMod["Project-Management Module"]:::feature
    ProjectComps["Components"]:::feature
    ProjectServ["Services"]:::feature
  end
  AppModule --> ProjectMod
  ProjectMod --> ProjectComps
  ProjectMod --> ProjectServ

  subgraph "Task Management Module"
    TaskMod["Task-Management Module"]:::feature
    TaskComps["Components"]:::feature
    TaskServ["Services"]:::feature
  end
  AppModule --> TaskMod
  TaskMod --> TaskComps
  TaskMod --> TaskServ

  subgraph "User Account Management Module"
    UserMod["User-Account-Management Module"]:::feature
    UserComps["Components"]:::feature
    UserServ["Services"]:::feature
  end
  AppModule --> UserMod
  UserMod --> UserComps
  UserMod --> UserServ

  subgraph "Contracts & Types"
    Contracts["Contracts (interfaces)"]:::contract
    Types["Domain Types & Models"]:::contract
  end
  DashServ --> Contracts
  DisplayServ --> Contracts
  ProjectServ --> Contracts
  TaskServ --> Contracts
  UserServ --> Contracts
  DashServ --> Types
  DisplayServ --> Types
  ProjectServ --> Types
  TaskServ --> Types
  UserServ --> Types

  subgraph "Assets & Styling"
    Assets["Assets"]:::asset
    Icons["Icons"]:::asset
    Styles["Global Styles & Theming"]:::asset
  end
  Assets --> Icons
  AppModule --> Styles
  AppModule --> Assets

  Backend["Backend API"]:::external
  AuthAdapters --> Backend
  HttpInterceptors -->|"intercepts HTTP"| Backend
  DashServ -->|"HTTP calls"| Backend
  DisplayServ -->|"HTTP calls"| Backend
  ProjectServ -->|"HTTP calls"| Backend
  TaskServ -->|"HTTP calls"| Backend
  UserServ -->|"HTTP calls"| Backend

  classDef entry fill:#f9f,stroke:#333,stroke-width:1px;
  classDef config fill:#ddf,stroke:#333,stroke-width:1px;
  classDef core fill:#cfe,stroke:#333,stroke-width:1px;
  classDef shared fill:#cfc,stroke:#333,stroke-width:1px;
  classDef feature fill:#fcf,stroke:#333,stroke-width:1px;
  classDef contract fill:#ffe,stroke:#333,stroke-width:1px;
  classDef asset fill:#eef,stroke:#333,stroke-width:1px;
  classDef external fill:#fcc,stroke:#333,stroke-width:1px;

  click HTML "https://github.com/saksoft-training/task-management-system/blob/sprint/src/index.html"
  click Main "https://github.com/saksoft-training/task-management-system/blob/sprint/src/main.ts"
  click AppModule "https://github.com/saksoft-training/task-management-system/blob/sprint/src/app/app.ts"
  click AppRoutes "https://github.com/saksoft-training/task-management-system/blob/sprint/src/app/app.routes.ts"
  click GlobalConfig "https://github.com/saksoft-training/task-management-system/blob/sprint/src/app/app.config.ts"
  click AuthAdapters "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/core/auth"
  click HttpInterceptors "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/core/interceptor"
  click SharedModule "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/shared"
  click SharedComponents "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/shared/components"
  click SharedConstants "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/shared/constants"
  click SharedDirectives "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/shared/directives"
  click SharedEnums "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/shared/enums"
  click SharedPipes "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/shared/pipes"
  click SharedServices "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/shared/services"
  click SharedUtils "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/shared/utils"
  click DashMod "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/features/dashboard"
  click DashComps "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/features/dashboard/components"
  click DashServ "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/features/dashboard/services"
  click DisplayMod "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/features/display-statistics-and-overview"
  click DisplayComps "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/features/display-statistics-and-overview/components"
  click DisplayServ "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/features/display-statistics-and-overview/services"
  click ProjectMod "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/features/project-management"
  click ProjectComps "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/features/project-management/components"
  click ProjectServ "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/features/project-management/services"
  click TaskMod "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/features/task-management"
  click TaskComps "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/features/task-management/components"
  click TaskServ "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/features/task-management/services"
  click UserMod "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/features/user-account-management"
  click UserComps "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/features/user-account-management/components"
  click UserServ "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/features/user-account-management/services"
  click Contracts "https://github.com/saksoft-training/task-management-system/tree/sprint/src/app/contracts"
  click Types "https://github.com/saksoft-training/task-management-system/tree/sprint/src/types"
  click Assets "https://github.com/saksoft-training/task-management-system/tree/sprint/src/assets"
  click Icons "https://github.com/saksoft-training/task-management-system/tree/sprint/src/assets/icons"
  click Styles "https://github.com/saksoft-training/task-management-system/tree/sprint/src/styles"
```
