# siddanth-dev/nammanotice- architecture

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

- Interactive diagram: https://gitdiagram.com/siddanth-dev/nammanotice-
- Repository: https://github.com/siddanth-dev/nammanotice-

## Overview

NammaNotice is a college-notice and deadline-tracking web app. Students use the browser dashboard to review and filter notices, inspect details, track tasks and deadlines, and upload PDFs; the Flask API serves and updates the underlying SQLite records. The graph separates the browser experience, API/domain operations, document intake, and persistence. README-documented capabilities are included where their exact implementation is not visible; those links are dashed with no evidence path rather than asserting unseen call details.

Main entry points: [`backend/app.py`](https://github.com/siddanth-dev/nammanotice-/blob/main/backend/app.py) (Flask API routes), [`backend/database.py`](https://github.com/siddanth-dev/nammanotice-/blob/main/backend/database.py) (Notice, deadline, task records), [`frontend/script.js`](https://github.com/siddanth-dev/nammanotice-/blob/main/frontend/script.js) (Dashboard and navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Browser dashboard"]
  node_dashboard["Dashboard and navigation<br/>[script.js]"]
  node_notice_views["Notice search and details<br/>[script.js]"]
  node_task_views["Tasks and deadlines<br/>[script.js]"]
  node_pdf_upload_ui["PDF upload UI<br/>[script.js]"]
end

subgraph group_api["Notice and task API"]
  node_api_routes["Flask API routes<br/>[app.py]"]
  node_notice_ops["Notice management<br/>[app.py]"]
  node_task_ops["Task tracking<br/>[app.py]"]
  node_deadline_ops["Deadline management<br/>[app.py]"]
end

subgraph group_documents["PDF intake"]
  node_pdf_processing["PDF processing<br/>[app.py]"]
  node_pdf_files[("Uploaded PDFs<br/>[app.py]")]
end

subgraph group_storage["Persistence"]
  node_db_access["SQLite connection and setup<br/>[database.py]"]
  node_sqlite_store[("Notice, deadline, task records<br/>[database.py]")]
end

node_student(("Student"))

node_student -->|"uses"| node_dashboard
node_dashboard -->|"shows"| node_notice_views
node_dashboard -->|"shows"| node_task_views
node_notice_views -.->|"requests notices"| node_api_routes
node_task_views -->|"updates task status"| node_api_routes
node_pdf_upload_ui -->|"uploads PDF"| node_api_routes
node_api_routes -->|"routes notice requests"| node_notice_ops
node_api_routes -->|"routes task requests"| node_task_ops
node_api_routes -->|"routes PDF upload"| node_pdf_processing
node_notice_ops -->|"gets connection"| node_db_access
node_task_ops -->|"gets connection"| node_db_access
node_pdf_processing -->|"gets connection"| node_db_access
node_db_access -->|"opens"| node_sqlite_store
node_notice_ops -->|"reads and writes"| node_sqlite_store
node_task_ops -->|"reads and writes"| node_sqlite_store
node_pdf_processing -->|"saves uploads"| node_pdf_files
node_pdf_processing -->|"stores notice and text"| node_sqlite_store
node_deadline_ops -.->|"stores deadlines"| node_sqlite_store
node_notice_ops -.->|"manages deadlines"| node_deadline_ops
node_student -->|"selects PDF"| node_pdf_upload_ui

click node_dashboard "https://github.com/siddanth-dev/nammanotice-/blob/main/frontend/script.js"
click node_notice_views "https://github.com/siddanth-dev/nammanotice-/blob/main/frontend/script.js"
click node_task_views "https://github.com/siddanth-dev/nammanotice-/blob/main/frontend/script.js"
click node_pdf_upload_ui "https://github.com/siddanth-dev/nammanotice-/blob/main/frontend/script.js"
click node_api_routes "https://github.com/siddanth-dev/nammanotice-/blob/main/backend/app.py"
click node_notice_ops "https://github.com/siddanth-dev/nammanotice-/blob/main/backend/app.py"
click node_task_ops "https://github.com/siddanth-dev/nammanotice-/blob/main/backend/app.py"
click node_pdf_processing "https://github.com/siddanth-dev/nammanotice-/blob/main/backend/app.py"
click node_pdf_files "https://github.com/siddanth-dev/nammanotice-/blob/main/backend/app.py"
click node_db_access "https://github.com/siddanth-dev/nammanotice-/blob/main/backend/database.py"
click node_sqlite_store "https://github.com/siddanth-dev/nammanotice-/blob/main/backend/database.py"
click node_deadline_ops "https://github.com/siddanth-dev/nammanotice-/blob/main/backend/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_dashboard,node_notice_views,node_task_views,node_pdf_upload_ui toneBlue
class node_api_routes,node_notice_ops,node_task_ops,node_deadline_ops toneAmber
class node_pdf_processing,node_pdf_files toneMint
class node_db_access,node_sqlite_store toneRose
class node_student toneIndigo
```

## Components

### Browser dashboard

- [Dashboard and navigation](https://github.com/siddanth-dev/nammanotice-/blob/main/frontend/script.js): `frontend/script.js`
- [Notice search and details](https://github.com/siddanth-dev/nammanotice-/blob/main/frontend/script.js): `frontend/script.js`
- [Tasks and deadlines](https://github.com/siddanth-dev/nammanotice-/blob/main/frontend/script.js): `frontend/script.js`
- [PDF upload UI](https://github.com/siddanth-dev/nammanotice-/blob/main/frontend/script.js): `frontend/script.js`

### Notice and task API

- [Flask API routes](https://github.com/siddanth-dev/nammanotice-/blob/main/backend/app.py): `backend/app.py`
- [Notice management](https://github.com/siddanth-dev/nammanotice-/blob/main/backend/app.py): `backend/app.py`
- [Task tracking](https://github.com/siddanth-dev/nammanotice-/blob/main/backend/app.py): `backend/app.py`
- [Deadline management](https://github.com/siddanth-dev/nammanotice-/blob/main/backend/app.py): `backend/app.py`

### PDF intake

- [PDF processing](https://github.com/siddanth-dev/nammanotice-/blob/main/backend/app.py): `backend/app.py`
- [Uploaded PDFs](https://github.com/siddanth-dev/nammanotice-/blob/main/backend/app.py): `backend/app.py`

### Persistence

- [SQLite connection and setup](https://github.com/siddanth-dev/nammanotice-/blob/main/backend/database.py): `backend/database.py`
- [Notice, deadline, task records](https://github.com/siddanth-dev/nammanotice-/blob/main/backend/database.py): `backend/database.py`

### Other components

- **Student**

## Connections

- Student → Dashboard and navigation: uses (evidence: `README.md`)
- Dashboard and navigation → Notice search and details: shows (evidence: `frontend/script.js`)
- Dashboard and navigation → Tasks and deadlines: shows (evidence: `frontend/script.js`)
- Notice search and details → Flask API routes: requests notices
- Tasks and deadlines → Flask API routes: updates task status (evidence: `frontend/script.js`)
- PDF upload UI → Flask API routes: uploads PDF (evidence: `frontend/script.js`)
- Flask API routes → Notice management: routes notice requests (evidence: `backend/app.py`)
- Flask API routes → Task tracking: routes task requests (evidence: `backend/app.py`)
- Flask API routes → PDF processing: routes PDF upload (evidence: `backend/app.py`)
- Notice management → SQLite connection and setup: gets connection (evidence: `backend/app.py`)
- Task tracking → SQLite connection and setup: gets connection (evidence: `backend/app.py`)
- PDF processing → SQLite connection and setup: gets connection (evidence: `backend/app.py`)
- SQLite connection and setup → Notice, deadline, task records: opens (evidence: `backend/database.py`)
- Notice management → Notice, deadline, task records: reads and writes (evidence: `backend/app.py`)
- Task tracking → Notice, deadline, task records: reads and writes (evidence: `backend/app.py`)
- PDF processing → Uploaded PDFs: saves uploads (evidence: `backend/app.py`)
- PDF processing → Notice, deadline, task records: stores notice and text (evidence: `backend/app.py`)
- Deadline management → Notice, deadline, task records: stores deadlines (evidence: `backend/app.py`)
- Notice management → Deadline management: manages deadlines (evidence: `backend/app.py`)
- Student → PDF upload UI: selects PDF (evidence: `README.md`)
