# cinioluwa/tracker architecture

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

- Interactive diagram: https://gitdiagram.com/cinioluwa/tracker
- Repository: https://github.com/cinioluwa/tracker

## Overview

##### Major Components
- User Interface (UI) Component:
- Built using Tkinter.
- Contains windows, forms for user input (username, week number, learning hours, application hours, certificates), a “Calculate” button, “View History” button, and a progress bar.
- Handles user events and displays feedback (e.g., performance messages like “Excellent”, “Good”, etc.).

- Business Logic / Points Calculation Module:
- Responsible for calculating learning, application, certificate, and bonus points.
- Implements the rules for bonus system and data validation (e.g., detecting duplicate entries).
- Provides performance feedback based on the aggregated evaluation points.

- Data Access / Persistence Layer:
- Uses Pandas (and openpyxl) to read from and write to an Excel file that stores users’ weekly progress.
- Manages the Excel file operations ensuring data integrity.

##### Relationships and Interactions
- The UI Component collects data from the user and then dispatches it to the Business Logic Module.
- The Business Logic processes the input data, performs calculations and validations, and then interacts with the Data Access Layer to store or retrieve historical data.
- Once the Business Logic has processed the data, the UI is updated accordingly (progress bar and performance feedback).

##### Architectural Patterns and Design Principles
- Although not separated into multiple files, apply a Modular Design Principle:
- Follow a Model-View-Controller (MVC)-like conceptual separation:
- View: The Tkinter-based GUI.
- Controller/Model: The calculation and validation logic that processes user data.
- Data Model: The module using Pandas to manage Excel storage.

##### Relevant Technologies
- Python (core programming language).
- Tkinter (for the graphical user interface).
- Pandas and openpyxl (for data processing and Excel operations).
- Excel file (for persistent storage of user progress data).

## Diagram (Mermaid)

```mermaid
flowchart TD
    UI["UI Module (Tkinter)"]:::gui
    BL["Business Logic / Points Calculation"]:::logic
    DAL["Data Access / Persistence (Pandas, openpyxl, Excel)"]:::data

    UI -->|"UserDataInput"| BL
    BL -->|"ExcelOperations"| DAL
    DAL -->|"ExcelDataOperations"| BL
    BL -->|"FeedbackUpdates"| UI

    click UI "https://github.com/cinioluwa/tracker/blob/main/tracker.py"
    click BL "https://github.com/cinioluwa/tracker/blob/main/tracker.py"
    click DAL "https://github.com/cinioluwa/tracker/blob/main/tracker.py"

    classDef gui fill:#FFCC00,stroke:#333,stroke-width:2px;
    classDef logic fill:#66CCFF,stroke:#333,stroke-width:2px;
    classDef data fill:#99FF99,stroke:#333,stroke-width:2px;
```
