Career AI Platform (Phase 1)

Production-grade monorepo foundation for an AI-powered career guidance and job readiness platform.

Project Structure

career-ai-platform/
├── frontend/
├── backend/
├── ai-service/
├── database/
├── docker/
├── shared/
├── docs/
├── scripts/
├── docker-compose.yml
└── .env.example

Prerequisites

• Node.js 20+
• Python 3.11+ (3.12 recommended)
• Docker + Docker Compose

Local Setup

1. Install dependencies:
   • Frontend: cd frontend && npm install
   • Backend: cd backend && npm install
   • AI service: cd ai-service && python -m venv .venv && .\.venv\Scripts\Activate.ps1 && pip install -r requirements.txt
2. Keep environment files as provided:
   • frontend/.env.local
   • backend/.env
   • ai-service/.env
   • root .env.example as template

Run Services (Local)

• Frontend: cd frontend && npm run dev
• Backend: cd backend && npm run dev
• AI service: cd ai-service && .\.venv\Scripts\Activate.ps1 && uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

Endpoints:

• Frontend: http://localhost:3000
• Backend health: http://localhost:5000/api/health
• Backend AI check: http://localhost:5000/api/health/ai
• AI health: http://localhost:8000/health
• AI test: http://localhost:8000/test-ai

Docker

From repo root:

docker compose up --build

Services:

• frontend: 3000
• backend: 5000
• ai-service: 8000
• mongodb: 27017

Testing

• Frontend lint: cd frontend && npm run lint
• Backend tests: cd backend && npm test
• AI tests: cd ai-service && .\.venv\Scripts\Activate.ps1 && pytest -q