Blame

24b4aa admin 2026-08-07 11:37:38
init
1
---
2
title: Source Map and Glossary
3
aliases: [Glossary, Source Map]
4
tags: [3netra/wiki, glossary, sources]
5
product: 3netra Meta Android App
6
source_repository: 3Netra-ai/3n_meta_android
7
source_ref: origin/prod
8
source_revision: b48aada8fd5427b5db0c02945569963c4ae543c8
9
last_verified: 2026-08-06
10
up: "[[Home]]"
11
---
12
13
# Source Map and Glossary
14
15
## Evidence hierarchy
16
17
1. Active source and build configuration.
18
2. Automated tests and CI behavior.
19
3. Repository documentation that matches active source.
20
4. Progress notes and meeting claims.
21
5. PRDs, Jira acceptance criteria, roadmaps, and future matrices.
22
23
## Implementation source map
24
25
Paths below are relative to the reviewed canonical repository `3Netra-ai/3n_meta_android` at `origin/prod` `b48aada8fd5427b5db0c02945569963c4ae543c8` (2026-08-05, merge PR #11 cleanup). Its local checkout directory is named `archived-3n-meta-app`.
26
27
| Topic | Primary source |
28
|---|---|
29
| Compose build | `src/frontend/settings.gradle`, `src/frontend/app/build.gradle` |
30
| Secondary Expo app | `settings.gradle.kts`, `android/app/` |
31
| CI | `.github/workflows/android-build.yml` |
32
| Startup/auth routing | `src/frontend/app/src/main/kotlin/com/threenetra/app/MainActivity.kt`, `MainViewModel.kt` |
33
| Navigation | `src/frontend/app/src/main/kotlin/com/threenetra/app/ui/Navigation.kt` |
34
| Student home | `.../ui/student/StudentHomeScreen.kt` |
35
| Visual chat | `.../ui/student/AssistantChatScreen.kt` |
36
| Scene modes | `.../ui/student/SceneDescriptionScreen.kt` |
37
| Story/history | `.../ui/student/TodaysStoryScreen.kt` |
38
| Face enrollment/list | `.../ui/student/FaceRegistrationScreen.kt`, `ClassmatesScreen.kt` |
39
| Lecture notes | `.../ui/student/LectureNotesScreen.kt` |
40
| Settings/companions | `.../ui/student/SettingsScreen.kt`, `CompanionSelectScreen.kt` |
41
| Supabase | `.../services/SupabaseService.kt` |
42
| Active AI client | `.../services/SupabaseAiService.kt`, `supabase/functions/chat-vision/index.ts` |
43
| AWS prototype | `.../services/AwsBackendService.kt`, `src/backend/template.yaml`, `src/backend/src/app.js` |
44
| Meta camera | `.../services/WearableCameraService.kt` |
45
| Speech | `.../services/VoiceCommandService.kt`, `AudioTranscriptionService.kt` |
46
| Sarvam | `.../services/SarvamService.kt` |
47
| Face model | `.../ml/FaceNetModel.kt` |
48
| Local biometric utility | `.../utils/EncryptedFaceStorageManager.kt` |
49
| PDF export | `.../utils/PdfExportManager.kt` |
50
| Permissions/components | `src/frontend/app/src/main/AndroidManifest.xml` |
51
| Build/test/CI | `src/frontend/app/build.gradle`, `src/frontend/app/src/test/`, `.github/workflows/android-build.yml`, `.github/workflows/deploy-backend.yml` |
52
53
## Product-memory source map
54
55
| Source | Use |
56
|---|---|
57
| [[3n Meta app Context Mesh]] | Current-functionality claims, feature roadmap, Q2 epics |
58
| [[Mayukh progress]] | Supabase/data model and historical delivery claims |
59
| [[JIRA_TICKET_AI_CHAT]] | AI chat acceptance criteria and definition of done |
60
| `../../3n-Pod_Glass-POC/3Netra_Glass_Feature_Technical_Matrix.md` | P0/P1 requirements, targets, proposed vendors, hardware roadmap |
61
| `../../3n-DesignSystem/README.md` | Product voice, visuals, accessibility, mascot concepts |
62
| [[Org Meeting logs and Action Items]] | Delivery claims and organizational follow-ups |
63
64
## Issue and pull-request register
65
66
| Reference | Verified meaning |
67
|---|---|
68
| Local AI-chat story draft | [[JIRA_TICKET_AI_CHAT]]; no Jira key, URL, assignee, or sprint is recorded |
69
| Harness PR #1 | Local merge commit `a933ced`, "add-hermes-integration-skills"; not app implementation evidence |
70
| Harness PR #2 | Local merge commit `63ec6cf`, "harness-readme-and-restructure"; not app implementation evidence |
71
72
The audited Android source commit is merge PR #11, `b48aada8fd5427b5db0c02945569963c4ae543c8`, dated 2026-08-05. No implementation claim in this wiki relies on unverified PR narrative.
73
74
## Generated and reference artifacts
75
76
| Artifact | Purpose/status |
77
|---|---|
78
| `../3Netra_Feature_Technical_Matrix.pdf` | Three-page Meta-app feature matrix; requirements/reference, not implementation proof |
79
| `../../3n-Pod_Glass-POC/3Netra - Pod & Glass - PitchDeck.pdf` | Product pitch deck; reference only |
80
| `../../3n-Pod_Glass-POC/ShortDemo.pdf` | Product demo document; reference only |
81
| `../../3n-Pod_Glass-POC/Feature-Manual.png` | Feature manual image; reference only |
82
| `3nApp-Mobile/3Netra_Feature_Technical_Matrix.pdf` | Android-repository feature matrix; reference only |
83
84
## Glossary
85
86
| Term | Meaning |
87
|---|---|
88
| DAT | Meta Wearables Device Access Toolkit used for registration, device state, and capture |
89
| VLM | Vision-language model that answers questions about images/video |
90
| OCR | Optical character recognition |
91
| TTS / STT | Text-to-speech / speech-to-text |
92
| Face embedding | Numeric representation used to compare faces; biometric data |
93
| RLS | PostgreSQL row-level security, used by Supabase to authorize rows |
94
| PostgREST | Supabase's REST data API over PostgreSQL |
95
| Companion | Student-selected AI guide/avatar |
96
| Student shell | Main four-tab Compose navigation surface |
97
| HAL | Planned hardware abstraction layer for multiple glasses vendors |
98
| Implemented | Verified active source path |
99
| Claimed | Historical note says delivered, without active-path proof |
100
101
## Maintenance protocol
102
103
> [!important] Rules for updating this wiki
104
> - Update `last_verified` frontmatter when implementation is re-audited.
105
> - Keep implementation status separate from roadmap priority.
106
> - Cite a source path for every material status change.
107
> - Do not place credentials, raw student data, media, transcripts, or embeddings in this wiki.
108
> - When architecture changes, update the diagram and the corresponding status/risk entry in the same change.
109
> - Treat compliance statements as requirements until technical controls and review evidence exist.
110
> - Record the canonical repository, immutable revision, and audit date when changing implementation claims.
111
112
---
113
114
> [!tip] Navigation
115
> ⬅️ [[12-Risks-Decisions|Risks & Decisions]] · 🏠 [[Home]]