Backend refactor: modular architecture, style guide, tooling

.gitignore

@@ -49,6 +49,7 @@ logs/
 # Generated files
 app/openapi.json
 tauri/src-tauri/binaries/*
+tauri/src-tauri/gen/Assets.car
 
 # Temporary
 tmp/

CHANGELOG.md

@@ -66,14 +66,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - OpenAPI client generator script now documents the local backend port and avoids an unused loop variable warning
 
 ### Added
-- **Makefile** - Comprehensive development workflow automation with commands for setup, development, building, testing, and code quality checks
-  - Includes Python version detection and compatibility warnings
-  - Self-documenting help system with `make help`
-  - Colored output for better readability
-  - Supports parallel development server execution
+- **justfile** - Comprehensive development workflow automation with commands for setup, development, building, testing, and code quality checks
+  - Cross-platform support (macOS, Linux, Windows)
+  - Python version detection and compatibility warnings
+  - Self-documenting help system with `just --list`
 
 ### Changed
-- **README** - Added Makefile reference and updated Quick Start with Makefile-based setup instructions alongside manual setup
+- **README** - Updated Quick Start with justfile-based setup instructions
+
+### Removed
+- **Makefile** - Replaced by justfile (cross-platform, simpler syntax)
 
 ---
 

PATCH_NOTES.md

@@ -31,7 +31,7 @@ Two-part fix:
 
 ## Testing
 To test this fix:
-1. Build Voicebox from source: `make build`
+1. Build Voicebox from source: `just build`
 2. Disconnect from internet
 3. Try generating speech
 4. Should work without network requests
@@ -40,13 +40,13 @@ To test this fix:
 
 ```bash
 # Install dependencies
-pip install -r requirements.txt
+just setup
 
 # Build the app
-make build
+just build
 
 # Or build just the server
-make build-server
+just build-server
 ```
 
 ## Notes