docs: clarify data storage — what syncs to cloud vs local-only

Author: Partha-dev01

README.md

@@ -199,13 +199,31 @@ AutiSense/
 
 ---
 
-## Privacy Architecture
+## Data Architecture
+
+### What's stored where
+
+| Data | Storage | Syncs to Cloud? | Cross-Device? |
+|------|---------|-----------------|---------------|
+| **Screening sessions** | IndexedDB → DynamoDB | Yes (opt-in, anonymized) | Yes (after sync) |
+| **Biomarker scores** | IndexedDB → DynamoDB | Yes (opt-in, anonymized) | Yes (after sync) |
+| **User account** | DynamoDB | Always (Google OAuth) | Yes |
+| **Game progress & scores** | IndexedDB only | No | No |
+| **Daily streaks** | IndexedDB only | No | No |
+| **Weekly reports** | IndexedDB only | No | No |
+| **Chat history** | IndexedDB only | No | No |
+| **Child profiles** | IndexedDB only | No | No |
+| **Difficulty levels** | localStorage only | No | No |
+
+> **Note**: Game progress, streaks, and weekly reports are stored locally in the browser only. Switching devices or clearing browser data will reset this data. This is by design -- game activity data never leaves the device.
+
+### Privacy architecture
 
 AutiSense follows a **zero-egress screening** model:
 
 1. **On-device inference** -- All 4 AI models (YOLO, BodyTCN, FER+, FaceTCN) run in a Web Worker via ONNX Runtime Web. No video frames, keypoints, or inference results are transmitted to any server.
-2. **Local-first storage** -- All screening data lives in IndexedDB (Dexie). The app works fully offline.
-3. **Opt-in cloud sync** -- An explicit consent checkbox at Step 10 controls whether anonymized biomarker scores are synced to DynamoDB. Child names are stripped before upload.
+2. **Local-first storage** -- All game and screening data lives in IndexedDB (Dexie). The app works fully offline.
+3. **Opt-in cloud sync** -- Only anonymized screening sessions and biomarker scores are synced to DynamoDB. Child names are stripped before upload. Game activity stays local.
 4. **Cloud AI enrichment** -- Only aggregated biomarker scores (not raw data) are sent to Amazon Bedrock for report generation. This step is optional and has template-based fallbacks.
 5. **Data expiry** -- DynamoDB records have a 365-day TTL and auto-expire.
 

docs/DOCS.md

@@ -406,18 +406,20 @@ All API routes have **mock fallbacks** — the app works without AWS credentials
 
 ### IndexedDB Schema (Dexie v5)
 
-| Table | Primary Key | Indexes | Purpose |
-|-------|-------------|---------|---------|
-| `sessions` | `id` | `userId`, `createdAt`, `synced`, `status` | Screening sessions |
-| `biomarkers` | `++id` (auto) | `sessionId`, `userId`, `timestamp`, `taskId` | Per-task biomarker data |
-| `syncQueue` | `++id` (auto) | `sessionId`, `queuedAt`, `retryCount` | Offline sync queue |
-| `childProfiles` | `id` | `userId`, `createdAt` | Child profiles |
-| `feedPosts` | `++id` (auto) | `userId`, `createdAt` | Community feed posts |
-| `feedReactions` | `++id` (auto) | `[postId+userId+type]`, `postId`, `userId` | Per-user reaction tracking |
-| `gameActivity` | `++id` (auto) | `childId`, `date`, `gameId` | Game session records |
-| `streaks` | `childId` | — | Daily play streak tracking |
-| `weeklyReports` | `++id` (auto) | `childId`, `weekStart` | Weekly progress summaries |
-| `chatHistory` | `++id` (auto) | `childId`, `createdAt` | AI chat conversations |
+> **Important**: All IndexedDB data is stored in the user's browser only. Game progress, streaks, weekly reports, and chat history do NOT sync to the cloud. Switching devices or clearing browser data resets this data. Only `sessions` and `biomarkers` sync to DynamoDB (opt-in, anonymized).
+
+| Table | Primary Key | Indexes | Syncs to Cloud? |
+|-------|-------------|---------|-----------------|
+| `sessions` | `id` | `userId`, `createdAt`, `synced`, `status` | **Yes** (opt-in, anonymized) |
+| `biomarkers` | `++id` (auto) | `sessionId`, `userId`, `timestamp`, `taskId` | **Yes** (opt-in, anonymized) |
+| `syncQueue` | `++id` (auto) | `sessionId`, `queuedAt`, `retryCount` | N/A (queue mechanism) |
+| `childProfiles` | `id` | `userId`, `createdAt` | **No** (local only) |
+| `gameActivity` | `++id` (auto) | `childId`, `date`, `gameId` | **No** (local only) |
+| `streaks` | `childId` | — | **No** (local only) |
+| `weeklyReports` | `++id` (auto) | `childId`, `weekStart` | **No** (local only) |
+| `chatHistory` | `++id` (auto) | `childId`, `createdAt` | **No** (local only) |
+| `feedPosts` | `++id` (auto) | `userId`, `createdAt` | **No** (unused — API serves feed) |
+| `feedReactions` | `++id` (auto) | `[postId+userId+type]`, `postId`, `userId` | **No** (unused — API serves feed) |
 
 ### Biomarker Fields