Sales Tool specifications

Stage 3 · Tools

Proposed Sales Tools

Language specifications derived from the capability analysis. Status reflects the current Tool source.

kitchen.finance.daily-sales-report

Restaurant Daily Sales Report

ai-assistedrequested

Read and explain one bounded Kitchen-local day of immutable completed Sales.

Records:reads Kitchen Salereads Sales report

Inputs

  • selected Kitchen
  • owner-local service date
  • authorized KitchenSale projection

Outputs

  • reconciled currency-grouped totals, item rollups and transaction summaries

Evidence

  • immutable KitchenSales and bounded server projection

Authority: The Tool reports gross Sales only and does not invent refunds, net Sales, tax, tips, payments, costs or profit.

Approval: Read-only reporting needs no mutation approval; export or external sharing is separate.

kitchen.finance.compare-periods

Sales Period Comparison

ai-assistedrequested

Compare equivalent bounded gross-Sales measures across two Kitchen-local periods.

Records:reads Kitchen Salereads Sales report

Inputs

  • selected Kitchen
  • two explicit periods
  • authorized complete projections

Outputs

  • currency-safe measure differences, trends and source scope

Evidence

  • same canonical KitchenSale measures for both periods

Authority: The Tool preserves timezone and metric definitions, avoids cross-currency totals and does not invent causes.

Approval: Read-only comparison needs no mutation approval.

salesAI

Specialist responsibility

  • Own Kitchen gross-Sales interpretation, bounded report semantics and Sales Tool specifications.
  • Use only immutable KitchenSales and their trusted server projection.
  • Keep stored Sale, report projection, comparison and deduction distinct.
  • Never invent refunds, net revenue, tax, tips, payment settlement, costs, profit or causal explanations.
  • Expose current Tools as requested until callable registration and AI verification exist.

KitchenAI

Coordinator responsibility

  • Recognise Sales-reporting intent and delegate it to SalesAI.
  • Pass selected Kitchen, authorized period and context without copying Finance semantics.
  • Route cost or contribution questions to CostsAI rather than broadening Sales.
  • Discover real Tool availability through SalesAI registration and preserve export boundaries.

Activation gate

  • The current bounded gross-Sales reader remains reconciled and authorized.
  • Callable Tool adapters validate Kitchen, timezone, date range, currency and query limits.
  • Report metric names match the KitchenSale producer exactly.
  • Tool registration truthfully distinguishes the existing page from AI-callable availability.
  • Authorization, export policy, UI and end-to-end verification are complete.

Until every relevant gate is satisfied, unavailable specifications remain language—not Tools.