ACME Salary Management
HR salary tool for ~10,000 employees (Incubyte take-home).
All make targets are in the root Makefile. Run them from the repo root (make help lists everything).
Live deployment
Production matches docs/IMPLEMENTATION_PLAN.md §3a: Railway (API + Postgres) and Vercel (React UI). Pushes to the connected Git branch redeploy each service.
Vercel build env: VITE_API_URL=https://testtask-incubyte-production.up.railway.app (no trailing slash; the app calls /api/...).
Railway API env: DATABASE_URL (reference Postgres), CORS_ORIGINS must include https://test-task-incubyte.vercel.app (and localhost origins if you still test locally).
On first deploy with an empty database, the API auto-seeds 10,000 employees (AUTO_SEED_ON_STARTUP=true). Migrations run on container start (backend/scripts/railway-start.sh).
Architecture diagrams
Data model
System architecture (local Docker and production)
Run with Docker (recommended)
Requires Docker and Compose.
cp .env.example .env
make up
Stop: Ctrl+C, then make down (add docker compose down -v to reset DB).
If the UI shows missing @mui/* imports after pulling new frontend deps, recreate the frontend service (docker compose up -d --build --force-recreate frontend) or remove the frontend_node_modules volume once.
Compose variables live in .env (see .env.example).
Host development (optional)
One-time setup:
cd backend && python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
cd ../frontend && npm install
cp frontend/.env.example frontend/.env # VITE_API_URL
make env # creates backend/.env
Postgres on localhost:5432 (e.g. make db-up, wait until healthy), then:
make migrate
make run # API :8000 — separate terminal: make ui for :5173
make seed # optional if DB empty; API also auto-seeds on startup
make test
Layout
Makefile all make targets (repo root only)
docker-compose.yml db + API + UI
backend/ FastAPI, Alembic, pytest
frontend/ React, Vite
docs/
