# smangajasithole-developer/sj-sithole-portfolio architecture

> Architecture diagram of the GitHub repository smangajasithole-developer/sj-sithole-portfolio, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/smangajasithole-developer/sj-sithole-portfolio
- Repository: https://github.com/smangajasithole-developer/sj-sithole-portfolio

## Overview

This is a Django-managed personal portfolio: visitors browse profile, skills, projects and contact details, while an authenticated owner manages portfolio content and uploaded documents. Contact messages are also collected and managed. The main request handlers are in `myApp/views.py`; models persist the portfolio and message data. The excerpts show URL dispatch, model usage, and configuration for the database, middleware and Cloudinary media storage. Several feature branches are represented by their routes and handler modules, but their detailed implementations and template wiring were not sampled.

Main entry points: [`myApp/urls.py`](https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/urls.py) (App routes), [`myApp/models.py`](https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/models.py) (Portfolio models), [`myProject/settings.py`](https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myProject/settings.py) (Django settings), [`myApp/views.py`](https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/views.py) (Public pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Portfolio site"]
  node_routes["App routes<br/>[urls.py]"]
  node_public["Public pages<br/>[views.py]"]
  node_contact["Contact form<br/>[views.py]"]
end

subgraph group_manage["Owner management"]
  node_login["Admin login<br/>[views.py]"]
  node_dashboard["Owner dashboard<br/>[views.py]"]
  node_profile["Profile editor<br/>[views.py]"]
  node_skills["Skill manager<br/>[views.py]"]
  node_projects["Project manager<br/>[views.py]"]
  node_documents["Document manager<br/>[views.py]"]
  node_messages["Message inbox<br/>[views.py]"]
end

subgraph group_domain["Portfolio data"]
  node_models["Portfolio models<br/>[models.py]"]
end

subgraph group_platform["Runtime services"]
  node_database[("Application database")]
  node_middleware["Request middleware<br/>[middleware.py]"]
  node_settings["Django settings<br/>[settings.py]"]
  node_media["Cloudinary media"]
end

node_visitor(("Visitor"))
node_owner(("Portfolio owner"))

node_visitor -.->|"requests pages"| node_routes
node_owner -.->|"requests management"| node_routes
node_routes -->|"routes pages"| node_public
node_routes -->|"routes contact"| node_contact
node_routes -->|"routes login"| node_login
node_routes -->|"routes dashboard"| node_dashboard
node_routes -->|"routes profile"| node_profile
node_routes -->|"routes skills"| node_skills
node_routes -->|"routes projects"| node_projects
node_routes -->|"routes documents"| node_documents
node_routes -->|"routes messages"| node_messages
node_public -->|"reads portfolio"| node_models
node_contact -->|"stores messages"| node_models
node_login -->|"authenticates owner"| node_models
node_dashboard -->|"reads portfolio"| node_models
node_profile -->|"updates profile"| node_models
node_skills -->|"updates skills"| node_models
node_projects -->|"updates projects"| node_models
node_documents -->|"updates documents"| node_models
node_messages -.->|"manages messages"| node_models
node_settings -->|"configures middleware"| node_middleware
node_settings -->|"configures database"| node_database
node_settings -->|"configures media storage"| node_media
node_models -.->|"persists records"| node_database

click node_routes "https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/urls.py"
click node_public "https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/views.py"
click node_contact "https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/views.py"
click node_login "https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/views.py"
click node_dashboard "https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/views.py"
click node_profile "https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/views.py"
click node_skills "https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/views.py"
click node_projects "https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/views.py"
click node_documents "https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/views.py"
click node_messages "https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/views.py"
click node_models "https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/models.py"
click node_middleware "https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/middleware.py"
click node_settings "https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myProject/settings.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_routes,node_public,node_contact toneBlue
class node_login,node_dashboard,node_profile,node_skills,node_projects,node_documents,node_messages toneAmber
class node_models toneMint
class node_database,node_middleware,node_settings,node_media toneRose
class node_visitor,node_owner toneIndigo
```

## Components

### Portfolio site

- [App routes](https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/urls.py): `myApp/urls.py`
- [Public pages](https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/views.py): `myApp/views.py`
- [Contact form](https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/views.py): `myApp/views.py`

### Owner management

- [Admin login](https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/views.py): `myApp/views.py`
- [Owner dashboard](https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/views.py): `myApp/views.py`
- [Profile editor](https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/views.py): `myApp/views.py`
- [Skill manager](https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/views.py): `myApp/views.py`
- [Project manager](https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/views.py): `myApp/views.py`
- [Document manager](https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/views.py): `myApp/views.py`
- [Message inbox](https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/views.py): `myApp/views.py`

### Portfolio data

- [Portfolio models](https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/models.py): `myApp/models.py`

### Runtime services

- **Application database**
- [Request middleware](https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myApp/middleware.py): `myApp/middleware.py`
- [Django settings](https://github.com/smangajasithole-developer/sj-sithole-portfolio/blob/main/myProject/settings.py): `myProject/settings.py`
- **Cloudinary media**

### Other components

- **Visitor**
- **Portfolio owner**

## Connections

- Visitor → App routes: requests pages
- Portfolio owner → App routes: requests management
- App routes → Public pages: routes pages (evidence: `myApp/urls.py`)
- App routes → Contact form: routes contact (evidence: `myApp/urls.py`)
- App routes → Admin login: routes login (evidence: `myApp/urls.py`)
- App routes → Owner dashboard: routes dashboard (evidence: `myApp/urls.py`)
- App routes → Profile editor: routes profile (evidence: `myApp/urls.py`)
- App routes → Skill manager: routes skills (evidence: `myApp/urls.py`)
- App routes → Project manager: routes projects (evidence: `myApp/urls.py`)
- App routes → Document manager: routes documents (evidence: `myApp/urls.py`)
- App routes → Message inbox: routes messages (evidence: `myApp/urls.py`)
- Public pages → Portfolio models: reads portfolio (evidence: `myApp/views.py`)
- Contact form → Portfolio models: stores messages (evidence: `myApp/views.py`)
- Admin login → Portfolio models: authenticates owner (evidence: `myApp/views.py`)
- Owner dashboard → Portfolio models: reads portfolio (evidence: `myApp/views.py`)
- Profile editor → Portfolio models: updates profile (evidence: `myApp/views.py`)
- Skill manager → Portfolio models: updates skills (evidence: `myApp/views.py`)
- Project manager → Portfolio models: updates projects (evidence: `myApp/views.py`)
- Document manager → Portfolio models: updates documents (evidence: `myApp/views.py`)
- Message inbox → Portfolio models: manages messages (evidence: `myApp/views.py`)
- Django settings → Request middleware: configures middleware (evidence: `myProject/settings.py`)
- Django settings → Application database: configures database (evidence: `myProject/settings.py`)
- Django settings → Cloudinary media: configures media storage (evidence: `myProject/settings.py`)
- Portfolio models → Application database: persists records
