merge master

.dockerignore

@@ -0,0 +1,46 @@
+# Version control
+.git/
+.gitignore
+
+# CI/CD
+.github/
+
+# Development environment
+.venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.claude/
+
+# macOS
+.DS_Store
+
+# Large directories -- must not be included in image
+perfetto-build/
+perfetto-plugin/
+platform/
+
+# Build artifacts
+*.egg-info/
+dist/
+build/
+
+# Environment config (inject via env vars or volume)
+.env
+
+# Generated reports (use volume mount)
+reports/
+
+# Documentation (not needed at runtime)
+docs/
+*.md
+!README.md
+
+# Tests (not needed in production image)
+tests/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo

.env.docker.example

@@ -0,0 +1,28 @@
+# =============================================================================
+# SmartInspector Docker Environment Variables
+# =============================================================================
+# Usage:
+#   1. Copy to .env: cp .env.docker.example .env
+#   2. Fill in [REQUIRED] values
+#   3. Run: docker compose --profile prod up -d
+# =============================================================================
+
+# -- LLM Configuration [REQUIRED] -------------------------------------------
+SI_API_KEY=                           # [REQUIRED] LLM API key
+SI_MODEL=deepseek-chat                # Default model
+SI_BASE_URL=https://api.deepseek.com  # API endpoint
+
+# -- Role Override (optional) ------------------------------------------------
+# SI_ATTRIBUTOR_MODEL=claude-sonnet-4-20250514
+
+# -- Feature Configuration ---------------------------------------------------
+SI_DEBUG=0
+SI_REPORT_MAX_TOKENS=4000
+SI_TOOL_TIMEOUT=30
+SI_WS_PORT=9876
+SI_WS_PING_TIMEOUT=30
+
+# -- Docker Volume Mount Paths -----------------------------------------------
+TRACE_DIR=./traces
+REPORT_DIR=./reports
+SOURCE_DIR=./src

.gitignore

@@ -33,3 +33,4 @@ reports/
 platform/android/.gradle/
 platform/android/build/
 platform/android/.idea/
+perfetto-build/