feat: user service

user/docs/README.md

@@ -0,0 +1,19 @@
+# User Service Docs
+
+This directory keeps service-local documentation that is more operational or
+more example-heavy than [`../README.md`](../README.md).
+
+Sections:
+
+- [Runtime and components](runtime.md)
+- [Main flows and boundaries](flows.md)
+- [Operator runbook](runbook.md)
+- [Contract examples](examples.md)
+
+Primary references:
+
+- [`../README.md`](../README.md) for stable service scope and business rules
+- [`../openapi.yaml`](../openapi.yaml) for the trusted internal REST contract
+- [`../../ARCHITECTURE.md`](../../ARCHITECTURE.md) for system-level transport
+  and ownership rules
+- [`../../TESTING.md`](../../TESTING.md) for the cross-service testing matrix