How moevm/document_insight_system works
This Flask application accepts presentation and report files, runs asynchronous checks, and exposes results to users and API clients. The main workflow is upload → persist file/check metadata → optional PDF conversion → parse → execute configured criteria → persist and retrieve results. The tree also shows account and criterion-pack management, LTI grade passback, and NLP helpers. The task and upload excerpts support the central processing edges; other branches are included where the index or README identifies capabilities, with unverified wiring left out.
Main entry points: server.py Flask server · app/tasks.py Celery task worker · check.py Check records · routes/tasks.py Upload and task routes
Components 21
Web interface
- Flask server
app/server.py - Upload and task routes
app/routes/tasks.py - Results routes
app/routes/results.py - API routes
app/routes/api.py - Account and admin routes
app/routes
Check processing
- Celery task worker
app/tasks.py - Document parser
app/main/parser.py - Presentation readers
app/main/presentations - Report readers
app/main/reports
Analysis
- Check orchestrator
app/main/checker.py - Criterion packs
app/main/check_packs/base_criterion_pack.py - Presentation checks
app/main/checks/presentation_checks - Report checks
app/main/checks/report_checks - NLP helpers
app/nlp
Persistence
- File metadata and content
app/db/methods/file.py - Check records
app/db/methods/check.py - MongoDB and GridFS
app/db/methods/client.py - Account and pack setup
app/servants/pre_luncher.py
External integrations
- LTI validation and passback
app/lti_session_passback
Other components
- User
- LMS
Connections 27
- User → Flask server: sends requests
app/server.py - Flask server → Upload and task routes: registers routes
app/server.py - Flask server → Results routes: registers routes
app/server.py - Flask server → API routes: registers routes
app/server.py - Flask server → Account and admin routes: registers routes
app/server.py - Upload and task routes → File metadata and content: saves upload
app/routes/tasks.py - Upload and task routes → Check records: creates check
app/routes/tasks.py - Upload and task routes → Celery task worker: dispatches task
app/routes/tasks.py - Celery task worker → Document parser: parses file
app/tasks.py - Celery task worker → Check orchestrator: runs checks
app/tasks.py - Celery task worker → Check records: saves result
app/tasks.py - Celery task worker → File metadata and content: converts PDF
app/tasks.py - Document parser → Presentation readers: selects reader
app/main/parser.py - Document parser → Report readers: selects reader
app/main/parser.py - Check orchestrator → Criterion packs: uses criteria
- Check orchestrator → Presentation checks: runs criteria
- Check orchestrator → Report checks: runs criteria
- Presentation checks → NLP helpers: uses text analysis
app/main/checks/presentation_checks/find_tasks.py - Report checks → NLP helpers: uses similarity
app/main/checks/report_checks/compare_tasks_and_content.py - Results routes → Check records: reads results
app/routes/results.py - API routes → Check records: accesses checks
app/routes/api.py - File metadata and content → MongoDB and GridFS: reads and writes
app/db/methods/file.py - Check records → MongoDB and GridFS: reads and writes
app/db/methods/check.py - Account and pack setup → MongoDB and GridFS: checks connection
app/servants/pre_luncher.py - Account and pack setup → Criterion packs: loads base packs
app/servants/pre_luncher.py - Flask server → LTI validation and passback: loads LTI utilities
app/server.py - LTI validation and passback → LMS: passes grades