Blame

8dbfc1 Anonymous 2026-08-07 13:49:00
Reverted commit 95a0e8.
1
# Home
2
3
---
4
title: 3netra Meta Android App — Engineering Wiki
5
aliases: [3netra Wiki, Meta App Wiki, Home]
6
tags: [3netra/wiki, moc]
7
product: 3netra Meta Android App
8
source_repository: 3Netra-ai/3n_meta_android
9
source_ref: origin/prod
10
source_revision: b48aada8fd5427b5db0c02945569963c4ae543c8
11
last_verified: 2026-08-06
12
---
13
14
# 🦉 3netra Meta Android App — Engineering Wiki
15
16
> [!quote] Tagline
17
> **See the World. Learn Without Limits.**
18
19
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**.
20
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`.)
21
22
> [!info] Provenance
23
> 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]].
24
25
---
26
27
## 📚 Pages
28
29
| # | Page | Contents |
30
|---|------|----------|
31
| 1 | 01-Product-Overview | Mission, problem, goals/KPIs, personas |
32
| 2 | 02-System-Architecture | Architecture diagrams, repo layout, tech stack, backends |
33
| 3 | 03-Frontend-Navigation | Navigation graph, screen catalog, frontend flow chart |
34
| 4 | 04-User-Journeys | Student / teacher / caregiver journeys, gestures & voice |
35
| 5 | 05-Avatars-Companions | AI companion characters, voice personas |
36
| 6 | 06-Feature-Matrix | Implemented vs pending (PRD + roadmap) |
37
| 7 | 07-Services-APIs-Vendors | Full vendor/API inventory |
38
| 8 | 08-Data-Model-Supabase | Tables, columns, compliance (FERPA/COPPA) |
39
| 9 | 09-Design-System | Palette, typography, accessibility rules |
40
| 10 |10-Engineering-Ops | Build, test, deploy, config keys, known quirks |
41
| 11 |11-Security-Privacy-Compliance | Data classification, trust boundaries, FERPA/COPPA controls |
42
| 12 |12-Risks-Decisions | Risk register, open architecture decisions |
43
| 13 | 13-Source-Map-Glossary | Code→capability map, org doc sources, glossary |
44
45
> [!note] Archive
46
> An earlier audit-style draft of this wiki is preserved in `wiki/archive/` for reference.
47
48
---
49
50
## ⚡ 60-Second Summary
51
52
- **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.
53
- **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.
54
- **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]].
55
- **Mascot:** Netra the Owl 🦉 (+ Cosmo, Sage, Ripple companions). See [[05-Avatars-Companions]].
56
57
## 🗂 Key Facts
58
59
| Fact | Value |
60
|---|---|
61
| Primary codebase | `src/frontend/` (Kotlin, Compose) — minSdk 29, target 34, compile 35 |
62
| Secondary tree | `android/` — Expo/React Native shell (vestigial; JS sources absent) |
63
| Glasses SDK | Meta Wearables DAT (MWDAT) `0.7.0` — core, camera, mockdevice |
64
| Backend DB/Auth | Supabase (Postgres 17, GoTrue, PostgREST, Realtime) |
65
| Active AI path | Supabase `chat-vision` Edge Function → OpenAI `gpt-4o`; Android client currently discards the response |
66
| Voice (Indic) | Sarvam.ai (translate / TTS speaker "meera" / STT "saaras:v1") |
67
| Face recognition | FaceNet TFLite + cosine comparison against Supabase-fetched embeddings (threshold 0.5) |
68
| Legacy paths | Firebase Cloud Functions + Vercel function (Resend welcome emails) |
69
70
%%
71
Tags index: #3netra/wiki — all pages in this folder belong to the wiki MOC.
72
%%