先見明 Horizen

容晟科技旗下 ESG 法規情報基礎設施。即時監控 30+ 台灣與國際法規來源，透過 SDK / API 推送至顧問前端，讓企業客戶先一步看見法規動向。

See the regulatory horizon before it shifts.

📍 當前進度（2026-04-18）

Day 7 完成：Consumer API + Bearer token 認證。部署設定完成（Fly.io + Supabase + Upstash）。GitHub Actions cron 取代 APScheduler。

🏗 技術棧

🐍 Python / FastAPI 🐘 Supabase (PostgreSQL) ⚡ Upstash (Redis) ✈️ Fly.io 部署 ⚙️ GitHub Actions Cron 🔐 Bearer Token Auth 🧪 Alembic Migration 📦 Poetry

🔗 連結

GitHub EZoneLai/horizen
部署平台 Fly.io
資料庫 Supabase
快取 Upstash Redis
Health GET /v1/health

📡 API 路由清單

GET /v1/health — 健康檢查

GET/POST /v1/sources — 法規來源管理

POST /v1/sources/{code}/trigger — GitHub Actions 觸發爬取

GET/POST /v1/items — 法規條目（CRUD）

GET/POST /v1/events — 法規事件（異動記錄）

GET/POST /v1/consumers — Consumer 管理（Bearer Token）

GET /v1/coefficients — ESG 排放係數表

🗺 開發路線圖

✅ D1–D4 法規來源 CRUD + 爬取基礎架構
✅ D5 ESG 雙用途擴充（emission_coefficient 表 + /v1/coefficients）
✅ D6–D7 Consumer API + Bearer token 認證
✅ D8 部署設定（Fly.io + Supabase + Upstash）+ GitHub Actions cron
⬜ 下一步 SDK 套件（npm / PyPI）供前端整合
⬜ 前端顧問 Dashboard（法規異動一覽）
⬜ 通知 Webhook 推送 + LINE / Email 告警
⬜ 擴充監控來源擴充至 30+（目前初版）
⬜ 商業化 訂閱制 API Key 管理

🎨 品牌規範

完整版：~/Projects/ceyan-web/docs/BRAND_先見明_Horizen.md

Regulatory Ink #0B1E3D

Bronze Signal #B87333

Compliance Cream #F5F2EA

Verified Jade #2E7B5F

⚡ 本機開發

cd ~/Projects/horizen
poetry install
docker compose up -d postgres redis
poetry run alembic upgrade head
poetry run python scripts/seed_sources.py
poetry run uvicorn horizen.api.main:app --reload --port 8000
# health: curl http://localhost:8000/v1/health

🌅 先見明 Horizen — ESG 法規情報平台