# drajdeep/flask-based-submission-portal-for-iem-kolkata architecture

> Architecture diagram of the GitHub repository drajdeep/flask-based-submission-portal-for-iem-kolkata, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/drajdeep/flask-based-submission-portal-for-iem-kolkata
- Repository: https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata

## Overview

This Flask portal collects student assignment files and metadata, organizes submissions by date and academic stream, and gives authenticated administrators statistics and bulk-download tools. The main flow is student form submission → validation and storage/logging → confirmation; the admin flow is login → review logged submissions → download ZIP archives. README capabilities supply several relationships not visible in the partial application excerpt, so those links cite the README; implementation details beyond the excerpt are not inferred.

Main entry points: [`portal/app.py`](https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/app.py) (Submission handler), [`portal/templates/index.html`](https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/templates/index.html) (Submission form), [`portal/templates/success.html`](https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/templates/success.html) (Receipt page), [`portal/templates/admin.html`](https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/templates/admin.html) (Admin dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_submission["Student submissions"]
  node_submission_flow["Submission handler<br/>[app.py]"]
  node_submission_form["Submission form<br/>[index.html]"]
  node_confirmation["Receipt page<br/>[success.html]"]
end

subgraph group_storage["Submission storage"]
  node_file_storage[("Uploaded files<br/>[app.py]")]
  node_submission_logs[("Stream CSV logs<br/>[app.py]")]
end

subgraph group_administration["Administration"]
  node_admin_flow["Admin routes<br/>[app.py]"]
  node_admin_dashboard["Admin dashboard<br/>[admin.html]"]
  node_archive_download["ZIP downloads<br/>[app.py]"]
end

node_student(("Student"))
node_administrator(("Administrator"))

node_student -->|"opens"| node_submission_form
node_submission_form -->|"submits details"| node_submission_flow
node_submission_flow -->|"stores files"| node_file_storage
node_submission_flow -->|"records metadata"| node_submission_logs
node_submission_flow -->|"renders receipt"| node_confirmation
node_administrator -->|"requests admin"| node_admin_flow
node_admin_flow -->|"reads entries"| node_submission_logs
node_admin_flow -->|"renders dashboard"| node_admin_dashboard
node_administrator -->|"requests archive"| node_archive_download
node_archive_download -->|"packages submissions"| node_file_storage
node_archive_download -->|"includes logs"| node_submission_logs

click node_submission_flow "https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/app.py"
click node_submission_form "https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/templates/index.html"
click node_confirmation "https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/templates/success.html"
click node_file_storage "https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/app.py"
click node_submission_logs "https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/app.py"
click node_admin_flow "https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/app.py"
click node_admin_dashboard "https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/templates/admin.html"
click node_archive_download "https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/app.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_submission_flow,node_submission_form,node_confirmation toneBlue
class node_file_storage,node_submission_logs toneAmber
class node_admin_flow,node_admin_dashboard,node_archive_download toneMint
class node_student,node_administrator toneIndigo
```

## Components

### Student submissions

- [Submission handler](https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/app.py): `portal/app.py`
- [Submission form](https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/templates/index.html): `portal/templates/index.html`
- [Receipt page](https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/templates/success.html): `portal/templates/success.html`

### Submission storage

- [Uploaded files](https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/app.py): `portal/app.py`
- [Stream CSV logs](https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/app.py): `portal/app.py`

### Administration

- [Admin routes](https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/app.py): `portal/app.py`
- [Admin dashboard](https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/templates/admin.html): `portal/templates/admin.html`
- [ZIP downloads](https://github.com/drajdeep/flask-based-submission-portal-for-iem-kolkata/blob/main/portal/app.py): `portal/app.py`

### Other components

- **Student**
- **Administrator**

## Connections

- Student → Submission form: opens (evidence: `README.md`)
- Submission form → Submission handler: submits details (evidence: `README.md`)
- Submission handler → Uploaded files: stores files (evidence: `README.md`)
- Submission handler → Stream CSV logs: records metadata (evidence: `README.md`)
- Submission handler → Receipt page: renders receipt (evidence: `portal/app.py`)
- Administrator → Admin routes: requests admin (evidence: `README.md`)
- Admin routes → Stream CSV logs: reads entries (evidence: `portal/app.py`)
- Admin routes → Admin dashboard: renders dashboard (evidence: `portal/app.py`)
- Administrator → ZIP downloads: requests archive (evidence: `README.md`)
- ZIP downloads → Uploaded files: packages submissions (evidence: `portal/app.py`)
- ZIP downloads → Stream CSV logs: includes logs (evidence: `portal/app.py`)
