# Auth / Session Service Docs

This directory keeps service-local documentation that is too detailed for the
root architecture document and too operational for the OpenAPI specs.

Sections:

- [Runtime and components](runtime.md)
- [Auth, revoke, and repair flows](flows.md)
- [Operator runbook](runbook.md)
- [Configuration and contract examples](examples.md)

Primary references:

- [`../README.md`](../README.md) for service scope, contracts, and core domain
  rules
- [`../api/public-openapi.yaml`](../api/public-openapi.yaml) for the public
  REST contract
- [`../api/internal-openapi.yaml`](../api/internal-openapi.yaml) for the
  trusted internal REST contract
- [`../../gateway/README.md`](../../gateway/README.md) for the downstream
  consumer of authsession's public DTOs and Redis session projection