How binah-dev/cf-compass works
CF Compass is a desktop Codeforces training system that closes the loop from public-data sync and problem selection through practice, review, and contest analysis. The renderer presents the workflow; shared domain logic computes training and review insights, while Electron’s main process provides persistence and service-backed capabilities. Major README features are represented even where implementation excerpts were unavailable; those documented links cite the README rather than implying that unsampled code was inspected.
Main entry points: main.cjs Electron service host · ContestReplayPage.jsx Contest replay · App.jsx Application shell · ai-service.cjs AI review
Components 31
Desktop experience
- Application shell
src/App.jsx - Problem workspace
src/components/ProblemWorkspace.jsx
Training and review
- Today training
src/components/TodayTraining.jsx - Training recommendations
src/lib/planning.js - Training profile
electron/shared/training-profile.mjs - Review library
src/components/ReviewLibrary.jsx - Review and timeline
src/lib/review.js - Submission statistics
src/lib/stats.js
Contest analysis
- Contest replay
src/components/ContestReplayPage.jsx - Contest center
src/components/ContestCenterPage.jsx - Custom training
src/components/CustomTraining.jsx - AI review
electron/services/ai-service.cjs - Contest recommendations
electron/services/contest-recommendation-service.cjs
Data and services
- Electron service host
electron/main.cjs - Renderer bridge
electron/preload.cjs - Codeforces data client
src/lib/codeforces.js - Codeforces transport
electron/shared/codeforces-transport.mjs - Contest sessions
electron/services/contest-session.cjs - Virtual scoring
electron/services/virtual-score.cjs - Combined rating
electron/services/combined-rating-service.cjs - Local learning data
electron/services/atomic-json.cjs
Personal workspace
- Goal list and notes
src/components/PlanQueueButton.jsx - Study plan service
electron/services/study-plan-service.cjs - Study timer
src/components/StudyTimerWindow.jsx - Timer service
electron/services/study-timer-service.cjs - Template library
src/components/TemplateLibrary.jsx - Appearance and workbench
src/components/AppearanceDrawer.jsx - Application updates
electron/services/app-update-service.cjs
Other components
- Learner
- Optional AI provider
- Codeforces API
Connections 40
- Learner → Application shell: uses
README.md - Application shell → Problem workspace: presents
src/App.jsx - Problem workspace → Codeforces data client: opens problems
README.md - Application shell → Today training: presents
README.md - Today training → Training recommendations: requests recommendations
README.md - Training recommendations → Training profile: uses profile
src/lib/planning.js - Training recommendations → Submission statistics: uses performance
src/lib/planning.js - Codeforces data client → Codeforces transport: fetches data
src/lib/codeforces.js - Codeforces transport → Codeforces API: requests API
- Learner → Review library: reviews work
README.md - Review library → Review and timeline: builds views
src/components/ReviewLibrary.jsx - Review and timeline → Submission statistics: uses statistics
src/lib/review.js - Learner → Contest center: browses contests
README.md - Contest center → Codeforces data client: syncs public data
README.md - Learner → Contest replay: reviews contest
README.md - Contest replay → Contest sessions: uses session evidence
README.md - Contest replay → Virtual scoring: shows virtual estimate
README.md - Contest replay → Combined rating: shows combined estimate
README.md - Contest replay → AI review: requests draft
README.md - AI review → Contest sessions: reads contest session
electron/services/ai-service.cjs - AI review → Contest recommendations: builds candidates
electron/services/ai-service.cjs - AI review → Optional AI provider: sends review request
README.md - Learner → Custom training: sets up practice
README.md - Custom training → Electron service host: starts session
- Application shell → Electron service host: requests desktop services
- Electron service host → Renderer bridge: exposes bridge
- Electron service host → Local learning data: persists data
electron/main.cjs - Electron service host → Contest sessions: uses session service
electron/main.cjs - Electron service host → Virtual scoring: uses scoring
electron/main.cjs - Electron service host → Combined rating: creates rating service
electron/main.cjs - Learner → Goal list and notes: manages goals
README.md - Goal list and notes → Electron service host: adds planned problem
- Electron service host → Study plan service: serves study plan
electron/main.cjs - Learner → Study timer: uses timer
README.md - Study timer → Timer service: controls timer
- Electron service host → Timer service: registers timer service
electron/main.cjs - Learner → Template library: browses templates
README.md - Learner → Appearance and workbench: customizes workspace
README.md - Learner → Application updates: checks updates
README.md - Electron service host → Application updates: registers update service
electron/main.cjs