Draft: Sync development into main for next release

.github/workflows/docker-build.yml

@@ -15,4 +15,4 @@ jobs:
 
       - name: Build Docker image
         run: |
-          docker build -t fireform:test .
+          docker build -t fireform:test -f docker/prod/Dockerfile .

.github/workflows/lint.yml

@@ -19,11 +19,12 @@ jobs:
         with:
           python-version: "3.11"
 
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
       - name: Install linter
-        run: |
-          python -m pip install --upgrade pip
-          pip install ruff
+        run: uv pip install --system ruff
 
       - name: Run linter
         run: |
-          ruff check src/ --output-format=github
+          ruff check app/ --output-format=github

.github/workflows/tests.yml

@@ -2,14 +2,39 @@ name: Tests
 
 on:
   push:
-    branches: [main]
+    branches: [main,development]
+    paths:
+      - '**.py'
+      - 'requirements.txt'
+      - 'alembic.ini'
+      - '.github/workflows/tests.yml'
   pull_request:
-    branches: [main]
+    branches: [main,development]
+    paths:
+      - '**.py'
+      - 'requirements.txt'
+      - 'alembic.ini'
+      - '.github/workflows/tests.yml'
 
 jobs:
   test:
     runs-on: ubuntu-latest
 
+    services:
+      postgres:
+        image: postgres:16
+        env:
+          POSTGRES_USER: fireform
+          POSTGRES_PASSWORD: fireform
+          POSTGRES_DB: fireform
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd "pg_isready -U fireform"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
     steps:
       - uses: actions/checkout@v4
 
@@ -18,13 +43,22 @@ jobs:
         with:
           python-version: "3.11"
 
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
       - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install -r requirements.txt
+        run: uv pip install --system -r requirements.txt
 
       - name: Run tests
         env:
           PYTHONPATH: .
         run: |
-          python -m pytest tests/ -v --tb=short
+          python -m pytest tests/ -v --tb=short
+
+      - name: Check for un-migrated model changes
+        env:
+          PYTHONPATH: .
+          DATABASE_URL: postgresql://fireform:fireform@localhost:5432/fireform
+        run: |
+          python -m alembic upgrade head
+          python -m alembic check

.gitignore

@@ -26,4 +26,7 @@ src/inputs/*.pdf
 frontend/release/
 
 # Local Claude Code instructions
-CLAUDE.md
+CLAUDE.md
+
+*temp/
+*.env*

CONTRIBUTING.md

@@ -39,25 +39,14 @@ If you have a great idea for FireForm, we'd love to hear it! Please open an issu
 4. Make sure your code lints.
 5. Issue that pull request!
 
-## 🛠️ Local Development Setup
-
-FireForm uses Docker and Docker Compose for the backend to ensure a consistent environment.
+**Issues are not formally assigned.** You are free to pick any open issue, work on it, and raise a PR directly. If multiple PRs address the same issue, the first one that actually fixes it generally gets preference. To avoid duplicating someone else's work, coordinate with other contributors on our [Discord](https://discord.gg/nBv5b6kF68) before starting.
 
-### Prerequisites
+## 💬 Community
 
-- [Docker](https://docs.docker.com/get-docker/)
-- [Docker Compose](https://docs.docker.com/compose/install/)
-- `make` (optional, but recommended)
-- [Node.js](https://nodejs.org/) 20+ (only needed for the desktop app)
+Join our Discord server to ask questions, discuss issues, and coordinate work with other contributors: https://discord.gg/nBv5b6kF68
 
-### Desktop App Development
-
-The frontend is a vanilla HTML/CSS/JS app wrapped in Electron. To run it locally:
+## 🛠️ Local Development Setup
 
-```bash
-cd frontend
-npm install    # one-time setup
-npm start      # launches the Electron desktop window
-```
+See the [Setup Guide](docs/1.%20SETUP.md) for the full walkthrough: prerequisites, running the backend with Docker, testing endpoints via Swagger UI, day-to-day commands, and troubleshooting.
 
-The backend (API + Ollama) must be running separately via Docker — see `make fireform`.
+Before writing code, read the [Project Structure](docs/2.%20PROJECT_STRUCTURE.md) guide — it explains how the codebase is organized and where new code should go.