Sven laptop
635a130f0b
### 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
4.1 KiB
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.
MCP Tool Reference — Shared Index
Shared tools used across multiple AppOnboard phases, plus the cross-cutting Phase→Tool Map. For phase-specific tools with full parameter tables, see the per-phase references linked below.
Troubleshooting: If a tool call fails with unknown parameter or missing command errors, consult the official docs for current parameter names and allowed values: https://learn.microsoft.com/en-us/azure/developer/azure-mcp-server/tools/
Per-Phase Tool References
| Phase | File | Exclusive Tools |
|---|---|---|
| Prereq | (shared tools only — see table below) | (shared only) |
| Prepare | mcp-tools.md | pricing, quota, cloudarchitect, WAF, advisor, group_resource_list, policy |
| Scaffold | mcp-tools.md | bicepschema, all mcp_bicep_*, deploy (iac_rules/pipeline/plan), terraform best practices |
| Deploy | mcp-tools.md | resourcehealth, monitor, appservice, deploy (app_logs/arch_diagram), role |
Global Parameters (all tools)
Every Azure MCP tool accepts these optional parameters in addition to its own:
| Parameter | Description |
|---|---|
subscription |
Azure subscription ID or display name. Defaults to az account show default. |
tenant |
Entra ID tenant GUID or name. Uses default tenant if omitted. |
resource-group |
Resource group name. Required for most resource-specific operations. |
Additional global params (not commonly needed by AppOnboard):
authentication-method(credential|key|connectionString),max-retries(default 3),retry-delay(default 2s),retry-delay-maximum(default 10s),retry-mode(fixed|exponential),retry-network-timeout(default 100s). See official docs for details.
Shared Tools (used by 2+ phases)
mcp_azure_mcp_subscription_list
| Required | Optional | Read-Only |
|---|---|---|
| (none) | tenant |
✅ |
Returns: subscriptionId, displayName, state, tenantId, isDefault. Use isDefault: true as default subscription.
Used by: prepare (Step 1), deploy (Step 1)
mcp_azure_mcp_group_list
| Required | Optional | Read-Only |
|---|---|---|
| (none) | subscription, tenant |
✅ |
Returns: resource group names and IDs as JSON array.
Used by: prepare (Step 7), deploy (Step 3)
mcp_azure_mcp_extension_cli_install
| Required | Optional | Read-Only |
|---|---|---|
cli-type (az|azd|func) |
tenant |
✅ |
Returns: installation instructions for the specified CLI tool.
Used by: prereq (Step 2), deploy (Step 3)
mcp_azure_mcp_get_azure_bestpractices (hierarchical)
| Sub-command | Required Params | Optional Params | Read-Only |
|---|---|---|---|
get_azure_bestpractices_get |
resource (general|azurefunctions|static-web-app|coding-agent), action (all|code-generation|deployment) |
— | ✅ |
get_azure_bestpractices_ai_app |
(none) | — | ✅ |
Usage: resource + action are both required for _get. For static-web-app and coding-agent, only action: "all" is supported.
Used by: prereq (Step 3), scaffold (Step 5)
Tool Pitfalls
mcp_azure_mcp_subscription_listis slow at scale: Returns ALL subscriptions across ALL tenants (238+ in large orgs), causing lengthy picker detours. Useaz account showfor the active subscription (<1 second). Reservesubscription_listfor prepare Step 1 when the user explicitly wants a different subscription.