docs(audit): align documentation with post-remediation backend reality

- Update data model enums to match backend models
- Update API reference auth requirements
- Add dispute module references and warning blocks
- Add 2026-05-24 audit remediation callout to Overview
- Generate task breakdowns and audit artifacts
- Add doc alignment report (.taskmaster/reports/)

Taskmaster/Tasks/task-5-4.md

@@ -0,0 +1,35 @@
+---
+taskmaster_id: "5.4"
+status: "pending"
+priority: "high"
+depends_on: ["1", "2"]
+parent_id: "5"
+source: "taskmaster"
+generated_at: "2026-05-24T07:15:25.199Z"
+---
+
+# 5.4 - Build Telegram Mini App shell for marketplace workflows
+
+- [ ] 5.4 - Build Telegram Mini App shell for marketplace workflows #taskmaster #priority/high #status/pending ⏫ 🆔 tm-5-4 ⛔ tm-1 ⛔ tm-2
+
+## Metadata
+
+| Field | Value |
+| --- | --- |
+| Taskmaster ID | 5.4 |
+| Status | pending |
+| Priority | high |
+| Dependencies | 1, 2 |
+| Parent | 5 - Deliver Telegram-native app, bot, and wallet experience |
+
+## Description
+
+Deliver the mobile-first Mini App that gives users the full Amanat workflow surface inside Telegram.
+
+## Details
+
+Use Telegram theme, safe-area, viewport, back button, haptics, and main/bottom button patterns. Support browsing requests, creating/editing requests, reviewing offers, payment state, evidence uploads, delivery actions, and dispute actions. Launch from bot profile, menu button, inline buttons, and direct links with startapp context. Handle unlinked accounts, expired sessions, unsupported clients, and fallback web links.
+
+## Verification
+
+See Telegram-native PRD acceptance criteria.