How pre1102/placement-assistant works
CareerCampusAI is a placement-intelligence and career-guidance product for students and placement-cell staff. Students use its React workspace to ask cited institutional questions, check eligibility, compare companies, build career plans, prepare for interviews, align resumes, and maintain a profile; admins manage documents and inspect/rebuild retrieval. The backend combines FastAPI routes, deterministic eligibility checks, document processing, and grounded RAG over SQLite and FAISS. Several route/page implementations were not sampled, so those capabilities and links are represented from the README and source index; unsampled internal call details are not inferred.
Main entry points: App.jsx App routing shell · main.py FastAPI application · api.js HTTP API client · rag_engine.py RAG orchestration
Components 34
Student workspace
- App routing shell
frontend/src/App.jsx - AI assistant
frontend/src/pages/AIAssistant.jsx - Eligibility checker
frontend/src/pages/PlacementChecker.jsx - Company explorer
frontend/src/pages/CompanyExplorer.jsx - Career roadmap
frontend/src/pages/CareerGuidance.jsx - Interview prep
frontend/src/pages/InterviewPrep.jsx - Resume guidance
frontend/src/pages/ResumeGuidance.jsx - Student profile
frontend/src/pages/ProfilePage.jsx - HTTP API client
frontend/src/services/api.js
Admin workspace
- Admin dashboard
frontend/src/pages/AdminDashboard.jsx - Document management
frontend/src/pages/AdminDocuments.jsx - Knowledge health
frontend/src/pages/AdminKnowledgeBase.jsx - Retrieval inspector
frontend/src/pages/AdminRetrievalTest.jsx
Backend API
- FastAPI application
backend/app/main.py - Chat endpoint
backend/app/api/routes/chat.py - Placement endpoints
backend/app/api/routes/placement.py - Company directory
backend/app/api/routes/companies.py - Career endpoint
backend/app/api/routes/career.py - Interview endpoint
backend/app/api/routes/interview.py - Resume endpoint
backend/app/api/routes/resume.py - Profile endpoints
backend/app/api/routes/profile.py - Document endpoints
backend/app/api/routes/documents.py - Knowledge-base endpoints
backend/app/api/routes/knowledge_base.py - Retrieval endpoint
backend/app/api/routes/retrieval.py
Intelligence services
- RAG orchestration
backend/app/services/rag_engine.py - Intent classification
backend/app/services/query_classifier.py - Hybrid retrieval
backend/app/services/retriever.py - Eligibility engine
backend/app/services/placement_engine.py - Grounded answer synthesis
backend/app/services/llm_service.py - Career planning logic
backend/app/services/career_engine.py
Knowledge and state
- PDF text extraction
backend/app/services/document_processor.py - Metadata chunking
backend/app/services/chunking.py
Other components
- Student
- Placement staff
Connections 43
- Student → App routing shell: uses
README.md - Placement staff → App routing shell: uses
README.md - App routing shell → AI assistant: routes to
frontend/src/App.jsx - App routing shell → Eligibility checker: routes to
frontend/src/App.jsx - App routing shell → Company explorer: routes to
frontend/src/App.jsx - App routing shell → Career roadmap: routes to
frontend/src/App.jsx - App routing shell → Interview prep: routes to
frontend/src/App.jsx - App routing shell → Resume guidance: routes to
frontend/src/App.jsx - App routing shell → Student profile: routes to
frontend/src/App.jsx - App routing shell → Admin dashboard: routes to
frontend/src/App.jsx - App routing shell → Document management: routes to
frontend/src/App.jsx - App routing shell → Knowledge health: routes to
frontend/src/App.jsx - App routing shell → Retrieval inspector: routes to
frontend/src/App.jsx - App routing shell → HTTP API client: loads profile via
frontend/src/App.jsx - AI assistant → HTTP API client: asks via
- Eligibility checker → HTTP API client: checks via
- Company explorer → HTTP API client: loads via
frontend/src/pages/CompanyExplorer.jsx - Career roadmap → HTTP API client: requests via
- Interview prep → HTTP API client: requests via
- Resume guidance → HTTP API client: requests via
frontend/src/pages/ResumeGuidance.jsx - Student profile → HTTP API client: updates via
frontend/src/pages/ProfilePage.jsx - Document management → HTTP API client: manages via
frontend/src/pages/AdminDocuments.jsx - Retrieval inspector → HTTP API client: tests via
frontend/src/pages/AdminRetrievalTest.jsx - FastAPI application → Chat endpoint: registers
backend/app/main.py - FastAPI application → Placement endpoints: registers
backend/app/main.py - FastAPI application → Company directory: registers
backend/app/main.py - FastAPI application → Career endpoint: registers
backend/app/main.py - FastAPI application → Interview endpoint: registers
backend/app/main.py - FastAPI application → Resume endpoint: registers
backend/app/main.py - FastAPI application → Profile endpoints: registers
backend/app/main.py - FastAPI application → Document endpoints: registers
backend/app/main.py - FastAPI application → Knowledge-base endpoints: registers
backend/app/main.py - FastAPI application → Retrieval endpoint: registers
backend/app/main.py - Chat endpoint → RAG orchestration: dispatches
backend/app/main.py - Company directory → Eligibility engine: evaluates with
backend/app/api/routes/companies.py - Placement endpoints → Eligibility engine: evaluates with
backend/app/api/routes/placement.py - Retrieval endpoint → Hybrid retrieval: tests through
backend/app/api/routes/retrieval.py - Document endpoints → PDF text extraction: processes with
backend/app/api/routes/documents.py - Document endpoints → Metadata chunking: chunks with
backend/app/api/routes/documents.py - RAG orchestration → Intent classification: classifies
backend/app/services/rag_engine.py - RAG orchestration → Hybrid retrieval: retrieves via
backend/app/services/rag_engine.py - RAG orchestration → Eligibility engine: evaluates with
backend/app/services/rag_engine.py - RAG orchestration → Grounded answer synthesis: synthesizes with
backend/app/services/rag_engine.py