Track and present your skills as developer. Actively manage team competencies as leader.

• Framework: React + TypeScript (Vite)
• State: TanStack Query (Server State) + Zustand (UI State)
• Styling: Tailwind CSS + Shadcn UI
• Routing: React Router
• Visuals: Recharts

• Language: Go
• Router: Chi
• Database Access: sqlc (Type-safe SQL generation)
• Database: PostgreSQL
• Auth: OAuth2 (GitHub/Google) with HttpOnly Sessions

• Python (FastAPI + Scikit-learn)

1. Skill Journal: A "diary" view for users to log daily activities and link them to specific skills.
2. Visual Analytics: Graphical dashboards to visualize competence growth over time.
3. Smart Recommendations: A system that suggests new skills or activities based on the user's history and similar users' data.

This project uses VS Code Dev Containers to ensure a consistent environment. You do not need to install Go, Node.js, or Postgres locally on your machine—only Docker.

• Docker Desktop (Running)
• VS Code
• Remote - Containers Extension

1. Clone the repo:

2. Open in Container:

3. Wait for Initialization:

4. Start Development Servers: Open the integrated terminal (Ctrl+`) inside VS Code.

   Terminal 1 (Backend):

   # Runs the Go server with live reloading (Air)
   # Ensure you have 'air' installed or run 'go run cmd/server/main.go'
   go run cmd/server/main.go

   Terminal 2 (Frontend):

   cd web
   npm install
   npm run dev

5. Access the App:

   • Frontend: http://localhost:5173
   • Backend API: http://localhost:8080
   • Database: localhost:5432 (User: postgres, Pass: postgres, DB: postgres)

We follow the "Tracer Bullet" methodology: building thin, complete slices of functionality rather than isolated layers.

• Set up Monorepo structure (Go + Vite).
• Configure Dev Container with Postgres.
• Goal: A /api/health endpoint that queries the DB and is displayed on the React frontend.

• Implement GitHub OAuth flow (Backend-for-Frontend pattern).
• Secure cookies (HttpOnly, SameSite).
• Deploy "Skeleton" to Production (Railway + Vercel) to verify cross-domain cookies.

• Design DB Schema (users, skills, activities).
• Generate Go code with sqlc.
• Build "Add Activity" form (React Hook Form + Zod).
• Build "Activity Feed" (Infinite Scroll with React Query).

• Create Aggregation Queries in SQL (Competence over time).
• Implement Charts using Recharts.
• Spin up Python Microservice (FastAPI).
• Implement basic recommendation algorithm.

We use a split-stack deployment strategy for cost and performance optimization.

Backend (Railway):

PORT=8080
DATABASE_URL=postgres://...
GO_ENV=production
# OAuth
GITHUB_CLIENT_ID=...
GITHUB_CLIENT_SECRET=...
# Security
SESSION_SECRET=...
FRONTEND_URL=[https://app.yourdomain.com](https://app.yourdomain.com)