# PeriodStatus

> State, provenance, and the next action.

Source: https://lopifi.com/components/period-status
Part of: Lopifi — US GAAP books on autopilot, checked by a CPA (https://lopifi.com)

---

- **Family:** Close, controls & consolidation — **See also:** `#69 TrialBalance` and `#70 CloseChecklist` in [statements](06-statements.md) — same family conceptually.
- **Status:** Implemented
- **Spec:** https://lopifi.com/docs/catalog/12-close-controls-consolidation

## Install

```bash
npx shadcn@latest add @lopifi/theme
npx shadcn@latest add @lopifi/period-status
```

## Specification

The state banner on every period-scoped surface. Three things, always: the state, the provenance, and **the next action**.

The provenance is a signed-off avatar — initials or a photo, with a tick — and not a sentence. "Closed 4 Oct 2026 by A. Rivera, Controller" is read once and then costs a line forever; the auditor who needs it presses the face and gets the name, the role and the timestamp. `InfoTip`, so it opens under a thumb.

```
🔒  September 2026 · Closed 4 Oct 2026 by A. Rivera
    Entries dated in this period will post to October and be flagged
    for cutoff review.                              [Request reopen]
```

A lock icon alone is a dead end. Reopening states its blast radius first: "Reopening September will mark 4 published statements as superseded."

## Rules this component obeys

Money is minor units, never floats. `null` is not `0` and neither is redacted. Negatives render in accounting parentheses with the parenthesis column reserved on both sides. Debit and credit are two columns. Per-currency decimal places. Polarity is explicit — up is not always good. Every figure states its period, entity, currency, basis and as-of.