How kunalpec/check-paper works
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 Streamlit app · db.py Database access · gemini_service.py Gemini extraction · record_management.py Record management
Components 17
Teacher workflow
- Streamlit app
app.py - Teacher sign-in
app.py - Paper setup
app.py - Solution setup
app.py - Student assignment
app.py - Submission review
app.py
Documents and AI
- PDF rendering
services/pdf_service.py - Gemini extraction
services/gemini_service.py - Gemini grading
services/gemini_service.py
Records and persistence
- Record management
services/record_management.py - Database access
database/db.py - SQLite database
Review and reporting
- Evaluation review
app.py - PDF report generation
services/report_service.py - Report download
app.py
Other components
- Teacher
- Gemini API
Connections 19
- Teacher → Streamlit app: uses
README.md - Streamlit app → Teacher sign-in: presents
README.md - Streamlit app → Paper setup: presents
README.md - Streamlit app → Solution setup: presents
README.md - Streamlit app → Student assignment: presents
README.md - Streamlit app → Submission review: presents
README.md - Streamlit app → PDF rendering: renders PDFs
README.md - Streamlit app → Gemini extraction: requests extraction
README.md - Streamlit app → Gemini grading: requests grading
README.md - Gemini extraction → Gemini API: calls
services/gemini_service.py - Gemini grading → Gemini API: calls
services/gemini_service.py - Streamlit app → Record management: delegates updates
app.py - Streamlit app → Database access: uses
app.py - Database access → SQLite database: reads and writes
database/db.py - Record management → Database access: reads and writes
services/record_management.py - Streamlit app → Evaluation review: presents results
README.md - Streamlit app → PDF report generation: generates report
README.md - Streamlit app → Report download: offers download
README.md - Report download → PDF report generation: downloads PDF
app.py