# alienminus/arcturus-connexa architecture

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

- Interactive diagram: https://gitdiagram.com/alienminus/arcturus-connexa
- Repository: https://github.com/alienminus/arcturus-connexa

## Overview

Arcturus Connexa is a professional social, recruiting, and campus-placement platform. Users enter through the routed web app, authenticate, and use social, career, learning, or CampusLink workflows; CampusLink combines institutional drive management, student readiness diagnostics, matching, and offers. The server provides domain APIs backed by MongoDB models, with Gemma inference for placement guidance. Major documented capabilities are represented even where their implementation was not sampled; those uncertain client-to-server connections are omitted rather than inferred.

Main entry points: [`src/Router.jsx`](https://github.com/alienminus/arcturus-connexa/blob/main/src/Router.jsx) (Web routes), [`server/routes/auth.js`](https://github.com/alienminus/arcturus-connexa/blob/main/server/routes/auth.js) (Authentication API), [`src/pages/CampusLink/CampusLinkPage.jsx`](https://github.com/alienminus/arcturus-connexa/blob/main/src/pages/CampusLink/CampusLinkPage.jsx) (CampusLink portal), [`server/routes/campuslink/drivesRoutes.js`](https://github.com/alienminus/arcturus-connexa/blob/main/server/routes/campuslink/drivesRoutes.js) (Drive operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_router["Web routes<br/>[Router.jsx]"]
  node_api["API URL helper<br/>[api.js]"]
end

subgraph group_identity["Identity and profiles"]
  node_authpage["Sign-in flows<br/>[AuthPage.jsx]"]
  node_authstate["Auth state<br/>[AuthContext.jsx]"]
  node_profilestate["Profile state<br/>[ProfileContext.jsx]"]
  node_authapi["Authentication API<br/>[auth.js]"]
end

subgraph group_community["Social and career"]
  node_search["People and job search<br/>[SearchPage.jsx]"]
  node_jobs["Jobs marketplace<br/>[JobsPage.jsx]"]
  node_posting["Recruiter dashboard<br/>[JobPostingPage.jsx]"]
  node_feed["Feed and Tales<br/>[Feed.jsx]"]
  node_messaging["Messaging<br/>[Messenger.jsx]"]
  node_learning["Learning hub"]
  node_games["Puzzle games<br/>[PuzzleGames.jsx]"]
end

subgraph group_campus["CampusLink placement"]
  node_campuspage["CampusLink portal<br/>[CampusLinkPage.jsx]"]
  node_campusui["Placement experience<br/>[ReadinessTab.jsx]"]
  node_driveapi["Drive operations<br/>[drivesRoutes.js]"]
  node_profileapi["Readiness diagnostics<br/>[profileRoutes.js]"]
  node_assistantapi["Placement assistant<br/>[assistantRoutes.js]"]
  node_gemma["Gemma inference<br/>[gemmaService.js]"]
  node_conflicts["Schedule conflicts"]
  node_placementprofile[("Placement profiles")]
  node_drivemodel[("Placement drives<br/>[PlacementDrive.js]")]
end

subgraph group_platform["Server and data"]
  node_admin["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_authmw["Token middleware<br/>[auth.js]"]
  node_users[("User records<br/>[User.js]")]
  node_profilemodel[("Profile records<br/>[Profile.js]")]
  node_organization[("Organizations<br/>[Organization.js]")]
end

node_member(("Platform users"))
node_huggingface["Hugging Face"]

node_member -.->|"browses"| node_router
node_router -->|"routes to"| node_authpage
node_router -->|"routes to"| node_campuspage
node_router -->|"routes to"| node_search
node_router -->|"routes to"| node_jobs
node_router -->|"routes to"| node_posting
node_router -->|"routes to"| node_learning
node_authpage -->|"uses"| node_authstate
node_authstate -->|"requests"| node_authapi
node_authapi -->|"reads and writes"| node_users
node_authapi -->|"creates"| node_profilemodel
node_authapi -->|"uses"| node_authmw
node_authmw -->|"checks admin"| node_users
node_profilestate -->|"reads token"| node_authstate
node_profilestate -->|"builds requests"| node_api
node_search -->|"builds requests"| node_api
node_campuspage -.->|"presents"| node_campusui
node_campusui -.->|"manages drives"| node_driveapi
node_driveapi -->|"queries"| node_drivemodel
node_driveapi -->|"resolves conflicts"| node_conflicts
node_driveapi -->|"matches candidates"| node_placementprofile
node_profileapi -->|"updates readiness"| node_placementprofile
node_profileapi -->|"loads candidate"| node_profilemodel
node_profileapi -->|"requests analysis"| node_gemma
node_assistantapi -->|"requests guidance"| node_gemma
node_gemma -->|"queries inference"| node_huggingface
node_campuspage -.->|"requests diagnostics"| node_profileapi
node_campuspage -.->|"requests assistance"| node_assistantapi
node_member -.->|"shares and views"| node_feed
node_member -.->|"messages"| node_messaging
node_member -.->|"learns"| node_learning
node_member -.->|"plays"| node_games
node_member -.->|"administers"| node_admin
node_member -.->|"represents"| node_organization

click node_router "https://github.com/alienminus/arcturus-connexa/blob/main/src/Router.jsx"
click node_authpage "https://github.com/alienminus/arcturus-connexa/blob/main/src/pages/AuthPage/AuthPage.jsx"
click node_authstate "https://github.com/alienminus/arcturus-connexa/blob/main/src/context/AuthContext.jsx"
click node_profilestate "https://github.com/alienminus/arcturus-connexa/blob/main/src/context/ProfileContext.jsx"
click node_api "https://github.com/alienminus/arcturus-connexa/blob/main/src/utils/api.js"
click node_search "https://github.com/alienminus/arcturus-connexa/blob/main/src/pages/SearchPage/SearchPage.jsx"
click node_jobs "https://github.com/alienminus/arcturus-connexa/blob/main/src/pages/JobsPage/JobsPage.jsx"
click node_posting "https://github.com/alienminus/arcturus-connexa/blob/main/src/pages/JobPostingPage/JobPostingPage.jsx"
click node_feed "https://github.com/alienminus/arcturus-connexa/blob/main/src/components/Home/Feed/Feed.jsx"
click node_messaging "https://github.com/alienminus/arcturus-connexa/blob/main/src/components/Home/Messenger/Messenger.jsx"
click node_learning "https://github.com/alienminus/arcturus-connexa/blob/main/src/pages/Learning/LearningHubPage.jsx"
click node_games "https://github.com/alienminus/arcturus-connexa/blob/main/src/components/Games/PuzzleGames.jsx"
click node_admin "https://github.com/alienminus/arcturus-connexa/blob/main/src/pages/admin/AdminDashboard.jsx"
click node_campuspage "https://github.com/alienminus/arcturus-connexa/blob/main/src/pages/CampusLink/CampusLinkPage.jsx"
click node_campusui "https://github.com/alienminus/arcturus-connexa/blob/main/src/components/CampusLink/ReadinessTab.jsx"
click node_driveapi "https://github.com/alienminus/arcturus-connexa/blob/main/server/routes/campuslink/drivesRoutes.js"
click node_profileapi "https://github.com/alienminus/arcturus-connexa/blob/main/server/routes/campuslink/profileRoutes.js"
click node_assistantapi "https://github.com/alienminus/arcturus-connexa/blob/main/server/routes/campuslink/assistantRoutes.js"
click node_gemma "https://github.com/alienminus/arcturus-connexa/blob/main/server/services/gemmaService.js"
click node_conflicts "https://github.com/alienminus/arcturus-connexa/blob/main/server/utils/conflictDetector.js"
click node_authapi "https://github.com/alienminus/arcturus-connexa/blob/main/server/routes/auth.js"
click node_authmw "https://github.com/alienminus/arcturus-connexa/blob/main/server/middleware/auth.js"
click node_users "https://github.com/alienminus/arcturus-connexa/blob/main/server/models/User.js"
click node_profilemodel "https://github.com/alienminus/arcturus-connexa/blob/main/server/models/Profile.js"
click node_placementprofile "https://github.com/alienminus/arcturus-connexa/blob/main/server/models/PlacementProfile.js"
click node_drivemodel "https://github.com/alienminus/arcturus-connexa/blob/main/server/models/PlacementDrive.js"
click node_organization "https://github.com/alienminus/arcturus-connexa/blob/main/server/models/Organization.js"

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_router,node_api,node_member toneBlue
class node_authpage,node_authstate,node_profilestate,node_authapi toneAmber
class node_search,node_jobs,node_posting,node_feed,node_messaging,node_learning,node_games toneMint
class node_campuspage,node_campusui,node_driveapi,node_profileapi,node_assistantapi,node_gemma,node_conflicts,node_placementprofile,node_drivemodel toneRose
class node_admin,node_authmw,node_users,node_profilemodel,node_organization,node_huggingface toneIndigo
```

## Components

### Web experience

- [Web routes](https://github.com/alienminus/arcturus-connexa/blob/main/src/Router.jsx): `src/Router.jsx`
- [API URL helper](https://github.com/alienminus/arcturus-connexa/blob/main/src/utils/api.js): `src/utils/api.js`

### Identity and profiles

- [Sign-in flows](https://github.com/alienminus/arcturus-connexa/blob/main/src/pages/AuthPage/AuthPage.jsx): `src/pages/AuthPage/AuthPage.jsx`
- [Auth state](https://github.com/alienminus/arcturus-connexa/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [Profile state](https://github.com/alienminus/arcturus-connexa/blob/main/src/context/ProfileContext.jsx): `src/context/ProfileContext.jsx`
- [Authentication API](https://github.com/alienminus/arcturus-connexa/blob/main/server/routes/auth.js): `server/routes/auth.js`

### Social and career

- [People and job search](https://github.com/alienminus/arcturus-connexa/blob/main/src/pages/SearchPage/SearchPage.jsx): `src/pages/SearchPage/SearchPage.jsx`
- [Jobs marketplace](https://github.com/alienminus/arcturus-connexa/blob/main/src/pages/JobsPage/JobsPage.jsx): `src/pages/JobsPage/JobsPage.jsx`
- [Recruiter dashboard](https://github.com/alienminus/arcturus-connexa/blob/main/src/pages/JobPostingPage/JobPostingPage.jsx): `src/pages/JobPostingPage/JobPostingPage.jsx`
- [Feed and Tales](https://github.com/alienminus/arcturus-connexa/blob/main/src/components/Home/Feed/Feed.jsx): `src/components/Home/Feed/Feed.jsx`
- [Messaging](https://github.com/alienminus/arcturus-connexa/blob/main/src/components/Home/Messenger/Messenger.jsx): `src/components/Home/Messenger/Messenger.jsx`
- [Learning hub](https://github.com/alienminus/arcturus-connexa/blob/main/src/pages/Learning/LearningHubPage.jsx): `src/pages/Learning/LearningHubPage.jsx`
- [Puzzle games](https://github.com/alienminus/arcturus-connexa/blob/main/src/components/Games/PuzzleGames.jsx): `src/components/Games/PuzzleGames.jsx`

### CampusLink placement

- [CampusLink portal](https://github.com/alienminus/arcturus-connexa/blob/main/src/pages/CampusLink/CampusLinkPage.jsx): `src/pages/CampusLink/CampusLinkPage.jsx`
- [Placement experience](https://github.com/alienminus/arcturus-connexa/blob/main/src/components/CampusLink/ReadinessTab.jsx): `src/components/CampusLink/ReadinessTab.jsx`
- [Drive operations](https://github.com/alienminus/arcturus-connexa/blob/main/server/routes/campuslink/drivesRoutes.js): `server/routes/campuslink/drivesRoutes.js`
- [Readiness diagnostics](https://github.com/alienminus/arcturus-connexa/blob/main/server/routes/campuslink/profileRoutes.js): `server/routes/campuslink/profileRoutes.js`
- [Placement assistant](https://github.com/alienminus/arcturus-connexa/blob/main/server/routes/campuslink/assistantRoutes.js): `server/routes/campuslink/assistantRoutes.js`
- [Gemma inference](https://github.com/alienminus/arcturus-connexa/blob/main/server/services/gemmaService.js): `server/services/gemmaService.js`
- [Schedule conflicts](https://github.com/alienminus/arcturus-connexa/blob/main/server/utils/conflictDetector.js): `server/utils/conflictDetector.js`
- [Placement profiles](https://github.com/alienminus/arcturus-connexa/blob/main/server/models/PlacementProfile.js): `server/models/PlacementProfile.js`
- [Placement drives](https://github.com/alienminus/arcturus-connexa/blob/main/server/models/PlacementDrive.js): `server/models/PlacementDrive.js`

### Server and data

- [Admin dashboard](https://github.com/alienminus/arcturus-connexa/blob/main/src/pages/admin/AdminDashboard.jsx): `src/pages/admin/AdminDashboard.jsx`
- [Token middleware](https://github.com/alienminus/arcturus-connexa/blob/main/server/middleware/auth.js): `server/middleware/auth.js`
- [User records](https://github.com/alienminus/arcturus-connexa/blob/main/server/models/User.js): `server/models/User.js`
- [Profile records](https://github.com/alienminus/arcturus-connexa/blob/main/server/models/Profile.js): `server/models/Profile.js`
- [Organizations](https://github.com/alienminus/arcturus-connexa/blob/main/server/models/Organization.js): `server/models/Organization.js`

### Other components

- **Platform users**
- **Hugging Face**

## Connections

- Platform users → Web routes: browses (evidence: `README.md`)
- Web routes → Sign-in flows: routes to (evidence: `src/Router.jsx`)
- Web routes → CampusLink portal: routes to (evidence: `src/Router.jsx`)
- Web routes → People and job search: routes to (evidence: `src/Router.jsx`)
- Web routes → Jobs marketplace: routes to (evidence: `src/Router.jsx`)
- Web routes → Recruiter dashboard: routes to (evidence: `src/Router.jsx`)
- Web routes → Learning hub: routes to (evidence: `src/Router.jsx`)
- Sign-in flows → Auth state: uses (evidence: `src/pages/AuthPage/AuthPage.jsx`)
- Auth state → Authentication API: requests (evidence: `src/context/AuthContext.jsx`)
- Authentication API → User records: reads and writes (evidence: `server/routes/auth.js`)
- Authentication API → Profile records: creates (evidence: `server/routes/auth.js`)
- Authentication API → Token middleware: uses (evidence: `server/routes/auth.js`)
- Token middleware → User records: checks admin
- Profile state → Auth state: reads token (evidence: `src/context/ProfileContext.jsx`)
- Profile state → API URL helper: builds requests (evidence: `src/context/ProfileContext.jsx`)
- People and job search → API URL helper: builds requests (evidence: `src/pages/SearchPage/SearchPage.jsx`)
- CampusLink portal → Placement experience: presents (evidence: `README.md`)
- Placement experience → Drive operations: manages drives (evidence: `README.md`)
- Drive operations → Placement drives: queries (evidence: `server/routes/campuslink/drivesRoutes.js`)
- Drive operations → Schedule conflicts: resolves conflicts (evidence: `server/routes/campuslink/drivesRoutes.js`)
- Drive operations → Placement profiles: matches candidates (evidence: `server/routes/campuslink/drivesRoutes.js`)
- Readiness diagnostics → Placement profiles: updates readiness (evidence: `server/routes/campuslink/profileRoutes.js`)
- Readiness diagnostics → Profile records: loads candidate (evidence: `server/routes/campuslink/profileRoutes.js`)
- Readiness diagnostics → Gemma inference: requests analysis (evidence: `server/routes/campuslink/profileRoutes.js`)
- Placement assistant → Gemma inference: requests guidance (evidence: `server/routes/campuslink/assistantRoutes.js`)
- Gemma inference → Hugging Face: queries inference (evidence: `server/services/gemmaService.js`)
- CampusLink portal → Readiness diagnostics: requests diagnostics
- CampusLink portal → Placement assistant: requests assistance
- Platform users → Feed and Tales: shares and views (evidence: `README.md`)
- Platform users → Messaging: messages (evidence: `README.md`)
- Platform users → Learning hub: learns (evidence: `README.md`)
- Platform users → Puzzle games: plays (evidence: `README.md`)
- Platform users → Admin dashboard: administers (evidence: `README.md`)
- Platform users → Organizations: represents (evidence: `README.md`)
