# raviteja-5976/task-manager-using-streamlit architecture

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

- Interactive diagram: https://gitdiagram.com/raviteja-5976/task-manager-using-streamlit
- Repository: https://github.com/raviteja-5976/task-manager-using-streamlit

## Overview

##### Project Type & Purpose
- Full-stack, single-repo Streamlit web application
- Frontend and backend are both in Python, served via Streamlit
- Uses a MySQL relational database to store and manage GDSC task data
- Modular code organized by pages and feature categories (NON-TECHNICAL / TECHNICAL)

##### File Structure
- Top-level files:
– README.md, LICENSE (project metadata)
– signup.py, member_add.py, member.py, lead_page.py, common_page.py (Streamlit page entry points)
- Gdsc/ directory: houses feature modules by domain:
– NON-TECHNICAL/{marketing, design, management, social media, writing}
– TECHNICAL/{android, cloud, comp code, flutter, machine learning, webdev}
- Each domain has two files:
– *auth.py (authentication & permission checks)
– *.py (main feature logic and UI components)
- __pycache__ directories (compiled bytecode – not part of runtime architecture)

##### Key Insights from README
- Streamlit app (serves UI over HTTP)
- MySQL database backend
- Core use case: CRUD operations on “tasks” for different GDSC categories
- Intended for college-level GDSC chapter management

##### Main Components
a. Client Browser / User Agent
b. Streamlit Server (Python runtime)
c. Application Modules:
– Authentication Layer (signup.py, *auth.py modules)
– Page Controllers (lead_page.py, member.py, member_add.py, common_page.py)
– Feature Domains (Marketing, Design, etc.)
d. Database Layer: MySQL server
e. External Dependencies:
– Streamlit library
– mysql-connector / SQLAlchemy (or similar)
– (Optional) Deployment environment (Streamlit Cloud, Docker, etc.)

##### Relationships & Data Flow
1. User requests a page via browser → HTTP request to Streamlit server
2. Streamlit routing selects the corresponding page controller (e.g., signup.py)
3. Controller calls authentication module (*auth.py) to verify user credentials
4. Upon success, controller invokes feature module logic (e.g., marketing.py)
5. Feature module executes CRUD queries against MySQL via connector
6. MySQL returns data → feature module formats results → Streamlit renders UI
7. User sees updated UI; interactions loop back in the same flow

##### Architectural Patterns & Principles
- Modular separation: each domain is self-contained (authentication + business logic)
- Page-based MVC-like pattern:
– View: Streamlit UI elements in page scripts
– Controller: page scripts handle user events & coordinate modules
– Model: SQL operations through a DB connector library
- Single codebase deployment, but logically layered

##### Final Checklist
[ ] All major components clearly labeled
[ ] Key technologies/frameworks noted
[ ] Modular grouping of feature domains (for clarity)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Entities
    Browser["Browser / User Agent"]:::external
    Streamlit["Streamlit Server<br/>(Python, Streamlit)"]:::server

    %% UI / Page Controllers
    subgraph "UI / Page Controllers"
        direction TB
        Signup["signup.py"]:::ui
        MemberAdd["member_add.py"]:::ui
        Member["member.py"]:::ui
        LeadPage["lead_page.py"]:::ui
        CommonPage["Gdsc/common_page.py"]:::ui
    end

    %% Authentication Layer
    subgraph "Authentication Layer"
        direction TB
        MAuth["Gdsc/NON-TECHNICAL/Marketing/markauth.py"]:::auth
        DAuth["Gdsc/NON-TECHNICAL/design/degauth.py"]:::auth
        MgAuth["Gdsc/NON-TECHNICAL/management/managauth.py"]:::auth
        SMAuth["Gdsc/NON-TECHNICAL/social media/socauth.py"]:::auth
        WAuth["Gdsc/NON-TECHNICAL/writing/wriauth.py"]:::auth
        AAuth["Gdsc/TECHNICAL/android/andauth.py"]:::auth
        CAuth["Gdsc/TECHNICAL/cloud/clauth.py"]:::auth
        CcAuth["Gdsc/TECHNICAL/comp code/ccauth.py"]:::auth
        FAuth["Gdsc/TECHNICAL/flutter/fluauth.py"]:::auth
        MLAuth["Gdsc/TECHNICAL/machine learning/mlauth.py"]:::auth
        WbAuth["Gdsc/TECHNICAL/webdev/webauth.py"]:::auth
    end

    %% Feature Modules
    subgraph "Feature Modules"
        direction TB
        MFeat["Gdsc/NON-TECHNICAL/Marketing/marketing.py"]:::feature
        DFeat["Gdsc/NON-TECHNICAL/design/design.py"]:::feature
        MgFeat["Gdsc/NON-TECHNICAL/management/management.py"]:::feature
        SMFeat["Gdsc/NON-TECHNICAL/social media/social_media.py"]:::feature
        WFeat["Gdsc/NON-TECHNICAL/writing/writing.py"]:::feature
        AFeat["Gdsc/TECHNICAL/android/andriod.py"]:::feature
        CFeat["Gdsc/TECHNICAL/cloud/cloud.py"]:::feature
        CcFeat["Gdsc/TECHNICAL/comp code/cc.py"]:::feature
        FFeat["Gdsc/TECHNICAL/flutter/flutter.py"]:::feature
        MLFeat["Gdsc/TECHNICAL/machine learning/ml.py"]:::feature
        WbFeat["Gdsc/TECHNICAL/webdev/webdev.py"]:::feature
    end

    %% Database
    DB["MySQL Database"]:::db

    %% Connections
    Browser --> Streamlit
    Streamlit --> Signup
    Streamlit --> MemberAdd
    Streamlit --> Member
    Streamlit --> LeadPage
    Streamlit --> CommonPage

    Signup -->|requests auth| MAuth
    MemberAdd -->|requests auth| MgAuth
    Member -->|requests auth| DAuth
    LeadPage -->|requests auth| SMAuth
    CommonPage -->|requests auth| WAuth

    %% Generic flows for technical domains
    Signup -->|requests auth| AAuth
    Signup -->|requests auth| CAuth
    Signup -->|requests auth| CcAuth
    Signup -->|requests auth| FAuth
    Signup -->|requests auth| MLAuth
    Signup -->|requests auth| WbAuth

    %% Auth to Feature
    MAuth --> MFeat
    DAuth --> DFeat
    MgAuth --> MgFeat
    SMAuth --> SMFeat
    WAuth --> WFeat
    AAuth --> AFeat
    CAuth --> CFeat
    CcAuth --> CcFeat
    FAuth --> FFeat
    MLAuth --> MLFeat
    WbAuth --> WbFeat

    %% Feature to DB and back to UI
    MFeat -->|CRUD queries| DB
    DFeat -->|CRUD queries| DB
    MgFeat -->|CRUD queries| DB
    SMFeat -->|CRUD queries| DB
    WFeat -->|CRUD queries| DB
    AFeat -->|CRUD queries| DB
    CFeat -->|CRUD queries| DB
    CcFeat -->|CRUD queries| DB
    FFeat -->|CRUD queries| DB
    MLFeat -->|CRUD queries| DB
    WbFeat -->|CRUD queries| DB

    DB -->|results| Streamlit
    Streamlit --> Browser

    %% Click Events
    click Signup "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/signup.py"
    click MemberAdd "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/member_add.py"
    click Member "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/member.py"
    click LeadPage "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/lead_page.py"
    click CommonPage "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/common_page.py"
    click MAuth "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/NON-TECHNICAL/Marketing/markauth.py"
    click MFeat "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/NON-TECHNICAL/Marketing/marketing.py"
    click DAuth "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/NON-TECHNICAL/design/degauth.py"
    click DFeat "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/NON-TECHNICAL/design/design.py"
    click MgAuth "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/NON-TECHNICAL/management/managauth.py"
    click MgFeat "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/NON-TECHNICAL/management/management.py"
    click SMAuth "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/NON-TECHNICAL/social media/socauth.py"
    click SMFeat "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/NON-TECHNICAL/social media/social_media.py"
    click WAuth "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/NON-TECHNICAL/writing/wriauth.py"
    click WFeat "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/NON-TECHNICAL/writing/writing.py"
    click AAuth "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/TECHNICAL/android/andauth.py"
    click AFeat "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/TECHNICAL/android/andriod.py"
    click CAuth "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/TECHNICAL/cloud/clauth.py"
    click CFeat "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/TECHNICAL/cloud/cloud.py"
    click CcAuth "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/TECHNICAL/comp code/ccauth.py"
    click CcFeat "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/TECHNICAL/comp code/cc.py"
    click FAuth "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/TECHNICAL/flutter/fluauth.py"
    click FFeat "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/TECHNICAL/flutter/flutter.py"
    click MLAuth "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/TECHNICAL/machine learning/mlauth.py"
    click MLFeat "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/TECHNICAL/machine learning/ml.py"
    click WbAuth "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/TECHNICAL/webdev/webauth.py"
    click WbFeat "https://github.com/raviteja-5976/task-manager-using-streamlit/blob/main/Gdsc/TECHNICAL/webdev/webdev.py"

    %% Styles
    classDef external fill:#AEDFF7,stroke:#333,stroke-width:1px
    classDef server fill:#B3E6B5,stroke:#333,stroke-width:1px
    classDef ui fill:#A3C4FE,stroke:#333,stroke-width:1px
    classDef auth fill:#C0F4C1,stroke:#333,stroke-width:1px
    classDef feature fill:#FDD0A2,stroke:#333,stroke-width:1px
    classDef db fill:#F4B6C2,stroke:#333,stroke-width:1px
```
