# aayushtcp/gunaso architecture

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

- Interactive diagram: https://gitdiagram.com/aayushtcp/gunaso
- Repository: https://github.com/aayushtcp/gunaso

## Overview

##### Project type and purpose
- This is a monolithic full-stack web application built with Django (Python).
- Purpose: “Gunaso – the Confession kinda web App” where users can write, read, search, and clip confessions or stories, manage profiles, groups, and view analytics.

##### File structure
- Top-level:
- manage.py – Django management script
- db.sqlite3 – development database
- requirements.txt – Python dependencies
- static/ – CSS, JS, images for client
- media/ – uploaded user content (images)
- templates/ – HTML views
- gunasoProject/ (Django project):
- settings.py, urls.py, wsgi.py, asgi.py – core Django configuration
- gunasoApp/ (Django app):
- models.py, views.py, forms.py, admin.py – MVC components
- urls.py – app-level routing
- context_processors.py, signals.py, detectViolence.py – custom middleware/logic
- templatetags/ – custom template filters and tags
- migrations/ – DB schema history
- static/scripts & static/styles – front-end behavior and styling

##### README for additional insights
- Minimal description: confirms it’s a confession/story sharing platform.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        Browser["Client Browser"]:::presentation
        Templates["Templates"]:::presentation
        StaticAssets["Static Assets"]:::presentation
    end

    %% Infrastructure Layer
    subgraph "Infrastructure Layer"
        WebServer["Web Server (Nginx/Apache)"]:::applogic
        WSGIServer["WSGI Server"]:::applogic
        ASGIServer["ASGI Server"]:::applogic
    end

    %% Application Layer
    subgraph "Application Layer"
        DjangoSettings["Settings"]:::applogic
        DjangoURLs["Project URLs"]:::applogic
        Manage["manage.py"]:::applogic
        subgraph "gunasoApp"
            AppConfig["App Config"]:::applogic
            AppURLs["App URLs"]:::applogic
            Views["Views"]:::applogic
            Models["Models"]:::applogic
            Forms["Forms"]:::applogic
            Admin["Admin"]:::applogic
            Context["Context Processors"]:::applogic
            Signals["Signals"]:::applogic
            Detect["Violence Detection"]:::applogic
            ExtrasTags["Template Tags & Filters"]:::applogic
        end
    end

    %% Data Layer
    subgraph "Data Layer"
        DB["SQLite DB"]:::storage
        Media["Media Storage"]:::storage
        StaticService["Static File Service"]:::storage
    end

    %% External Services
    subgraph "External Services"
        SMTP["SMTP Service"]:::external
    end

    %% Connections
    Browser -->|"HTTP(S)"| WebServer
    WebServer --> WSGIServer
    WebServer --> ASGIServer
    WSGIServer --> DjangoURLs
    ASGIServer --> DjangoURLs
    Manage --> DjangoSettings
    DjangoSettings --> DjangoURLs
    DjangoURLs --> AppURLs
    AppURLs --> Views
    Views --> Models
    Views --> Forms
    Views --> Admin
    Views --> Templates
    Views --> StaticAssets
    Views --> Media
    Views --> SMTP
    Models --> DB
    Signals --> Models
    Detect --> Models
    Templates --> Context
    Templates --> ExtrasTags

    %% Click Events
    click Templates "https://github.com/aayushtcp/gunaso/tree/main/templates/"
    click StaticAssets "https://github.com/aayushtcp/gunaso/tree/main/static/"
    click WSGIServer "https://github.com/aayushtcp/gunaso/blob/main/gunasoProject/wsgi.py"
    click ASGIServer "https://github.com/aayushtcp/gunaso/blob/main/gunasoProject/asgi.py"
    click DjangoSettings "https://github.com/aayushtcp/gunaso/blob/main/gunasoProject/settings.py"
    click DjangoURLs "https://github.com/aayushtcp/gunaso/blob/main/gunasoProject/urls.py"
    click Manage "https://github.com/aayushtcp/gunaso/blob/main/manage.py"
    click AppConfig "https://github.com/aayushtcp/gunaso/blob/main/gunasoApp/apps.py"
    click AppURLs "https://github.com/aayushtcp/gunaso/blob/main/gunasoApp/urls.py"
    click Views "https://github.com/aayushtcp/gunaso/blob/main/gunasoApp/views.py"
    click Models "https://github.com/aayushtcp/gunaso/blob/main/gunasoApp/models.py"
    click Forms "https://github.com/aayushtcp/gunaso/blob/main/gunasoApp/forms.py"
    click Admin "https://github.com/aayushtcp/gunaso/blob/main/gunasoApp/admin.py"
    click Context "https://github.com/aayushtcp/gunaso/blob/main/gunasoApp/context_processors.py"
    click Signals "https://github.com/aayushtcp/gunaso/blob/main/gunasoApp/signals.py"
    click Detect "https://github.com/aayushtcp/gunaso/blob/main/gunasoApp/detectViolence.py"
    click ExtrasTags "https://github.com/aayushtcp/gunaso/blob/main/gunasoApp/templatetags/extras.py"
    click ExtrasTags "https://github.com/aayushtcp/gunaso/blob/main/gunasoApp/templatetags/filters.py"
    click DB "https://github.com/aayushtcp/gunaso/blob/main/db.sqlite3"
    click Media "https://github.com/aayushtcp/gunaso/tree/main/media/"
    click StaticService "https://github.com/aayushtcp/gunaso/tree/main/static/"

    %% Styles
    classDef presentation fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef applogic fill:#90EE90,stroke:#333,stroke-width:1px
    classDef storage fill:#FFA500,stroke:#333,stroke-width:1px
    classDef external fill:#D3D3D3,stroke:#333,stroke-width:1px
```
