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
2.7 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.
Artifact write procedures for the prereq phase exit. Read at Step 4 of the readiness gate.
Write Artifacts
⛔ Write all 3 artifacts before exiting prereq. Downstream phases read these. ⛔ Use
createtool for ALL session files — NEVERpowershell. Terminal is OK ONLY for read-only ops: UUID generation, git info, file existence checks. ⛔ Path scoping: ALLcreatecalls target.copilot-azure/sessions/{uuid}/. After writing, read back to confirm correct path.
-
prereq-output.json— ⛔ Readprereq-schemas.tsforPrereqOutputinterface.⛔ Per-component verdicts MUST persist. Every entry in
components[]MUST include averdictsobject:{ "build", "completeness", "deployability" }with valuesPASS/WARN/FAIL(buildmay beSKIPPEDwhen build validation was skipped;completeness/deployabilityare neverSKIPPED). Downstream readiness scoring and the prepare phase read these — never omit them.⛔ Warnings MUST persist. Every ⚠️ WARN →
warnings[]:{ "id": "W-{ID}", "component", "axis", "summary", "detail", "fix", "fixPhase" }. BothfixandfixPhaseare required — validate before writing.⛔ Health endpoint: Write detected path to
healthEndpoint(e.g.,"/api/v1/health/"). If none →null+W-HEALTHwarning withfixPhase: "scaffold".⛔ Entry point: Write to
entryPoint(e.g.,"index.js").nullfor .NET/Go/Java (Oryx handles startup).⛔
postDeployRecommendations[]: For each ⚠️ WARN, write perPostDeployRecommendationschema fromsession-schemas.ts:{ "title", "reason", "effort": "low|medium|high", "services": [] }. -
context.json— ⛔ Useedit(notcreate— Step 1 already created it). Populatecomponents[],repo,detectedInfra[],detectedServices[],app.name(from primary component's project manifest or workspace root dir name). Append"prereq"tocompletedPhasesNOW (before presenting), setcurrentPhase: null, updatelastModifiedUtc. -
readiness-report.md— Summary table (Build/Completeness/Deployability verdicts), detected stack, all warnings with actionable detail. Clean markdown, no rigid template.
⛔ Phase exit gate: All 3 artifacts must exist. If any missing, write NOW.