# colenocks/tasktrackercli architecture

> Architecture diagram of the GitHub repository colenocks/tasktrackercli, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/colenocks/tasktrackercli
- Repository: https://github.com/colenocks/tasktrackercli

## Overview

##### Main Components

a) User Interface Layer:
- CLI Interface (TaskCLI.java)
- Command Parser

b) Business Logic Layer:
- Task Management (Task.java, TasksList.java)
- Action Handler (ActionEnum.java)
- Status Management (StatusEnum.java)
- Helper Utilities (Helper.java)

c) Data Layer:
- File Management (FileManager.java)
- JSON Storage (tasks.json)
- GSON Library Integration (gson-2.10.1.jar)

**┌─────────────────────────────────────────┐**
- User Interface Layer          │
- ┘
- ↓             ↑
**┌─────────────────────────────────────────┐**
- Business Logic Layer          │
- ┘
- ↓             ↑
**┌─────────────────────────────────────────┐**
- Data Layer                 │
- ┘

##### Detailed Component Breakdown

**User Interface Layer:**
**┌─────────────────┐**
- TaskCLI      │←── User Input (CLI Commands)
- Command      │
- Processing   │
- Input        │
- Validation   │
- ┘

**Business Logic Layer:**
**┌─────────────────┐    ┌─────────────────┐**
- ActionEnum    │    │   StatusEnum    │
- List         │    │  - Todo         │
- Add          │    │  - In Progress  │
- Update       │    │  - Done         │
- Delete       │    └─────────────────┘
- ┘
- ↓
**┌─────────────────┐    ┌─────────────────┐**
- TasksList    │←───│      Task       │
- Task         │    │  - ID           │
- Management   │    │  - Description  │
- ┘    │  - Status       │
- Timestamps    │
- ┘

**Data Layer:**
**┌─────────────────┐    ┌─────────────────┐**
- FileManager    │←───│   tasks.json    │
- Read/Write   │    │  (JSON Storage) │
- GSON Parser  │    │                 │
- ┘    └─────────────────┘

##### Important Elements to Highlight

- Command Flow:
- How user input flows from CLI through the action handling system
- Validation steps
- How data is persisted back to storage

- Data Flow:
- Demonstrate how tasks are created, updated, and stored
- Relationship between Task objects and JSON storage

##### Technical Details to Note

- The system uses a file-based JSON storage system
- All operations are synchronous
- The application follows a simple three-tier architecture
- GSON is used for JSON serialization/deserialization

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles and Classes
    classDef ui fill:#a8d1f0,stroke:#000
    classDef logic fill:#b7e3c5,stroke:#000
    classDef data fill:#ffe4b5,stroke:#000
    classDef storage fill:#ffd700,stroke:#000
    classDef lib fill:#e6e6fa,stroke:#000

    %% User Interface Layer
    subgraph UI
        CLI[TaskCLI]:::ui
        Colors[CLIColors]:::ui
        Main[Main]:::ui
    end

    %% Business Logic Layer
    subgraph Logic
        Task[Task]:::logic
        TasksList[TasksList]:::logic
        Action[ActionEnum]:::logic
        Status[StatusEnum]:::logic
        Helper[Helper]:::logic
    end

    %% Data Layer
    subgraph Data
        FileManager[FileManager]:::data
        JSON[tasks.json]:::storage
        GSON[GSON Library]:::lib
    end

    %% Relationships
    Main --> CLI
    CLI --> Colors
    CLI --> Action
    CLI --> TasksList
    TasksList --> Task
    Task --> Status
    TasksList --> FileManager
    FileManager --> JSON
    FileManager --> GSON
    Helper --> TasksList
    Helper --> FileManager

    %% Click Events
    click CLI "https://github.com/colenocks/TaskTrackerCLI/blob/main/src/TaskCLI.java"
    click Colors "https://github.com/colenocks/TaskTrackerCLI/blob/main/src/CLIColors.java"
    click Task "https://github.com/colenocks/TaskTrackerCLI/blob/main/src/Task.java"
    click TasksList "https://github.com/colenocks/TaskTrackerCLI/blob/main/src/TasksList.java"
    click Action "https://github.com/colenocks/TaskTrackerCLI/blob/main/src/ActionEnum.java"
    click Status "https://github.com/colenocks/TaskTrackerCLI/blob/main/src/StatusEnum.java"
    click Helper "https://github.com/colenocks/TaskTrackerCLI/blob/main/src/Helper.java"
    click FileManager "https://github.com/colenocks/TaskTrackerCLI/blob/main/src/FileManager.java"
    click JSON "https://github.com/colenocks/TaskTrackerCLI/blob/main/tasks.json"
    click GSON "https://github.com/colenocks/TaskTrackerCLI/blob/main/lib/gson-2.10.1.jar"
    click Main "https://github.com/colenocks/TaskTrackerCLI/blob/main/src/Main.java"

    %% Legend
    subgraph Legend
        UI_L[UI Components]:::ui
        Logic_L[Business Logic]:::logic
        Data_L[Data Layer]:::data
        Storage_L[Storage]:::storage
        Lib_L[Libraries]:::lib
    end
```
