──────

### Summary of Changes 1. Documentation Consolidation: • Relocated the docs/ folder and all repository .md files (README.md, DEPLOYMENT.md, DOCKER_README.md, DOMAINS_README.md, GETTING_STARTED.md, CI_CD_PORTAINER_GUIDE.md, ADMIN_DEPLOYMENT_SUMMARY.md, SECURITY_PRIVATE_FILES.md, handoff.md, azure-project-plan.md, plus service-specific READMEs) into . • Updated document links in README.md. 2. AI Agent Project Map: • Created PROJECT_MAP.md in the project root containing complete architecture diagrams, service specs, ports, DB schemas, environment variables, and developer workflows. • Added PROJECT_MAP.md to .gitignore. 3. Monitoring UI & Infrastructure Integration: • Added monitoring_ui service to docker-compose.yml (port 5175). • Configured Gitea workflow docker-build.yml for monitoring_ui builds. • Added CORS middleware headers in index.js. • Added nginx.conf copy step in Dockerfile. ────── ### Recommended Commit Message docs: consolidate project documentation into monitoring_ui and add agent project map - Move all markdown documentation files and docs/ folder into monitoring_ui/docs/ - Update documentation hub index (monitoring_ui/docs/README.md) with relative paths - Generate comprehensive AI agent reference map (PROJECT_MAP.md) in repository root - Add PROJECT_MAP.md and monitoring_ui build output/env overrides to .gitignore - Integrate monitoring_ui service into docker-compose.yml and Gitea CI workflow - Configure CORS handling in employee_api for monitoring dashboard access ────── ### Alternative Short Commit Message refactor(docs): move docs to monitoring_ui and create AI agent PROJECT_MAP.md
2026-09-20 23:33:55 +02:00
parent f935bbeb8c
commit 635a130f0b
195 changed files with 28309 additions and 957 deletions
@@ -0,0 +1,74 @@
+<!-- azure-cor-disclaimer -->
+> **Important:** This skill provides guidance and recommended instructions to assist the AI system. Outputs are not guaranteed to be complete, correct, secure, or applicable to every scenario. Results should be reviewed and validated by a human before being applied. The AI model may choose not to follow all instructions exactly, and additional verification may be required.
+
+# Subagent Template — Quota Validation (Step 5)
+
+Validate SKU quota and offer restrictions across candidate regions before presenting region choices.
+
+## Critical Rules
+
+- ⛔ **Do NOT invoke any other agents or hand off** — no external agent calls of any kind. You are a quota-check subagent only.
+- **Read [`sku-quota-validation.md`](sku-quota-validation.md) before executing ANY quota or offer restriction check.** It contains the per-provider API patterns, anti-patterns to avoid, offer restriction checks for database services, region selection logic, and output schema. All procedures live there — follow them exactly.
+
+## Input (provided by caller)
+
+| Field | Required |
+|-------|---------|
+| `subscriptionId` | YES |
+| SKU list from Step 4 (service type + SKU per service) | YES |
+| Restricted-offer services (PostgreSQL, MySQL) | If present in plan |
+| **Detected DB version per DB service** (from `context.json.detectedServices[]`, e.g. MySQL `5.7`) | ⛔ REQUIRED if a DB is in the plan — the version-selection algorithm in [`sku-quota-validation.md`](sku-quota-validation.md) needs it. |
+
+## Output
+
+Return JSON (≤500 tokens):
+```jsonc
+{
+  "quotaResults": [
+    {
+      "region": "{checked region}",
+      "services": [
+        { "service": "{provider}", "sku": "{sku}", "limit": "{from API}", "used": "{from API}", "available": "{limit - used > 0}" },
+        // if DB service: add "offerRestricted": "{from capabilities API}", "version": "{selected per sku-quota-validation.md — exact patch, never major-only '8.0'}"
+      ],
+      "allAvailable": "{true only if ALL services in this region have available=true}"
+    }
+    // one entry per checked region
+  ],
+  "recommendedRegion": "{first region where allAvailable=true}",
+  "checkedRegions": ["{all regions checked}"],
+  "offerRestrictions": [
+    // one entry per DB service+region checked — derive from capabilities API response
+    { "provider": "{namespace}", "region": "{region}", "restricted": "{true if blocked}", "reason": "{from API or null}" }
+  ],
+  "offerRestrictionsVerified": "{true only if every DB service from input has ≥1 entry in offerRestrictions[]}"
+}
+```
+
+⛔ **Caller:** copy each DB service's returned `version` into `prepare-plan.json.services[].version` at plan-write — scaffold needs the exact patch (ARM rejects major-only `'8.0'`).
+
+## Workflow
+
+1. Read [`sku-quota-validation.md`](sku-quota-validation.md)
+2. Run the per-provider quota checks for every SKU across all candidate regions
+3. If restricted-offer services are in the input, run the offer restriction check for each database service in each candidate region per `sku-quota-validation.md` § Offer Restriction Check
+4. Return results per the Output schema above (≤500 tokens)
+
+## Anti-Patterns (from sku-quota-validation.md — repeated here as guardrails)
+
+- ⛔ `az vm list-usage` — wrong provider, misleading data
+- ⛔ `az appservice list-locations` — lists locations, NOT quota
+- ⛔ `az appservice list-usages` — wrong scope
+- ⛔ `mcp_azure_mcp_quota` — unreliable for App Service
+- ⛔ `az quota list` — extension loading fails on Windows
+- ⛔ Use `az rest` for ALL quota checks
+
+## Rules
+
+- ⛔ Paid ≠ unlimited — B1, Flex Consumption, Serverless all have per-subscription, per-region quotas (F1/Free are never selected — floor is B1)
+- ⛔ Check BOTH limit AND current usage — `limit=1, usage=1` means FULL
+- ⛔ For PostgreSQL/MySQL: run offer restriction check per `sku-quota-validation.md` § Offer Restriction Check
+
+## Token Budget
+
+≤500 tokens for quota results report.