python版本:3.11.9

啟動

1. 於 Supabase 執行 sql/schema.sql 建表與 RPC。
2. 複製 .env.example 為 .env 並填入 SUPABASE_URL、SUPABASE_KEY、OPENAI_API_KEY。
3. 建立 ES 索引（執行 backend\worker\create_index.py）。
4. 建置啟動容器：

   docker compose build --no-cache
   docker compose up
   

服務位址

• Gateway: http://localhost:8090/docs
• Worker: http://localhost:8091/docs
• PHP UI: http://localhost:8081/chat、http://localhost:8081/chat、http://localhost:8081/uploader

常用

• 重新建立索引：

  python backend/worker/create_index.py
  

• 清空索引資料：

  curl -X POST "http://localhost:9200/estate_knowledge/_delete_by_query?pretty" \
    -H "Content-Type: application/json" \
    -d '{"query": { "match_all": {} }}'
  

環境變數完整清單

.env / 後端使用

• SUPABASE_URL（必填）：Supabase 專案 URL
• SUPABASE_KEY（必填）：Supabase service_role key
• OPENAI_API_KEY（必填）：OpenAI API key
• EMBEDDING_MODEL（選填）：向量模型
  • backend/shared/settings.py 預設 text-embedding-3-large
  • seed_data.py / reembed_missing.py 預設 text-embedding-3-small → 建議在 .env 明確設定避免不一致
• CHAT_MODEL（選填）：對話模型，預設 gpt-4o-mini
• RERANK_MODEL（選填）：重排模型，未設定時使用 CHAT_MODEL
• INGEST_BUCKET（選填）：Storage bucket，預設 inheritance-tax-files
• STORAGE_BUCKET（選填）：INGEST_BUCKET 的替代名稱（worker 會讀）
• ES_URL（選填）：Elasticsearch URL
  • Docker 內預設 http://elasticsearch:9200
  • 本機預設 http://localhost:9200
• MAX_CHARS_PER_BATCH（選填）：單批次切片上限，預設 600000

Gateway / Worker 執行期（選填）

• IN_DOCKER：是否在 Docker 內執行（影響 ES URL 判斷）
• ALLOW_ORIGINS：CORS 白名單，預設 *
• STATIC_BASE_URL：Gateway 下載報告用的 base URL
• STATIC_DIR：Gateway 靜態檔案目錄，預設 /app/static

UI（ui/）

• GEMINI_API_KEY：僅 AI Studio 範例 UI 使用

Docker/容器設定（compose/Dockerfile）

• PYTHONUNBUFFERED、PIP_DISABLE_PIP_VERSION_CHECK、PIP_NO_CACHE_DIR
• PYTHONIOENCODING、LANG、LC_ALL
• Elasticsearch 容器：discovery.type、xpack.security.enabled、ES_JAVA_OPTS、search.max_buckets
• PHP 容器：APACHE_RUN_USER、APACHE_RUN_GROUP