How arjun-v1-ai/ai-career-hub works
Project Type and Purpose
• This is a full-stack application that serves as a comprehensive career guidance platform using AI-powered features like video proctoring, resume analysis, and career counseling.
• The frontend is built with Next.js (using the App Router) and Tailwind CSS, and it handles user-facing pages and API routes under the “app” directory.
• The backend is implemented in Python using FastAPI (located in the “server” directory) with additional AI components (for example, MediaPipe for video analysis).
File Structure
• Frontend (Next.js):
• The “app” directory contains pages and API routes (e.g., authentication routes, career guidance, resume analysis, forum functionalities) with subfolders for different features.
• There are also “components” (for UI elements and widgets), “assets”, and public images, ensuring a clear separation of presentation and business logic.
• Backend (Python FastAPI):
• The “server” directory has the FastAPI application (server/main.py) along with its requirements.
• The README explains that the API endpoints in the backend include health checks and video analysis.
• Shared Resources and Utilities:
• “db” and “lib” directories hold database connection logic (likely for MongoDB, based on “lib/mongodb.js” and “db/dbConnection.js”) and “models” (User model).
• “services” and “utils” contain business logic and helper functions that are used across the project.
Determining Key Components
• Frontend Application (Next.js):
• UI/UX pages (e.g., home, profile, forum, career guidance sections)
• API Routes under “app/api” (handling authentication, user creation, resume analysis, cover letter generation, career guidance, etc.)
• Third-party integrations (NextAuth.js for authentication, Gemini API for AI tasks, and possibly Google APIs).
• Backend API Service (Python FastAPI):
• Main FastAPI server (server/main.py) responsible for video proctoring, video analysis, and possibly other analytical tasks (e.g., analyze, health endpoints).
• Integration with MediaPipe for video/image analysis.
• Database:
• MongoDB (with connection logic in “lib/mongodb.js” and “db/dbConnection.js” and schemas in “models”).
• External Services & Integrations:
• Authentication service (using NextAuth.js)
• External API calls to services like Gemini for resume analysis (usages evident in “utils/geminiAPI.js”)
• Job scraping service (via an API endpoint in “app/api/scrape-jobs”)
Architectural Patterns and Design Principles
• Separation of Concerns:
• The frontend and backend are clearly separated, with Next.js directly managing routes and pages while FastAPI handles dedicated analytical endpoints.
• API-First Approach:
• The project uses well-defined API endpoints (both within Next.js “app/api” and FastAPI backend) to handle most business logic.
• Modular Design:
• Components, services, and utilities are split into separate directories, which is ideal for maintainability and scalability.