# pruthviraj07361/code_crafters architecture

> Architecture diagram of the GitHub repository pruthviraj07361/code_crafters, 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/pruthviraj07361/code_crafters
- Repository: https://github.com/pruthviraj07361/code_crafters

## Overview

This is a Django REST backend for a coding-club workflow: users register and gain approved roles, supervisors publish problems and meetings, and approved students submit work and check its status. The graph follows the visible view-to-serializer/model calls and the submission-check command. Authentication wiring and some URL dispatch details are not fully sampled, so those relationships are omitted rather than inferred.

Main entry points: [`submissions/views.py`](https://github.com/pruthviraj07361/code_crafters/blob/main/submissions/views.py) (Student Submission API), [`accounts/api_views.py`](https://github.com/pruthviraj07361/code_crafters/blob/main/accounts/api_views.py) (Account API), [`assignments/views.py`](https://github.com/pruthviraj07361/code_crafters/blob/main/assignments/views.py) (Problem & Meeting API), [`accounts/permissions.py`](https://github.com/pruthviraj07361/code_crafters/blob/main/accounts/permissions.py) (Role Permissions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts &amp; Roles"]
  node_account_api["Account API<br/>[api_views.py]"]
  node_account_views["Account Views<br/>[views.py]"]
  node_role_permissions["Role Permissions<br/>[permissions.py]"]
end

subgraph group_assignments["Problems &amp; Meetings"]
  node_problem_api["Problem &amp; Meeting API<br/>[views.py]"]
end

subgraph group_submissions["Submission Checking"]
  node_submission_api["Student Submission API<br/>[views.py]"]
  node_checker["Pending Submission Checker"]
  node_judge_adapter["Judge0 Adapter<br/>[judge0.py]"]
end

subgraph group_internal["Persistence &amp; Serialization"]
  node_account_data["Account Profiles<br/>[models.py]"]
  node_account_serializers["Account Serializers<br/>[serializers.py]"]
  node_assignment_data["Problems &amp; Meetings<br/>[models.py]"]
  node_assignment_serializers["Assignment Serializers<br/>[serializers.py]"]
  node_submission_data["Submission Records<br/>[models.py]"]
  node_submission_serializers["Submission Serializers<br/>[serializers.py]"]
end

node_student(("Student"))
node_staff(("Staff"))
node_judge0{{"Judge0 Service"}}

node_student -->|"registers or logs in"| node_account_api
node_staff -->|"reviews registrations"| node_account_api
node_account_api -->|"validates data"| node_account_serializers
node_account_api -->|"reads and updates"| node_account_data
node_account_api -->|"checks staff roles"| node_role_permissions
node_account_views -.->|"uses profiles"| node_account_data
node_staff -->|"manages problems and meetings"| node_problem_api
node_student -->|"views problems and meetings"| node_problem_api
node_problem_api -->|"requires role"| node_role_permissions
node_problem_api -->|"validates and formats"| node_assignment_serializers
node_problem_api -->|"reads and writes"| node_assignment_data
node_student -->|"submits and views work"| node_submission_api
node_submission_api -->|"requires approval"| node_role_permissions
node_submission_api -->|"looks up problem"| node_assignment_data
node_submission_api -->|"validates and formats"| node_submission_serializers
node_submission_api -->|"creates and queries"| node_submission_data
node_checker -->|"loads and updates pending"| node_submission_data
node_checker -->|"checks code"| node_judge_adapter
node_judge_adapter -.->|"sends code for checking"| node_judge0

click node_account_api "https://github.com/pruthviraj07361/code_crafters/blob/main/accounts/api_views.py"
click node_account_views "https://github.com/pruthviraj07361/code_crafters/blob/main/accounts/views.py"
click node_role_permissions "https://github.com/pruthviraj07361/code_crafters/blob/main/accounts/permissions.py"
click node_account_data "https://github.com/pruthviraj07361/code_crafters/blob/main/accounts/models.py"
click node_account_serializers "https://github.com/pruthviraj07361/code_crafters/blob/main/accounts/serializers.py"
click node_problem_api "https://github.com/pruthviraj07361/code_crafters/blob/main/assignments/views.py"
click node_assignment_data "https://github.com/pruthviraj07361/code_crafters/blob/main/assignments/models.py"
click node_assignment_serializers "https://github.com/pruthviraj07361/code_crafters/blob/main/assignments/serializers.py"
click node_submission_api "https://github.com/pruthviraj07361/code_crafters/blob/main/submissions/views.py"
click node_submission_data "https://github.com/pruthviraj07361/code_crafters/blob/main/submissions/models.py"
click node_submission_serializers "https://github.com/pruthviraj07361/code_crafters/blob/main/submissions/serializers.py"
click node_checker "https://github.com/pruthviraj07361/code_crafters/blob/main/submissions/management/commands/check_submissions.py"
click node_judge_adapter "https://github.com/pruthviraj07361/code_crafters/blob/main/submissions/judge0.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_account_api,node_account_views,node_role_permissions toneBlue
class node_problem_api toneAmber
class node_submission_api,node_checker,node_judge_adapter toneMint
class node_account_data,node_account_serializers,node_assignment_data,node_assignment_serializers,node_submission_data,node_submission_serializers toneRose
class node_student,node_staff,node_judge0 toneIndigo
```

## Components

### Accounts & Roles

- [Account API](https://github.com/pruthviraj07361/code_crafters/blob/main/accounts/api_views.py): `accounts/api_views.py`
- [Account Views](https://github.com/pruthviraj07361/code_crafters/blob/main/accounts/views.py): `accounts/views.py`
- [Role Permissions](https://github.com/pruthviraj07361/code_crafters/blob/main/accounts/permissions.py): `accounts/permissions.py`

### Problems & Meetings

- [Problem & Meeting API](https://github.com/pruthviraj07361/code_crafters/blob/main/assignments/views.py): `assignments/views.py`

### Submission Checking

- [Student Submission API](https://github.com/pruthviraj07361/code_crafters/blob/main/submissions/views.py): `submissions/views.py`
- [Pending Submission Checker](https://github.com/pruthviraj07361/code_crafters/blob/main/submissions/management/commands/check_submissions.py): `submissions/management/commands/check_submissions.py`
- [Judge0 Adapter](https://github.com/pruthviraj07361/code_crafters/blob/main/submissions/judge0.py): `submissions/judge0.py`

### Persistence & Serialization

- [Account Profiles](https://github.com/pruthviraj07361/code_crafters/blob/main/accounts/models.py): `accounts/models.py`
- [Account Serializers](https://github.com/pruthviraj07361/code_crafters/blob/main/accounts/serializers.py): `accounts/serializers.py`
- [Problems & Meetings](https://github.com/pruthviraj07361/code_crafters/blob/main/assignments/models.py): `assignments/models.py`
- [Assignment Serializers](https://github.com/pruthviraj07361/code_crafters/blob/main/assignments/serializers.py): `assignments/serializers.py`
- [Submission Records](https://github.com/pruthviraj07361/code_crafters/blob/main/submissions/models.py): `submissions/models.py`
- [Submission Serializers](https://github.com/pruthviraj07361/code_crafters/blob/main/submissions/serializers.py): `submissions/serializers.py`

### Other components

- **Student**
- **Staff**
- **Judge0 Service**

## Connections

- Student → Account API: registers or logs in (evidence: `accounts/api_views.py`)
- Staff → Account API: reviews registrations (evidence: `accounts/api_views.py`)
- Account API → Account Serializers: validates data (evidence: `accounts/api_views.py`)
- Account API → Account Profiles: reads and updates (evidence: `accounts/api_views.py`)
- Account API → Role Permissions: checks staff roles (evidence: `accounts/api_views.py`)
- Account Views → Account Profiles: uses profiles
- Staff → Problem & Meeting API: manages problems and meetings (evidence: `assignments/views.py`)
- Student → Problem & Meeting API: views problems and meetings (evidence: `assignments/views.py`)
- Problem & Meeting API → Role Permissions: requires role (evidence: `assignments/views.py`)
- Problem & Meeting API → Assignment Serializers: validates and formats (evidence: `assignments/views.py`)
- Problem & Meeting API → Problems & Meetings: reads and writes (evidence: `assignments/views.py`)
- Student → Student Submission API: submits and views work (evidence: `submissions/views.py`)
- Student Submission API → Role Permissions: requires approval (evidence: `submissions/views.py`)
- Student Submission API → Problems & Meetings: looks up problem (evidence: `submissions/views.py`)
- Student Submission API → Submission Serializers: validates and formats (evidence: `submissions/views.py`)
- Student Submission API → Submission Records: creates and queries (evidence: `submissions/views.py`)
- Pending Submission Checker → Submission Records: loads and updates pending (evidence: `submissions/management/commands/check_submissions.py`)
- Pending Submission Checker → Judge0 Adapter: checks code (evidence: `submissions/management/commands/check_submissions.py`)
- Judge0 Adapter → Judge0 Service: sends code for checking
