# darshanr43/satchi architecture

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

- Interactive diagram: https://gitdiagram.com/darshanr43/satchi
- Repository: https://github.com/darshanr43/satchi

## Overview

GYAN is a student project-repository and event-registration portal with administrative event management, judging, and analytics. The main workflow is account access, browsing/configuring a hierarchical event, submitting a project team, judging submissions, and reviewing results. The graph combines sampled calls and model relationships with README-documented capabilities. Several frontend pages and backend routes were not sampled, so their connections are shown only where documented; deployment infrastructure is excluded.

Main entry points: [`satchi-main/src/App.jsx`](https://github.com/darshanr43/satchi/blob/main/satchi-main/src/App.jsx) (SPA routes), [`satchi-main/src/lib/api.js`](https://github.com/darshanr43/satchi/blob/main/satchi-main/src/lib/api.js) (API URL config), [`satchi-main/src/context/AuthContext.jsx`](https://github.com/darshanr43/satchi/blob/main/satchi-main/src/context/AuthContext.jsx) (Auth provider), [`satchi-main/src/Pages/Admin.jsx`](https://github.com/darshanr43/satchi/blob/main/satchi-main/src/Pages/Admin.jsx) (Administration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["SPA routes<br/>[App.jsx]"]
  node_api_client["API URL config<br/>[api.js]"]
end

subgraph group_identity["Accounts and access"]
  node_auth["Auth provider<br/>[AuthContext.jsx]"]
  node_login["Login and signup<br/>[Signup.jsx]"]
  node_profile[("User profiles<br/>[models.py]")]
  node_roles["Role services<br/>[roles.py]"]
  node_user_admin_ui["User management<br/>[UserManagement.jsx]"]
end

subgraph group_events["Event operations"]
  node_admin_ui["Administration<br/>[Admin.jsx]"]
  node_events_ui["Event browser<br/>[Events.jsx]"]
  node_event_ops["Event operations<br/>[views.py]"]
  node_event_models[("Event hierarchy<br/>[models.py]")]
end

subgraph group_projects["Project registration"]
  node_registration_ui["Project submission"]
  node_manual_entry["Manual team entry"]
  node_project_api["Project API<br/>[views.py]"]
  node_project_services["Participant linking<br/>[services.py]"]
  node_project_models[("Projects and teams<br/>[models.py]")]
  node_team_ui["Team management<br/>[TeamManagement.jsx]"]
end

subgraph group_judging["Evaluation and analytics"]
  node_evaluation_ui["Judge console<br/>[Evaluation.jsx]"]
  node_evaluation_api["Evaluation API<br/>[views.py]"]
  node_evaluation_models[("Rubrics and scores<br/>[models.py]")]
  node_statistics_ui["Operational analytics<br/>[Statistics.jsx]"]
end

node_browser(("Participant / staff"))

node_browser -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_events_ui
node_app -->|"routes to"| node_admin_ui
node_app -->|"routes to"| node_evaluation_ui
node_app -->|"routes to"| node_statistics_ui
node_app -->|"routes to"| node_team_ui
node_app -->|"routes to"| node_user_admin_ui
node_app -->|"wrapped by"| node_auth
node_auth -->|"uses URL"| node_api_client
node_auth -->|"fetches profile"| node_profile
node_login -->|"uses"| node_auth
node_admin_ui -->|"uses"| node_auth
node_admin_ui -->|"requests API"| node_api_client
node_events_ui -->|"requests API"| node_api_client
node_admin_ui -.->|"manages events"| node_event_ops
node_events_ui -.->|"loads events"| node_event_ops
node_event_ops -->|"reads and writes"| node_event_models
node_event_ops -->|"promotes managers"| node_roles
node_registration_ui -.->|"submits project"| node_project_models
node_manual_entry -->|"renders form"| node_registration_ui
node_manual_entry -->|"requests API"| node_api_client
node_project_api -->|"reads and writes"| node_project_models
node_project_api -->|"synchronizes participants"| node_project_services
node_project_services -->|"updates team links"| node_project_models
node_project_services -->|"matches users"| node_profile
node_evaluation_ui -->|"requests API"| node_api_client
node_evaluation_ui -.->|"submits scores"| node_evaluation_api
node_evaluation_api -->|"reads and writes"| node_evaluation_models
node_evaluation_api -->|"loads projects"| node_project_models
node_evaluation_api -->|"checks event scope"| node_event_models
node_statistics_ui -->|"requests API"| node_api_client
node_statistics_ui -.->|"loads analytics"| node_project_api
node_team_ui -.->|"requests API"| node_api_client
node_user_admin_ui -.->|"requests API"| node_api_client

click node_app "https://github.com/darshanr43/satchi/blob/main/satchi-main/src/App.jsx"
click node_auth "https://github.com/darshanr43/satchi/blob/main/satchi-main/src/context/AuthContext.jsx"
click node_api_client "https://github.com/darshanr43/satchi/blob/main/satchi-main/src/lib/api.js"
click node_login "https://github.com/darshanr43/satchi/blob/main/satchi-main/src/Pages/Signup.jsx"
click node_profile "https://github.com/darshanr43/satchi/blob/main/satchi_api/users/models.py"
click node_roles "https://github.com/darshanr43/satchi/blob/main/satchi_api/users/services/roles.py"
click node_admin_ui "https://github.com/darshanr43/satchi/blob/main/satchi-main/src/Pages/Admin.jsx"
click node_events_ui "https://github.com/darshanr43/satchi/blob/main/satchi-main/src/Pages/Events.jsx"
click node_event_ops "https://github.com/darshanr43/satchi/blob/main/satchi_api/events/views.py"
click node_event_models "https://github.com/darshanr43/satchi/blob/main/satchi_api/events/models.py"
click node_registration_ui "https://github.com/darshanr43/satchi/blob/main/satchi-main/src/Components/projects/ProjectSubmissionForm.jsx"
click node_manual_entry "https://github.com/darshanr43/satchi/blob/main/satchi-main/src/Pages/ManualTeamEntry.jsx"
click node_project_api "https://github.com/darshanr43/satchi/blob/main/satchi_api/api/views.py"
click node_project_services "https://github.com/darshanr43/satchi/blob/main/satchi_api/api/services.py"
click node_project_models "https://github.com/darshanr43/satchi/blob/main/satchi_api/api/models.py"
click node_evaluation_ui "https://github.com/darshanr43/satchi/blob/main/satchi-main/src/Pages/Evaluation.jsx"
click node_evaluation_api "https://github.com/darshanr43/satchi/blob/main/satchi_api/eval/views.py"
click node_evaluation_models "https://github.com/darshanr43/satchi/blob/main/satchi_api/eval/models.py"
click node_statistics_ui "https://github.com/darshanr43/satchi/blob/main/satchi-main/src/Pages/Statistics.jsx"
click node_team_ui "https://github.com/darshanr43/satchi/blob/main/satchi-main/src/Pages/TeamManagement.jsx"
click node_user_admin_ui "https://github.com/darshanr43/satchi/blob/main/satchi-main/src/Pages/UserManagement.jsx"

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_app,node_api_client toneBlue
class node_auth,node_login,node_profile,node_roles,node_user_admin_ui toneAmber
class node_admin_ui,node_events_ui,node_event_ops,node_event_models toneMint
class node_registration_ui,node_manual_entry,node_project_api,node_project_services,node_project_models,node_team_ui toneRose
class node_evaluation_ui,node_evaluation_api,node_evaluation_models,node_statistics_ui,node_browser toneIndigo
```

## Components

### Web application

- [SPA routes](https://github.com/darshanr43/satchi/blob/main/satchi-main/src/App.jsx): `satchi-main/src/App.jsx`
- [API URL config](https://github.com/darshanr43/satchi/blob/main/satchi-main/src/lib/api.js): `satchi-main/src/lib/api.js`

### Accounts and access

- [Auth provider](https://github.com/darshanr43/satchi/blob/main/satchi-main/src/context/AuthContext.jsx): `satchi-main/src/context/AuthContext.jsx`
- [Login and signup](https://github.com/darshanr43/satchi/blob/main/satchi-main/src/Pages/Signup.jsx): `satchi-main/src/Pages/Signup.jsx`
- [User profiles](https://github.com/darshanr43/satchi/blob/main/satchi_api/users/models.py): `satchi_api/users/models.py`
- [Role services](https://github.com/darshanr43/satchi/blob/main/satchi_api/users/services/roles.py): `satchi_api/users/services/roles.py`
- [User management](https://github.com/darshanr43/satchi/blob/main/satchi-main/src/Pages/UserManagement.jsx): `satchi-main/src/Pages/UserManagement.jsx`

### Event operations

- [Administration](https://github.com/darshanr43/satchi/blob/main/satchi-main/src/Pages/Admin.jsx): `satchi-main/src/Pages/Admin.jsx`
- [Event browser](https://github.com/darshanr43/satchi/blob/main/satchi-main/src/Pages/Events.jsx): `satchi-main/src/Pages/Events.jsx`
- [Event operations](https://github.com/darshanr43/satchi/blob/main/satchi_api/events/views.py): `satchi_api/events/views.py`
- [Event hierarchy](https://github.com/darshanr43/satchi/blob/main/satchi_api/events/models.py): `satchi_api/events/models.py`

### Project registration

- [Project submission](https://github.com/darshanr43/satchi/blob/main/satchi-main/src/Components/projects/ProjectSubmissionForm.jsx): `satchi-main/src/Components/projects/ProjectSubmissionForm.jsx`
- [Manual team entry](https://github.com/darshanr43/satchi/blob/main/satchi-main/src/Pages/ManualTeamEntry.jsx): `satchi-main/src/Pages/ManualTeamEntry.jsx`
- [Project API](https://github.com/darshanr43/satchi/blob/main/satchi_api/api/views.py): `satchi_api/api/views.py`
- [Participant linking](https://github.com/darshanr43/satchi/blob/main/satchi_api/api/services.py): `satchi_api/api/services.py`
- [Projects and teams](https://github.com/darshanr43/satchi/blob/main/satchi_api/api/models.py): `satchi_api/api/models.py`
- [Team management](https://github.com/darshanr43/satchi/blob/main/satchi-main/src/Pages/TeamManagement.jsx): `satchi-main/src/Pages/TeamManagement.jsx`

### Evaluation and analytics

- [Judge console](https://github.com/darshanr43/satchi/blob/main/satchi-main/src/Pages/Evaluation.jsx): `satchi-main/src/Pages/Evaluation.jsx`
- [Evaluation API](https://github.com/darshanr43/satchi/blob/main/satchi_api/eval/views.py): `satchi_api/eval/views.py`
- [Rubrics and scores](https://github.com/darshanr43/satchi/blob/main/satchi_api/eval/models.py): `satchi_api/eval/models.py`
- [Operational analytics](https://github.com/darshanr43/satchi/blob/main/satchi-main/src/Pages/Statistics.jsx): `satchi-main/src/Pages/Statistics.jsx`

### Other components

- **Participant / staff**

## Connections

- Participant / staff → SPA routes: uses (evidence: `satchi-main/src/App.jsx`)
- SPA routes → Login and signup: routes to (evidence: `satchi-main/src/App.jsx`)
- SPA routes → Event browser: routes to (evidence: `satchi-main/src/App.jsx`)
- SPA routes → Administration: routes to (evidence: `satchi-main/src/App.jsx`)
- SPA routes → Judge console: routes to (evidence: `satchi-main/src/App.jsx`)
- SPA routes → Operational analytics: routes to (evidence: `satchi-main/src/App.jsx`)
- SPA routes → Team management: routes to (evidence: `satchi-main/src/App.jsx`)
- SPA routes → User management: routes to (evidence: `satchi-main/src/App.jsx`)
- SPA routes → Auth provider: wrapped by (evidence: `satchi-main/src/main.jsx`)
- Auth provider → API URL config: uses URL (evidence: `satchi-main/src/context/AuthContext.jsx`)
- Auth provider → User profiles: fetches profile (evidence: `satchi-main/src/context/AuthContext.jsx`)
- Login and signup → Auth provider: uses
- Administration → Auth provider: uses (evidence: `satchi-main/src/Pages/Admin.jsx`)
- Administration → API URL config: requests API (evidence: `satchi-main/src/Pages/Admin.jsx`)
- Event browser → API URL config: requests API (evidence: `satchi-main/src/Pages/Events.jsx`)
- Administration → Event operations: manages events (evidence: `README.md`)
- Event browser → Event operations: loads events (evidence: `README.md`)
- Event operations → Event hierarchy: reads and writes (evidence: `satchi_api/events/views.py`)
- Event operations → Role services: promotes managers (evidence: `satchi_api/events/views.py`)
- Project submission → Projects and teams: submits project (evidence: `README.md`)
- Manual team entry → Project submission: renders form (evidence: `satchi-main/src/Pages/ManualTeamEntry.jsx`)
- Manual team entry → API URL config: requests API (evidence: `satchi-main/src/Pages/ManualTeamEntry.jsx`)
- Project API → Projects and teams: reads and writes (evidence: `satchi_api/api/views.py`)
- Project API → Participant linking: synchronizes participants (evidence: `satchi_api/api/views.py`)
- Participant linking → Projects and teams: updates team links (evidence: `satchi_api/api/services.py`)
- Participant linking → User profiles: matches users (evidence: `satchi_api/api/services.py`)
- Judge console → API URL config: requests API (evidence: `satchi-main/src/Pages/Evaluation.jsx`)
- Judge console → Evaluation API: submits scores (evidence: `README.md`)
- Evaluation API → Rubrics and scores: reads and writes (evidence: `satchi_api/eval/views.py`)
- Evaluation API → Projects and teams: loads projects (evidence: `satchi_api/eval/views.py`)
- Evaluation API → Event hierarchy: checks event scope (evidence: `satchi_api/eval/views.py`)
- Operational analytics → API URL config: requests API (evidence: `satchi-main/src/Pages/Statistics.jsx`)
- Operational analytics → Project API: loads analytics (evidence: `README.md`)
- Team management → API URL config: requests API (evidence: `README.md`)
- User management → API URL config: requests API (evidence: `README.md`)
