Skip to content

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 ​

CategoryCountSeverity
Security63 Critical, 3 High
Testing7All High (medical data app with 0% coverage)
CI/CD6High (no automation)
Code Quality5Medium
Compliance4High (regulatory requirement)
Total28

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) ​

  1. TD-SEC-06 — Data residency routing (compliance blocker)
  2. TD-CICD-01 — Mobile lint/type-check on PR
  3. TD-CICD-05 — EAS secrets setup
  4. TD-QUALITY-01 — Enhanced ESLint config
  5. TD-TEST-01/02 — Test baseline + RNTL install

Short-term (Sprint 2-3) ​

  1. TD-SEC-05 — MMKV encryption key (RESOLVED via #634)
  2. TD-SEC-04 — Token refresh flow
  3. TD-TEST-03 — Geofencing unit tests
  4. TD-TEST-04 — Auth flow tests
  5. TD-CICD-02 — Jest CI gate

Medium-term (Sprint 4-6) ​

  1. TD-SEC-02 — Certificate pinning
  2. TD-SEC-03 — Jailbreak detection + CSP
  3. TD-SEC-01 / #565 — better-auth migration
  4. TD-TEST-06 — E2E tests (Maestro)
  5. TD-COMP-01-04 — Compliance implementation

Note: All 29 issues were raised as part of the mobile tech debt assessment on 2026-02-17.

Internal documentation — org members only