init: 클린 아키텍처 백엔드

2026-07-24 14:29:36 +09:00
parent 9eed16d097
commit 821fe00c32
971 changed files with 74769 additions and 1 deletions
@@ -0,0 +1,34 @@
+---
+title: Runbook — LOCK_ACQUISITION_TIMEOUT (분산 락 획득 타임아웃)
+category: CONFLICT
+error_codes: [LOCK_ACQUISITION_TIMEOUT]
+severity: P2
+owner: oncall
+last_updated: 2026-06-15
+status: stub
+---
+
+# Runbook: LOCK_ACQUISITION_TIMEOUT (`runbook://lock/acquisition-timeout`)
+
+## Symptoms
+
+- HTTP 409 with `error.code=LOCK_ACQUISITION_TIMEOUT`
+- Distributed lock wait exceeded configured timeout; high contention on a resource
+
+## Diagnosis
+
+- Check `lock.acquisition` metric for lock name and duration
+- Identify lock holders (check DB `integration_lock` table)
+
+## Action
+
+- Client should retry with backoff (retryable=true)
+- Optimize critical section holding time if lock contention is systemic
+
+## Escalation
+
+- Escalate if lock holder appears stuck (potential deadlock in distributed lock)
+
+---
+
+> **Stub**: Phase D2 — author body after domain adoption. (feature-operational-runbook-contract D9)