# ashishsoni145/smartmind architecture

> Architecture diagram of the GitHub repository ashishsoni145/smartmind, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ashishsoni145/smartmind
- Repository: https://github.com/ashishsoni145/smartmind

## Overview

SharpMind is a cloud-first student academic platform with web, mobile, and backend code. The README explicitly says Phase 01 product features have not been implemented, so the repository tree alone is not evidence of a complete learning workflow. The clearest implemented runtime path in the excerpts is Android focus monitoring and intervention; backend assessment and student-model handlers are also represented. Several backend and web subsystems are present in the tree but their wiring was not sampled, so those relationships are omitted rather than inferred.

Main entry points: [`apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/FocusRuntime.kt`](https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/FocusRuntime.kt) (Focus runtime), [`apps/mobile/src/features/focus/useFocusSession.ts`](https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/src/features/focus/useFocusSession.ts) (Focus session hook), [`apps/mobile/android/app/src/main/java/com/sharpmind/app/services/FocusForegroundService.kt`](https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/services/FocusForegroundService.kt) (Foreground monitor), [`apps/mobile/android/app/src/main/java/com/sharpmind/app/MainApplication.kt`](https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/MainApplication.kt) (App runtime setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Mobile app"]
  node_mobile_app["Mobile shell<br/>[App.tsx]"]
  node_navigator["Navigation<br/>[RootNavigator.tsx]"]
  node_focus_hook["Focus session hook<br/>[useFocusSession.ts]"]
  node_focus_api["Focus API<br/>[index.ts]"]
  node_focus_sync["Focus outbox<br/>[focusSync.ts]"]
end

subgraph group_native["Android focus"]
  node_native_module["Native bridge"]
  node_app_runtime["App runtime setup<br/>[MainApplication.kt]"]
  node_focus_runtime["Focus runtime<br/>[FocusRuntime.kt]"]
  node_focus_service["Foreground monitor"]
  node_usage_manager["Usage access<br/>[AppUsageManager.kt]"]
  node_path_policy["Usage path policy<br/>[UsagePathPolicy.kt]"]
  node_accessibility["Accessibility service"]
  node_event_processor["Event processor"]
  node_restriction_engine["Restriction engine"]
  node_restriction_rules["Restriction rules<br/>[RestrictionRule.kt]"]
end

subgraph group_backend["Backend domains"]
  node_assessment_controller["Assessment handlers"]
  node_assessment_service["Assessment service"]
  node_student_model_controller["Student model handlers"]
  node_student_model_service["Student model service"]
  node_search_service["Search service<br/>[search.service.ts]"]
end

subgraph group_ai["AI platform"]
  node_ai_orchestrator["AI orchestration<br/>[orchestrator.ts]"]
end

node_student(("Student"))
node_database[("Supabase database")]

node_student -.->|"uses"| node_mobile_app
node_mobile_app -->|"renders"| node_navigator
node_focus_hook -->|"calls"| node_focus_api
node_focus_hook -->|"queues events"| node_focus_sync
node_focus_hook -->|"uses bridge"| node_native_module
node_app_runtime -->|"registers"| node_native_module
node_app_runtime -->|"initializes"| node_focus_runtime
node_focus_service -->|"ticks"| node_focus_runtime
node_focus_service -->|"reads usage"| node_usage_manager
node_focus_service -->|"checks path"| node_path_policy
node_accessibility -->|"submits events"| node_focus_runtime
node_accessibility -->|"processes events"| node_event_processor
node_focus_runtime -.->|"evaluates restrictions"| node_restriction_engine
node_restriction_engine -->|"applies"| node_restriction_rules
node_assessment_controller -->|"calls"| node_assessment_service
node_student_model_controller -->|"calls"| node_student_model_service
node_search_service -->|"queries"| node_database
node_assessment_service -.->|"persists"| node_database
node_student_model_service -.->|"persists"| node_database

click node_mobile_app "https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/src/app/App.tsx"
click node_navigator "https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/src/navigation/RootNavigator.tsx"
click node_focus_hook "https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/src/features/focus/useFocusSession.ts"
click node_focus_api "https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/src/api/index.ts"
click node_focus_sync "https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/src/features/focus/focusSync.ts"
click node_native_module "https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/bridge/SharpMindAndroidModule.kt"
click node_app_runtime "https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/MainApplication.kt"
click node_focus_runtime "https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/FocusRuntime.kt"
click node_focus_service "https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/services/FocusForegroundService.kt"
click node_usage_manager "https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/usage/AppUsageManager.kt"
click node_path_policy "https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/UsagePathPolicy.kt"
click node_accessibility "https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/accessibility/SharpMindAccessibilityService.kt"
click node_event_processor "https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/accessibility/AccessibilityEventProcessor.kt"
click node_restriction_engine "https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/RestrictionEngine.kt"
click node_restriction_rules "https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/RestrictionRule.kt"
click node_assessment_controller "https://github.com/ashishsoni145/smartmind/blob/main/backend/src/modules/assessments/assessment.controller.ts"
click node_assessment_service "https://github.com/ashishsoni145/smartmind/blob/main/backend/src/modules/assessments/assessment.service.ts"
click node_student_model_controller "https://github.com/ashishsoni145/smartmind/blob/main/backend/src/modules/student-model/student-model.controller.ts"
click node_student_model_service "https://github.com/ashishsoni145/smartmind/blob/main/backend/src/modules/student-model/student-model.service.ts"
click node_search_service "https://github.com/ashishsoni145/smartmind/blob/main/backend/src/modules/search/search.service.ts"
click node_ai_orchestrator "https://github.com/ashishsoni145/smartmind/blob/main/backend/src/ai/orchestrator.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mobile_app,node_navigator,node_focus_hook,node_focus_api,node_focus_sync toneBlue
class node_native_module,node_app_runtime,node_focus_runtime,node_focus_service,node_usage_manager,node_path_policy,node_accessibility,node_event_processor,node_restriction_engine,node_restriction_rules,node_database toneAmber
class node_assessment_controller,node_assessment_service,node_student_model_controller,node_student_model_service,node_search_service toneMint
class node_ai_orchestrator toneRose
class node_student toneIndigo
```

## Components

### Mobile app

- [Mobile shell](https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/src/app/App.tsx): `apps/mobile/src/app/App.tsx`
- [Navigation](https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/src/navigation/RootNavigator.tsx): `apps/mobile/src/navigation/RootNavigator.tsx`
- [Focus session hook](https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/src/features/focus/useFocusSession.ts): `apps/mobile/src/features/focus/useFocusSession.ts`
- [Focus API](https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/src/api/index.ts): `apps/mobile/src/api/index.ts`
- [Focus outbox](https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/src/features/focus/focusSync.ts): `apps/mobile/src/features/focus/focusSync.ts`

### Android focus

- [Native bridge](https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/bridge/SharpMindAndroidModule.kt): `apps/mobile/android/app/src/main/java/com/sharpmind/app/bridge/SharpMindAndroidModule.kt`
- [App runtime setup](https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/MainApplication.kt): `apps/mobile/android/app/src/main/java/com/sharpmind/app/MainApplication.kt`
- [Focus runtime](https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/FocusRuntime.kt): `apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/FocusRuntime.kt`
- [Foreground monitor](https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/services/FocusForegroundService.kt): `apps/mobile/android/app/src/main/java/com/sharpmind/app/services/FocusForegroundService.kt`
- [Usage access](https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/usage/AppUsageManager.kt): `apps/mobile/android/app/src/main/java/com/sharpmind/app/usage/AppUsageManager.kt`
- [Usage path policy](https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/UsagePathPolicy.kt): `apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/UsagePathPolicy.kt`
- [Accessibility service](https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/accessibility/SharpMindAccessibilityService.kt): `apps/mobile/android/app/src/main/java/com/sharpmind/app/accessibility/SharpMindAccessibilityService.kt`
- [Event processor](https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/accessibility/AccessibilityEventProcessor.kt): `apps/mobile/android/app/src/main/java/com/sharpmind/app/accessibility/AccessibilityEventProcessor.kt`
- [Restriction engine](https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/RestrictionEngine.kt): `apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/RestrictionEngine.kt`
- [Restriction rules](https://github.com/ashishsoni145/smartmind/blob/main/apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/RestrictionRule.kt): `apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/RestrictionRule.kt`

### Backend domains

- [Assessment handlers](https://github.com/ashishsoni145/smartmind/blob/main/backend/src/modules/assessments/assessment.controller.ts): `backend/src/modules/assessments/assessment.controller.ts`
- [Assessment service](https://github.com/ashishsoni145/smartmind/blob/main/backend/src/modules/assessments/assessment.service.ts): `backend/src/modules/assessments/assessment.service.ts`
- [Student model handlers](https://github.com/ashishsoni145/smartmind/blob/main/backend/src/modules/student-model/student-model.controller.ts): `backend/src/modules/student-model/student-model.controller.ts`
- [Student model service](https://github.com/ashishsoni145/smartmind/blob/main/backend/src/modules/student-model/student-model.service.ts): `backend/src/modules/student-model/student-model.service.ts`
- [Search service](https://github.com/ashishsoni145/smartmind/blob/main/backend/src/modules/search/search.service.ts): `backend/src/modules/search/search.service.ts`

### AI platform

- [AI orchestration](https://github.com/ashishsoni145/smartmind/blob/main/backend/src/ai/orchestrator.ts): `backend/src/ai/orchestrator.ts`

### Other components

- **Student**
- **Supabase database**

## Connections

- Student → Mobile shell: uses
- Mobile shell → Navigation: renders (evidence: `apps/mobile/src/app/App.tsx`)
- Focus session hook → Focus API: calls (evidence: `apps/mobile/src/features/focus/useFocusSession.ts`)
- Focus session hook → Focus outbox: queues events (evidence: `apps/mobile/src/features/focus/useFocusSession.ts`)
- Focus session hook → Native bridge: uses bridge (evidence: `apps/mobile/src/features/focus/useFocusSession.ts`)
- App runtime setup → Native bridge: registers (evidence: `apps/mobile/android/app/src/main/java/com/sharpmind/app/MainApplication.kt`)
- App runtime setup → Focus runtime: initializes (evidence: `apps/mobile/android/app/src/main/java/com/sharpmind/app/MainApplication.kt`)
- Foreground monitor → Focus runtime: ticks (evidence: `apps/mobile/android/app/src/main/java/com/sharpmind/app/services/FocusForegroundService.kt`)
- Foreground monitor → Usage access: reads usage (evidence: `apps/mobile/android/app/src/main/java/com/sharpmind/app/services/FocusForegroundService.kt`)
- Foreground monitor → Usage path policy: checks path (evidence: `apps/mobile/android/app/src/main/java/com/sharpmind/app/services/FocusForegroundService.kt`)
- Accessibility service → Focus runtime: submits events (evidence: `apps/mobile/android/app/src/main/java/com/sharpmind/app/accessibility/SharpMindAccessibilityService.kt`)
- Accessibility service → Event processor: processes events (evidence: `apps/mobile/android/app/src/main/java/com/sharpmind/app/accessibility/SharpMindAccessibilityService.kt`)
- Focus runtime → Restriction engine: evaluates restrictions
- Restriction engine → Restriction rules: applies (evidence: `apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/RestrictionEngine.kt`)
- Assessment handlers → Assessment service: calls (evidence: `backend/src/modules/assessments/assessment.controller.ts`)
- Student model handlers → Student model service: calls (evidence: `backend/src/modules/student-model/student-model.controller.ts`)
- Search service → Supabase database: queries (evidence: `backend/src/modules/search/search.service.ts`)
- Assessment service → Supabase database: persists
- Student model service → Supabase database: persists
