# guru-dharpale/itas architecture

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

- Interactive diagram: https://gitdiagram.com/guru-dharpale/itas
- Repository: https://github.com/guru-dharpale/itas

## Overview

##### Project type and purpose
- This is a full-stack web application (“Intelligent Talent Acquisition System”) built with Django (Python) on the backend and a static HTML/CSS/JS (Material Dashboard) frontend.
- It combines a traditional 3-tier web architecture (client, application server, database) with embedded machine-learning/deep-learning components for resume parsing, skill matching, and predictive analytics.

##### File structure
- Top-level Django structure:
- core/ – global settings, URL routing, ASGI/WGI entrypoints
- home/ – the main Django “app” with models, views, URLs, templates, and custom management commands (scrape_jobs, check_db_connection)
- manage.py – Django CLI
- requirements.txt, gunicorn-cfg.py, env.sample – environment and deployment files
- Frontend assets under static/ and templates/ – Material Dashboard theme CSS, SCSS, JS, and HTML templates.
- Database config in core/settings.py and my.cnf sample.
- No explicit microservices; ML code lives alongside Django, possibly invoked as library calls or background tasks.

##### README for additional insights
- Confirms use of Django + MySQL for backend, HTML/CSS/JS + Bootstrap for frontend.
- Describes deep-learning libs (Transformers, TensorFlow, PyTorch, HuggingFace) used for core AI features.
- Mentions management commands (database checks, job scraping).
- Outlines database models in home/models.py.

##### Detail
- Every logical component (reverse proxy, WSGI server, ML library) rather than lumping all into “backend.”
- Data flow for static vs. dynamic routes.
- How management commands integrate into the overall system.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Client Tier
    subgraph "Client Tier"
        direction TB
        Browser["Browser (HTML/CSS/JS)"]:::presentation
        StaticAssets["Static Assets"]:::presentation
        TemplatesPages["Templates: pages/"]:::presentation
        TemplatesIncludes["Templates: includes/"]:::presentation
        TemplatesLayouts["Templates: layouts/"]:::presentation
    end

    %% Static Asset Pipeline
    subgraph "Static Asset Pipeline"
        direction TB
        SCSS["SCSS"]:::presentation
        CSS["CSS"]:::presentation
        JS["JS"]:::presentation
        Gulp["gulpfile.js"]:::presentation
    end

    %% Application Tier
    subgraph "Application Tier"
        direction TB
        Nginx["Nginx Reverse Proxy"]:::infra
        Gunicorn["Gunicorn (WSGI)"]:::application

        subgraph "Django Core App"
            direction TB
            CoreSettings["core/settings.py"]:::application
            CoreURLs["core/urls.py"]:::application
            CoreASGI["core/asgi.py"]:::application
            CoreWSGI["core/wsgi.py"]:::application
        end

        subgraph "Django Home App"
            direction TB
            HomeModels["home/models.py"]:::application
            HomeViews["home/views.py"]:::application
            HomeURLs["home/urls.py"]:::application
            HomeAdmin["home/admin.py"]:::application
            HomeTests["home/tests.py"]:::application
            HomeApps["home/apps.py"]:::application
            HomeMigrations["home/migrations/"]:::application
        end
    end

    %% ML/AI Engine
    subgraph "ML/AI Engine"
        direction TB
        MLEngine["Transformers/TensorFlow/PyTorch"]:::ml
    end

    %% Data Tier
    subgraph "Data Tier"
        direction TB
        MySQL["MySQL Database"]:::data
    end

    %% Scheduler and Commands
    subgraph "Scheduler/Tasks"
        direction TB
        Scheduler["Scheduler (cron/Celery)"]:::infra
        ScrapeJobs["scrape_jobs"]:::infra
        CheckDB["check_db_connection"]:::infra
    end

    %% Deployment Config
    subgraph "Deployment Config"
        direction TB
        ManagePy["manage.py"]:::infra
        GunicornCfg["gunicorn-cfg.py"]:::infra
        Requirements["requirements.txt"]:::infra
        EnvSample["env.sample"]:::infra
        MyCnf["my.cnf"]:::infra
    end

    %% Connections
    Browser --> StaticAssets
    Browser --> TemplatesPages
    Browser --> TemplatesIncludes
    Browser --> TemplatesLayouts
    SCSS --> CSS
    CSS --> Browser
    JS --> Browser
    Gulp --> SCSS
    Gulp --> JS

    Browser -->|HTTP| Nginx
    Nginx -->|WSGI| Gunicorn
    Gunicorn --> CoreSettings
    Gunicorn --> CoreURLs
    Gunicorn --> CoreASGI
    Gunicorn --> CoreWSGI
    Gunicorn --> HomeModels
    Gunicorn --> HomeViews
    Gunicorn --> HomeURLs
    Gunicorn --> HomeAdmin

    HomeViews -->|DB Query| MySQL
    MySQL -->|Data| HomeViews

    HomeViews -->|ML Inference| MLEngine
    MLEngine -->|Result| HomeViews

    Scheduler -.-> ScrapeJobs
    Scheduler -.-> CheckDB
    ScrapeJobs -->|Write| MySQL
    CheckDB -->|Check| MySQL

    ManagePy --> CoreSettings
    ManagePy --> HomeApps
    GunicornCfg --> Gunicorn
    Requirements --> Gunicorn
    Requirements --> CoreSettings
    Requirements --> HomeModels
    Requirements --> MLEngine
    EnvSample --> CoreSettings
    MyCnf --> MySQL

    %% Click Events
    click StaticAssets "https://github.com/guru-dharpale/itas/tree/main/static/"
    click TemplatesPages "https://github.com/guru-dharpale/itas/tree/main/templates/pages/"
    click TemplatesIncludes "https://github.com/guru-dharpale/itas/tree/main/templates/includes/"
    click TemplatesLayouts "https://github.com/guru-dharpale/itas/tree/main/templates/layouts/"
    click SCSS "https://github.com/guru-dharpale/itas/tree/main/static/scss/"
    click CSS "https://github.com/guru-dharpale/itas/tree/main/static/css/"
    click JS "https://github.com/guru-dharpale/itas/tree/main/static/js/"
    click Gulp "https://github.com/guru-dharpale/itas/blob/main/static/gulpfile.js"
    click CoreSettings "https://github.com/guru-dharpale/itas/blob/main/core/settings.py"
    click CoreURLs "https://github.com/guru-dharpale/itas/blob/main/core/urls.py"
    click CoreASGI "https://github.com/guru-dharpale/itas/blob/main/core/asgi.py"
    click CoreWSGI "https://github.com/guru-dharpale/itas/blob/main/core/wsgi.py"
    click HomeModels "https://github.com/guru-dharpale/itas/blob/main/home/models.py"
    click HomeViews "https://github.com/guru-dharpale/itas/blob/main/home/views.py"
    click HomeURLs "https://github.com/guru-dharpale/itas/blob/main/home/urls.py"
    click HomeAdmin "https://github.com/guru-dharpale/itas/blob/main/home/admin.py"
    click HomeTests "https://github.com/guru-dharpale/itas/blob/main/home/tests.py"
    click HomeApps "https://github.com/guru-dharpale/itas/blob/main/home/apps.py"
    click HomeMigrations "https://github.com/guru-dharpale/itas/tree/main/home/migrations/"
    click ScrapeJobs "https://github.com/guru-dharpale/itas/blob/main/home/management/commands/scrape_jobs.py"
    click CheckDB "https://github.com/guru-dharpale/itas/blob/main/home/management/commands/check_db_connection.py"
    click ManagePy "https://github.com/guru-dharpale/itas/blob/main/manage.py"
    click GunicornCfg "https://github.com/guru-dharpale/itas/blob/main/gunicorn-cfg.py"
    click Requirements "https://github.com/guru-dharpale/itas/blob/main/requirements.txt"
    click EnvSample "https://github.com/guru-dharpale/itas/blob/main/env.sample"
    click MyCnf "https://github.com/guru-dharpale/itas/blob/main/my.cnf"

    %% Styles
    classDef presentation fill:#D0E6FF,stroke:#000
    classDef application fill:#D0F0D0,stroke:#000
    classDef data fill:#FFE5B4,stroke:#000
    classDef ml fill:#E6D0FF,stroke:#000
    classDef infra fill:#F0F0F0,stroke:#000
```
