# arjunbalaji123/skillproof architecture

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

- Interactive diagram: https://gitdiagram.com/arjunbalaji123/skillproof
- Repository: https://github.com/arjunbalaji123/skillproof

## Overview

Skillproof is a role-based platform for developers to build skill portfolios and demonstrate verified abilities, while recruiters discover developers and admins oversee users and verification. The main developer workflow is to manage skills, take assessments or submit proof, and present a public portfolio; recruiter discovery and admin review are distinct product stages. The client routes users to role-specific pages and calls an API, while server controllers handle domain operations and use shared database and response utilities. The README is empty, and several route/controller files were not sampled, so some backend feature links are intentionally omitted.

Main entry points: [`skillproof/client/src/routes/AppRoutes.tsx`](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/routes/AppRoutes.tsx) (Role-based routes), [`skillproof/server/src/utils/audit.ts`](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/utils/audit.ts) (Audit logging), [`skillproof/server/src/config/db.ts`](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/config/db.ts) (Prisma database), [`skillproof/server/src/controllers/verificationController.ts`](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/controllers/verificationController.ts) (Verification operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client experience"]
  node_app["Client shell<br/>[App.tsx]"]
  node_auth["Session and auth<br/>[AuthContext.tsx]"]
  node_routes["Role-based routes<br/>[AppRoutes.tsx]"]
  node_api["API client<br/>[api.ts]"]
  node_developer_dash["Developer dashboard"]
  node_portfolio["Public portfolio"]
end

subgraph group_evidence["Skills and evidence"]
  node_skills["Skill manager"]
  node_assessments["Assessment flow"]
  node_verifications["Verification review"]
  node_projects["Project portfolio<br/>[ProjectsPage.tsx]"]
  node_verification_controller["Verification operations"]
  node_assessment_controller["Assessment operations"]
end

subgraph group_discovery["Recruiter discovery"]
  node_recruiter_dash["Developer discovery"]
  node_bookmarks["Saved developers<br/>[BookmarksPage.tsx]"]
  node_recruiter_controller["Recruiter operations"]
end

subgraph group_server["Server operations"]
  node_admin_dash["Admin console<br/>[AdminDashboard.tsx]"]
  node_admin_controller["Admin operations<br/>[adminController.ts]"]
  node_server_app["HTTP application<br/>[app.ts]"]
  node_route_index["Server route registry<br/>[index.ts]"]
  node_database[("Prisma database<br/>[db.ts]")]
  node_audit["Audit logging<br/>[audit.ts]"]
  node_response["Response helpers<br/>[response.ts]"]
end

node_developer(("Developer"))
node_recruiter(("Recruiter"))
node_admin(("Admin"))

node_app -->|"provides session"| node_auth
node_app -->|"renders routes"| node_routes
node_app -.->|"calls API"| node_server_app
node_routes -->|"routes to"| node_developer_dash
node_routes -->|"routes to"| node_portfolio
node_routes -->|"routes to"| node_skills
node_routes -->|"routes to"| node_assessments
node_routes -->|"routes to"| node_verifications
node_routes -->|"routes to"| node_projects
node_routes -->|"routes to"| node_recruiter_dash
node_routes -->|"routes to"| node_bookmarks
node_routes -->|"routes to"| node_admin_dash
node_auth -->|"requests session"| node_api
node_skills -->|"requests skills"| node_api
node_skills -.->|"submits proof"| node_verification_controller
node_assessments -.->|"submits attempt"| node_assessment_controller
node_recruiter_dash -.->|"searches developers"| node_recruiter_controller
node_admin_dash -.->|"requests oversight"| node_admin_controller
node_server_app -->|"mounts routes"| node_route_index
node_admin_controller -->|"queries"| node_database
node_admin_controller -->|"records changes"| node_audit
node_admin_controller -->|"formats response"| node_response
node_assessment_controller -->|"queries"| node_database
node_assessment_controller -->|"records events"| node_audit
node_assessment_controller -->|"formats response"| node_response
node_verification_controller -->|"queries"| node_database
node_verification_controller -->|"records events"| node_audit
node_verification_controller -->|"formats response"| node_response
node_recruiter_controller -->|"queries"| node_database
node_recruiter_controller -->|"records events"| node_audit
node_recruiter_controller -->|"formats response"| node_response
node_audit -->|"writes logs"| node_database

click node_app "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/App.tsx"
click node_auth "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/context/AuthContext.tsx"
click node_routes "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/routes/AppRoutes.tsx"
click node_api "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/services/api.ts"
click node_developer_dash "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/pages/DeveloperDashboard.tsx"
click node_portfolio "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/pages/PublicPortfolioPage.tsx"
click node_skills "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/pages/SkillsManagerPage.tsx"
click node_assessments "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/pages/AssessmentPlayerPage.tsx"
click node_verifications "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/pages/VerificationsPage.tsx"
click node_projects "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/pages/ProjectsPage.tsx"
click node_verification_controller "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/controllers/verificationController.ts"
click node_assessment_controller "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/controllers/assessmentsController.ts"
click node_recruiter_dash "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/pages/RecruiterDashboard.tsx"
click node_bookmarks "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/pages/BookmarksPage.tsx"
click node_recruiter_controller "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/controllers/recruiterController.ts"
click node_admin_dash "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/pages/AdminDashboard.tsx"
click node_admin_controller "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/controllers/adminController.ts"
click node_server_app "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/app.ts"
click node_route_index "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/routes/index.ts"
click node_database "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/config/db.ts"
click node_audit "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/utils/audit.ts"
click node_response "https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/utils/response.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_auth,node_routes,node_api,node_developer_dash,node_portfolio toneBlue
class node_skills,node_assessments,node_verifications,node_projects,node_verification_controller,node_assessment_controller toneAmber
class node_recruiter_dash,node_bookmarks,node_recruiter_controller toneMint
class node_admin_dash,node_admin_controller,node_server_app,node_route_index,node_database,node_audit,node_response toneRose
class node_developer,node_recruiter,node_admin toneIndigo
```

## Components

### Client experience

- [Client shell](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/App.tsx): `skillproof/client/src/App.tsx`
- [Session and auth](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/context/AuthContext.tsx): `skillproof/client/src/context/AuthContext.tsx`
- [Role-based routes](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/routes/AppRoutes.tsx): `skillproof/client/src/routes/AppRoutes.tsx`
- [API client](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/services/api.ts): `skillproof/client/src/services/api.ts`
- [Developer dashboard](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/pages/DeveloperDashboard.tsx): `skillproof/client/src/pages/DeveloperDashboard.tsx`
- [Public portfolio](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/pages/PublicPortfolioPage.tsx): `skillproof/client/src/pages/PublicPortfolioPage.tsx`

### Skills and evidence

- [Skill manager](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/pages/SkillsManagerPage.tsx): `skillproof/client/src/pages/SkillsManagerPage.tsx`
- [Assessment flow](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/pages/AssessmentPlayerPage.tsx): `skillproof/client/src/pages/AssessmentPlayerPage.tsx`
- [Verification review](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/pages/VerificationsPage.tsx): `skillproof/client/src/pages/VerificationsPage.tsx`
- [Project portfolio](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/pages/ProjectsPage.tsx): `skillproof/client/src/pages/ProjectsPage.tsx`
- [Verification operations](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/controllers/verificationController.ts): `skillproof/server/src/controllers/verificationController.ts`
- [Assessment operations](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/controllers/assessmentsController.ts): `skillproof/server/src/controllers/assessmentsController.ts`

### Recruiter discovery

- [Developer discovery](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/pages/RecruiterDashboard.tsx): `skillproof/client/src/pages/RecruiterDashboard.tsx`
- [Saved developers](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/pages/BookmarksPage.tsx): `skillproof/client/src/pages/BookmarksPage.tsx`
- [Recruiter operations](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/controllers/recruiterController.ts): `skillproof/server/src/controllers/recruiterController.ts`

### Server operations

- [Admin console](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/client/src/pages/AdminDashboard.tsx): `skillproof/client/src/pages/AdminDashboard.tsx`
- [Admin operations](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/controllers/adminController.ts): `skillproof/server/src/controllers/adminController.ts`
- [HTTP application](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/app.ts): `skillproof/server/src/app.ts`
- [Server route registry](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/routes/index.ts): `skillproof/server/src/routes/index.ts`
- [Prisma database](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/config/db.ts): `skillproof/server/src/config/db.ts`
- [Audit logging](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/utils/audit.ts): `skillproof/server/src/utils/audit.ts`
- [Response helpers](https://github.com/arjunbalaji123/skillproof/blob/main/skillproof/server/src/utils/response.ts): `skillproof/server/src/utils/response.ts`

### Other components

- **Developer**
- **Recruiter**
- **Admin**

## Connections

- Client shell → Session and auth: provides session (evidence: `skillproof/client/src/App.tsx`)
- Client shell → Role-based routes: renders routes (evidence: `skillproof/client/src/App.tsx`)
- Client shell → HTTP application: calls API
- Role-based routes → Developer dashboard: routes to (evidence: `skillproof/client/src/routes/AppRoutes.tsx`)
- Role-based routes → Public portfolio: routes to (evidence: `skillproof/client/src/routes/AppRoutes.tsx`)
- Role-based routes → Skill manager: routes to (evidence: `skillproof/client/src/routes/AppRoutes.tsx`)
- Role-based routes → Assessment flow: routes to (evidence: `skillproof/client/src/routes/AppRoutes.tsx`)
- Role-based routes → Verification review: routes to (evidence: `skillproof/client/src/routes/AppRoutes.tsx`)
- Role-based routes → Project portfolio: routes to (evidence: `skillproof/client/src/routes/AppRoutes.tsx`)
- Role-based routes → Developer discovery: routes to (evidence: `skillproof/client/src/routes/AppRoutes.tsx`)
- Role-based routes → Saved developers: routes to (evidence: `skillproof/client/src/routes/AppRoutes.tsx`)
- Role-based routes → Admin console: routes to (evidence: `skillproof/client/src/routes/AppRoutes.tsx`)
- Session and auth → API client: requests session (evidence: `skillproof/client/src/context/AuthContext.tsx`)
- Skill manager → API client: requests skills (evidence: `skillproof/client/src/pages/SkillsManagerPage.tsx`)
- Skill manager → Verification operations: submits proof
- Assessment flow → Assessment operations: submits attempt
- Developer discovery → Recruiter operations: searches developers
- Admin console → Admin operations: requests oversight
- HTTP application → Server route registry: mounts routes (evidence: `skillproof/server/src/app.ts`)
- Admin operations → Prisma database: queries (evidence: `skillproof/server/src/controllers/adminController.ts`)
- Admin operations → Audit logging: records changes (evidence: `skillproof/server/src/controllers/adminController.ts`)
- Admin operations → Response helpers: formats response (evidence: `skillproof/server/src/controllers/adminController.ts`)
- Assessment operations → Prisma database: queries (evidence: `skillproof/server/src/controllers/assessmentsController.ts`)
- Assessment operations → Audit logging: records events (evidence: `skillproof/server/src/controllers/assessmentsController.ts`)
- Assessment operations → Response helpers: formats response (evidence: `skillproof/server/src/controllers/assessmentsController.ts`)
- Verification operations → Prisma database: queries (evidence: `skillproof/server/src/controllers/verificationController.ts`)
- Verification operations → Audit logging: records events (evidence: `skillproof/server/src/controllers/verificationController.ts`)
- Verification operations → Response helpers: formats response (evidence: `skillproof/server/src/controllers/verificationController.ts`)
- Recruiter operations → Prisma database: queries (evidence: `skillproof/server/src/controllers/recruiterController.ts`)
- Recruiter operations → Audit logging: records events (evidence: `skillproof/server/src/controllers/recruiterController.ts`)
- Recruiter operations → Response helpers: formats response (evidence: `skillproof/server/src/controllers/recruiterController.ts`)
- Audit logging → Prisma database: writes logs (evidence: `skillproof/server/src/utils/audit.ts`)
