Commit 24b4aa
2026-08-07 11:37:38 admin: init| /dev/null .. source map & glossary.md | |
| @@ 0,0 1,115 @@ | |
| + | --- |
| + | title: Source Map and Glossary |
| + | aliases: [Glossary, Source Map] |
| + | tags: [3netra/wiki, glossary, sources] |
| + | product: 3netra Meta Android App |
| + | source_repository: 3Netra-ai/3n_meta_android |
| + | source_ref: origin/prod |
| + | source_revision: b48aada8fd5427b5db0c02945569963c4ae543c8 |
| + | last_verified: 2026-08-06 |
| + | up: "[[Home]]" |
| + | --- |
| + | |
| + | # Source Map and Glossary |
| + | |
| + | ## Evidence hierarchy |
| + | |
| + | 1. Active source and build configuration. |
| + | 2. Automated tests and CI behavior. |
| + | 3. Repository documentation that matches active source. |
| + | 4. Progress notes and meeting claims. |
| + | 5. PRDs, Jira acceptance criteria, roadmaps, and future matrices. |
| + | |
| + | ## Implementation source map |
| + | |
| + | 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`. |
| + | |
| + | | Topic | Primary source | |
| + | |---|---| |
| + | | Compose build | `src/frontend/settings.gradle`, `src/frontend/app/build.gradle` | |
| + | | Secondary Expo app | `settings.gradle.kts`, `android/app/` | |
| + | | CI | `.github/workflows/android-build.yml` | |
| + | | Startup/auth routing | `src/frontend/app/src/main/kotlin/com/threenetra/app/MainActivity.kt`, `MainViewModel.kt` | |
| + | | Navigation | `src/frontend/app/src/main/kotlin/com/threenetra/app/ui/Navigation.kt` | |
| + | | Student home | `.../ui/student/StudentHomeScreen.kt` | |
| + | | Visual chat | `.../ui/student/AssistantChatScreen.kt` | |
| + | | Scene modes | `.../ui/student/SceneDescriptionScreen.kt` | |
| + | | Story/history | `.../ui/student/TodaysStoryScreen.kt` | |
| + | | Face enrollment/list | `.../ui/student/FaceRegistrationScreen.kt`, `ClassmatesScreen.kt` | |
| + | | Lecture notes | `.../ui/student/LectureNotesScreen.kt` | |
| + | | Settings/companions | `.../ui/student/SettingsScreen.kt`, `CompanionSelectScreen.kt` | |
| + | | Supabase | `.../services/SupabaseService.kt` | |
| + | | Active AI client | `.../services/SupabaseAiService.kt`, `supabase/functions/chat-vision/index.ts` | |
| + | | AWS prototype | `.../services/AwsBackendService.kt`, `src/backend/template.yaml`, `src/backend/src/app.js` | |
| + | | Meta camera | `.../services/WearableCameraService.kt` | |
| + | | Speech | `.../services/VoiceCommandService.kt`, `AudioTranscriptionService.kt` | |
| + | | Sarvam | `.../services/SarvamService.kt` | |
| + | | Face model | `.../ml/FaceNetModel.kt` | |
| + | | Local biometric utility | `.../utils/EncryptedFaceStorageManager.kt` | |
| + | | PDF export | `.../utils/PdfExportManager.kt` | |
| + | | Permissions/components | `src/frontend/app/src/main/AndroidManifest.xml` | |
| + | | Build/test/CI | `src/frontend/app/build.gradle`, `src/frontend/app/src/test/`, `.github/workflows/android-build.yml`, `.github/workflows/deploy-backend.yml` | |
| + | |
| + | ## Product-memory source map |
| + | |
| + | | Source | Use | |
| + | |---|---| |
| + | | [[3n Meta app Context Mesh]] | Current-functionality claims, feature roadmap, Q2 epics | |
| + | | [[Mayukh progress]] | Supabase/data model and historical delivery claims | |
| + | | [[JIRA_TICKET_AI_CHAT]] | AI chat acceptance criteria and definition of done | |
| + | | `../../3n-Pod_Glass-POC/3Netra_Glass_Feature_Technical_Matrix.md` | P0/P1 requirements, targets, proposed vendors, hardware roadmap | |
| + | | `../../3n-DesignSystem/README.md` | Product voice, visuals, accessibility, mascot concepts | |
| + | | [[Org Meeting logs and Action Items]] | Delivery claims and organizational follow-ups | |
| + | |
| + | ## Issue and pull-request register |
| + | |
| + | | Reference | Verified meaning | |
| + | |---|---| |
| + | | Local AI-chat story draft | [[JIRA_TICKET_AI_CHAT]]; no Jira key, URL, assignee, or sprint is recorded | |
| + | | Harness PR #1 | Local merge commit `a933ced`, "add-hermes-integration-skills"; not app implementation evidence | |
| + | | Harness PR #2 | Local merge commit `63ec6cf`, "harness-readme-and-restructure"; not app implementation evidence | |
| + | |
| + | 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. |
| + | |
| + | ## Generated and reference artifacts |
| + | |
| + | | Artifact | Purpose/status | |
| + | |---|---| |
| + | | `../3Netra_Feature_Technical_Matrix.pdf` | Three-page Meta-app feature matrix; requirements/reference, not implementation proof | |
| + | | `../../3n-Pod_Glass-POC/3Netra - Pod & Glass - PitchDeck.pdf` | Product pitch deck; reference only | |
| + | | `../../3n-Pod_Glass-POC/ShortDemo.pdf` | Product demo document; reference only | |
| + | | `../../3n-Pod_Glass-POC/Feature-Manual.png` | Feature manual image; reference only | |
| + | | `3nApp-Mobile/3Netra_Feature_Technical_Matrix.pdf` | Android-repository feature matrix; reference only | |
| + | |
| + | ## Glossary |
| + | |
| + | | Term | Meaning | |
| + | |---|---| |
| + | | DAT | Meta Wearables Device Access Toolkit used for registration, device state, and capture | |
| + | | VLM | Vision-language model that answers questions about images/video | |
| + | | OCR | Optical character recognition | |
| + | | TTS / STT | Text-to-speech / speech-to-text | |
| + | | Face embedding | Numeric representation used to compare faces; biometric data | |
| + | | RLS | PostgreSQL row-level security, used by Supabase to authorize rows | |
| + | | PostgREST | Supabase's REST data API over PostgreSQL | |
| + | | Companion | Student-selected AI guide/avatar | |
| + | | Student shell | Main four-tab Compose navigation surface | |
| + | | HAL | Planned hardware abstraction layer for multiple glasses vendors | |
| + | | Implemented | Verified active source path | |
| + | | Claimed | Historical note says delivered, without active-path proof | |
| + | |
| + | ## Maintenance protocol |
| + | |
| + | > [!important] Rules for updating this wiki |
| + | > - Update `last_verified` frontmatter when implementation is re-audited. |
| + | > - Keep implementation status separate from roadmap priority. |
| + | > - Cite a source path for every material status change. |
| + | > - Do not place credentials, raw student data, media, transcripts, or embeddings in this wiki. |
| + | > - When architecture changes, update the diagram and the corresponding status/risk entry in the same change. |
| + | > - Treat compliance statements as requirements until technical controls and review evidence exist. |
| + | > - Record the canonical repository, immutable revision, and audit date when changing implementation claims. |
| + | |
| + | --- |
| + | |
| + | > [!tip] Navigation |
| + | > ⬅️ [[12-Risks-Decisions|Risks & Decisions]] · 🏠 [[Home]] |