feat: authsession service

authsession/docs/README.md

@@ -0,0 +1,22 @@
+# 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