Commit f25158
2026-08-07 11:48:26 admin: init| /dev/null .. home.md | |
| @@ 0,0 1,70 @@ | |
| + | --- |
| + | title: 3netra Meta Android App — Engineering Wiki |
| + | aliases: [3netra Wiki, Meta App Wiki, Home] |
| + | tags: [3netra/wiki, moc] |
| + | product: 3netra Meta Android App |
| + | source_repository: 3Netra-ai/3n_meta_android |
| + | source_ref: origin/prod |
| + | source_revision: b48aada8fd5427b5db0c02945569963c4ae543c8 |
| + | last_verified: 2026-08-06 |
| + | --- |
| + | |
| + | # 🦉 3netra Meta Android App — Engineering Wiki |
| + | |
| + | > [!quote] Tagline |
| + | > **See the World. Learn Without Limits.** |
| + | |
| + | AI-powered learning companion for blind & visually impaired higher education students (high school and college), pairing **Meta Ray-Ban smart glasses** with a native **Kotlin/Jetpack Compose Android app**. |
| + | Canonical source repo: `3Netra-ai/3n_meta_android` · Package: `com.threenetra.app` · Status: active development. (The inspected local checkout is named `archived-3n-meta-app`.) |
| + | |
| + | > [!info] Provenance |
| + | > Wiki implementation claims were audited **2026-08-06** from `origin/prod` at `b48aada8fd5427b5db0c02945569963c4ae543c8` (2026-08-05, merge PR #11 cleanup). PRD and roadmap statements are explicitly non-implementation evidence. See [[13-Source-Map-Glossary#Maintenance protocol|maintenance protocol]]. |
| + | |
| + | --- |
| + | |
| + | ## 📚 Pages |
| + | |
| + | | # | Page | Contents | |
| + | |---|------|----------| |
| + | | 1 | [[01-Product-Overview\|Product Overview]] | Mission, problem, goals/KPIs, personas | |
| + | | 2 | [[02-System-Architecture\|System Architecture]] | Architecture diagrams, repo layout, tech stack, backends | |
| + | | 3 | [[03-Frontend-Navigation\|Frontend & Navigation]] | Navigation graph, screen catalog, frontend flow chart | |
| + | | 4 | [[04-User-Journeys\|User Journeys]] | Student / teacher / caregiver journeys, gestures & voice | |
| + | | 5 | [[05-Avatars-Companions\|Avatars & Companions]] | AI companion characters, voice personas | |
| + | | 6 | [[06-Feature-Matrix\|Feature Matrix]] | Implemented vs pending (PRD + roadmap) | |
| + | | 7 | [[07-Services-APIs-Vendors\|Services, APIs & Vendors]] | Full vendor/API inventory | |
| + | | 8 | [[08-Data-Model-Supabase\|Data Model (Supabase)]] | Tables, columns, compliance (FERPA/COPPA) | |
| + | | 9 | [[09-Design-System\|Design System]] | Palette, typography, accessibility rules | |
| + | | 10 | [[10-Engineering-Ops\|Engineering Ops]] | Build, test, deploy, config keys, known quirks | |
| + | | 11 | [[11-Security-Privacy-Compliance\|Security, Privacy & Compliance]] | Data classification, trust boundaries, FERPA/COPPA controls | |
| + | | 12 | [[12-Risks-Decisions\|Risks & Decisions]] | Risk register, open architecture decisions | |
| + | | 13 | [[13-Source-Map-Glossary\|Source Map & Glossary]] | Code→capability map, org doc sources, glossary | |
| + | |
| + | > [!note] Archive |
| + | > An earlier audit-style draft of this wiki is preserved in `wiki/archive/` for reference. |
| + | |
| + | --- |
| + | |
| + | ## ⚡ 60-Second Summary |
| + | |
| + | - **What is wired:** Compose screens attempt glasses capture, Supabase Edge Function invocation, Android speech, face enrollment/matching, chat, notes, and in-memory story UI. At this revision `SupabaseAiService` discards every successful model reply and returns fixed success text; those assistance flows are not verified as useful end-to-end. |
| + | - **How:** Native Kotlin app (`src/frontend/`) — single activity, Jetpack Compose, service-singleton architecture. Meta **MWDAT 0.7.0** capture/registration code is present, but gesture callbacks and hardware behavior are untested. Active AI calls target Supabase `chat-vision`; the AWS `/api/chat` client/prototype is unreferenced by production app code. |
| + | - **Privacy status:** cloud `face_embeddings` are the active enrollment/matching path. Local encrypted 90-day storage is unreferenced; schema/RLS/consent claims are not proven. See [[08-Data-Model-Supabase]]. |
| + | - **Mascot:** Netra the Owl 🦉 (+ Cosmo, Sage, Ripple companions). See [[05-Avatars-Companions]]. |
| + | |
| + | ## 🗂 Key Facts |
| + | |
| + | | Fact | Value | |
| + | |---|---| |
| + | | Primary codebase | `src/frontend/` (Kotlin, Compose) — minSdk 29, target 34, compile 35 | |
| + | | Secondary tree | `android/` — Expo/React Native shell (vestigial; JS sources absent) | |
| + | | Glasses SDK | Meta Wearables DAT (MWDAT) `0.7.0` — core, camera, mockdevice | |
| + | | Backend DB/Auth | Supabase (Postgres 17, GoTrue, PostgREST, Realtime) | |
| + | | Active AI path | Supabase `chat-vision` Edge Function → OpenAI `gpt-4o`; Android client currently discards the response | |
| + | | Voice (Indic) | Sarvam.ai (translate / TTS speaker "meera" / STT "saaras:v1") | |
| + | | Face recognition | FaceNet TFLite + cosine comparison against Supabase-fetched embeddings (threshold 0.5) | |
| + | | Legacy paths | Firebase Cloud Functions + Vercel function (Resend welcome emails) | |
| + | |
| + | %% |
| + | Tags index: #3netra/wiki — all pages in this folder belong to the wiki MOC. |
| + | %% |