Add Swagger UI enterprise documentation

Author: nuttidagoedseesuk-eng

docs/api/README.md

@@ -0,0 +1,34 @@
+# AEON MATRIX API Documentation
+
+## Swagger UI
+
+Open:
+
+/swagger-ui.html
+
+
+## API Specification
+
+OpenAPI 3.0.3
+
+## Core Services
+
+### Telemetry Ingestion
+POST /api/v1/events
+
+รับ Event จาก WMS, GPS, IoT และ Transport System
+
+
+### AI Intelligence Engine
+POST /api/v1/ai/analyze
+
+วิเคราะห์ Event ด้วย AI Decision Engine
+
+
+## Event Types
+
+- ORDER_CREATED
+- GPS_UPDATED
+- STOCK_SHORTAGE
+- POLICY_VIOLATION
+- ETA_RISK

docs/api/swagger-ui.html

@@ -0,0 +1,45 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <title>AEON MATRIX API Documentation</title>
+
+  <link rel="stylesheet"
+    href="https://unpkg.com/swagger-ui-dist/swagger-ui.css" />
+
+</head>
+
+<body>
+
+<div id="swagger-ui"></div>
+
+<script src="https://unpkg.com/swagger-ui-dist/swagger-ui-bundle.js"></script>
+<script src="https://unpkg.com/swagger-ui-dist/swagger-ui-standalone-preset.js"></script>
+
+<script>
+
+window.onload = () => {
+
+  SwaggerUIBundle({
+
+    url: "./openapi.yaml",
+
+    dom_id: "#swagger-ui",
+
+    deepLinking: true,
+
+    presets: [
+      SwaggerUIBundle.presets.apis,
+      SwaggerUIStandalonePreset
+    ],
+
+    layout: "StandaloneLayout"
+
+  });
+
+};
+
+</script>
+
+</body>
+</html>