The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.
| # | Surface | Action | Capability | Expected | Provenance |
|---|---|---|---|---|---|
| 1 | closeFiscalPeriod | Complete the first eleven months and attempt one out-of-sequence close. | CAP-ACC-CLS-008 | Months complete in order and the premature request is refused. | documented |
| 2 | /console/{tenantId}/accounting/close/years/{fiscalYearId} | Review the fiscal-year screen. | CAP-ACC-CLS-004 | The final month includes year checks and explains the absence of year-end ledger entries. | documented |
| 3 | closeFiscalPeriod | Confirm the final period’s close. | CAP-ACC-CLS-010 | The year-close run completes and future-year generation attempts to supply three eligible years. | test |
| 4 | /console/{tenantId}/accounting/close/history | Inspect the calendar after completion. | CAP-ACC-CLS-001 | The year is closed with its final-period details and the next unfinished period is current. | test services-accounting:modules/fiscal-close/tests/integration/services/periods/period-calendar.integration.spec.js#answers a closed year with its last period’s close |
| 5 | reopenFiscalPeriod | Request a reasoned reopen of the final month. | CAP-ACC-CLS-011 | The period and year return to open. | test services-accounting:modules/fiscal-close/tests/integration/services/persistence/fiscal-periods.integration.spec.js#becomes open again when one period starts reopening |
| Path | From step | Condition | Path taken | Outcome | Provenance |
|---|---|---|---|---|---|
| failure | 3 | Generation fails after successful finalization. | The run remains successful while its job records the failed future-year step. | A later close can fill the calendar, without a dedicated staff notification today. | observed services-accounting:docs/migrations/fiscal-close/README.md#Decisions and departures from the brief |
| Id | Statement | Provenance |
|---|---|---|
01 | The year closes when its final remaining period closes. | test services-accounting:modules/fiscal-close/tests/integration/services/jobs/close-job.integration.spec.js#closes the fiscal year with its twelfth period |
02 | Year completion produces no closing or opening ledger entries. | documented services-accounting:docs/fiscal-close/README.md#5. Fiscal-year close |
03 | Successful uncapped roll-forward leaves three eligible future years. | test services-accounting:modules/fiscal-close/tests/integration/services/jobs/close-job.integration.spec.js#rolls the fiscal years forward to three open years after September 2026 |
End-to-end policy: optional: Year review spans the final-month screen and execution; service evidence covers the available path while browser coverage remains optional.