# energyshifter8/mindxplusv2 architecture

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

- Interactive diagram: https://gitdiagram.com/energyshifter8/mindxplusv2
- Repository: https://github.com/energyshifter8/mindxplusv2

## Overview

MindX Plus is a frontend dashboard for HR teams to manage surveys and talent recruitment assessments. Users sign in, then work in two main product areas: create and publish surveys or configure recruitment assessments, invite candidates, and review assessment results. Invited-talent search and history provide a related candidate-management view. Interactive pages use query/mutation hooks and typed API clients to communicate with the external MindX Plus backend. The README documents dashboard statistics and periodic refresh; unsampled implementation details are represented only where documented, with no inferred backend internals.

Main entry points: [`lib/hooks/role-assessment/queries.ts`](https://github.com/energyshifter8/mindxplusv2/blob/main/lib/hooks/role-assessment/queries.ts) (Assessment queries), [`lib/api.ts`](https://github.com/energyshifter8/mindxplusv2/blob/main/lib/api.ts) (Survey API client), [`lib/hooks/role-assessment/mutations.ts`](https://github.com/energyshifter8/mindxplusv2/blob/main/lib/hooks/role-assessment/mutations.ts) (Assessment mutations), [`app/dashboard/surveys/[id]/edit/page.tsx`](https://github.com/energyshifter8/mindxplusv2/blob/main/app/dashboard/surveys/%5Bid%5D/edit/page.tsx) (Survey editor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and dashboard"]
  node_login["Sign in<br/>[AuthForm.tsx]"]
  node_dashboard["Overview dashboard<br/>[Dashboard.tsx]"]
end

subgraph group_surveys["Survey management"]
  node_survey_list["Survey list<br/>[page.tsx]"]
  node_survey_create["Survey creation<br/>[page.tsx]"]
  node_survey_editor["Survey editor<br/>[page.tsx]"]
  node_survey_preview["Survey preview<br/>[EditorPreview.tsx]"]
  node_survey_results["Survey results<br/>[page.tsx]"]
end

subgraph group_assessment["Role assessment"]
  node_ra_list["Assessment list<br/>[page.tsx]"]
  node_ra_wizard["Assessment wizard"]
  node_ra_preview["Participant preview"]
  node_ra_dashboard["Recruitment dashboard"]
  node_ra_result["Invitation results"]
  node_talent_list["Invited talents"]
  node_talent_detail["Talent details"]
end

subgraph group_data["Client data layer"]
  node_ra_queries["Assessment queries<br/>[queries.ts]"]
  node_ra_mutations["Assessment mutations<br/>[mutations.ts]"]
  node_survey_api["Survey API client<br/>[api.ts]"]
  node_ra_api["Assessment API"]
end

node_hr(("HR user"))
node_backend{{"MindX backend"}}

node_hr -->|"signs in"| node_login
node_login -->|"authenticates with"| node_backend
node_hr -->|"views"| node_dashboard
node_dashboard -->|"fetches dashboard data"| node_backend
node_hr -->|"manages surveys"| node_survey_list
node_survey_list -->|"requests survey data"| node_survey_api
node_hr -->|"creates surveys"| node_survey_create
node_survey_create -->|"loads templates"| node_survey_api
node_hr -->|"edits and publishes"| node_survey_editor
node_survey_editor -->|"renders preview"| node_survey_preview
node_survey_editor -->|"saves survey changes"| node_survey_api
node_hr -->|"reviews responses"| node_survey_results
node_survey_results -->|"loads results"| node_survey_api
node_hr -->|"manages assessments"| node_ra_list
node_ra_list -->|"loads list and stats"| node_ra_queries
node_ra_list -->|"performs list actions"| node_ra_mutations
node_ra_wizard -->|"loads assessment data"| node_ra_queries
node_ra_wizard -->|"updates assessment"| node_ra_mutations
node_ra_preview -->|"loads preview data"| node_ra_queries
node_ra_dashboard -->|"loads recruitment data"| node_ra_queries
node_ra_dashboard -->|"invites candidates"| node_ra_mutations
node_ra_result -.->|"loads result details"| node_ra_queries
node_talent_list -.->|"searches talent records"| node_ra_queries
node_talent_detail -.->|"loads talent history"| node_ra_queries
node_ra_queries -->|"calls assessment endpoints"| node_ra_api
node_ra_mutations -.->|"calls assessment endpoints"| node_ra_api
node_ra_api -.->|"requests assessment data"| node_backend
node_survey_api -->|"requests survey data"| node_backend

click node_login "https://github.com/energyshifter8/mindxplusv2/blob/main/components/AuthForm.tsx"
click node_dashboard "https://github.com/energyshifter8/mindxplusv2/blob/main/components/Dashboard.tsx"
click node_survey_list "https://github.com/energyshifter8/mindxplusv2/blob/main/app/dashboard/surveys/page.tsx"
click node_survey_create "https://github.com/energyshifter8/mindxplusv2/blob/main/app/dashboard/surveys/new/page.tsx"
click node_survey_editor "https://github.com/energyshifter8/mindxplusv2/blob/main/app/dashboard/surveys/%5Bid%5D/edit/page.tsx"
click node_survey_preview "https://github.com/energyshifter8/mindxplusv2/blob/main/components/surveys/editor/EditorPreview.tsx"
click node_survey_results "https://github.com/energyshifter8/mindxplusv2/blob/main/app/dashboard/surveys/%5Bid%5D/results/page.tsx"
click node_ra_list "https://github.com/energyshifter8/mindxplusv2/blob/main/app/role-assessment/page.tsx"
click node_ra_wizard "https://github.com/energyshifter8/mindxplusv2/blob/main/components/role-assessment/wizard/RoleAssessmentWizard.tsx"
click node_ra_preview "https://github.com/energyshifter8/mindxplusv2/blob/main/components/role-assessment/preview/RecruitmentPreview.tsx"
click node_ra_dashboard "https://github.com/energyshifter8/mindxplusv2/blob/main/components/role-assessment/dashboard/RecruitmentDashboard.tsx"
click node_ra_result "https://github.com/energyshifter8/mindxplusv2/blob/main/components/role-assessment/result/ResultSidePanel.tsx"
click node_talent_list "https://github.com/energyshifter8/mindxplusv2/blob/main/components/role-assessment/talents/InvitedTalentsList.tsx"
click node_talent_detail "https://github.com/energyshifter8/mindxplusv2/blob/main/components/role-assessment/talents/TalentDetailView.tsx"
click node_ra_queries "https://github.com/energyshifter8/mindxplusv2/blob/main/lib/hooks/role-assessment/queries.ts"
click node_ra_mutations "https://github.com/energyshifter8/mindxplusv2/blob/main/lib/hooks/role-assessment/mutations.ts"
click node_survey_api "https://github.com/energyshifter8/mindxplusv2/blob/main/lib/api.ts"
click node_ra_api "https://github.com/energyshifter8/mindxplusv2/tree/main/lib/api/role-assessment"

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_login,node_dashboard,node_hr toneBlue
class node_survey_list,node_survey_create,node_survey_editor,node_survey_preview,node_survey_results toneAmber
class node_ra_list,node_ra_wizard,node_ra_preview,node_ra_dashboard,node_ra_result,node_talent_list,node_talent_detail toneMint
class node_ra_queries,node_ra_mutations,node_survey_api,node_ra_api toneRose
class node_backend toneIndigo
```

## Components

### Access and dashboard

- [Sign in](https://github.com/energyshifter8/mindxplusv2/blob/main/components/AuthForm.tsx): `components/AuthForm.tsx`
- [Overview dashboard](https://github.com/energyshifter8/mindxplusv2/blob/main/components/Dashboard.tsx): `components/Dashboard.tsx`

### Survey management

- [Survey list](https://github.com/energyshifter8/mindxplusv2/blob/main/app/dashboard/surveys/page.tsx): `app/dashboard/surveys/page.tsx`
- [Survey creation](https://github.com/energyshifter8/mindxplusv2/blob/main/app/dashboard/surveys/new/page.tsx): `app/dashboard/surveys/new/page.tsx`
- [Survey editor](https://github.com/energyshifter8/mindxplusv2/blob/main/app/dashboard/surveys/%5Bid%5D/edit/page.tsx): `app/dashboard/surveys/[id]/edit/page.tsx`
- [Survey preview](https://github.com/energyshifter8/mindxplusv2/blob/main/components/surveys/editor/EditorPreview.tsx): `components/surveys/editor/EditorPreview.tsx`
- [Survey results](https://github.com/energyshifter8/mindxplusv2/blob/main/app/dashboard/surveys/%5Bid%5D/results/page.tsx): `app/dashboard/surveys/[id]/results/page.tsx`

### Role assessment

- [Assessment list](https://github.com/energyshifter8/mindxplusv2/blob/main/app/role-assessment/page.tsx): `app/role-assessment/page.tsx`
- [Assessment wizard](https://github.com/energyshifter8/mindxplusv2/blob/main/components/role-assessment/wizard/RoleAssessmentWizard.tsx): `components/role-assessment/wizard/RoleAssessmentWizard.tsx`
- [Participant preview](https://github.com/energyshifter8/mindxplusv2/blob/main/components/role-assessment/preview/RecruitmentPreview.tsx): `components/role-assessment/preview/RecruitmentPreview.tsx`
- [Recruitment dashboard](https://github.com/energyshifter8/mindxplusv2/blob/main/components/role-assessment/dashboard/RecruitmentDashboard.tsx): `components/role-assessment/dashboard/RecruitmentDashboard.tsx`
- [Invitation results](https://github.com/energyshifter8/mindxplusv2/blob/main/components/role-assessment/result/ResultSidePanel.tsx): `components/role-assessment/result/ResultSidePanel.tsx`
- [Invited talents](https://github.com/energyshifter8/mindxplusv2/blob/main/components/role-assessment/talents/InvitedTalentsList.tsx): `components/role-assessment/talents/InvitedTalentsList.tsx`
- [Talent details](https://github.com/energyshifter8/mindxplusv2/blob/main/components/role-assessment/talents/TalentDetailView.tsx): `components/role-assessment/talents/TalentDetailView.tsx`

### Client data layer

- [Assessment queries](https://github.com/energyshifter8/mindxplusv2/blob/main/lib/hooks/role-assessment/queries.ts): `lib/hooks/role-assessment/queries.ts`
- [Assessment mutations](https://github.com/energyshifter8/mindxplusv2/blob/main/lib/hooks/role-assessment/mutations.ts): `lib/hooks/role-assessment/mutations.ts`
- [Survey API client](https://github.com/energyshifter8/mindxplusv2/blob/main/lib/api.ts): `lib/api.ts`
- [Assessment API](https://github.com/energyshifter8/mindxplusv2/tree/main/lib/api/role-assessment): `lib/api/role-assessment`

### Other components

- **HR user**
- **MindX backend**

## Connections

- HR user → Sign in: signs in (evidence: `README.md`)
- Sign in → MindX backend: authenticates with (evidence: `README.md`)
- HR user → Overview dashboard: views (evidence: `README.md`)
- Overview dashboard → MindX backend: fetches dashboard data (evidence: `README.md`)
- HR user → Survey list: manages surveys (evidence: `README.md`)
- Survey list → Survey API client: requests survey data (evidence: `app/dashboard/surveys/page.tsx`)
- HR user → Survey creation: creates surveys (evidence: `README.md`)
- Survey creation → Survey API client: loads templates (evidence: `app/dashboard/surveys/new/page.tsx`)
- HR user → Survey editor: edits and publishes (evidence: `README.md`)
- Survey editor → Survey preview: renders preview (evidence: `app/dashboard/surveys/[id]/edit/page.tsx`)
- Survey editor → Survey API client: saves survey changes (evidence: `app/dashboard/surveys/[id]/edit/page.tsx`)
- HR user → Survey results: reviews responses (evidence: `README.md`)
- Survey results → Survey API client: loads results (evidence: `app/dashboard/surveys/[id]/results/page.tsx`)
- HR user → Assessment list: manages assessments (evidence: `README.md`)
- Assessment list → Assessment queries: loads list and stats (evidence: `app/role-assessment/page.tsx`)
- Assessment list → Assessment mutations: performs list actions (evidence: `app/role-assessment/page.tsx`)
- Assessment wizard → Assessment queries: loads assessment data (evidence: `components/role-assessment/wizard/RoleAssessmentWizard.tsx`)
- Assessment wizard → Assessment mutations: updates assessment (evidence: `components/role-assessment/wizard/RoleAssessmentWizard.tsx`)
- Participant preview → Assessment queries: loads preview data (evidence: `components/role-assessment/preview/RecruitmentPreview.tsx`)
- Recruitment dashboard → Assessment queries: loads recruitment data (evidence: `components/role-assessment/dashboard/RecruitmentDashboard.tsx`)
- Recruitment dashboard → Assessment mutations: invites candidates (evidence: `components/role-assessment/dashboard/RecruitmentDashboard.tsx`)
- Invitation results → Assessment queries: loads result details
- Invited talents → Assessment queries: searches talent records
- Talent details → Assessment queries: loads talent history
- Assessment queries → Assessment API: calls assessment endpoints (evidence: `lib/hooks/role-assessment/queries.ts`)
- Assessment mutations → Assessment API: calls assessment endpoints
- Assessment API → MindX backend: requests assessment data
- Survey API client → MindX backend: requests survey data (evidence: `README.md`)
