How lucasuiii/fudan_icourse_subscriber works
iCourse Subscriber monitors selected Fudan iCourse courses, processes new lecture recordings into transcripts and PPT-derived evidence, produces AI study notes, and emails them per course. The main runtime coordinates authentication, course enumeration, lecture processing, scheduling, persistence, and delivery. The README also documents the encrypted-database browser and optional ASR rescue, glossary, homework-evidence, and shared-queue capabilities. Several of those branches are represented from documentation and source-index references; unsampled implementation details are not inferred.
Main entry points: main.py Run coordinator · lecture_runner.py Lecture processor · ppt_pipeline.py PPT pipeline · summarizer.py AI note generation
Components 30
Runtime orchestration
- Run coordinator
main.py - Session selection
src/runtime/session_rules.py - Resource scheduler
src/runtime/scheduler.py - Run reporting
src/runtime/reporter.py
Course and media access
- WebVPN login
src/api/webvpn.py - iCourse client
src/api/icourse.py
Lecture intelligence
- Lecture processor
src/pipeline/lecture_runner.py - PPT pipeline
src/pipeline/ppt_pipeline.py - PPT OCR
src/ai/ocr.py - Slide deduplication
src/ai/ppt_dedup.py - Transcript routing
src/ai/transcriber.py - Local Qwen ASR
src/ai/qwen_transcriber.py - ASR quality review
scripts/qwen_quality.py - Bounded ASR rescue
src/ai/qwen_review_ledger.py - Cloud ASR rescue
src/ai/doubao_asr.py - Course terminology
src/ai/automatic_glossary.py - Homework evidence
src/pipeline/homework_visual.py - AI note generation
src/ai/summarizer.py
State and delivery
- Encrypted course state
src/data/database.py - Course email delivery
src/api/emailer.py
Encrypted course viewer
- Browser viewer
frontend/js/app.js - Browser database access
frontend/js/db.js - Browser decryption
frontend/js/crypto.js - GitHub access
frontend/js/github.js
Other components
- Subscriber
- Fudan iCourse
- Configured LLM provider
- Seed-ASR service
- SMTP service
- GitHub repository
Connections 38
- Subscriber → Run coordinator: starts run
README.md - Run coordinator → Session selection: filters lectures
main.py - Run coordinator → WebVPN login: authenticates via
main.py - Run coordinator → iCourse client: enumerates courses
main.py - WebVPN login → Fudan iCourse: logs in through
src/api/webvpn.py - iCourse client → Fudan iCourse: fetches course media
README.md - Run coordinator → Lecture processor: processes lectures
main.py - Run coordinator → Encrypted course state: tracks progress
main.py - Run coordinator → Resource scheduler: coordinates resources
main.py - Run coordinator → Run reporting: reports status
main.py - Run coordinator → Course email delivery: sends course notes
main.py - Lecture processor → Transcript routing: transcribes audio
src/pipeline/lecture_runner.py - Lecture processor → PPT pipeline: starts slide processing
src/pipeline/lecture_runner.py - Lecture processor → AI note generation: generates notes
src/pipeline/lecture_runner.py - Lecture processor → Encrypted course state: saves lecture state
src/pipeline/lecture_runner.py - Lecture processor → Resource scheduler: schedules media work
src/pipeline/lecture_runner.py - Lecture processor → Bounded ASR rescue: reviews ASR evidence
src/pipeline/lecture_runner.py - Lecture processor → Course terminology: loads course terms
src/pipeline/lecture_runner.py - Lecture processor → Homework evidence: assembles homework evidence
README.md - PPT pipeline → iCourse client: fetches slide images
src/pipeline/ppt_pipeline.py - PPT pipeline → PPT OCR: submits pages for OCR
src/pipeline/ppt_pipeline.py - PPT pipeline → Slide deduplication: deduplicates slides
src/pipeline/ppt_pipeline.py - PPT pipeline → Encrypted course state: stores page status
src/pipeline/ppt_pipeline.py - PPT pipeline → Resource scheduler: uses worker pools
src/pipeline/ppt_pipeline.py - Transcript routing → Local Qwen ASR: uses local recognizer
src/ai/transcriber.py - Local Qwen ASR → ASR quality review: checks recognition quality
src/ai/qwen_transcriber.py - Bounded ASR rescue → ASR quality review: selects review candidates
src/ai/qwen_review_ledger.py - Bounded ASR rescue → Cloud ASR rescue: requests bounded rescue
src/ai/qwen_review_ledger.py - Cloud ASR rescue → Seed-ASR service: recognizes selected clips
README.md - AI note generation → Configured LLM provider: requests note generation
README.md - AI note generation → Course terminology: uses course terms
src/ai/summarizer.py - AI note generation → Homework evidence: uses assignment evidence
src/ai/summarizer.py - Course email delivery → SMTP service: delivers course email
README.md - Subscriber → Browser viewer: browses course notes
README.md - Browser viewer → Browser database access: loads database content
README.md - Browser database access → Browser decryption: decrypts database
README.md - Browser viewer → GitHub access: uses repository access
- GitHub access → GitHub repository: accesses repository