How mostafawahiep/codearc works
CodeArc delivers versioned programming challenges through a VS Code extension backed by a Flask progression API. Learners browse challenges, start or resume attempts, edit starter projects, run local tests, and submit results so the backend can advance level progress. The graph separates extension experience, backend API/services, challenge packages, and persistence/domain layers. Backend API handler internals and extension activation wiring were not sampled; those connections are shown only where documented or marked unverified.
Main entry points: HttpBackendClient.ts HTTP Backend Client · file_challenge_repository.py Challenge Package Loader · container.py Application Wiring · ChallengeViewProvider.ts Challenge Experience
Components 25
VS Code Extension
- Challenge Experience
extension/src/views/ChallengeViewProvider.ts - Attempt Session
extension/src/application/AttemptSession.ts - Attempt Catalog
extension/src/application/AttemptCatalog.ts - Challenge Catalog
extension/src/application/ChallengeCatalog.ts - Learner Workspace
extension/src/infrastructure/LearnerWorkspaceService.ts - Local Test Runner
extension/src/application/LocalTestRunner.ts - Pytest Execution
extension/src/infrastructure/PytestRunner.ts - HTTP Backend Client
extension/src/backend/HttpBackendClient.ts
Backend Services
- Attempt Progression
backend/app/services/attempt_service.py - Challenge Catalog Service
backend/app/services/challenge_service.py - Attempt API
backend/app/api/v1/attempt.py - Challenge API
backend/app/api/v1/challenge.py - Application Wiring
backend/app/container.py
Challenge Packages
- Versioned Challenge Content
challenges/search-engine/v1 - Shared Contracts
shared/src/challenge.ts
Domain and Persistence
- Challenge Repository
backend/app/repositories/challenge_repository.py - Challenge Package Loader
backend/app/infrastructure/file_challenge_repository.py - Manifest Validation
backend/app/validation/manifest_validator.py - Attempt Repository
backend/app/repositories/attempt_repository.py - SQL Attempt Storage
backend/app/infrastructure/sqlalchemy_attempt_repository.py - Attempt Database
backend/app/infrastructure/database/attempt_models.py - Challenge and Level Models
backend/app/domain/challenge.py - Attempt Model
backend/app/domain/attempt.py
Other components
- Learner
- VS Code
Connections 31
- Learner → Challenge Experience: uses
README.md - Challenge Experience → Attempt Session: delegates to
extension/src/views/ChallengeViewProvider.ts - Challenge Experience → Attempt Catalog: loads attempts
extension/src/views/ChallengeViewProvider.ts - Challenge Experience → Challenge Catalog: loads challenges
extension/src/views/ChallengeViewProvider.ts - Attempt Session → Local Test Runner: runs tests
extension/src/application/AttemptSession.ts - Attempt Session → Learner Workspace: manages workspace
extension/src/views/ChallengeViewProvider.ts - Attempt Session → HTTP Backend Client: requests backend
extension/src/application/AttemptSession.ts - Attempt Catalog → HTTP Backend Client: requests backend
extension/src/application/AttemptCatalog.ts - Challenge Catalog → HTTP Backend Client: requests backend
extension/src/application/ChallengeCatalog.ts - Local Test Runner → Pytest Execution: executes tests
- Learner Workspace → HTTP Backend Client: fetches starter files
extension/src/infrastructure/LearnerWorkspaceService.ts - HTTP Backend Client → Attempt API: HTTP requests
- HTTP Backend Client → Challenge API: HTTP requests
- Attempt API → Attempt Progression: dispatches
- Challenge API → Challenge Catalog Service: dispatches
- Attempt Progression → Attempt Repository: reads and writes
backend/app/services/attempt_service.py - Attempt Progression → Challenge Repository: loads challenge data
backend/app/services/attempt_service.py - Challenge Catalog Service → Challenge Repository: loads challenge data
backend/app/services/challenge_service.py - Application Wiring → Attempt Progression: configures
backend/app/container.py - Application Wiring → Challenge Catalog Service: configures
backend/app/container.py - Application Wiring → Challenge Package Loader: configures
backend/app/container.py - Application Wiring → SQL Attempt Storage: configures
backend/app/container.py - Challenge Package Loader → Manifest Validation: validates manifests
backend/app/infrastructure/file_challenge_repository.py - Challenge Package Loader → Challenge and Level Models: loads definitions
backend/app/infrastructure/file_challenge_repository.py - Challenge Repository → Challenge Package Loader: implemented by
backend/app/infrastructure/file_challenge_repository.py - Attempt Repository → SQL Attempt Storage: implemented by
backend/app/infrastructure/sqlalchemy_attempt_repository.py - SQL Attempt Storage → Attempt Database: maps and persists
backend/app/infrastructure/sqlalchemy_attempt_repository.py - SQL Attempt Storage → Attempt Model: maps attempts
backend/app/infrastructure/sqlalchemy_attempt_repository.py - Versioned Challenge Content → Challenge Package Loader: loaded from packages
- Shared Contracts → HTTP Backend Client: defines contracts
- VS Code → Learner Workspace: hosts workspace
extension/src/infrastructure/LearnerWorkspaceService.ts