SkillSense AI

AI-powered skill intelligence for developers and teams. SkillSense AI connects to developer activity (mocked GitHub integration), builds a skill graph, generates weekly learning plans, and offers an AI coach chat experience. Multi-tenant organizations are supported with basic analytics.

Stack

• Backend: Java 17, Spring Boot 3, Spring Security (JWT), Spring Data JPA, Flyway, PostgreSQL
• Frontend: React 18 + TypeScript, Vite, Tailwind CSS, React Router, TanStack Query, Axios, Zustand
• Infra: Docker Compose (PostgreSQL, backend, frontend)

Quick start

1. Start database (and optionally app stack)

   cd infra
   docker compose up -d db
   # or full stack
   docker compose up -d

2. Backend (dev)

   cd backend
   mvn spring-boot:run

3. Frontend (dev)

   cd frontend
   npm install
   npm run dev

4. Open UI at http://localhost:5173, register, login, and explore dashboard, skill graph, plan, AI coach, and analytics.

Configuration

• Database: DB_URL (default jdbc:postgresql://localhost:5432/skillsense), DB_USER, DB_PASSWORD
• JWT: JWT_SECRET, skillsense.jwt.expiration-ms, skillsense.jwt.refresh-expiration-ms
• CORS: ALLOWED_ORIGINS (default http://localhost:5173)
• AI: LLM_API_KEY, LLM_BASE_URL (mocked responses when API key is absent)

Database schema

Flyway migration V1__init.sql creates users, organizations, memberships, integrations, skills, learning plans, AI conversations/messages, and related tables. JPA entities live under backend/src/main/java/com/skillsense.

Running tests

cd backend
mvn test

Notes

• GitHub OAuth/connect URL is stubbed; manual sync seeds mock activity.
• LLM client returns a mocked response unless LLM_API_KEY is provided.
• Profiles: dev (default) and prod are available via SPRING_PROFILES_ACTIVE.