Blueprint Runtime Boundary

One Blueprint declares the full-stack system. It is not split into an entity blueprint and an app blueprint. A target supplies only executable bindings; the standard app and server hosts interpret the selected target.

Blueprint
  ├─ modules, entities, facets, fields, relationships
  ├─ lifecycles, actions, rules, audit, evidence
  ├─ DB and UI declarations
  ├─ application workspace, routes, collections, shell
  └─ endpoint declaration
          │
          ▼
BlueprintTarget + external bindings
          │
          ├─ BlueprintServer ── Blueprint protocol ── Postgres
          │
          └─ BlueprintApp ───── Blueprint protocol ── Studio UI

BlueprintRegistry
  └─ selects a BlueprintTarget for the workspace executable

The public architecture has five names: Blueprint, BlueprintTarget, BlueprintRegistry, BlueprintServer, and BlueprintApp. Protocol route modules, transport clients, binding completeness gates, DDL emitters, and runtime plugins are implementation details behind those hosts.

The server does not generate an API per application. Its fixed route modules derive entity, projection, action, capability, and explorer behavior from the assembled Blueprint at runtime. OpenAPI is produced by the generic server plugin from mounted routes.

BlueprintApp talks only to BlueprintServer through the Blueprint protocol. It does not import server bindings or database code. The server publishes the portable Blueprint manifest for the selected target, and the app maps that declaration into vyuh_studio_ui while resolving optional custom client bindings.

Seed data is application-owned and deterministic. Blueprint seed/scenario metadata may guide a product's seed implementation, but there is no separate seed compiler.

What to inspect

Concern	Source
DB generation	packages/vyuh_blueprint_server/lib/src/kernel/compiler/db_compiler.dart
Domain DDL	packages/vyuh_blueprint_server/lib/src/kernel/postgres/ddl_emitter.dart
Runtime DDL	packages/vyuh_blueprint_server/lib/src/kernel/postgres/runtime_ddl_emitter.dart
Fixed server routes	packages/vyuh_blueprint_server/lib/src/
Blueprint declaration	packages/vyuh_blueprint/lib/src/blueprint.dart
Target and registry	packages/vyuh_blueprint_server/lib/src/blueprint_target.dart
Server host	packages/vyuh_blueprint_server/lib/src/blueprint_server_app.dart
App host	packages/vyuh_blueprint_ui/lib/src/blueprint_app_runner.dart
Blueprint-to-Studio adapters	packages/vyuh_blueprint_ui/lib/src/
Generic enterprise UI	packages/vyuh_studio_ui/lib/src/