# joshi-chinmay-016/skillswap architecture

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

- Interactive diagram: https://gitdiagram.com/joshi-chinmay-016/skillswap
- Repository: https://github.com/joshi-chinmay-016/skillswap

## Overview

SkillSwap Arena is a peer-to-peer learning platform where users exchange skills, book verified mentors, conduct live sessions, and earn or spend coins. Its core user journey runs from finding a learning opportunity through verified capability matching and escrow-backed booking to collaborative sessions and grounded session intelligence. The React SPA also exposes AI mentorship and document-grounded Q&A; backend services support these features alongside platform governance. Several domain links below follow explicit README descriptions; unsampled implementation details are not asserted.

Main entry points: [`frontend/src/routes/AppRoutes.jsx`](https://github.com/joshi-chinmay-016/skillswap/blob/dev/frontend/src/routes/AppRoutes.jsx) (Application routes), [`backend/app/services/session_service.py`](https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/services/session_service.py) (Live sessions), [`backend/app/services/session_request_service.py`](https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/services/session_request_service.py) (Session booking), [`backend/app/rag/rag_service.py`](https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/rag/rag_service.py) (Grounded RAG)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_spa["React application<br/>[App.jsx]"]
  node_journey_ui["Learning journeys"]
  node_session_ui["Session workspace<br/>[SessionDetail.jsx]"]
  node_mentor_ui["AI mentor<br/>[AIMentorPage.tsx]"]
  node_rag_ui["Knowledge Q&amp;A<br/>[RAGQueryPage.jsx]"]
  node_routes["Application routes<br/>[AppRoutes.jsx]"]
end

subgraph group_exchange["Peer learning exchange"]
  node_verification["Skill verification<br/>[skill_service.py]"]
  node_matching["Mentor matching<br/>[match_service.py]"]
  node_booking["Session booking"]
  node_sessions["Live sessions<br/>[session_service.py]"]
  node_coin_wallet[("Coin wallet<br/>[wallet_service.py]")]
end

subgraph group_intelligence["AI and knowledge"]
  node_session_ai["Session intelligence"]
  node_mentor_ai["Mentor intelligence"]
  node_document_api["Document ingestion<br/>[document_router.py]"]
  node_parsing["Document parsing<br/>[parser_manager.py]"]
  node_embedding["Embedding generation"]
  node_vector_index["Vector indexing"]
  node_rag_query["Grounded RAG<br/>[rag_service.py]"]
  node_retrieval["Vector retrieval"]
  node_rag_api["RAG endpoint<br/>[rag_router.py]"]
end

subgraph group_platform["Platform services"]
  node_db[("PostgreSQL<br/>[database.py]")]
  node_redis[("Redis coordination<br/>[redis.py]")]
end

node_learner(("Platform user"))
node_video(("Jitsi Meet"))

node_learner -->|"uses"| node_spa
node_spa -->|"routes through"| node_routes
node_routes -.->|"opens"| node_journey_ui
node_routes -->|"opens"| node_session_ui
node_routes -.->|"opens"| node_mentor_ui
node_routes -.->|"opens"| node_rag_ui
node_learner -->|"pursues learning"| node_journey_ui
node_journey_ui -.->|"finds mentors"| node_matching
node_verification -->|"qualifies mentors"| node_matching
node_matching -.->|"supports booking"| node_booking
node_learner -->|"books sessions"| node_booking
node_booking -->|"escrows coins"| node_coin_wallet
node_booking -.->|"creates sessions"| node_sessions
node_sessions -->|"hosts workspace"| node_session_ui
node_sessions -->|"uses video rooms"| node_video
node_sessions -->|"feeds session notes"| node_session_ai
node_mentor_ui -.->|"requests mentorship"| node_mentor_ai
node_learner -.->|"uploads documents"| node_document_api
node_document_api -.->|"parses documents"| node_parsing
node_parsing -.->|"prepares chunks"| node_embedding
node_embedding -.->|"indexes vectors"| node_vector_index
node_rag_ui -->|"submits query"| node_rag_api
node_rag_api -->|"calls query"| node_rag_query
node_rag_query -->|"retrieves context"| node_retrieval
node_retrieval -->|"resolves metadata"| node_db
node_rag_query -->|"returns grounded answer"| node_learner
node_sessions -->|"coordinates sockets"| node_redis
node_booking -->|"persists bookings"| node_db

click node_spa "https://github.com/joshi-chinmay-016/skillswap/blob/dev/frontend/src/App.jsx"
click node_journey_ui "https://github.com/joshi-chinmay-016/skillswap/blob/dev/frontend/src/pages/LearningJourney.jsx"
click node_session_ui "https://github.com/joshi-chinmay-016/skillswap/blob/dev/frontend/src/pages/SessionDetail.jsx"
click node_mentor_ui "https://github.com/joshi-chinmay-016/skillswap/blob/dev/frontend/src/pages/AIMentorPage.tsx"
click node_rag_ui "https://github.com/joshi-chinmay-016/skillswap/blob/dev/frontend/src/pages/RAGQueryPage.jsx"
click node_routes "https://github.com/joshi-chinmay-016/skillswap/blob/dev/frontend/src/routes/AppRoutes.jsx"
click node_verification "https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/services/skill_service.py"
click node_matching "https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/services/match_service.py"
click node_booking "https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/services/session_request_service.py"
click node_sessions "https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/services/session_service.py"
click node_coin_wallet "https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/services/wallet_service.py"
click node_session_ai "https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/ai/services/ai_session_summary_generator.py"
click node_mentor_ai "https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/ai/services/mentor_intelligence_engine.py"
click node_document_api "https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/api/document_router.py"
click node_parsing "https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/parsers/parser_manager.py"
click node_embedding "https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/services/embedding_service.py"
click node_vector_index "https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/services/vector_indexing_service.py"
click node_rag_query "https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/rag/rag_service.py"
click node_retrieval "https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/retrieval/retrieval_service.py"
click node_rag_api "https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/api/rag_router.py"
click node_db "https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/core/database.py"
click node_redis "https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/core/redis.py"

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_spa,node_journey_ui,node_session_ui,node_mentor_ui,node_rag_ui,node_routes,node_learner toneBlue
class node_verification,node_matching,node_booking,node_sessions,node_coin_wallet toneAmber
class node_session_ai,node_mentor_ai,node_document_api,node_parsing,node_embedding,node_vector_index,node_rag_query,node_retrieval,node_rag_api toneMint
class node_db,node_redis toneRose
class node_video toneIndigo
```

## Components

### User experience

- [React application](https://github.com/joshi-chinmay-016/skillswap/blob/dev/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Learning journeys](https://github.com/joshi-chinmay-016/skillswap/blob/dev/frontend/src/pages/LearningJourney.jsx): `frontend/src/pages/LearningJourney.jsx`
- [Session workspace](https://github.com/joshi-chinmay-016/skillswap/blob/dev/frontend/src/pages/SessionDetail.jsx): `frontend/src/pages/SessionDetail.jsx`
- [AI mentor](https://github.com/joshi-chinmay-016/skillswap/blob/dev/frontend/src/pages/AIMentorPage.tsx): `frontend/src/pages/AIMentorPage.tsx`
- [Knowledge Q&A](https://github.com/joshi-chinmay-016/skillswap/blob/dev/frontend/src/pages/RAGQueryPage.jsx): `frontend/src/pages/RAGQueryPage.jsx`
- [Application routes](https://github.com/joshi-chinmay-016/skillswap/blob/dev/frontend/src/routes/AppRoutes.jsx): `frontend/src/routes/AppRoutes.jsx`

### Peer learning exchange

- [Skill verification](https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/services/skill_service.py): `backend/app/services/skill_service.py`
- [Mentor matching](https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/services/match_service.py): `backend/app/services/match_service.py`
- [Session booking](https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/services/session_request_service.py): `backend/app/services/session_request_service.py`
- [Live sessions](https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/services/session_service.py): `backend/app/services/session_service.py`
- [Coin wallet](https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/services/wallet_service.py): `backend/app/services/wallet_service.py`

### AI and knowledge

- [Session intelligence](https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/ai/services/ai_session_summary_generator.py): `backend/app/ai/services/ai_session_summary_generator.py`
- [Mentor intelligence](https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/ai/services/mentor_intelligence_engine.py): `backend/app/ai/services/mentor_intelligence_engine.py`
- [Document ingestion](https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/api/document_router.py): `backend/app/api/document_router.py`
- [Document parsing](https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/parsers/parser_manager.py): `backend/parsers/parser_manager.py`
- [Embedding generation](https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/services/embedding_service.py): `backend/app/services/embedding_service.py`
- [Vector indexing](https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/services/vector_indexing_service.py): `backend/app/services/vector_indexing_service.py`
- [Grounded RAG](https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/rag/rag_service.py): `backend/app/rag/rag_service.py`
- [Vector retrieval](https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/retrieval/retrieval_service.py): `backend/app/retrieval/retrieval_service.py`
- [RAG endpoint](https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/api/rag_router.py): `backend/app/api/rag_router.py`

### Platform services

- [PostgreSQL](https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/core/database.py): `backend/app/core/database.py`
- [Redis coordination](https://github.com/joshi-chinmay-016/skillswap/blob/dev/backend/app/core/redis.py): `backend/app/core/redis.py`

### Other components

- **Platform user**
- **Jitsi Meet**

## Connections

- Platform user → React application: uses
- React application → Application routes: routes through (evidence: `frontend/src/App.jsx`)
- Application routes → Learning journeys: opens (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Application routes → Session workspace: opens (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Application routes → AI mentor: opens (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Application routes → Knowledge Q&A: opens
- Platform user → Learning journeys: pursues learning
- Learning journeys → Mentor matching: finds mentors
- Skill verification → Mentor matching: qualifies mentors
- Mentor matching → Session booking: supports booking
- Platform user → Session booking: books sessions
- Session booking → Coin wallet: escrows coins
- Session booking → Live sessions: creates sessions
- Live sessions → Session workspace: hosts workspace
- Live sessions → Jitsi Meet: uses video rooms
- Live sessions → Session intelligence: feeds session notes
- AI mentor → Mentor intelligence: requests mentorship
- Platform user → Document ingestion: uploads documents
- Document ingestion → Document parsing: parses documents
- Document parsing → Embedding generation: prepares chunks
- Embedding generation → Vector indexing: indexes vectors
- Knowledge Q&A → RAG endpoint: submits query (evidence: `backend/app/api/rag_router.py`)
- RAG endpoint → Grounded RAG: calls query (evidence: `backend/app/api/rag_router.py`)
- Grounded RAG → Vector retrieval: retrieves context (evidence: `backend/app/rag/rag_service.py`)
- Vector retrieval → PostgreSQL: resolves metadata (evidence: `backend/app/retrieval/retrieval_service.py`)
- Grounded RAG → Platform user: returns grounded answer
- Live sessions → Redis coordination: coordinates sockets
- Session booking → PostgreSQL: persists bookings
