Blame
|
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]] |
|||||||
