🌅 先見明 Horizen

🐙 GitHub 📊 甘特圖 🎨 UI/UX 設計稿

先見明 · Horizen

容晟科技 ESG 法規情報基礎設施 — 整合法規監控、碳盤查、GRI 報告三引擎。

See the regulatory horizon before it shifts.
100
Tests ✅
7
API 路由
2
付費客戶
P1
當前 Phase
Sprint 1 · 2 週
Haiku 摘要 + Webhook Dispatch + 碳盤查基礎
進行中
2026-04-18 ~ 2026-05-02週期
Eugene（100%）成員
10 工作天容量
~18 Story Points計畫量
等待 A/B 客戶確認單🚧 外部相依
Sprint Goal：在不依賴客戶回覆的前提下，完成平台核心功能（AI 摘要 + 推送重試），並建立碳盤查 DB schema 基礎，讓 A/B 客戶確認到位後可立即開展。
進度 55% · 估計完成日 2026-05-02
13
已完成 pts
0
進行中 pts
4
受阻 pts
9
Backlog pts
26
Total pts
50%
Velocity %

📋 Sprint Board

2026-04-18 ~ 2026-05-02

Backlog
碳盤查 DB Migration
emission_period + emission_entry
P12 ptsA+B+Platform
POST /v1/emissions/periods API
P12 ptsB 客戶
GET/POST /v1/emissions/entries API
P12 ptsB 客戶
OCR 電費單解析
pdfplumber + Tesseract
P23 ptsB 客戶
DQI 健檢引擎
加權資料品質指數 1–5
P22 ptsB 客戶
In Progress
/v1/emissions/* API
POST /periods, POST /entries, GET /periods/{id}/summary
P03 ptsB 客戶
DQI 健檢引擎
completeness + timeliness + source_reliability
P02 ptsB 客戶
Blocked
A 客戶 Webhook 中台對接
P02 ptsA 客戶
🚧 等待：需求確認單回覆
B 客戶 S1–S3 碳盤查前端 API 設計
P02 ptsB 客戶
🚧 等待：需求確認單回覆
Done ✅
Claude Haiku 摘要整合
services/summarizer.py · 8 tests
完成3 ptsPlatform
Webhook dispatch + HMAC-SHA256
dispatch_log + 3次重試 · 10 tests
完成3 ptsA 客戶
Migration 004 + 碳盤查 5 張表
完成2 ptsB 客戶
Consumer API + Bearer token 認證
完成3 ptsPlatform
部署設定（Fly.io + Supabase + Upstash）
完成2 pts
A/B 客戶提案書 + 合約草稿
完成—BIZ

⚠️ 風險登記冊

風險影響可能性對應措施
A/B 客戶確認單長時間未回覆 高 — 客戶端開發 blocked 中 72h 後主動 follow-up；在等待期間推進 Platform 核心功能
Supabase RLS 多租戶隔離設計複雜度 中 — DB migration 延誤 中 Phase 1 先建單租戶版本，待 RLS 設計完成再升級
OCR 台電帳單格式多元 中 — OCR 準確率不穩定 高 先支援標準台電帳單格式，其他格式走手動輸入 fallback
Claude Haiku 單日 API 費用超過 $5 低 — 成本告警 低 CLAUDE.md 已定義告警機制；input 限 500 tokens / 次

✅ Definition of Done

程式碼通過 poetry run ruff check 0 errors
新功能至少 3 個測試（快照 / 整合），全部 pass
API 路由已加入 ARCHITECTURE.md 路由清單
docs/NEXT_SESSION.md 更新下次啟動包
docs/TRACKER.md 任務狀態更新（完成打 ✅）
此 Sprint Board 對應 card 移至 Done 欄
git commit（指定檔案，不用 git add -A）

🗺 Phase 路線圖

✅ Phase 0 — 法規情報基礎（完成）
Fetchers · DB Schema · Consumer API · 部署 Fly.io + Supabase · 71 tests
/v1/sources/v1/items/v1/events/v1/consumers/v1/coefficients
🟡 Phase 1 — AI 摘要 + 碳盤查（進行中，2–3 月）
Claude Haiku 摘要 · Webhook dispatch · emission_period + emission_entry · OCR · DQI
⬜ Phase 2 — ESG S/G 面 + 報告生成（3–4 月）
social_record · governance_record · GRI auto-gen · TCFD · 查證師入口 · SHA-256
⬜ Phase 3 — Next.js 前端 SaaS（4–6 月）
Cloudflare Pages · shadcn/ui · Supabase Auth · 同業 benchmark · FE-A/B/C
⬜ Phase 4 — @horizen/core SDK（6–9 月）
npm 套件發布 · TypeScript types · 白牌授權機制

先見明 Horizen — 技術視角

FastAPI · Supabase · Fly.io · GitHub Actions Cron

The infrastructure layer for ESG regulatory intelligence.
100
Tests Pass
0
Ruff Errors

📍 當前狀態（2026-04-18）

Phase 1 核心完成：Claude Haiku 摘要（summarizer.py）+ Webhook HMAC-SHA256（webhook_dispatcher.py）+ Migration 004（碳盤查 5 張表）+ Consumer webhook_secret + NormalizeResult.event_ids + jobs.py 串接。100 tests passed，0 ruff errors。

🏗 技術棧

🐍 Python 3.11 / FastAPI 🐘 Supabase PostgreSQL 16 ⚡ Upstash Redis ✈️ Fly.io (nrt) ⚙️ GitHub Actions Cron 🔐 Bearer Token Auth ☁️ Cloudflare R2 / Pages 🤖 Claude Haiku 🧪 Alembic Migration 📦 Poetry

🔗 連結

  • GitHub EZoneLai/horizen
  • API 文件 api.horizen.tw/docs（上線後）
  • 部署平台 Fly.io · Tokyo (nrt)
  • DB Supabase Pro
  • 快取 Upstash Redis
  • UI/UX 設計稿預覽

📡 API 路由清單

GET /v1/health
GET / POST /v1/sources — 法規來源
POST /v1/sources/{code}/trigger — Actions 觸發爬取
GET / POST /v1/items — 法規條目
GET / POST /v1/events — 法規異動事件
GET / POST /v1/consumers — Consumer + Bearer Token
GET /v1/coefficients — ESG 排放係數
Phase 1 → /v1/emissions/* /v1/orgs/* /v1/audit/*

⚡ 本機開發

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
poetry run pytest            # 100 passed
poetry run ruff check src/   # 0 errors

🗺 開發路線圖

  • ✅ Phase 0 法規來源 CRUD + 爬取架構 + Consumer Auth + 部署
  • 進行中 Phase 1 Claude Haiku 摘要 · Webhook dispatch · 碳盤查 DB
  • ⬜ Phase 2 ESG S/G 面 · GRI 報告生成 · 查證師入口 · SHA-256
  • ⬜ Phase 3 Next.js 前端 SaaS · Cloudflare Pages · 同業 benchmark
  • ⬜ Phase 4 @horizen/core SDK npm 套件

🎨 品牌規範

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

Regulatory Ink #0B1E3D
Bronze Signal #B87333
Compliance Cream #F5F2EA
Verified Jade #2E7B5F

🔒 客戶機密

兩位客戶彼此保密，文件分存於獨立目錄。本頁僅限內部使用。
A
A 客戶 — ESG 中台整合
3.25 人月 · NT$500k–650k · API-as-a-Service
里程碑
📋 M0 需求確認中 M1 Webhook 上線 M2 全爬蟲 M3 驗收
功能進度
  • ✅ 排放係數 API（/v1/coefficients）
  • ⏳ 需求確認單（待客戶回覆）
  • 待建 Webhook 推送對接
  • 待建 法規爬蟲全範圍（13 來源）
  • 待建 GRI / TCFD 報告（可選）
B
B 客戶 — ESG 全面盤查平台
原 5.5 人月 → ~8.9 人月（+3.4 新模組）· NT$1.6M–2.2M · 含架構授權
⚠️ 範圍更新：新版 UI 參考（ronsunai_ultimate.html）揭露 7 個新模組，需在確認單中確認是否納入合約。建議「Phase 2 延伸」分期交付。
里程碑
📋 M0 需求確認中 M1 E 面 S1–S3 M2 S/G + 供應商 M3 GRI + EcoVadis M4 架構文件
原始範圍（5.5 人月）
  • ⏳ 需求確認單（待客戶回覆）
  • 待建 S1–S6 碳盤查 + OCR
  • 待建 S 面社會指標 + G 面治理指標
  • 待建 GRI 全文報告生成（AI 草稿）
  • 待建 查證師入口 + SHA-256
  • 待建 系統架構文件授權
新增模組（+3.4 人月，待確認）
  • 新 供應商 ESG 評估 + EcoVadis 牌級比對（0.8 人月）
  • 新 EcoVadis 21 項指標自動對應台灣法規（0.6 人月）
  • 新 雙重重大性鑑別 IFRS S1/GRI（0.5 人月）
  • 新 跨部門協作任務看板（0.4 人月）
  • 新 改善計畫追蹤 + 顧問唯讀分享連結（0.3 人月）
  • 新 員工聲音匿名調查 GRI 403/102（0.5 人月）
  • 新 合規指數儀表板（五維 0–100）（0.3 人月）

功能模組整合矩陣

Horizen 平台 vs 客戶需求對應

模組 A 客戶 B 客戶 Horizen SaaS Phase
法規爬蟲 + AI 摘要✅ 核心🔶✅0 done
排放係數 API✅ 核心✅✅0 done
Webhook 推送 + HMAC✅ 核心—✅1 done
碳盤查 Scope 1/2/3🔶✅ 核心✅1 進行中
OCR 電費解析—✅ 核心✅1 進行中
DQI 健檢引擎—✅ 核心✅1 進行中
S 面社會指標—✅ 核心✅2
G 面治理指標—✅ 核心✅2
GRI 全文報告生成（AI 草稿）🔶✅ 核心✅2
查證師入口 + SHA-256—✅ 核心✅2
🆕 供應商 ESG 評估—🆕 待確認✅ 未來2+
🆕 EcoVadis 21 項對應—🆕 待確認✅ 未來2+
🆕 雙重重大性鑑別 IFRS S1/GRI—🆕 待確認✅ 未來2+
🆕 跨部門協作任務看板—🆕 待確認✅ 未來2+
🆕 改善計畫追蹤 + 顧問分享連結—🆕 待確認✅ 未來2+
🆕 員工聲音匿名調查—🆕 待確認✅ 未來2+
🆕 合規指數儀表板（五維 0–100）—🆕 待確認✅ 未來2+
Next.js 前端FE-AFE-BFE-C3
✅ 已確認核心 · 🔶 可選/輕量 · 🆕 B客戶新版UI新增（待合約確認）· — 不含 · 背景紫色 = 新增待確認範圍