Skip to content

reads

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

reads

README.md

Reads experience (Reads*)

Commercial IP-buyer surface for /reads: master-detail pipelines, shared repository·branch·commit source package (DepositSourceSelection), Need + Relevant/Irrelevant path steering, SynthesizeReadAssetPacks (SDIVF), option select, SettleAssetPack → /exchange.

Master-detail (shared across product routes)

Route Master Detail Back
/exchange Activity table Selected AssetPack / proof detail Via selection
/deposits Pipelines table Source + Obfuscations + options Back to Deposit
/reads Pipelines table Source + Need + options Back to Read

Layout

reads/
  README.md
  models/
    deposit-read-workbench.ts            # stable type re-exports (activity drafts)
    deposit-read-workbench-types.ts
    enterprise-reading-ux-types.ts       # step catalog + types
    enterprise-reading-ux-state.ts       # builders + re-exports
    read-route-session-types.ts
    read-route-helpers.ts
    read-procurement-governance.ts
    read-fit-measurement-review.ts
    read-settlement-rights-delivery.ts
    read-route-model.ts                  # session facade + stage helpers
    read-route-rows.ts                   # session / procurement / authority rows
    read-scenarios.ts                    # measurement draft types (activity history)
    read-format.ts
  ReadPageClient/
    ReadPageClient.tsx                   # thin orchestration + multi-rail settle
    hooks/
      use-read-route-params.ts
      use-read-live-runs.ts
      use-read-url-navigation.ts
      use-read-pipeline-telemetry.ts
      use-read-session-projections.ts
      use-read-activity-recording.ts
      use-read-option-synthesis.ts
  ReadsPipelinesMaster/                  # table + New (+) + Back
  ReadsPipelineTelemetry/
  ReadsNeedComposePanel/                 # Need + path pickers + synthesize CTA
  ReadsNeedPathPickers/
  ReadsAssetPackOptions/                 # options + ETH/BTC/SOL checkout + quote
  ReadsOptionCard/
  ReadsRouteStateAside/

Multi-rail settle checkout (Gate 5)

  1. Select synthesized option(s) with needinesses measurements.
  2. POST /api/read/settle/quote → BTD volume (needinesses × decay) + ETH/BTC/SOL pay amounts.
  3. Choose pay rail (ETH P0). Buyer 0x from Auxillaries wallet when connected.
  4. POST /api/read/settle with payAsset, buyerEthereumAddress, payment observation.
  5. Escrow mint + AP co-own + pending seller payout → finalize on /exchange.

Source selection reuses deposits/DepositSourceSelection (same SHA element as deposit) with route-facing copy overrides.

Page shell: apps/uapi/app/reads/.

Import Bitcode bases + shared deposit source selection only where the product law is one source package control. Full filesystem contract: .docs/BITCODE_SOURCE_LAYOUT.md.

Stable external import for workbench types remains: @/components/reads/models/deposit-read-workbench.

Stable external import for route model remains: @/components/reads/models/read-route-model.