# Administrator Guide

> **Status:** Scaffold only. No legacy page has been promoted into this book yet.

This book is the canonical home for installation, configuration, deployment, routine operations, security controls, incident response, and recovery. User workflows belong in [`USER-GUIDE/`](../USER-GUIDE/); implementation and contributor material belongs in [`DEVELOPER-GUIDE/`](../DEVELOPER-GUIDE/).

## Start here

- [Documentation atlas](../README.md) — placement rules and source-of-truth boundaries.
- [Documentation sitemap](../SITEMAP.md) — existing navigation is transitional and still contains legacy paths.
- [Product requirements](../PRD.md) — normative requirements, currently marked draft.

## Chapter map

| Chapter                           | Scope                                                               | Status                                                  |
| --------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------- |
| `installation/`                   | Prerequisites, installation, and first deployment.                  | Scaffold only.                                          |
| `configuration/`                  | Environment, provider, tier, and runtime configuration.             | Scaffold only.                                          |
| `deployment/`                     | Topologies, rollout, migration, and upgrade procedures.             | Scaffold only.                                          |
| `operations/`                     | Health, observability, routine operation, and maintenance.          | Scaffold only.                                          |
| [`security/`](security/README.md) | Authentication, authorization, SSO, secrets, and security controls. | SSO provider guide is current; other pages are planned. |
| `recovery/`                       | Incident response, backup, rollback, and recovery.                  | Scaffold only.                                          |

Every promoted page must be added to this index and to [`SITEMAP.md`](../SITEMAP.md) in the same migration slice.

## Evidence — not current operator guidance

- [`P8-003 performance report`](../reports/qa/p8-003-performance-optimization.md) — historical performance evidence; implementation alignment is partial, and production metrics remain unverified. It is not an operational SLO or runbook.

## Migration backlog — not current operator guidance

These are source candidates, not verified runbooks:

- [`_old_structure/guides/admin-guide.md`](../_old_structure/guides/admin-guide.md) — historical source; verify claims before promotion.
- [`_old_structure/guides/deployment.md`](../_old_structure/guides/deployment.md) — historical source; verify commands and deployment assumptions before promotion.

Do not treat a migration candidate as current until its commands, paths, permissions, and safety status are checked against source and tests.

## Authoring boundary

New administrator documentation belongs under one of the chapter directories above. Operationally sensitive pages must identify prerequisites, ownership, source-of-truth dependencies, and whether any procedure is current, illustrative, held, or non-operative.

## Related

- [[README|Documentation contract]]
- [[PRD|Product requirements]]
- [[DEVELOPER-GUIDE/architecture/README|Architecture index]]
