Project navigation console

tachigo / tachiya project map

給新同事與日常開發者使用的專案導覽入口。先建立系統 mental model，再追 domain、flow、source、tests 與跨 repo 邊界。

source of truthreviewed 2026-05-13base developP0 onboarding

Start hereDomain mapsSource index

runtime pathviewer action to commerce boundary

entryTwitchViewer identity, channel context, extension session

frontendExtension + DashboardSidepanel UX, streamer operations, agency workflows

coretachigo APIGo boundary for auth, watch, points, spend, claims

stateLedger + PostgreSQLUsers, balances, sessions, redemptions, receipts

commercetachiyaFastAPI integration and Saleor protection layer

edgesSaleor + ChainCheckout, orders, discount application, future claims

01 / first hour

Onboarding path

先看系統地圖、開發環境、第一個 PR 的安全路徑。02 / domains

Domain maps

Points、Auth、Extension 的 source、routes、tests 與風險。03 / cross repo

Flow traces

watch-to-points、spend-to-tachiya、claim flow 的邊界。04 / daily work

Daily dev

改功能前先定位 owner、測試、PR scope 與 rollback path。05 / radar

Graph explorer

把 graphify 當成影響範圍雷達，而不是架構真相本身。

watchExtension heartbeatAPI sessionpoints ledger

spendbalance checktachiya handoffSaleor order

reviewdomain mapsource indextargeted tests

新同事

從 Start Here 進入，先跑完 first-hour route。

日常開發

從 Daily Dev Guide 找改動入口，再回 domain map。

架構 review

從 Cross-Repo Flows 判斷是否碰到 repo、權限或 ledger 邊界。

Markdown 仍是 source of truth。既有 docs taxonomy、文件狀態說明與 source links 已搬到 Source Index；首頁只負責導覽決策。