Add detailed architecture diagrams and state management workflows to README.md

This update enhances the documentation by introducing comprehensive diagrams for component architecture, task management, statistics architecture, navigation flow, and state management. These additions aim to provide a clearer understanding of the application's structure and workflows.

Author: abd3lraouf

README.md

@@ -181,6 +181,345 @@ This application demonstrates:
 4. **Dependency Injection**: Clean provision of dependencies to components
 5. **SaveInstanceState**: Automatic state restoration across configuration changes
 
+### Component Architecture
+
+```mermaid
+graph TD
+    A[Application] --> B[RootComponent]
+    B --> C[MainScreenComponent]
+    B --> D[SettingsComponent]
+    B --> E[StatisticsComponent]
+    
+    C --> F[TaskListComponent]
+    C --> G[TaskDetailsComponent]
+    C --> H[TaskEditComponent]
+    
+    F --> I[TaskItemComponent]
+    G --> J[StatusToggleComponent]
+    H --> K[PrioritySelectComponent]
+    H --> L[DatePickerComponent]
+    
+    style A fill:#f9f,stroke:#333,stroke-width:2px
+    style B fill:#bbf,stroke:#333,stroke-width:2px
+    style C fill:#dfd,stroke:#333,stroke-width:2px
+    style D fill:#dfd,stroke:#333,stroke-width:2px
+    style E fill:#dfd,stroke:#333,stroke-width:2px
+```
+
+### Task Management Architecture
+
+```mermaid
+graph TD
+    A[TaskListComponent] -->|State| B[TaskListState]
+    A -->|Events| C[TaskListIntent]
+    C -->|Process| D[TaskListReducer]
+    D -->|Update| B
+    
+    A -->|Details Click| E[TaskDetailsComponent]
+    A -->|Add Click| F[TaskEditComponent]
+    E -->|Edit Click| F
+    
+    F -->|Save| G[TaskRepository]
+    E -->|Load| G
+    A -->|Load All| G
+    
+    G -->|Store| H[(Local Database)]
+    
+    style A fill:#bbf,stroke:#333,stroke-width:2px
+    style B fill:#dfd,stroke:#333,stroke-width:2px
+    style G fill:#ffd,stroke:#333,stroke-width:2px
+    style H fill:#fcc,stroke:#333,stroke-width:2px
+```
+
+### Statistics Architecture
+
+```mermaid
+graph TD
+    A[StatisticsComponent] -->|State| B[StatisticsState]
+    A -->|Events| C[StatisticsIntent]
+    C -->|Process| D[StatisticsReducer]
+    D -->|Update| B
+    
+    A -->|Load Stats| E[StatisticsRepository]
+    E -->|Query| F[TaskRepository]
+    F -->|Read| G[(Local Database)]
+    
+    E -->|Transform| H[StatsCalculator]
+    H -->|Provide| I[ChartData]
+    I -->|Display in| A
+    
+    style A fill:#bbf,stroke:#333,stroke-width:2px
+    style B fill:#dfd,stroke:#333,stroke-width:2px
+    style E fill:#ffd,stroke:#333,stroke-width:2px
+    style F fill:#ffd,stroke:#333,stroke-width:2px
+    style G fill:#fcc,stroke:#333,stroke-width:2px
+```
+
+### Navigation Flow
+
+```mermaid
+stateDiagram-v2
+    [*] --> TaskList
+    TaskList --> TaskDetails: Select Task
+    TaskDetails --> TaskEdit: Edit Button
+    TaskList --> TaskEdit: Add Button
+    
+    TaskEdit --> TaskList: Save/Cancel
+    TaskDetails --> TaskList: Back Button
+    
+    TaskList --> Statistics: Tab Navigation
+    TaskList --> Settings: Tab Navigation
+    
+    Statistics --> TaskList: Tab Navigation
+    Settings --> TaskList: Tab Navigation
+```
+
+### State Management
+
+```mermaid
+flowchart LR
+    A[User Interaction] -->|Intent| B[Reducer]
+    B -->|New State| C[Component State]
+    C -->|Renders UI| D[UI]
+    D -->|Triggers| A
+    
+    E[Decompose StateKeeper] <-->|Saves/Restores| C
+    F[Background Process] -->|Updates| B
+```
+
+### Clean Architecture Integration
+
+```mermaid
+graph TD
+    subgraph Presentation
+        A[Jetpack Compose UI] -->|Observes| B[Decompose Component]
+        B -->|Contains| C[Component State]
+        B -->|Processes| D[Component Intent]
+    end
+    
+    subgraph Domain
+        E[Use Cases]
+        F[Domain Models]
+        G[Repository Interfaces]
+    end
+    
+    subgraph Data
+        H[Repository Implementations]
+        I[Data Sources]
+        J[Network/DB/Cache]
+    end
+    
+    B -->|Invokes| E
+    E -->|Uses| F
+    E -->|Calls| G
+    G <--Implementation--> H
+    H -->|Accesses| I
+    I -->|Manages| J
+    
+    style A fill:#dfd,stroke:#333,stroke-width:2px
+    style B fill:#bbf,stroke:#333,stroke-width:2px
+    style E fill:#ffd,stroke:#333,stroke-width:2px
+    style H fill:#fcc,stroke:#333,stroke-width:2px
+```
+
+### Component Lifecycle
+
+```mermaid
+sequenceDiagram
+    participant User
+    participant Compose as Jetpack Compose
+    participant Component as Decompose Component
+    participant State as State Management
+    participant Domain as Domain Layer
+    
+    User->>Compose: Interaction
+    Compose->>Component: Event
+    Component->>State: Update State
+    Component->>Domain: Execute Use Case
+    Domain-->>Component: Result
+    Component->>State: Update State
+    State-->>Compose: State Change
+    Compose-->>User: UI Update
+    
+    Note over Component,State: Decompose handles lifecycle and state preservation during configuration changes
+```
+
+### Task Workflow State Management
+
+```mermaid
+stateDiagram-v2
+    classDef todo fill:#ffcccb,stroke:#333,stroke-width:1px
+    classDef inProgress fill:#ffffcc,stroke:#333,stroke-width:1px
+    classDef done fill:#ccffcc,stroke:#333,stroke-width:1px
+    
+    state "Task Created" as TC
+    state "Todo State" as TODO
+    state "In Progress State" as IP
+    state "Done State" as DONE
+    
+    [*] --> TC
+    TC --> TODO : Initial Status
+    
+    state TODO {
+        [*] --> Idle
+        Idle --> Starting : Start Task
+        Starting --> [*] : Emit Intent.StartTask
+    }
+    
+    state IP {
+        [*] --> Active
+        Active --> Completing : Complete Task
+        Active --> Abandoning : Back to Todo
+        Completing --> [*] : Emit Intent.CompleteTask
+        Abandoning --> [*] : Emit Intent.RevertToTodo
+    }
+    
+    state DONE {
+        [*] --> Completed
+        Completed --> Reopening : Reopen Task
+        Reopening --> [*] : Emit Intent.ReopenTask
+    }
+    
+    TODO --> IP : Start Button Click
+    IP --> DONE : Check Completed
+    IP --> TODO : Revert Button Click
+    DONE --> IP : Uncheck Completed
+    
+    class TODO todo
+    class IP inProgress
+    class DONE done
+```
+
+### Task Component Implementation Structure
+
+```mermaid
+classDiagram
+    class TaskComponent {
+        <<interface>>
+        +Value<Model> models
+        +onTaskAction(TaskAction)
+    }
+    
+    class DefaultTaskComponent {
+        -MutableValue<Model> _models
+        -TaskRepository repository
+        -CoroutineScope componentScope
+        -StateKeeper stateKeeper
+        +DefaultTaskComponent(componentContext, taskRepository)
+        -initializeState()
+        -saveState()
+        -processAction(TaskAction)
+    }
+    
+    class Model {
+        +TaskState state
+        +List<Task> tasks
+        +boolean isLoading
+        +boolean hasError
+        +String errorMessage
+    }
+    
+    class TaskState {
+        <<enum>>
+        TODO
+        IN_PROGRESS
+        DONE
+    }
+    
+    class TaskAction {
+        <<sealed class>>
+    }
+    
+    class TaskAction.Start {
+        +String taskId
+    }
+    
+    class TaskAction.Complete {
+        +String taskId
+    }
+    
+    class TaskAction.Revert {
+        +String taskId
+    }
+    
+    TaskComponent <|-- DefaultTaskComponent
+    DefaultTaskComponent --> Model
+    Model --> TaskState
+    DefaultTaskComponent --> TaskAction
+    TaskAction <|-- TaskAction.Start
+    TaskAction <|-- TaskAction.Complete
+    TaskAction <|-- TaskAction.Revert
+```
+
+### Decompose Navigation Architecture
+
+```mermaid
+graph TD
+    subgraph "Root Component"
+        NavHost[Navigation Host]
+        Stack[Navigation Stack]
+        Stack -->|Current| Child[Active Child Component]
+        NavHost -->|Manages| Stack
+    end
+    
+    subgraph "Navigation Configuration"
+        Config[Navigation Config]
+        Registry[Component Registry]
+        Factory[Component Factory]
+    end
+    
+    NavHost -->|Uses| Config
+    Config -->|Defines| Registry
+    Registry -->|Creates via| Factory
+    
+    Child -->|Can Push| NewScreen[New Screen Component]
+    NewScreen -->|Added to| Stack
+    Child -->|Can Pop| Stack
+    
+    style NavHost fill:#bbf,stroke:#333,stroke-width:2px
+    style Stack fill:#dfd,stroke:#333,stroke-width:2px
+    style Factory fill:#ffd,stroke:#333,stroke-width:2px
+```
+
+### Child Slots Management
+
+```mermaid
+graph LR
+    subgraph "Parent Component"
+        Parent[Parent Component]
+        
+        subgraph "Child Slots"
+            Slot1[Child Slot 1]
+            Slot2[Child Slot 2]
+            Slot3[Child Slot 3]
+        end
+        
+        Parent -->|Creates & Manages| Slot1
+        Parent -->|Creates & Manages| Slot2
+        Parent -->|Creates & Manages| Slot3
+    end
+    
+    subgraph "Compose UI"
+        UI[Compose UI]
+        slot1UI[Slot 1 UI]
+        slot2UI[Slot 2 UI]
+        slot3UI[Slot 3 UI]
+    end
+    
+    UI -->|Children| slot1UI
+    UI -->|Children| slot2UI
+    UI -->|Children| slot3UI
+    
+    Slot1 -->|Renders| slot1UI
+    Slot2 -->|Renders| slot2UI
+    Slot3 -->|Renders| slot3UI
+    
+    style Parent fill:#bbf,stroke:#333,stroke-width:2px
+    style Slot1 fill:#dfd,stroke:#333,stroke-width:2px
+    style Slot2 fill:#dfd,stroke:#333,stroke-width:2px
+    style Slot3 fill:#dfd,stroke:#333,stroke-width:2px
+```
+
 ## 📚 Additional Resources
 
 - [Decompose Documentation](https://arkivanov.github.io/Decompose/)