# vladyslav-tmf/it-company-task-manager architecture

> Architecture diagram of the GitHub repository vladyslav-tmf/it-company-task-manager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-02-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vladyslav-tmf/it-company-task-manager
- Repository: https://github.com/vladyslav-tmf/it-company-task-manager

## Overview

##### Project Type and Purpose
- This is a Django-powered web application focused on task management within IT companies.
- The README highlights features such as task management, status tracking, authentication/registration, email verification, an admin panel, and localization. This tells you that the system supports both regular workers and administrative users.
- The project utilizes a Bootstrap template for its front-end styling (“Soft UI Design System”), indicating that UI/UX components have been customized, though they still follow a clear separation from the core business logic.

##### File Structure
- The top-level directories show the Django project organization:
- "accounts" app: Handles user accounts, authentication/registration, admin functionality, email verification (e.g., email_service.py, token_service.py), and related forms, models, views, and tests.
- "tasks" app: Manages task operations such as creating, editing, deleting tasks and positions, with its own models, views, forms, tests, and URLs.
- "core": Contains global project settings and configuration (e.g., settings for development and production, ASGI and WSGI entries, URL configuration) that ties the individual apps together.
- "templates" and "static": Hold the front-end assets including layout files, partials (e.g., navigation, footer, pagination) and JavaScript/CSS for enhanced UI.
- Other supporting files such as manage.py, dataset.json (for loading sample data) and configuration files like .env.sample and requirements.txt.
- Migration and test directories within each app indicate adherence to Django’s best practices regarding database version control and automated testing.
- The directory structure suggests an MVC-inspired design where models, views, and templates are clearly separated.

##### README for Additional Insights
- The README provides important context including:
- Live demo links and instructions for running the project locally.
- Environment setup and credentials specifics.
- A note on using a Bootstrap-based template which is integrated within the “static” and “templates” directories.
- Detailed steps on deployment and testing which may be represented in a deployment pipeline component if needed.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend Layer"
        Templates("Templates"):::frontend
        StaticAssets("Static Assets"):::frontend
    end

    %% Core Module
    subgraph "Core Module"
        CoreConfig("Core Configuration"):::core
        CoreRouting("Core Routing"):::core
    end

    %% Accounts Module
    subgraph "Accounts Module"
        AccountsMain("Accounts Main"):::accounts
        AccountsModels("Accounts Models"):::accounts
        AccountsViews("Accounts Views"):::accounts
        AccountsForms("Accounts Forms"):::accounts
        AccountsURLs("Accounts URLs"):::accounts
        AccountsTests("Accounts Tests"):::accounts
        AccountsServices("Accounts Services"):::accounts
        EmailService("Email Service"):::accounts
        TokenService("Token Service"):::accounts
    end

    %% Tasks Module
    subgraph "Tasks Module"
        TasksMain("Tasks Main"):::tasks
        TasksModels("Tasks Models"):::tasks
        TasksViews("Tasks Views"):::tasks
        TasksForms("Tasks Forms"):::tasks
        TasksURLs("Tasks URLs"):::tasks
        TasksTests("Tasks Tests"):::tasks
    end

    %% External Components
    Database("Database"):::database
    Localization("Localization Files"):::external

    %% Connections from Frontend to Core
    Templates -->|"sends_requests"| CoreConfig
    StaticAssets -->|"loads_assets"| CoreConfig

    %% Core connections to modules and localization
    CoreConfig -->|"routes_to"| CoreRouting
    CoreConfig -->|"localizes"| Localization
    CoreRouting -->|"routes_to"| AccountsMain
    CoreRouting -->|"routes_to"| TasksMain

    %% Accounts Module internal flow
    AccountsMain -->|"handles"| AccountsModels
    AccountsMain -->|"handles"| AccountsViews
    AccountsMain -->|"handles"| AccountsForms
    AccountsMain -->|"handles"| AccountsURLs
    AccountsMain -->|"handles"| AccountsTests
    AccountsMain -->|"uses"| AccountsServices
    AccountsServices -->|"provides"| EmailService
    AccountsServices -->|"provides"| TokenService
    AccountsModels -->|"persists_to"| Database

    %% Tasks Module internal flow
    TasksMain -->|"handles"| TasksModels
    TasksMain -->|"handles"| TasksViews
    TasksMain -->|"handles"| TasksForms
    TasksMain -->|"handles"| TasksURLs
    TasksMain -->|"handles"| TasksTests
    TasksModels -->|"persists_to"| Database

    %% Styles
    classDef frontend fill:#9fcdff,stroke:#333,stroke-width:2px;
    classDef core fill:#f9c74f,stroke:#333,stroke-width:2px;
    classDef accounts fill:#a8d5e2,stroke:#333,stroke-width:2px;
    classDef tasks fill:#c5e1a5,stroke:#333,stroke-width:2px;
    classDef external fill:#ff9f1c,stroke:#333,stroke-width:2px;
    classDef database fill:#bbbbbb,stroke:#333,stroke-width:2px;

    %% Click Events for Frontend
    click Templates "https://github.com/vladyslav-tmf/it-company-task-manager/tree/main/templates/"
    click StaticAssets "https://github.com/vladyslav-tmf/it-company-task-manager/tree/main/static/"

    %% Click Events for Accounts Module
    click AccountsMain "https://github.com/vladyslav-tmf/it-company-task-manager/tree/main/accounts/"
    click AccountsModels "https://github.com/vladyslav-tmf/it-company-task-manager/blob/main/accounts/models.py"
    click AccountsViews "https://github.com/vladyslav-tmf/it-company-task-manager/blob/main/accounts/views.py"
    click AccountsForms "https://github.com/vladyslav-tmf/it-company-task-manager/blob/main/accounts/forms.py"
    click AccountsURLs "https://github.com/vladyslav-tmf/it-company-task-manager/blob/main/accounts/urls.py"
    click AccountsTests "https://github.com/vladyslav-tmf/it-company-task-manager/tree/main/accounts/tests/"
    click AccountsServices "https://github.com/vladyslav-tmf/it-company-task-manager/tree/main/accounts/services/"
    click EmailService "https://github.com/vladyslav-tmf/it-company-task-manager/blob/main/accounts/services/email_service.py"
    click TokenService "https://github.com/vladyslav-tmf/it-company-task-manager/blob/main/accounts/services/token_service.py"

    %% Click Events for Tasks Module
    click TasksMain "https://github.com/vladyslav-tmf/it-company-task-manager/tree/main/tasks/"
    click TasksModels "https://github.com/vladyslav-tmf/it-company-task-manager/blob/main/tasks/models.py"
    click TasksViews "https://github.com/vladyslav-tmf/it-company-task-manager/blob/main/tasks/views.py"
    click TasksForms "https://github.com/vladyslav-tmf/it-company-task-manager/blob/main/tasks/forms.py"
    click TasksURLs "https://github.com/vladyslav-tmf/it-company-task-manager/blob/main/tasks/urls.py"
    click TasksTests "https://github.com/vladyslav-tmf/it-company-task-manager/tree/main/tasks/tests/"

    %% Click Events for Core Module
    click CoreConfig "https://github.com/vladyslav-tmf/it-company-task-manager/tree/main/core/settings/"
    click CoreRouting "https://github.com/vladyslav-tmf/it-company-task-manager/blob/main/core/urls.py"

    %% Click Events for Localization
    click Localization "https://github.com/vladyslav-tmf/it-company-task-manager/blob/main/locale/uk/LC_MESSAGES/django.po"
```
