# mokyusuf22-lang/insight-compass architecture

> Architecture diagram of the GitHub repository mokyusuf22-lang/insight-compass, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mokyusuf22-lang/insight-compass
- Repository: https://github.com/mokyusuf22-lang/insight-compass

## Overview

Be:More is a career-coaching application that combines guided onboarding, assessments, personalized skill paths, and human coaching. The principal user journey starts at the public entry point, continues through authentication and Aura onboarding, and leads to a dashboard and skill path; deeper assessments and coaching are additional product areas. The graph reflects route ownership and the sampled auth, goal-search, and coach-thread integrations. Other page-level backend wiring is not shown because its source was not sampled.

Main entry points: [`src/App.tsx`](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/App.tsx) (Route application), [`src/pages/AuraFlow.tsx`](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/AuraFlow.tsx) (Aura onboarding), [`src/integrations/supabase/client.ts`](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/integrations/supabase/client.ts) (Supabase client), [`src/pages/Auth.tsx`](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/Auth.tsx) (Sign-in and signup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and access"]
  node_app["Route application<br/>[App.tsx]"]
  node_landing["Public landing<br/>[Index.tsx]"]
  node_auth_page["Sign-in and signup<br/>[Auth.tsx]"]
end

subgraph group_journey["Personal development"]
  node_aura["Aura onboarding<br/>[AuraFlow.tsx]"]
  node_aura_logic["Aura flow logic<br/>[auraFlow.ts]"]
  node_goal_search["Goal search<br/>[useGoalSearch.ts]"]
  node_welcome["Personal dashboard<br/>[Welcome.tsx]"]
  node_skill_path["Skill path<br/>[SkillPath.tsx]"]
  node_phase_task["Path phase and task<br/>[PhasePage.tsx]"]
  node_plan_function["Aura plan service<br/>[index.ts]"]
end

subgraph group_assessments["Assessments"]
  node_assessment_pages["Assessment workflows<br/>[DISCAssessment.tsx]"]
  node_assessment_results["Assessment results<br/>[DISCResults.tsx]"]
end

subgraph group_coaching["Coaching operations"]
  node_my_coach["Client coaching<br/>[MyCoach.tsx]"]
  node_coach_portal["Coach portal<br/>[CoachDashboard.tsx]"]
  node_coach_messages["Message threads<br/>[useCoachThread.ts]"]
  node_admin_portal["Admin coaching<br/>[AdminDashboard.tsx]"]
  node_coaching_function["Coaching generation<br/>[index.ts]"]
end

subgraph group_platform["Shared platform"]
  node_auth_state["Auth and roles<br/>[AuthContext.tsx]"]
  node_supabase_client["Supabase client<br/>[client.ts]"]
  node_supabase[("Supabase services")]
end

node_visitor(("Visitor or user"))
node_coach_actor(("Coach"))
node_admin_actor(("Administrator"))

node_visitor -->|"opens"| node_app
node_coach_actor -->|"opens"| node_app
node_admin_actor -->|"opens"| node_app
node_app -->|"routes"| node_landing
node_app -->|"routes"| node_auth_page
node_app -->|"routes"| node_aura
node_app -->|"routes"| node_welcome
node_app -->|"routes"| node_skill_path
node_app -->|"routes"| node_phase_task
node_app -->|"routes"| node_assessment_pages
node_app -->|"routes"| node_assessment_results
node_app -->|"routes"| node_my_coach
node_app -->|"routes"| node_coach_portal
node_app -->|"routes"| node_coach_messages
node_app -->|"routes"| node_admin_portal
node_auth_page -->|"authenticates through"| node_auth_state
node_auth_state -->|"reads auth and profile"| node_supabase_client
node_supabase_client -->|"connects"| node_supabase
node_aura -->|"uses flow logic"| node_aura_logic
node_goal_search -->|"searches goals through"| node_supabase_client
node_aura -->|"searches goals"| node_goal_search
node_coach_messages -->|"reads and writes messages"| node_supabase_client
node_aura -.->|"integration not sampled"| node_plan_function
node_my_coach -.->|"integration not sampled"| node_coaching_function

click node_app "https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/App.tsx"
click node_landing "https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/Index.tsx"
click node_auth_page "https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/Auth.tsx"
click node_auth_state "https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/contexts/AuthContext.tsx"
click node_supabase_client "https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/integrations/supabase/client.ts"
click node_aura "https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/AuraFlow.tsx"
click node_aura_logic "https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/lib/auraFlow.ts"
click node_goal_search "https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/hooks/useGoalSearch.ts"
click node_welcome "https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/Welcome.tsx"
click node_skill_path "https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/SkillPath.tsx"
click node_phase_task "https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/PhasePage.tsx"
click node_assessment_pages "https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/DISCAssessment.tsx"
click node_assessment_results "https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/DISCResults.tsx"
click node_my_coach "https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/MyCoach.tsx"
click node_coach_portal "https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/CoachDashboard.tsx"
click node_coach_messages "https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/hooks/useCoachThread.ts"
click node_admin_portal "https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/AdminDashboard.tsx"
click node_plan_function "https://github.com/mokyusuf22-lang/insight-compass/blob/main/supabase/functions/aura-plan/index.ts"
click node_coaching_function "https://github.com/mokyusuf22-lang/insight-compass/blob/main/supabase/functions/generate-coaching/index.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_app,node_landing,node_auth_page,node_visitor toneBlue
class node_aura,node_aura_logic,node_goal_search,node_welcome,node_skill_path,node_phase_task,node_plan_function toneAmber
class node_assessment_pages,node_assessment_results toneMint
class node_my_coach,node_coach_portal,node_coach_messages,node_admin_portal,node_coaching_function toneRose
class node_auth_state,node_supabase_client,node_supabase,node_coach_actor,node_admin_actor toneIndigo
```

## Components

### Entry and access

- [Route application](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/App.tsx): `src/App.tsx`
- [Public landing](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/Index.tsx): `src/pages/Index.tsx`
- [Sign-in and signup](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/Auth.tsx): `src/pages/Auth.tsx`

### Personal development

- [Aura onboarding](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/AuraFlow.tsx): `src/pages/AuraFlow.tsx`
- [Aura flow logic](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/lib/auraFlow.ts): `src/lib/auraFlow.ts`
- [Goal search](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/hooks/useGoalSearch.ts): `src/hooks/useGoalSearch.ts`
- [Personal dashboard](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/Welcome.tsx): `src/pages/Welcome.tsx`
- [Skill path](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/SkillPath.tsx): `src/pages/SkillPath.tsx`
- [Path phase and task](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/PhasePage.tsx): `src/pages/PhasePage.tsx`
- [Aura plan service](https://github.com/mokyusuf22-lang/insight-compass/blob/main/supabase/functions/aura-plan/index.ts): `supabase/functions/aura-plan/index.ts`

### Assessments

- [Assessment workflows](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/DISCAssessment.tsx): `src/pages/DISCAssessment.tsx`
- [Assessment results](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/DISCResults.tsx): `src/pages/DISCResults.tsx`

### Coaching operations

- [Client coaching](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/MyCoach.tsx): `src/pages/MyCoach.tsx`
- [Coach portal](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/CoachDashboard.tsx): `src/pages/CoachDashboard.tsx`
- [Message threads](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/hooks/useCoachThread.ts): `src/hooks/useCoachThread.ts`
- [Admin coaching](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/pages/AdminDashboard.tsx): `src/pages/AdminDashboard.tsx`
- [Coaching generation](https://github.com/mokyusuf22-lang/insight-compass/blob/main/supabase/functions/generate-coaching/index.ts): `supabase/functions/generate-coaching/index.ts`

### Shared platform

- [Auth and roles](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/contexts/AuthContext.tsx): `src/contexts/AuthContext.tsx`
- [Supabase client](https://github.com/mokyusuf22-lang/insight-compass/blob/main/src/integrations/supabase/client.ts): `src/integrations/supabase/client.ts`
- **Supabase services**

### Other components

- **Visitor or user**
- **Coach**
- **Administrator**

## Connections

- Visitor or user → Route application: opens
- Coach → Route application: opens
- Administrator → Route application: opens
- Route application → Public landing: routes
- Route application → Sign-in and signup: routes
- Route application → Aura onboarding: routes
- Route application → Personal dashboard: routes
- Route application → Skill path: routes
- Route application → Path phase and task: routes
- Route application → Assessment workflows: routes
- Route application → Assessment results: routes
- Route application → Client coaching: routes
- Route application → Coach portal: routes
- Route application → Message threads: routes
- Route application → Admin coaching: routes
- Sign-in and signup → Auth and roles: authenticates through
- Auth and roles → Supabase client: reads auth and profile
- Supabase client → Supabase services: connects
- Aura onboarding → Aura flow logic: uses flow logic
- Goal search → Supabase client: searches goals through
- Aura onboarding → Goal search: searches goals
- Message threads → Supabase client: reads and writes messages
- Aura onboarding → Aura plan service: integration not sampled
- Client coaching → Coaching generation: integration not sampled