diff --git a/docs/06-DECISIONS.md b/docs/06-DECISIONS.md index a508122..11517af 100644 --- a/docs/06-DECISIONS.md +++ b/docs/06-DECISIONS.md @@ -146,3 +146,16 @@ AWS attribution, no path to the fleet console). before the real-data import, so live data never migrates engines; SQLite stays the dev/test engine behind the same repositories. Physical repo split stays a cheap, reversible option if practice ever demands it. + +## D16 โ€” Employees are `staff_user` rows; the employee list is returned whole (2026-07-17) +The Employee entity (quote-to-close funnel, Phase 1) is **backed by the existing +`staff_user` table** โ€” renaming it would churn `session.staff_id`, +`interaction.staff_id` and audit entity names for zero gain; "Employee" lives in the +repo/API/UI vocabulary only. Roles widened to `owner | manager | staff` via a guarded, +transactional table rebuild. + +**Recorded deviation from the funnel spec's blanket pagination rule (ยง5 / rule 8):** +`GET /employees` returns the full set with `total` and **no `page`/`pageSize`** โ€” +console users are a small bounded set (single-digit headcount), the count is displayed, +and nothing is silently truncated, which is the intent of rule 8. If the team ever +grows past a screenful, paginate it like every other list.