Start Local Dev Skill

Use this skill when starting or managing local development services.

---

Quick Start

# Start database (in DevContainer, usually already running)
task compose:up

# Start the API
task api:start

# Optional: import data (if database is empty)
task importer:start:use-cache

# Optional: compute builds (if optimum_builds is empty)
task evaluator:start:test-mode

---

Services

Service	Command	Purpose
PostgreSQL	task compose:up	Database (required by all services)
API	task api:start	HTTP endpoints at localhost:8080
Importer	task importer:start	Populate database from tarkov.dev
Evaluator	task evaluator:start	Compute optimal builds

Importer Variants

Command	Use Case
task importer:start	Fetch fresh data from API
task importer:start:use-cache	Use local cache (faster)
task importer:start:cache-only	Update cache only, skip DB

Evaluator Variants

Command	Use Case
task evaluator:start	Full evaluation (slow)
task evaluator:start:test-mode	Limited subset (fast, for development)

---

Service Dependencies

PostgreSQL
    ├── API (reads builds)
    ├── Importer (writes data)
    └── Evaluator (reads data, writes builds)

Typical startup order:

1. Database: task compose:up
2. Migrations: task migrate:up (if not already applied)
3. Importer: task importer:start:use-cache (if database is empty)
4. Evaluator: task evaluator:start:test-mode (to compute builds)
5. API: task api:start

---

Common Workflows

API Development

task compose:up
task api:start

Import Pipeline Development

task compose:up
task importer:start:use-cache

Evaluator Development

task compose:up
task importer:start:use-cache
task evaluator:start:test-mode

---

Troubleshooting

Database connection fails:

• Check if database is running: docker compose ps
• Verify .env has correct POSTGRES_* values

Port already in use:

• Find process: lsof -i :8080
• Kill it: kill -9 <PID>

Stale data:

task compose:down
docker compose down -v  # removes volumes
task compose:up
task migrate:up
task importer:start