PPP Mobile App — Tech Debt Register
This document is the consolidated tech debt register for the PPP mobile app. Each item links to the corresponding GitHub Issue raised for tracking and prioritisation.
Overview
| Category | Count | Severity |
|---|---|---|
| Security | 6 | 3 Critical, 3 High |
| Testing | 7 | All High (medical data app with 0% coverage) |
| CI/CD | 6 | High (no automation) |
| Code Quality | 5 | Medium |
| Compliance | 4 | High (regulatory requirement) |
| Total | 28 |
Security Debt
TD-SEC-01: WebView localStorage Token Extraction
Issue: #565 (existing), #628 (better-auth migration) Files: app/index.tsx:97–166Risk: XSS-escalation, token interception, fragile string key matching (idToken) Effort: Large — requires new auth architecture Severity: Critical
TD-SEC-02: No Certificate Pinning
Issue: #629Files: lib/utils/trpcClient.tsRisk: MITM attack on hospital WiFi; medical data exposure Effort: Medium — add react-native-ssl-pinning or OkHttp pinning Severity: Critical
TD-SEC-03: No Content Security Policy / Jailbreak Detection
Issue: #630Files: app/index.tsx, app/(tabs)/_layout.tsxRisk: Compromised device can bypass all security controls Effort: Small-Medium Severity: High
TD-SEC-04: No Token Refresh Flow
Issue: #632Files: lib/stores/sessionStore.ts, lib/utils/trpcClient.tsRisk: Expired tokens cause silent API failures; data loss in background tasks Effort: Medium Severity: High
TD-SEC-05: MMKV Encryption Key Not Configured (RESOLVED)
Issue: #634Files: lib/utils/storage.ts, lib/utils/encryption-key.tsResolution: MMKV now encrypted with AES-256; key stored in device Keychain/Keystore via expo-secure-store
TD-SEC-06: No Data Residency Routing
Issue: #636Files: lib/utils/trpcClient.ts, app.config.jsRisk: GDPR and AU Privacy Act violation for medical data Effort: Medium — routing logic + per-region EAS environment variables Severity: Critical
Testing Debt
TD-TEST-01: Zero Test Coverage
Issue: #631 (baseline setup) Risk: Regressions in medical data flows go undetected Effort: Large (ongoing) Severity: High
TD-TEST-02: No React Native Testing Library
Issue: #631Files: package.jsonRisk: Cannot write component tests without RNTL Effort: Small — pnpm add -D @testing-library/react-native @testing-library/jest-nativeSeverity: High
TD-TEST-03: No Geofencing Logic Tests
Issue: #635Files: lib/services/location-service.tsRisk: Race conditions in notificationLock untested; duplicate timesheets possible Effort: Medium Severity: High
TD-TEST-04: No Auth Flow Tests
Issue: #638Files: app/index.tsxRisk: Token extraction bugs will reach production undetected Effort: Medium — requires WebView mock Severity: High
TD-TEST-05: No Screen Smoke + Accessibility Tests
Issue: #637Effort: Medium (16 screens) Severity: Medium
TD-TEST-06: No E2E Tests
Issue: #639Risk: Critical user journeys (logbook entry, timesheet) untested Effort: Large Severity: High
TD-TEST-07: No Compliance Tests
Issue: #640Risk: GDPR/AU Privacy Act violations not caught by automated testing Effort: Medium Severity: High
CI/CD Debt
TD-CICD-01: No Mobile Lint/Type-Check on PR
Issue: #641Risk: TypeScript errors and lint issues merged without review Effort: Small — add mobile-ci.yml workflow Severity: High
TD-CICD-02: No Jest CI Gate
Issue: #643Effort: Small (once tests exist) Severity: High
TD-CICD-03: No EAS Build on uat Merge
Issue: #645Effort: Medium — requires EAS secrets setup Severity: Medium
TD-CICD-04: No EAS Build + Submit on main Merge
Issue: #647Effort: Medium Severity: Medium
TD-CICD-05: No EAS Secrets in GitHub Actions
Issue: #649Files: .github/ secrets Effort: Small (admin task) Severity: High (blocks CI/CD)
TD-CICD-06: No Maestro/Detox E2E Workflow
Issue: #651Effort: Large Severity: Medium
Code Quality Debt
TD-QUALITY-01: Minimal ESLint Config (2 rules)
Issue: #644Files: .eslintrc.jsonEffort: Small Severity: Medium
TD-QUALITY-02: No Explicit Prettier Config
Issue: #646Effort: Small Severity: Low
TD-QUALITY-03: No Pre-commit Hooks
Issue: #648Effort: Small Severity: Low
TD-QUALITY-04: yarn vs pnpm Divergence (RESOLVED)
Issue: #650Files: package.json, pnpm-lock.yamlEffort: Completed — migrated to pnpm Severity: Resolved
TD-QUALITY-05: Hardcoded 2-Second Delay
Issue: #652Files: lib/services/location-service.ts:621Effort: Small Severity: Low
Compliance Debt
TD-COMP-01: GDPR Article 32 Technical Measures
Issue: #653Severity: High (regulatory)
TD-COMP-02: Australian Privacy Act Implementation
Issue: #654Severity: High (regulatory)
TD-COMP-03: OWASP MSTG CI Gate
Issue: #655Severity: Medium
TD-COMP-04: Mobile Dependency Audit in Security Scan
Issue: #656Severity: Medium
Prioritisation
Immediate (Sprint 1)
- TD-SEC-06 — Data residency routing (compliance blocker)
- TD-CICD-01 — Mobile lint/type-check on PR
- TD-CICD-05 — EAS secrets setup
- TD-QUALITY-01 — Enhanced ESLint config
- TD-TEST-01/02 — Test baseline + RNTL install
Short-term (Sprint 2-3)
TD-SEC-05 — MMKV encryption key(RESOLVED via #634)- TD-SEC-04 — Token refresh flow
- TD-TEST-03 — Geofencing unit tests
- TD-TEST-04 — Auth flow tests
- TD-CICD-02 — Jest CI gate
Medium-term (Sprint 4-6)
- TD-SEC-02 — Certificate pinning
- TD-SEC-03 — Jailbreak detection + CSP
- TD-SEC-01 / #565 — better-auth migration
- TD-TEST-06 — E2E tests (Maestro)
- TD-COMP-01-04 — Compliance implementation
Note: All 29 issues were raised as part of the mobile tech debt assessment on 2026-02-17.