# StockPlatform v2 Dev Baseline Owner Decision

- generated_at: `2026-06-24T14:02:36+08:00`
- product_id: `stockplatform-v2`
- local_path: `/Users/ogt/stockplatform-v2`
- status: `high risk, generated output split required`

## Readback

| Gate | Result |
|------|--------|
| local branch | `main` |
| local head | `1ef097e148ff6645e608fe5823aff9f038314512` |
| Gitea main | `1ef097e148ff6645e608fe5823aff9f038314512` |
| Gitea dev | missing |
| tracked modified | `60` |
| tracked deleted | `0` |
| untracked | `3800` |
| diff shortstat | `60 files changed, 8355 insertions(+), 3173 deletions(-)` |
| diff check | failed: trailing whitespace in two frontend files |

## Untracked 分桶

| Bucket | Count | 判定 |
|--------|------:|------|
| `tmp` generated outputs | `3742` | 預設排除，不可直接進 source control |
| source candidates | `58` | 需 owner include / exclude |
| apps | `31` | 需審 |
| docs | `8` | 需審 |
| scripts | `19` | 需審 |

最大 generated buckets：

- `tmp/admin-mobile-layout-audit`: `1985`
- `tmp/mobile-layout-audit`: `1687`
- `tmp/mobile-layout-smoke`: `23`
- `tmp/desktop-layout-smoke`: `23`
- `tmp/public-layout-audit`: `17`

## Tracked Modified Groups

- Admin app：dashboard、data gate / source / evidence / intelligence / notifications / reviews / diagnostics / tasks / trading / watchlist panels。
- API routes / services：backtest、copilot、ETF、intelligence、MCP、RAG、recommendations、stocks、subscriptions、system、trading、watchlists、notification charts / delivery。
- Web app：manifest、AI Copilot、analytics provider、risk asset panel、decision terminal、impact terminal、market trend、recommendation dashboard、share report、stock research、charts、timeline、market snapshot。
- Docs / runtime：crawler / ingestion plan、product IA、production compose、Nginx admin-auth edge conf。
- Ingestion / ops：official market sync、intelligence feed ingestion、deployment scripts、cron health monitor、market / margin ingestion、route and notification smoke scripts。

## Untracked Source Candidates

- Admin app：agents、audit、data sources、evidence、intelligence、notifications、publishing、reviews、source diagnostics、tasks、trading、watchlist pages。
- API / migrations：agents route、data source SLA、official source registry、notification report / snapshot / lifecycle / audit trail migrations。
- Web app：design assets、Phase6 shell、intelligence / recommendations / stocks / transparency / watchlist pages。
- Docs：Gemini output intake、UI design governance、legacy StockPlatform deprecation、production entrypoints、data governance risk register、historical data UX / navigation、modularization todo、production governance checklist。
- Ingestion / ops：source registry、legacy entrypoint guard、data freshness monitors、market index / EOD / YTD / price ingestion、source remediation task、content governance smoke、layout smoke、route guard、release checklist artifact、visual regression smoke。

Env-like paths observed but not read:

- `.env.example`
- `.env.production.local`

## 判定

StockPlatform v2 不能直接建立遠端 `dev`。雖然 local HEAD 與 Gitea main 完全一致，這是好事；但目前 worktree 同時包含：

1. `60` 個 tracked product changes。
2. `58` 個 untracked source candidates。
3. `3742` 個 `tmp/` 生成物，包括 Chrome / CDP profile、cache、layout audit 與 smoke 產物。
4. Nginx、Docker compose、market ingestion、official source registry、data freshness monitors、API migrations 與 public / admin UI change。

直接推 remote `dev` 會把生成物和未審核 production / ingestion 變更混進雙機開發基準。

## Owner Decision

需要 owner 回覆：

1. 是否同意 `tmp/**` generated outputs 預設排除。
2. 58 個 source candidates 哪些要納入。
3. 60 個 tracked modified files 哪些要納入。
4. `.env.example` 與 `.env.production.local` 僅能 metadata-only review，不讀 / 不收 secret value。
5. 是否先修 `AiCopilot.tsx` 與 `OpportunityMatrix.tsx` trailing whitespace，再進 review branch。
6. production Nginx、Docker compose、ingestion cron、official source registry、market freshness monitors 是否屬於同一個 dev baseline scope。
7. owner 接受 source-only include / exclude 後，才可建立 review branch 或 remote `dev`。

## 安全邊界

- 未讀 `.env` 類內容。
- 未讀 secret value。
- 未修改 StockPlatform repo。
- 未建立 branch、commit 或 push。
- 未同步 `tmp/**` generated outputs。
- 未執行 ingestion、smoke、browser audit、production write 或 runtime write。
