feat(usage): rate-card-join en predicaat "meetbaar" voor usage-regels (IDEA-235 T7) #71

Merged
janpeter merged 1 commit from feat/idea-235-usage-helpers into main 2026-10-05 14:14:44 +02:00
Owner

IDEA-235 plan Taak 7 (T-2006): gedeelde SQL-helpers voor de prijsjoin van usage-regels en het predicaat "meetbaar" (spec §3.4, §5.3).

Nieuw in lib/usage-sql.ts

  • usageRateCardJoinSqlText(modelIdExpr, runtimeExpr): dezelfde voorwaarden als RATE_CARD_JOIN_SQL_TEXT in Scrum4Me; SQL-tekst, de consument wrapt met Prisma.raw (Review record P16).
  • usageLineUsdSqlText(lineAlias): USD van één regel tegen mp; NULL zonder prijs.
  • measurableTaskSqlText(taskAlias): DONE, schatting aanwezig, ≥ 1 eigen segment met requests, alle segmenten gesloten, geen UNTRACKED.
  • fullyPricedTaskSqlText(taskAlias): elke regel van de eigen segmenten heeft een USD-proxyprijs (voorwaarde voor de kostenratio).

Tests

  • Fixture fixtures/usage-ledger/measurable-v1.json: de zes taken uit de acceptatie plus één zonder requests, plus een overheadsegment met een ongeprijsde regel. Alleen measurable telt voor kosten; measurable en unpriced-line voor tijd.
  • De SQL draait tegen echte Postgres via PGlite (nieuwe devDependency @electric-sql/pglite; lib/ blijft dependency-vrij, verify-no-deps groen). Een kolomcontrole houdt de testtabellen gelijk aan het canonieke schema.
  • Mutatiecontrole: het weglaten van UNTRACKED, requests > 0 of de billing-voorwaarden laat telkens een test falen.

npm run verify: 603 tests groen.

Daarna: submodule-bump + shim in Scrum4Me (aparte PR).

🤖 Generated with Claude Code

IDEA-235 plan Taak 7 (T-2006): gedeelde SQL-helpers voor de prijsjoin van usage-regels en het predicaat "meetbaar" (spec §3.4, §5.3). **Nieuw in `lib/usage-sql.ts`** - `usageRateCardJoinSqlText(modelIdExpr, runtimeExpr)`: dezelfde voorwaarden als `RATE_CARD_JOIN_SQL_TEXT` in Scrum4Me; SQL-tekst, de consument wrapt met `Prisma.raw` (Review record P16). - `usageLineUsdSqlText(lineAlias)`: USD van één regel tegen `mp`; NULL zonder prijs. - `measurableTaskSqlText(taskAlias)`: `DONE`, schatting aanwezig, ≥ 1 eigen segment met requests, alle segmenten gesloten, geen `UNTRACKED`. - `fullyPricedTaskSqlText(taskAlias)`: elke regel van de eigen segmenten heeft een USD-proxyprijs (voorwaarde voor de kostenratio). **Tests** - Fixture `fixtures/usage-ledger/measurable-v1.json`: de zes taken uit de acceptatie plus één zonder requests, plus een overheadsegment met een ongeprijsde regel. Alleen `measurable` telt voor kosten; `measurable` en `unpriced-line` voor tijd. - De SQL draait tegen echte Postgres via **PGlite** (nieuwe devDependency `@electric-sql/pglite`; `lib/` blijft dependency-vrij, `verify-no-deps` groen). Een kolomcontrole houdt de testtabellen gelijk aan het canonieke schema. - Mutatiecontrole: het weglaten van `UNTRACKED`, `requests > 0` of de billing-voorwaarden laat telkens een test falen. `npm run verify`: 603 tests groen. Daarna: submodule-bump + shim in Scrum4Me (aparte PR). 🤖 Generated with [Claude Code](https://claude.com/claude-code)
feat(usage): rate-card-join en predicaat "meetbaar" voor usage-regels (IDEA-235)
All checks were successful
CI / Verify (pull_request) Successful in 36s
9f1958dda1
Eén bron voor de prijsjoin van usage_lines en de definitie van een
meetbare taak (spec §3.4, §5.3; plan Taak 7), gedeeld door
get_estimate_history (scrum4me-mcp) en Insights (Scrum4Me).

- usageRateCardJoinSqlText(modelIdExpr, runtimeExpr): dezelfde
  voorwaarden als RATE_CARD_JOIN_SQL_TEXT; SQL-tekst, de consument
  maakt er met Prisma.raw een fragment van (Review record P16).
- usageLineUsdSqlText: USD van één regel; NULL zonder prijs, nooit 0.
- measurableTaskSqlText: done, schatting, ≥ 1 segment met requests,
  alles gesloten, geen UNTRACKED. fullyPricedTaskSqlText: elke regel
  geprijsd (voorwaarde voor de kostenratio).

De fixturetest draait de SQL tegen echte Postgres via PGlite
(devDependency; lib/ blijft dependency-vrij) en controleert dat de
testtabellen kolom voor kolom in het canonieke schema staan.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
s4m-codex-reviewer left a comment

COMMENT

Geen blokkerende codefindings gevonden. Goedkeuring blijft uit vanwege de hieronder beschreven verificatiebeperking.

  • warning — tests/usage-sql.test.ts:1 — De testsuite kon hier niet starten: de checkout onder /tmp blokkeert uitvoering/native-modulemapping (tsc: Permission denied; Rollup: failed to map segment from shared object). De dependency-gate, bijbehorende shell-tests en typecheck via node slagen. De claim van 603 groene tests is daarmee niet onafhankelijk bevestigd. Dit is een omgevingsbeperking, geen aangetoonde regressie.

Plan gekoppeld via pr_refs (product Scrum4Me), referentie: T-2006 (Scrum4Me), story ST-1630. Geen omitted onderdelen.

De gedeelde helpers voldoen statisch aan het afgebakende T7-plan: dependency-vrije SQL-tekst, prijsjoin met runtime/provider/billingvoorwaarden, meetbaarheid op DONE + schatting + requests + gesloten segmenten zonder UNTRACKED, en volledige prijzen als extra kostenvoorwaarde. De fixture dekt de zes gevraagde scenario's, nul requests en overhead; ontbrekende prijzen blijven NULL. Dit volgt de productarchitectuur van pure gedeelde logica zonder Prisma-client.

De PR beschrijft de submodule-bump en shim in Scrum4Me expliciet als vervolg-PR. Die consumerverificatie en overige storyonderdelen vallen buiten deze diff en zijn geen blokkerende omissies. Beoordeeld op commit 9f1958dda1e0afa519a37efcc7448a813f899cf8; PR en head zijn via Forgejo bevestigd.

# COMMENT Geen blokkerende codefindings gevonden. Goedkeuring blijft uit vanwege de hieronder beschreven verificatiebeperking. - **warning — __tests__/usage-sql.test.ts:1** — De testsuite kon hier niet starten: de checkout onder `/tmp` blokkeert uitvoering/native-modulemapping (`tsc: Permission denied`; Rollup: `failed to map segment from shared object`). De dependency-gate, bijbehorende shell-tests en typecheck via `node` slagen. De claim van 603 groene tests is daarmee niet onafhankelijk bevestigd. Dit is een omgevingsbeperking, geen aangetoonde regressie. Plan gekoppeld via pr_refs (product Scrum4Me), referentie: **T-2006 (Scrum4Me)**, story **ST-1630**. Geen omitted onderdelen. De gedeelde helpers voldoen statisch aan het afgebakende T7-plan: dependency-vrije SQL-tekst, prijsjoin met runtime/provider/billingvoorwaarden, meetbaarheid op DONE + schatting + requests + gesloten segmenten zonder UNTRACKED, en volledige prijzen als extra kostenvoorwaarde. De fixture dekt de zes gevraagde scenario's, nul requests en overhead; ontbrekende prijzen blijven NULL. Dit volgt de productarchitectuur van pure gedeelde logica zonder Prisma-client. De PR beschrijft de submodule-bump en shim in Scrum4Me expliciet als vervolg-PR. Die consumerverificatie en overige storyonderdelen vallen buiten deze diff en zijn geen blokkerende omissies. Beoordeeld op commit `9f1958dda1e0afa519a37efcc7448a813f899cf8`; PR en head zijn via Forgejo bevestigd.
Sign in to join this conversation.
No reviewers
No labels
severity/s4
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
janpeter/scrum4me-shared!71
No description provided.