# trungvose/jira-clone-angular architecture

> Architecture diagram of the GitHub repository trungvose/jira-clone-angular, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/trungvose/jira-clone-angular
- Repository: https://github.com/trungvose/jira-clone-angular

## Overview

##### Project type and purpose
- This is a front-end heavy, single‐page application built with Angular (v9+), Akita (state management), ng-zorro (UI components), TailwindCSS, and Angular CDK.
- It simulates a simplified Jira‐style kanban board, with modular features (login, project board, issue detail, settings), but currently uses static JSON assets as its “API.”

##### File structure
- Top-level Angular CLI project: angular.json, tsconfig.*, src/, e2e/, storybook/, webpack.config.js.
- src/app/core – application‐wide services, directives, validators, styles, analytics, “snow” decoration.
- src/app/project – the main feature module (lazy loaded) hosting auth, components (board, issues, navigation, search, user), pages (board, full-issue-detail, settings), Akita state (stores, queries, services).
- src/app/work-in-progress – a second lazy-loaded feature.
- src/assets/data – static JSON payloads as a stand-in API.
- storybook – UI component isolation environment; e2e & karma for tests.

##### README for additional insights
- Tech stack includes Angular CLI, Akita, NestJS (planned Phase 2 GraphQL API), ng-zorro, ngx-quill, CDK drag-drop, TailwindCSS.
- Architecture overview images: Application architecture (core vs lazy modules) and Akita data flow (component → service → store → query → component).

##### Detail over guesswork
- Decompose each feature module into its major pieces (pages, key component groups, state files).
- Lazy loading boundaries to highlight on-demand code splitting.
- Both current static data sources and future GraphQL backend to give a complete roadmap.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    Browser["Browser / User Agent"]:::presentation
    Browser -->|loads| AppModule
    AppModule["AppModule"]:::presentation
    click AppModule "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/app.module.ts"
    AppModule --> AppRoutingModule
    AppRoutingModule["App Routing Module"]:::presentation
    click AppRoutingModule "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/app-routing.module.ts"

    subgraph "CoreModule" 
        direction TB
        CoreModule["CoreModule"]:::presentation
        click CoreModule "https://github.com/trungvose/jira-clone-angular/tree/master/src/app/core"
        Directives["Directives"]:::presentation
        click Directives "https://github.com/trungvose/jira-clone-angular/tree/master/src/app/core/directives"
        Services["Services"]:::presentation
        click Services "https://github.com/trungvose/jira-clone-angular/tree/master/src/app/core/services"
        Validators["Validators"]:::presentation
        click Validators "https://github.com/trungvose/jira-clone-angular/tree/master/src/app/core/validators"
        SnowModule["Snow Module"]:::presentation
        click SnowModule "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/core/snow/snow.module.ts"
        Styles["Styles"]:::presentation
        click Styles "https://github.com/trungvose/jira-clone-angular/tree/master/src/app/core/styles"
        CoreModule --> Directives & Services & Validators & SnowModule & Styles
    end
    AppModule --> CoreModule

    shared["JiraControlModule (Shared UI Library)"]:::presentation
    click shared "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/jira-control/jira-control.module.ts"
    AppModule --> shared

    %% Feature Modules
    subgraph "Feature Modules" 
        direction TB
        subgraph "ProjectModule (lazy-loaded)" 
            direction TB
            PM["ProjectModule"]:::presentation
            click PM "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/project/project.module.ts"
            PM --> PMRouting
            PMRouting["Project Routing Module"]:::presentation
            click PMRouting "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/project/project-routing.module.ts"
            PM --> Guard
            Guard["Project Guard"]:::presentation
            click Guard "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/project/project.guard.ts"
            PM --> Shell
            Shell["Project Shell Component"]:::presentation
            click Shell "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/project/project.component.ts"
            
            %% Auth Feature
            subgraph "Auth Feature" 
                direction TB
                AuthStore["Auth Store"]:::state
                click AuthStore "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/project/auth/auth.store.ts"
                AuthQuery["Auth Query"]:::state
                click AuthQuery "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/project/auth/auth.query.ts"
                AuthService["Auth Service"]:::state
                click AuthService "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/project/auth/auth.service.ts"
                AuthStore --> AuthQuery
                AuthService --> AuthStore
                AuthQuery -->|provides| Shell
            end

            %% Project Akita State
            subgraph "Project State" 
                direction TB
                PStore["Project Store"]:::state
                click PStore "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/project/state/project/project.store.ts"
                PQuery["Project Query"]:::state
                click PQuery "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/project/state/project/project.query.ts"
                PService["Project Service"]:::state
                click PService "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/project/state/project/project.service.ts"
                PService --> PStore --> PQuery -->|data| Shell
            end

            %% Filter Akita State
            subgraph "Filter State" 
                direction TB
                FStore["Filter Store"]:::state
                click FStore "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/project/state/filter/filter.store.ts"
                FQuery["Filter Query"]:::state
                click FQuery "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/project/state/filter/filter.query.ts"
                FService["Filter Service"]:::state
                click FService "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/project/state/filter/filter.service.ts"
                FService --> FStore --> FQuery -->|filters| Shell
            end

            %% Components & Pages
            Components["Project Components"]:::presentation
            click Components "https://github.com/trungvose/jira-clone-angular/tree/master/src/app/project/components"
            Pages["Project Pages"]:::presentation
            click Pages "https://github.com/trungvose/jira-clone-angular/tree/master/src/app/project/pages"
            Shell --> Components
            Shell --> Pages
        end

        subgraph "WorkInProgressModule (lazy-loaded)"
            direction TB
            WIP["WorkInProgressModule"]:::presentation
            click WIP "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/work-in-progress/work-in-progress.module.ts"
            WIP --> WIPRouting
            WIPRouting["WIP Routing Module"]:::presentation
            click WIPRouting "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/work-in-progress/work-in-progress-routing.module.ts"
            WIP --> WIPComp
            WIPComp["WIP Component"]:::presentation
            click WIPComp "https://github.com/trungvose/jira-clone-angular/blob/master/src/app/work-in-progress/work-in-progress.component.ts"
        end

        AppRoutingModule -->|lazy load| PM
        AppRoutingModule -->|lazy load| WIP
    end

    %% Data Layer
    ServiceLayer["HttpClient"]:::data
    PService -->|HTTP calls| ServiceLayer
    AuthService -->|HTTP calls| ServiceLayer
    ServiceLayer -->|fetch| JSONAssets
    JSONAssets["Static JSON (auth.json, project.json)"]:::data
    click JSONAssets "https://github.com/trungvose/jira-clone-angular/tree/master/src/assets/data"
    JSONAssets -->|phase2| GraphQL["NestJS GraphQL API (future)"]:::data

    %% Storybook
    Storybook["Storybook"]:::tools
    click Storybook "https://github.com/trungvose/jira-clone-angular/blob/master/.storybook"
    Storybook --> shared

    %% Tooling / CI
    CLI["Angular CLI"]:::tools
    click CLI "https://github.com/trungvose/jira-clone-angular/blob/master/angular.json"
    Webpack["Webpack"]:::tools
    click Webpack "https://github.com/trungvose/jira-clone-angular/blob/master/webpack.config.js"
    E2E["E2E Tests"]:::tools
    click E2E "https://github.com/trungvose/jira-clone-angular/tree/master/e2e"
    Karma["Karma/Unit Tests"]:::tools
    click Karma "https://github.com/trungvose/jira-clone-angular/blob/master/karma.conf.js"
    CLI --> Webpack
    CLI --> E2E
    CLI --> Karma

    %% Legend
    subgraph "Legend"
        direction TB
        A["Presentation Layer"]:::presentation
        B["State Management"]:::state
        C["Data / API"]:::data
        D["Tools / CI"]:::tools
    end

    classDef presentation fill:#D0E8FF,stroke:#2B6CB0,color:#1A365D
    classDef state fill:#E6FFFA,stroke:#2C7A7B,color:#234E52
    classDef data fill:#FFF5E6,stroke:#DD6B20,color:#C05621
    classDef tools fill:#F7FAFC,stroke:#718096,color:#2D3748
```
