Skip to content

JNY-PFM-LLM-001A staff member reaches the monthly AI allowance

Markdown

JNY-PFM-LLM-001

A staff member reaches the monthly AI allowance

Markdown
  • DocumentDraft
  • Product intentProposed
  • ImplementationObserved

KindJourneyProduct areaPlatformModuleAI Requests, Usage and the Jazz AI TeammateRevision1End-to-endRequired

Read atservices-platform ad3f6a65react-console baf6dae3

The Formal Contract

The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.

Goal
Use AI to prepare queries and understand a refusal when monthly capacity runs out.
Screens
/console/{tenantId}/queries/new/hq/aiUsage/requests/{tenantId}/{invocationId}

Steps

#SurfaceActionCapabilityExpectedProvenance
1/console/{tenantId}/queries/newSubmit an AI request with allowance available.CAP-PFM-LLM-001The scripted request is charged and remains below the warning threshold.test
services-platform:modules/llm/tests/e2e/allowance-warning.e2e.spec.js#says nothing while the first call leaves the organization under 80 %
2/console/{tenantId}/queries/newMake another request that crosses the warning threshold.CAP-PFM-LLM-008Both administrators receive a warning with usage and reset information.test
services-platform:modules/llm/tests/e2e/allowance-warning.e2e.spec.js#tells each of the two administrators once when the second call passes 80 %
3/console/{tenantId}/queries/newMake a request that crosses the full allowance.CAP-PFM-LLM-007The admitted request finishes and is charged; administrators receive the pause notice.test
services-platform:modules/llm/tests/e2e/allowance-warning.e2e.spec.js#tells both again, once, when the third call passes 100 %
4/console/{tenantId}/queries/newTry another AI request.CAP-PFM-LLM-018Admission stops before provider dispatch and returns the allowance explanation.test
services-platform:modules/llm/tests/e2e/allowance-warning.e2e.spec.js#refuses the next call, because the allowance is used
5/hq/aiUsage/requests/{tenantId}/{invocationId}Ask Rhythm support to inspect the refusal.CAP-PFM-LLM-011The request directory provides the refusal reason and the admission figures.documented

Alternate and Failure Paths

PathFrom stepConditionPath takenOutcomeProvenance
alternate4Support grants temporary capacity.A request within the grant window can pass admission.The person resumes using AI before the monthly reset.test
failure2The workspace has no administrator.The notice is marked complete without recipients.The organization receives no warning.test
failure4The next request needs more capacity than remains.Admission refuses it even though the usage summary is still warned.The distinction between remaining credits and affordable requests needs a product decision.documented
services-platform:docs/milestones/plans/PLAT-M1-plan.md#D1. When is an organization's allowance "used up"?

Assertions

IdStatementProvenance
01In the tested sequence, administrators receive warning and pause notices while other staff receive neither.test
services-platform:modules/llm/tests/e2e/allowance-warning.e2e.spec.js#never tells a person who is not an administrator
02The request made after capacity runs out is refused with no charge.test
services-platform:modules/llm/tests/e2e/allowance-warning.e2e.spec.js#refuses the next call, because the allowance is used
03The proposed support walkthrough includes locating the refusal and its reason.documented

End-to-end policy: required: A complete browser walkthrough must connect the query screen, delivered mail and support inspection. The available scripted test does not prove that whole path.

The Markdown files under specs/ in rhythmsoftware/rhythm-v2-docs are the canonical source of truth. This reader is a generated, read-only projection of them.