Skip to content

docs(architecture): define Planner and downstream physical boundary - #337

Merged
zzylol merged 1 commit into
mainfrom
refactor/cost-window-boundary
Sep 4, 2026
Merged

zzylol merged 1 commit into
mainfrom
refactor/cost-window-boundary

Conversation

@zzylol

@zzylol zzylol commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

Why

Lifecycle policy, planner-visible realization choice, provider identity, and concrete executor deployment are different concepts. The integration boundary must allow workload-specific physical feedback without moving backend implementation or cluster placement into ASAPPlanner.

What

Add a self-contained boundary design document for ASAPPlanner, ASAPQuery-backend, ASAPCollector, and the ASAPQuery data plane.

Ownership

  • ASAPPlanner owns logical query rewrites, summary family/parameters, accuracy, lifecycle candidates, planner-visible realization candidates, and final evidence-backed selection.
  • A downstream physical provider enumerates feasible complete implementations and returns a stable physical identity plus cost/accuracy evidence for each candidate.
  • ASAPQuery-backend owns concrete library/operator choice, pane layout, placement, sharding, storage, materialization identifiers, and workload-level assignment.
  • ASAPCollector and the data plane validate and execute the compiled projections and report measurements back as future planner evidence.

The selected physical identity is retained as provenance and as the handle for downstream compilation; Planner does not interpret it as an executor configuration.

Example

Incremental describes when existing summary state is updated. Tumbling, sliding/panes, and exponential histogram describe planner-visible window realization algorithms. Planner may choose both axes. After that choice, the backend decides how the selected framework is concretely implemented and deployed.

Stack: documentation-only, based on #336; #338 adds the window-framework candidate contract.

@zzylol
zzylol force-pushed the feat/cost-streaming-planner-integration branch from fd470ab to 4e43888 Compare September 3, 2026 16:29
@zzylol
zzylol force-pushed the refactor/cost-window-boundary branch from 93cdcdc to 4c92e8e Compare September 3, 2026 16:29
@zzylol
zzylol force-pushed the feat/cost-streaming-planner-integration branch from 4e43888 to bfbcde8 Compare September 3, 2026 16:45
@zzylol
zzylol force-pushed the refactor/cost-window-boundary branch from 4c92e8e to 2c60c11 Compare September 3, 2026 16:45
@zzylol
zzylol force-pushed the feat/cost-streaming-planner-integration branch from bfbcde8 to 91b9b6e Compare September 3, 2026 16:50
@zzylol
zzylol force-pushed the refactor/cost-window-boundary branch from 2c60c11 to f81669f Compare September 3, 2026 16:50
@zzylol
zzylol force-pushed the feat/cost-streaming-planner-integration branch from 91b9b6e to 1a24e1e Compare September 3, 2026 16:57
@zzylol
zzylol force-pushed the refactor/cost-window-boundary branch from f81669f to 6f11aaa Compare September 3, 2026 16:57
@zzylol
zzylol force-pushed the feat/cost-streaming-planner-integration branch from 1a24e1e to a549ae9 Compare September 3, 2026 17:05
@zzylol
zzylol force-pushed the refactor/cost-window-boundary branch from 6f11aaa to af31303 Compare September 3, 2026 17:05
@zzylol
zzylol force-pushed the feat/cost-streaming-planner-integration branch from a549ae9 to fac7b09 Compare September 4, 2026 00:47
@zzylol
zzylol force-pushed the refactor/cost-window-boundary branch from af31303 to c1d5718 Compare September 4, 2026 00:50
@zzylol
zzylol force-pushed the feat/cost-streaming-planner-integration branch from fac7b09 to 529cccb Compare September 4, 2026 02:26
@zzylol
zzylol force-pushed the refactor/cost-window-boundary branch from c1d5718 to 6029671 Compare September 4, 2026 02:26
@zzylol
zzylol force-pushed the feat/cost-streaming-planner-integration branch from 529cccb to e5b16fe Compare September 4, 2026 03:04
@zzylol
zzylol force-pushed the refactor/cost-window-boundary branch from 6029671 to 03bda42 Compare September 4, 2026 03:04
@zzylol
zzylol force-pushed the feat/cost-streaming-planner-integration branch from e5b16fe to f8bfc92 Compare September 4, 2026 03:31
@zzylol
zzylol force-pushed the refactor/cost-window-boundary branch from 03bda42 to bccb146 Compare September 4, 2026 03:31
@zzylol
zzylol force-pushed the feat/cost-streaming-planner-integration branch from f8bfc92 to 0c779e7 Compare September 4, 2026 04:02
@zzylol
zzylol force-pushed the refactor/cost-window-boundary branch from bccb146 to 5c4a62d Compare September 4, 2026 04:02
@zzylol zzylol changed the title refactor(cost): separate abstract windows from deployment details docs(architecture): define Planner and downstream physical boundary Sep 4, 2026
@zzylol
zzylol changed the base branch from feat/cost-streaming-planner-integration to main September 4, 2026 11:28
@zzylol
zzylol merged commit 76250b0 into main Sep 4, 2026
1 check passed
@zzylol
zzylol deleted the refactor/cost-window-boundary branch September 7, 2026 15:51
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