Document telegram-native task 5 foundation

09 - Audits/Task 5.4 Telegram Mini App Shell Implementation.md

@@ -0,0 +1,42 @@
+---
+title: Task 5.4 Telegram Mini App Shell Implementation
+tags: [taskmaster, telegram, mini-app, frontend]
+created: 2026-05-24
+status: partial-foundation
+---
+
+# Task 5.4 Telegram Mini App Shell Implementation
+
+This document captures the first frontend implementation pass for the Telegram
+Mini App surface.
+
+## Implemented foundation
+
+- Added `/telegram` route.
+- Added `src/utils/telegram-webapp.ts` for safe Telegram WebApp context parsing.
+- Added `TelegramMiniAppShell` with three first-pass states:
+  - unsupported browser context,
+  - Telegram detected but unlinked,
+  - Telegram detected and authenticated web user present.
+- Added basic marketplace/escrow action cards for requests, request creation,
+  payment/escrow, chat, and account.
+- Added Telegram chrome attachment helper for MainButton, BackButton, and haptic
+  feedback when available.
+- Added safe-area and Telegram theme helpers.
+
+## Tests
+
+- `frontend/__tests__/utils-test/telegram-webapp.test.ts`
+- `frontend/__tests__/sections/telegram/telegram-mini-app-shell.test.tsx`
+
+Coverage includes standard browser fallback, Telegram context parsing,
+safe-area/theme fallback, start parameter parsing, unsupported state, unlinked
+state, and linked state rendering.
+
+## Remaining work
+
+- Wire Mini App shell to backend Telegram session endpoints.
+- Add request/offer/payment/dispute data loading inside the Mini App route.
+- Add upload and dispute action surfaces that call canonical backend APIs.
+- Add Telegram BackButton routing behavior once final navigation stack is known.
+- Add client matrix QA across iOS, Android, Desktop, and Web Telegram clients.