Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
36 commits
Select commit Hold shift + click to select a range
ac30f32
docs: clarify Planner physical plan and SDS architecture
zzylol Sep 17, 2026
af61296
docs: specify executable subplan materialization boundaries
zzylol Sep 18, 2026
e868424
docs: scope migration to backend precompute and query plans
zzylol Sep 18, 2026
daa5281
docs: clarify window terminology migration
zzylol Sep 18, 2026
e27bbb0
Revert "docs: clarify window terminology migration"
zzylol Sep 18, 2026
2230795
docs: focus physical plan and SDS designs
zzylol Sep 18, 2026
3f1830d
docs: add physical compiler input example
zzylol Sep 18, 2026
dd0a8b4
docs: add physical compiler output example
zzylol Sep 18, 2026
c1fbfb6
docs: include query expression in compiler example
zzylol Sep 18, 2026
887c526
docs: reorganize physical plan integration design
zzylol Sep 18, 2026
b8193bb
docs: reorganize SDS and migration designs
zzylol Sep 18, 2026
b24867b
docs: define maintenance inputs before plan split example
zzylol Sep 18, 2026
b358074
docs: use plan version consistently in backend design
zzylol Sep 18, 2026
7e4655a
docs: remove standalone catalog materialization abstraction
zzylol Sep 18, 2026
07580f8
docs: add concise planner backend glossary
zzylol Sep 18, 2026
ac855b2
docs: clarify selected deployment guarantee terminology
zzylol Sep 21, 2026
ea3226c
docs: explain missing planner maintenance guarantee
zzylol Sep 21, 2026
118e363
docs: motivate selected producer maintenance decision
zzylol Sep 21, 2026
1effeb5
docs: label catalog reads and SDS metadata ownership
zzylol Sep 21, 2026
ddc50e2
docs: align SDS ownership and lifecycle terminology
zzylol Sep 21, 2026
8e6d244
Merge main into docs design proposal
zzylol Sep 21, 2026
3c273ed
docs: use current planner and plan-version names consistently
zzylol Sep 21, 2026
1f0b4df
docs: align integration diagram with SDS ownership
zzylol Sep 21, 2026
5ceefb7
docs: clarify instance identity and shared producer wording
zzylol Sep 21, 2026
32de737
docs: distinguish summary definitions from runtime stores
zzylol Sep 22, 2026
be97173
docs: model one runtime summary store for DAG bindings
zzylol Sep 22, 2026
71157f4
docs: scope SDS lifecycle to read eligibility
zzylol Sep 22, 2026
d9fff69
docs: tie stored summary examples directly to DAG outputs
zzylol Sep 22, 2026
00e68cd
docs: name summary tables, stored records, and output references by role
zzylol Sep 22, 2026
073daa2
docs: illustrate summary definitions, stored records, and output refe…
zzylol Sep 22, 2026
edaf750
docs: limit v1 summary storage to definitions and stored summaries
zzylol Sep 22, 2026
55e4780
Merge remote-tracking branch 'origin/main' into stack/requested-737
zzylol Sep 22, 2026
ee71eca
Merge Planner selection baseline and require migration without legacy…
zzylol Sep 23, 2026
61a4a3c
Merge branch 'refactor/planner-selection-api' into stack/planner-api-737
zzylol Sep 23, 2026
5ed60fc
Merge branch 'refactor/planner-selection-api' into stack/planner-api-737
zzylol Sep 23, 2026
61e0c14
Merge branch 'refactor/planner-selection-api' into stack/planner-api-737
zzylol Sep 23, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 24 additions & 21 deletions docs/design_docs/README.md
Original file line number Diff line number Diff line change
@@ -1,26 +1,29 @@
# System design location
# Design documents

ASAPQuery-backend does not maintain a second copy of the system design.
The canonical component design is in
[ASAPCollector/docs/design_docs](https://github.com/ProjectASAP/ASAPCollector/tree/main/docs/design_docs).
These documents are for architects and developers. The integration proposal and
SDS model below define the target Planner-to-runtime boundary; their current-code
notes and migration gates distinguish implemented behavior from proposed changes.

Backend-specific implementation design notes are organized by component under
[`../developer_docs`](../developer_docs/README.md). They explain current Rust
internals and are subordinate to the shared system contracts.
- [Planner/backend glossary](planner-backend-glossary.md) defines the terms used
by the following three designs.
- [Planner output to backend physical plans](asapplanner-integration.md) defines
how one selected post-ASAP DAG becomes executable PrecomputePlan and QueryPlan
subgraphs joined at materialization boundaries.
- [Summary definitions table and SDS](summary-catalog-sds-architecture.md) owns definition
and instance identity, version-scoped state references, readiness and state
lifecycle semantics.
- [Architecture migration delivery plan](asapplanner-migration-plan.md) defines
common-library extraction, removal of ASAPCollector dependencies, the two-plan
rollout, and backend acceptance/retirement gates.
- [Accepted-input completeness](continuous-summary-completeness.md) describes
the backend's bounded admission, publication and recovery behavior.

Proposals for shared-contract review:
Existing [Collector system contracts](https://github.com/ProjectASAP/ASAPCollector/tree/main/docs/design_docs)
remain the cross-component baseline. Current backend implementation guides live
under [developer docs](../developer_docs/README.md).

- [ASAPPlanner integration architecture](asapplanner-integration.md) proposes
the Planner/backend responsibility boundary, shared semantic DAG workflow,
and high-level consolidation milestones.
- [Summary Catalog and SDS Architecture](summary-catalog-sds-architecture.md) defines the proposed
Summary Descriptor, Data Descriptor and Summary Instance layers.
Other designs and profiles:

These proposals complement the canonical cross-component contracts above.

Backend-specific operating profiles:

- [ASAPQuery compatibility profile](asapquery-compatibility-profile.md) defines
the smaller target configuration for Prometheus Remote Write, backend-local
precompute, and PromQL serving without ASAPCollector. It becomes a strict
configuration subset after its currently missing Remote Write adapter lands.
- [ASAPQuery compatibility profile](asapquery-compatibility-profile.md)
- [Shape-aware ERP](shape-aware-erp-v1.md)
- [Empirical observability execution plan](empirical-o11y-execution-plan.md)
Loading
Loading