690514:2019 204-rfa-approval-refactor #01

2026-05-14 20:19:21 +07:00
parent 07cc6d47b1
commit 0240d80da5
183 changed files with 20050 additions and 1017 deletions
@@ -0,0 +1,43 @@
+// File: docs/ai-knowledge-base/templates/api-spec.md
+# API Specification: [Endpoint Name]
+
+## 📋 Metadata
+- **Version**: v1
+- **Module**: [e.g. RFA]
+- **Protocol**: REST (JSON)
+- **Status**: Draft / Proposed
+
+## 🚀 Endpoint
+`METHOD /v1/[path]`
+
+## 🛡️ Authentication & Authorization
+- **Auth Required**: Yes/No
+- **Roles**: [Admin, Consultant, etc.]
+- **CASL Action**: `Action.Create / Action.Read / ...`
+
+## 📥 Request Parameters
+### Headers
+- `Idempotency-Key`: UUID (Required for Write actions)
+- `Authorization`: Bearer [token]
+
+### Body (JSON)
+| Field | Type | Required | Description |
+| --- | --- | --- | --- |
+| `name` | String | Yes | Name of entity |
+
+## 📤 Response (JSON)
+### Success (200/201)
+```json
+{
+  "publicId": "...",
+  "status": "success",
+  "data": { ... }
+}
+```
+
+### Error (400/401/403/500)
+- ปฏิบัติตาม ADR-007
+
+---
+// Change Log:
+// - 2026-05-14: Initial API spec template