feat: consolidate env config and add deployment files

- Add debug_font_path, demo_docs_dir, e2e_api_base_url to config.py
- Fix hardcoded paths in pp_structure_debug.py, create_demo_images.py
- Fix hardcoded paths in test files
- Update .env.example with new configuration options
- Update .gitignore to exclude AI development files (.claude/, openspec/, AGENTS.md, CLAUDE.md)
- Add production startup script (start-prod.sh)
- Add README.md with project documentation
- Add 1panel Docker deployment files (docker-compose.yml, Dockerfiles, nginx.conf)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

start.sh

@@ -22,7 +22,9 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PID_DIR="$SCRIPT_DIR/.pid"
 BACKEND_PID_FILE="$PID_DIR/backend.pid"
 FRONTEND_PID_FILE="$PID_DIR/frontend.pid"
+BACKEND_HOST=${BACKEND_HOST:-0.0.0.0}
 BACKEND_PORT=${BACKEND_PORT:-8000}
+FRONTEND_HOST=${FRONTEND_HOST:-0.0.0.0}
 FRONTEND_PORT=${FRONTEND_PORT:-5173}
 
 # Create PID directory
@@ -84,6 +86,17 @@ check_requirements() {
     return $missing
 }
 
+load_env() {
+    # Load environment variables from root .env.local (if present).
+    # This keeps backend/frontend config in sync without hardcoding ports/URLs in scripts.
+    if [ -f "$SCRIPT_DIR/.env.local" ]; then
+        set -a
+        # shellcheck disable=SC1090
+        source "$SCRIPT_DIR/.env.local"
+        set +a
+    fi
+}
+
 is_running() {
     local pid_file=$1
     if [ -f "$pid_file" ]; then
@@ -117,9 +130,7 @@ start_backend() {
     source "$SCRIPT_DIR/venv/bin/activate"
 
     # Load environment variables
-    if [ -f "$SCRIPT_DIR/.env.local" ]; then
-        export $(grep -v '^#' "$SCRIPT_DIR/.env.local" | xargs)
-    fi
+    load_env
 
     # Start backend in background
     cd "$SCRIPT_DIR/backend"
@@ -131,7 +142,7 @@ start_backend() {
     mkdir -p logs
 
     # Start uvicorn
-    nohup uvicorn app.main:app --reload --host 0.0.0.0 --port $BACKEND_PORT > "$SCRIPT_DIR/.pid/backend.log" 2>&1 &
+    nohup uvicorn app.main:app --reload --host "$BACKEND_HOST" --port "$BACKEND_PORT" > "$SCRIPT_DIR/.pid/backend.log" 2>&1 &
     local pid=$!
     echo $pid > "$BACKEND_PID_FILE"
 
@@ -157,6 +168,9 @@ start_frontend() {
 
     echo -e "${GREEN}Starting frontend server...${NC}"
 
+    # Load environment variables so Vite config can use FRONTEND_PORT/FRONTEND_HOST/etc.
+    load_env
+
     # Load nvm
     export NVM_DIR="$HOME/.nvm"
     [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"