Dev Tooling, Init Script & Developer Guide

Overview

A complete developer experience overhaul that replaced Docker exec and yarn-based workflows with bun run dev:* commands, added automated first-time setup, production database download, a full developer guide, and a port migration to avoid local conflicts.

What Changed

Automated Setup (PR #697)

• bun run init runs the full first-time setup: Docker containers, Composer, Bun install, database download, asset build, and cache clear.
• Eliminates the multi-step manual onboarding process.

Unified Dev Commands

Production DB Download

• bun run dev:download-db pulls the production database via SSH, excluding large tables (system_log, etl_property_address, etl_parcel, address_cache).
• bun run dev:download-db -- --import downloads and imports in one step (drops local DB first).

Port Migration (PR #696)

• All Docker ports prefixed with 1 to avoid conflicts: 8000 to 18000, 8444 to 18444, 8080 to 18080, 8025 to 18025.
• Updated docker-compose, nginx configs, CORS settings, Stripe fallback, E2E defaults.
• Auth0 callback URLs registered for localhost:18000 and localhost:18444.

Dev Dashboard

• Command Reference tab with every available command grouped by category.
• Deployment tab with step-by-step release guide, server layout, and rollback instructions.

Files Touched

Changelog Reference

• feat: add dev tooling, init script, and developer guide (f3b4762)
• fix: migrate all local dev ports to 1xxxx range (3ce081c)