# kunalpec/check-paper architecture

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

- Interactive diagram: https://gitdiagram.com/kunalpec/check-paper
- Repository: https://github.com/kunalpec/check-paper

## Overview

This is a local Streamlit grading portal for teachers. The workflow runs through teacher sign-in, paper and solution setup, student assignment, answer-sheet upload, AI extraction and grading, teacher review, and reporting. The app coordinates PDF rendering, Gemini, SQLite persistence, and report generation; record-management helpers handle updates and deletions. The README documents several workflow details not visible in the sampled app excerpts, so those links are cited to it rather than treated as inspected implementation.

Main entry points: [`app.py`](https://github.com/kunalpec/check-paper/blob/main/app.py) (Streamlit app), [`database/db.py`](https://github.com/kunalpec/check-paper/blob/main/database/db.py) (Database access), [`services/gemini_service.py`](https://github.com/kunalpec/check-paper/blob/main/services/gemini_service.py) (Gemini extraction), [`services/record_management.py`](https://github.com/kunalpec/check-paper/blob/main/services/record_management.py) (Record management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_teacher_workflow["Teacher workflow"]
  node_streamlit_app["Streamlit app<br/>[app.py]"]
  node_teacher_signin["Teacher sign-in<br/>[app.py]"]
  node_paper_setup["Paper setup<br/>[app.py]"]
  node_solution_setup["Solution setup<br/>[app.py]"]
  node_student_assignment["Student assignment<br/>[app.py]"]
  node_submission_review["Submission review<br/>[app.py]"]
end

subgraph group_documents_ai["Documents and AI"]
  node_pdf_rendering["PDF rendering<br/>[pdf_service.py]"]
  node_gemini_extraction["Gemini extraction<br/>[gemini_service.py]"]
  node_gemini_grading["Gemini grading<br/>[gemini_service.py]"]
end

subgraph group_records["Records and persistence"]
  node_record_management["Record management"]
  node_database_access["Database access<br/>[db.py]"]
  node_sqlite[("SQLite database")]
end

subgraph group_results["Review and reporting"]
  node_evaluation_review["Evaluation review<br/>[app.py]"]
  node_report_service["PDF report generation<br/>[report_service.py]"]
  node_report_download["Report download<br/>[app.py]"]
end

node_teacher(("Teacher"))
node_gemini_service{{"Gemini API"}}

node_teacher -->|"uses"| node_streamlit_app
node_streamlit_app -->|"presents"| node_teacher_signin
node_streamlit_app -->|"presents"| node_paper_setup
node_streamlit_app -->|"presents"| node_solution_setup
node_streamlit_app -->|"presents"| node_student_assignment
node_streamlit_app -->|"presents"| node_submission_review
node_streamlit_app -->|"renders PDFs"| node_pdf_rendering
node_streamlit_app -->|"requests extraction"| node_gemini_extraction
node_streamlit_app -->|"requests grading"| node_gemini_grading
node_gemini_extraction -->|"calls"| node_gemini_service
node_gemini_grading -->|"calls"| node_gemini_service
node_streamlit_app -->|"delegates updates"| node_record_management
node_streamlit_app -->|"uses"| node_database_access
node_database_access -->|"reads and writes"| node_sqlite
node_record_management -->|"reads and writes"| node_database_access
node_streamlit_app -->|"presents results"| node_evaluation_review
node_streamlit_app -->|"generates report"| node_report_service
node_streamlit_app -->|"offers download"| node_report_download
node_report_download -->|"downloads PDF"| node_report_service

click node_streamlit_app "https://github.com/kunalpec/check-paper/blob/main/app.py"
click node_teacher_signin "https://github.com/kunalpec/check-paper/blob/main/app.py"
click node_paper_setup "https://github.com/kunalpec/check-paper/blob/main/app.py"
click node_solution_setup "https://github.com/kunalpec/check-paper/blob/main/app.py"
click node_student_assignment "https://github.com/kunalpec/check-paper/blob/main/app.py"
click node_submission_review "https://github.com/kunalpec/check-paper/blob/main/app.py"
click node_pdf_rendering "https://github.com/kunalpec/check-paper/blob/main/services/pdf_service.py"
click node_gemini_extraction "https://github.com/kunalpec/check-paper/blob/main/services/gemini_service.py"
click node_gemini_grading "https://github.com/kunalpec/check-paper/blob/main/services/gemini_service.py"
click node_record_management "https://github.com/kunalpec/check-paper/blob/main/services/record_management.py"
click node_database_access "https://github.com/kunalpec/check-paper/blob/main/database/db.py"
click node_evaluation_review "https://github.com/kunalpec/check-paper/blob/main/app.py"
click node_report_service "https://github.com/kunalpec/check-paper/blob/main/services/report_service.py"
click node_report_download "https://github.com/kunalpec/check-paper/blob/main/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_streamlit_app,node_teacher_signin,node_paper_setup,node_solution_setup,node_student_assignment,node_submission_review toneBlue
class node_pdf_rendering,node_gemini_extraction,node_gemini_grading toneAmber
class node_record_management,node_database_access,node_sqlite,node_gemini_service toneMint
class node_evaluation_review,node_report_service,node_report_download toneRose
class node_teacher toneIndigo
```

## Components

### Teacher workflow

- [Streamlit app](https://github.com/kunalpec/check-paper/blob/main/app.py): `app.py`
- [Teacher sign-in](https://github.com/kunalpec/check-paper/blob/main/app.py): `app.py`
- [Paper setup](https://github.com/kunalpec/check-paper/blob/main/app.py): `app.py`
- [Solution setup](https://github.com/kunalpec/check-paper/blob/main/app.py): `app.py`
- [Student assignment](https://github.com/kunalpec/check-paper/blob/main/app.py): `app.py`
- [Submission review](https://github.com/kunalpec/check-paper/blob/main/app.py): `app.py`

### Documents and AI

- [PDF rendering](https://github.com/kunalpec/check-paper/blob/main/services/pdf_service.py): `services/pdf_service.py`
- [Gemini extraction](https://github.com/kunalpec/check-paper/blob/main/services/gemini_service.py): `services/gemini_service.py`
- [Gemini grading](https://github.com/kunalpec/check-paper/blob/main/services/gemini_service.py): `services/gemini_service.py`

### Records and persistence

- [Record management](https://github.com/kunalpec/check-paper/blob/main/services/record_management.py): `services/record_management.py`
- [Database access](https://github.com/kunalpec/check-paper/blob/main/database/db.py): `database/db.py`
- **SQLite database**

### Review and reporting

- [Evaluation review](https://github.com/kunalpec/check-paper/blob/main/app.py): `app.py`
- [PDF report generation](https://github.com/kunalpec/check-paper/blob/main/services/report_service.py): `services/report_service.py`
- [Report download](https://github.com/kunalpec/check-paper/blob/main/app.py): `app.py`

### Other components

- **Teacher**
- **Gemini API**

## Connections

- Teacher → Streamlit app: uses (evidence: `README.md`)
- Streamlit app → Teacher sign-in: presents (evidence: `README.md`)
- Streamlit app → Paper setup: presents (evidence: `README.md`)
- Streamlit app → Solution setup: presents (evidence: `README.md`)
- Streamlit app → Student assignment: presents (evidence: `README.md`)
- Streamlit app → Submission review: presents (evidence: `README.md`)
- Streamlit app → PDF rendering: renders PDFs (evidence: `README.md`)
- Streamlit app → Gemini extraction: requests extraction (evidence: `README.md`)
- Streamlit app → Gemini grading: requests grading (evidence: `README.md`)
- Gemini extraction → Gemini API: calls (evidence: `services/gemini_service.py`)
- Gemini grading → Gemini API: calls (evidence: `services/gemini_service.py`)
- Streamlit app → Record management: delegates updates (evidence: `app.py`)
- Streamlit app → Database access: uses (evidence: `app.py`)
- Database access → SQLite database: reads and writes (evidence: `database/db.py`)
- Record management → Database access: reads and writes (evidence: `services/record_management.py`)
- Streamlit app → Evaluation review: presents results (evidence: `README.md`)
- Streamlit app → PDF report generation: generates report (evidence: `README.md`)
- Streamlit app → Report download: offers download (evidence: `README.md`)
- Report download → PDF report generation: downloads PDF (evidence: `app.py`)
