01 · Business
兩邊都要吸引
客戶免費刊登同搵人；freelancer 免費建立 profile、接受邀請，付費先可主動揭示客戶 contact。平衡供需與信任。
01 / C4 Container Map
全局：邊個做乜、資料去邊度？
由左至右：三種人 → Astro 頁面 → Cloudflare API／業務邏輯 → Supabase 資料 → Stripe/Resend/CMS 等服務。底部係 GitHub、部署同監控。可以按圖中方框，跳去對應元件解釋。
本機有實作部分實作Pilot待接通/規劃尚未實作 Source/local boundary Future/unverified join
線代表架構依賴，唔係所有功能已真實連線。Public/private controls 必須經 server + DB 校驗。完整內容可打開其他分頁。
展開完整 39 個 Technical Components 樹狀 Mind Map
按每個組件會跳到詳細原碼／進度卡片。呢張圖係 taxonomy（分類關係），唔係執行流程。
02 · Architecture
唔係 39 套軟件
Astro 處理頁面/部分 API，Cloudflare 運行，Supabase 管身分與資料，Stripe/Resend 負責外部交易/寄信。其餘多數係同一 repo 內的 modules。
03 · Reality
有 code ≠ 已上線
大部分最複雜流程仍然 default-off。本機測試可以幫你證明邏輯方向，但未證明真實 provider、hosted permissions、付款及正式 release。
由三條 Business Loop 理解整個平台
免費提交 Brief → Contact reachability → 人手審核 → 已公開 Jobs → Paid Freelancer 揭示 contact → 自行接洽。
首頁分類 → Freelancer Profile → 免費邀請 → Freelancer 免費回 Proposal → Client 選人。
免費 Profile → 審核公開 → 瀏覽 Jobs → Saver/Serious Trial 或 Paid → 安全 Reveal → 自行 Pitch。
最核心嘅分界：CMS 只管文章；Account Portal 只管用戶自己嘅 records；Craftance Admin 只管業務審核；Stripe 只證明付款；最終有冇權揭示 contact，必須由server + database 原子判斷。
02 / Component Inventory
所有 Tech Stack Components
39 個有用途同 source file 嘅技術模組。搜尋名稱、責任、說明，按卡片可展開「角色／目前缺口／相關原碼／曾比較 alternativas」。
03 / Business User Journey Map
23 條 Canonical Flows ＋ 3 條平台配套
每條路徑分成「人做乜 → 網站做乜 → 後台/Database 做乜 → 下一個結果」。左邊選流程，右邊睇操作、涉及服務、嚴格限制、尚欠嘅功能。
04 / Sequence Diagrams
按掣之後：幾個系統點互相講嘢？
呢個先係 sequence diagram 嘅用途：一個 event 如何穿過 Browser、Worker、Postgres、Stripe/Resend，再返回結果。實線只代表原碼／本機流程；虛線係尚未完成或未取得真實 service proof。
05 / Data Model & Trust Boundary
資料放邊、邊個可以睇？
概念級別嘅 Data Domain Map，唔係精確 SQL ERD。幫你知道邊種資料屬公開、帳戶私有或系統內部；跨越私人資料界線必須經明確授權。
虛線紅色嘅 Reveal Ledger 係核心未完成部分；article 文件喺 Git，唔係用戶資料庫。
六個唔可以破壞嘅保護規則
01 · Login ≠ Permission
登入成功唔代表可管理別人 Job、可試用、可進 Admin 或可揭示聯絡資料。
02 · Public ≠ Private
Job/Profile 公開 reader 只提供允許嘅資訊；contact 留喺 private DB。
03 · Paid ≠ Stripe Redirect
付款跳轉成功頁只係頁面狀態；必須有 provider verified event + settlement + DB entitlement。
04 · Unique Reveal Atomicity
最後一個名額、試用第三次、replay、改版，都要同一 DB transaction 正確鎖定。
05 · Approval ≠ Publication
Admin 按 Approve 只係授權發佈；要驗證真正 served HTML / DB public reader。
06 · Email Accepted ≠ Delivered
Resend 接收 API request、寄件成功、對方收取／開啟係唔同事件；不能亂聲稱。
Lead Quality / Trust / Fair Use 係獨立業務功能
Verified Contact
只代表有真人能夠回應、已證明該 Job 現行 offered email／channel 可達；唔等於公司身份認證。Email-first 目前有 local 流程，WhatsApp/電話待接。
Business Verified
原本構想利用公司電郵域名、網站或 LinkedIn 等訊號核實背景，唔排除個人客戶；公開 badge 嘅 evidence rule／launch scope 仍需 D6 釐清。
Budget-Match Feedback
付費會員可以報告 posted budget 同真實 offer 是否相符（可選證據）；被驗證 feedback 應經審核與統計門檻，唔可以由 AI 自動頒發 badge。O4 尚未建成。
Fair-use / Anti-scraping
首 7 日新會員較嚴格 reveal 使用節制、正常會員高容量、異常快速 reveal／bounce／complaint 觸發審查。應作安全規則，不作 hidden paid-plan quota；實際限額待實作/驗證。
Shared Reveal Cap
BUSINESS.md 保留單個 job 最高 5 位 freelancer 可揭示嘅 launch 值；避免客戶被無限制騷擾。需要公開合理告知、原子競爭測試，現時未 live。
Quality & Integrity
每份 Job 需要 scope、deliverables、budget、timeline、location、reachable contact；防免費試做／做完先畀錢／不清楚交付。Operator 審核，而唔係每份表單自動上架。
會員權限矩陣
| 功能 | 一般訪客／Free Freelancer | Saver/Serious Trial | Active Paid | Client |
|---|---|---|---|---|
| 瀏覽合資格 Job scope、budget | 可以（公開讀取待啟用） | 可以 | 可以 | 可以 |
| 建立 Freelancer Profile / 免費收邀請 | 帳戶 + 審核後 | 可以 | 可以 | 不適用 |
| Client 免費 Post Job／邀請 | 不適用 | 不適用 | 不適用 | 可以 |
| Reveal protected client contact | 不可以 | 14 日最多 3 個 unique jobs | 可以，受相同安全限制 | 不適用 |
| 其他付費 plan 差別 | 不適用 | 只限 Saver/Serious 試用 | 4 plans 權限相同，只差價錢/期限 | 免費 |
訂閱條款（已確立；技術實現未完成）
| Plan | 一次過完整費用 | 服務期限 | Trial |
|---|---|---|---|
| Flex | HK$998 | 1 month | No |
| Saver | HK$1,988 | 3 months | 14 days · card required |
| Serious | HK$2,988 | 6 months | 14 days · card required |
| Pro | HK$4,488 | 12 months | No |
所有付費方案有相同產品權限；冇 per-lead credits／top-up／commission。續期、cancel/pause、錯誤扣款等部分實際 policy 邊界仍待 D2 決定，不能假設建議已批准。
06 / Product & Delivery Readiness
而家做到邊，仲差乜？
以下 35 項 task 由 2026-10-23 repo 內唯一 project map 轉錄。狀態係 work-package 尺度，唔代表全產品完成百分比。
6 個仍未獲批准嘅 Founder 決策
呢啲係產品規則真正卡住工程落地嘅地方。任何 proposal 仍然只係 proposal。
實際 Development Order（建議）
1. Stabilise a single accepted UI
保留一個真實 landing，修 hero mobile overlap / 26 asserts / theme transition；將已驗收嘅 buttons/cards/forms 抽成共用 design system。
2. Connect one hosted Client journey
喺受控測試環境完成 Auth → email verification → job review → served public readback；真實測試身份、權限、退回、retries。
3. Complete free two-sided participation
統一 /join onboarding；freelancer profile → 審核公開；Client free invite → freelancer proposal → client response，先用真資料做 End-to-End。
4. Unlock paid core safely
D1–D4 產品政策決定後，做 Stripe sandbox → canonical entitlement → atomic contact reveal → membership/cancel/reminders。
5. Content & operator practicality
Founder 真正試 CMS，發首篇已核准雙語文章；完成營運 support、budget reports、media、analytics 同 email 收件可靠度。
6. Go / No-Go production gate
測試 23 條主要 flow 涵蓋範圍、真實 providers、data restore、CI、手動 a11y/device、legal/privacy、Founder acceptance；最後先部署。
最近已知問題：WIP 已有 46 migrations；但 `project.json` 內部分較舊文字仍稱 44。完整 frontend 曾於 landing-refinement 出現 26 項 assertions fail，另有 theme transition contrast 問題。請以 exact commit 嘅 source/test 及實際畫面做驗收。
07 / Source of Truth
來源、閱讀順序、基本詞彙
每個層次嘅事實有唔同權威：Business / Pricing policy 決定應該做乜，repo source 顯示 code 有乜，tests 證明有限行為，hosted/provider 收據先證明外部世界發生咗乜。
你最應該分清嘅 7 個 Tech Terms
Frontend
用戶睇到／按到嘅頁面；Astro 係其主系統。
Backend / API
按掣後處理真實資料、業務規則、權限；Astro server route + Cloudflare Worker。
Database
記錄用戶、job、profile、會員及事件；PostgreSQL。RLS/RPC 負責再確認存取權限。
Authentication vs Authorization
Authentication = 你係邊個；Authorization = 你有權做乜。登入同付費唔係同一回事。
CMS vs Admin vs Portal
CMS 管文章；Admin 由 Craftance 管審核/支援；Portal 畀用戶管理自己嘅資料。
Worker / Cron / Outbox
Worker 執行後台工作；Cron 按時間叫醒；Outbox 記錄未完成通知，支持可追蹤重試。
Deployment
將指定版本放上真正 hosting，並證明公開用戶見到 exact version；`npm run build` 唔等於部署。
End-to-End Acceptance
由真實 user 點入網頁→真實服務→資料庫→預期畫面/收件，含失敗/安全/還原情境。
Scope／證據限制：截至 repo commit
689664ec34db（2026-10-23 HKT）。Local artifact 只讀地轉換既有 docs 同 source；冇重新測試 managed Supabase、Stripe、Resend、Cloudflare 真實設定；冇修改任何 GitHub／外部服務。圖入面 future arrows 係必需功能或 proposal，唔係已上線連接。