Skip to content

docs: update backend spec for scheduler/worker/orchestrator architecture#324

Draft
Blackgaurd wants to merge 1 commit into04-17-refactor_replace__build_recursive_with_orchestratorfrom
04-17-docs_update_backend_spec_for_scheduler_worker_orchestrator_architecture
Draft

docs: update backend spec for scheduler/worker/orchestrator architecture#324
Blackgaurd wants to merge 1 commit into04-17-refactor_replace__build_recursive_with_orchestratorfrom
04-17-docs_update_backend_spec_for_scheduler_worker_orchestrator_architecture

Conversation

@Blackgaurd
Copy link
Copy Markdown
Collaborator

@Blackgaurd Blackgaurd commented Apr 17, 2026

Updates SPEC-backend.md to document the new scheduler/worker/orchestrator build architecture.

What changed

  • New "Build architecture: scheduler / worker / orchestrator" section documenting:
    • Scheduler: DFS graph collection + Kahn's algorithm for topological ordering
    • Worker: single-job execution with per-dataset locking and atomicity
    • Orchestrator: level-by-level plan execution with barrier model
    • Data types: `JobDescriptor`, `JobResult`, `BuildPlan`
    • Commit-per-level model
  • Updated directory layout to include new service modules (`scheduler.py`, `worker.py`, `orchestrator.py`, `models.py`, `timestamps.py`, `locks.py`)
  • Updated atomicity section: per-job atomicity with per-level commit
  • Updated build concurrency section: lock scope now in `execute_job()`, deadlock safety guaranteed by startup DAG validation + topological execution order
  • Updated logging section: split across scheduler, orchestrator, worker
  • Updated calendar integration: `generate_timestamps()` now in `service/timestamps.py`

🤖 Generated with Claude Code

Copy link
Copy Markdown
Collaborator Author

Blackgaurd commented Apr 17, 2026

@Blackgaurd Blackgaurd force-pushed the 04-17-docs_update_backend_spec_for_scheduler_worker_orchestrator_architecture branch from 57f6e46 to a0e9d65 Compare April 18, 2026 00:06
@Blackgaurd Blackgaurd force-pushed the 04-17-refactor_replace__build_recursive_with_orchestrator branch from 6fdc1a6 to 4a73650 Compare April 18, 2026 00:06
@Blackgaurd Blackgaurd force-pushed the 04-17-refactor_replace__build_recursive_with_orchestrator branch from 4a73650 to 4aebc80 Compare April 25, 2026 04:18
@Blackgaurd Blackgaurd force-pushed the 04-17-docs_update_backend_spec_for_scheduler_worker_orchestrator_architecture branch from a0e9d65 to 29c1644 Compare April 25, 2026 04:18
@Blackgaurd Blackgaurd force-pushed the 04-17-refactor_replace__build_recursive_with_orchestrator branch from 4aebc80 to 06c0672 Compare April 25, 2026 04:24
@Blackgaurd Blackgaurd force-pushed the 04-17-docs_update_backend_spec_for_scheduler_worker_orchestrator_architecture branch from 29c1644 to 62a424e Compare April 25, 2026 04:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant