diff --git a/README.md b/README.md index 0f3dcf3..001bab3 100644 --- a/README.md +++ b/README.md @@ -34,17 +34,62 @@ npm start --- +## Emmy 投資台：四大模組 + +頂部分頁可切換四個視圖（用 hash 路由：`#/`、`#/learn`、`#/stock`、`#/journal`）： + +- **總經**：原本的 FRED 總經儀表板。 +- **學習教材**：把 `emmy/` 知識庫（學習分類、案例、110 條投資心法、538 個名詞、218 家公司、單集筆記）整理成可瀏覽、可站內跳轉、可搜尋的教材，含互動式練習題庫。 +- **個股工具**：輸入一個股票代號，四個子分頁共用： + - **價格走勢**：收盤線圖，可切 3 月／1 年／5 年／全部等區間。 + - **財報健檢**：自動抓真實財報（SEC EDGAR 為主、Yahoo 為輔），照「財報基本功」五步驟給紅綠燈，每條檢查連回名詞／心法。 + - **投資地圖**：把「投資底層邏輯」六層漏斗（總經→產業→商業模式→管理層→估值→交易紀律）做成互動判斷流程：逐層用「是／不確定／否」作答，閘門題答否該層即「出局」，每題連到對應心法，底部彙整總結論並可一鍵「存成交易紀錄」。 + - **回測**：機械式策略回測（買進持有／定期定額／均線趨勢／逢大跌進場），畫策略 vs 買進持有兩條權益曲線並列出總報酬、年化、最大回撤、在場比例、勝率等統計。 +- **交易復盤**：手動記錄進出與理由，自動算已實現損益、勝率、賺賠比，並依「交易/投資」「是否犯錯」「依據心法」分組復盤。資料存在本機 `data.db`。 + +> 個股工具與財報健檢、回測皆會把抓到的資料存進 `data.db` 快取：歷史股價日線預設 6 小時內沿用、財報季報依「軟/硬 TTL + SEC 申報探針」判斷是否需重抓，盡量節省外部 API。所有工具僅供學習，**不構成投資建議**。價格／回測資料來源以 Yahoo 為主，被限流（429）時自動改用 Nasdaq 免金鑰歷史（美股最完整）。 + +### 建立知識庫（學習教材的前置步驟） + +學習教材與財報健檢的連結，來自 `emmy/` 的內容快照。`emmy/` 在 `web/` 之外，所以用建置腳本產生 `data/knowledge.json` 與 `data/notes.json`： + +```bash +npm run build:knowledge +``` + +> `emmy/` 內容有更新時，重跑這個指令即可。若沒先執行，學習教材分頁會提示你建立。 + +--- + ## 專案結構 ``` -index.html 前端（純 HTML/CSS/JS，向 /api/macro 取資料後渲染） -server.js Express 伺服器：提供網頁 + /api/macro（代理 FRED、1 小時快取） -lib/indicators.js 指標字典：序列代碼、中文名、分組、是否反向、解釋文字 -lib/fred.js 抓取 FRED / Yahoo、做 YoY/MoM 換算、產生真實 sparkline -lib/score.js 用透明公式算出健康分數、景氣燈號與 5 個訊號 +index.html 前端骨架 + 總經視圖（向 /api/macro 取資料後渲染） +app.js 學習/個股工具/交易復盤視圖 + 主視圖路由 + Markdown 渲染 + 共用折線圖 +app.css 新視圖的樣式（沿用總經的深色主題變數） +server.js Express 伺服器：網頁 + 各 /api 路由（代理外部資料、快取） +lib/indicators.js 指標字典：序列代碼、中文名、分組、是否反向、解釋文字 +lib/fred.js 抓取 FRED / Yahoo、做 YoY/MoM 換算、產生真實 sparkline +lib/score.js 用透明公式算出健康分數、景氣燈號與 5 個訊號 +lib/db.js SQLite 存取：快取、序列、分數歷史、交易復盤 trades 表 +lib/knowledge.js 載入 data/knowledge.json / notes.json（學習教材） +lib/fundamentals.js 抓財報（SEC EDGAR 主、Yahoo quoteSummary 輔），正規化 +lib/fincheck.js 財報基本功五步驟規則引擎，輸出紅綠燈 + 連回名詞/心法 +lib/marketdata.js 抓歷史股價（Yahoo v8 主、Nasdaq 免金鑰輔），給價格走勢與回測共用 +lib/backtest.js 機械式策略回測純函式：buyhold/dca/sma/dip + 績效統計 +lib/investmap.js 投資地圖六層漏斗設定（每層提問清單 + 原則編號，由 server 補上標題/連結） +scripts/build-knowledge.mjs 把 ../emmy 快照成 data/*.json +data/ build:knowledge 產生的知識庫快照（已 gitignore 友善） ``` -資料流：`瀏覽器 → /api/macro → (持金鑰) FRED → 換算/計分 → 回傳 JSON → 渲染` +資料流： +- 總經：`瀏覽器 → /api/macro → (持金鑰) FRED → 換算/計分 → JSON → 渲染` +- 學習：`build:knowledge 讀 emmy/ → data/*.json → /api/knowledge、/api/note → 渲染` +- 財報：`/api/fundamentals/:symbol → EDGAR/Yahoo → fincheck 規則 → 紅綠燈 JSON` +- 價格：`/api/price/:symbol → Yahoo/Nasdaq（DB 快取）→ 收盤線圖` +- 回測：`/api/backtest/:symbol → 用快取歷史跑 backtest → 權益曲線 + 統計` +- 地圖：`/api/investmap → investmap 設定 + 知識庫原則 → 前端互動六層漏斗 → 可存成交易` +- 復盤：`/api/trades(.../stats) → SQLite trades 表 → 自動算損益與統計` --- diff --git a/app.css b/app.css new file mode 100644 index 0000000..ba94cf3 --- /dev/null +++ b/app.css @@ -0,0 +1,319 @@ +/* ═══════════════════════════════════════════════════════════ + Emmy 投資台 — 學習教材 / 財報健檢 / 交易復盤 的樣式 + 沿用 index.html 既有的 CSS 變數（--bg/--surface/--card…） + ═══════════════════════════════════════════════════════════ */ + +/* ── 主視圖切換 tabs ── */ +.view-tabs{display:flex;gap:4px;flex-wrap:wrap} +.view-tabs a{ + padding:7px 16px;border-radius:8px;font-size:.9rem;font-weight:600;color:var(--text2);cursor:pointer; + transition:background .15s,color .15s; +} +.view-tabs a:hover{color:var(--text);background:rgba(77,166,255,.08)} +.view-tabs a.active{background:rgba(77,166,255,.16);color:var(--blue)} + +.view[hidden]{display:none} + +/* 非總經視圖時，隱藏總經的群組子導覽 */ +body[data-view="macro"] #navLinks{display:flex} +body:not([data-view="macro"]) #navLinks{display:none} + +/* ── 共用：頁面區塊標題 ── */ +.page{margin:24px 32px 0;animation:fadeInUp .4s ease both} +.page-head{margin-bottom:18px} +.page-title{font-size:1.35rem;font-weight:700;letter-spacing:-.01em;display:flex;align-items:center;gap:10px} +.page-sub{font-size:.85rem;color:var(--text2);margin-top:6px;line-height:1.6;max-width:880px} +.disclaimer{font-size:.72rem;color:var(--text2);background:rgba(255,138,77,.08);border:1px solid rgba(255,138,77,.2); + border-radius:8px;padding:8px 14px;margin-top:14px;line-height:1.6} + +@media(max-width:900px){ .page{margin:18px 16px 0} } + +/* ═══════════ 學習教材 ═══════════ */ +.learn-layout{display:grid;grid-template-columns:230px 1fr;gap:22px;align-items:start} +.learn-side{position:sticky;top:78px;display:flex;flex-direction:column;gap:4px} +.learn-side .side-group{font-size:.7rem;color:var(--text2);letter-spacing:.06em;margin:12px 4px 4px;text-transform:uppercase} +.learn-side a{ + padding:7px 12px;border-radius:7px;font-size:.85rem;color:var(--text);cursor:pointer;transition:.15s; + display:flex;justify-content:space-between;align-items:center;gap:8px; +} +.learn-side a:hover{background:rgba(77,166,255,.08)} +.learn-side a.active{background:rgba(77,166,255,.15);color:var(--blue)} +.learn-side a .count{font-size:.68rem;color:var(--text2)} +.learn-content{min-width:0} + +@media(max-width:780px){ + .learn-layout{grid-template-columns:1fr} + .learn-side{position:static;flex-direction:row;flex-wrap:wrap;gap:6px;margin-bottom:14px} + .learn-side .side-group{width:100%;margin:6px 0 0} +} + +/* 三階段課綱卡片 */ +.stage{margin-bottom:24px} +.stage-title{font-size:1.05rem;font-weight:700;margin-bottom:4px;display:flex;align-items:center;gap:8px} +.stage-badge{font-size:.66rem;font-weight:700;padding:2px 9px;border-radius:20px} +.stage-desc{font-size:.82rem;color:var(--text2);margin-bottom:12px;line-height:1.6} +.module-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(240px,1fr));gap:12px} +.module-card{ + background:var(--card);border:1px solid var(--border);border-radius:var(--radius);padding:16px 18px;cursor:pointer; + transition:border-color .2s,box-shadow .2s;display:flex;flex-direction:column;gap:8px; +} +.module-card:hover{border-color:rgba(77,166,255,.35);box-shadow:0 0 18px rgba(77,166,255,.06)} +.module-card .mod-name{font-size:.98rem;font-weight:700} +.module-card .mod-meta{font-size:.74rem;color:var(--text2);line-height:1.55} +.module-card .mod-tags{display:flex;flex-wrap:wrap;gap:5px;margin-top:2px} +.chip{font-size:.68rem;color:var(--text2);background:var(--surface);border:1px solid var(--border); + border-radius:20px;padding:2px 9px;cursor:pointer;transition:.15s;white-space:nowrap} +.chip:hover{border-color:var(--blue);color:var(--blue)} + +/* 速查（名詞 / 公司 / 單集）搜尋 */ +.search-box{display:flex;gap:8px;margin-bottom:14px} +.search-box input{ + flex:1;background:var(--surface);border:1px solid var(--border);border-radius:8px;color:var(--text); + padding:10px 14px;font-size:.9rem;outline:none;transition:.15s;font-family:inherit; +} +.search-box input:focus{border-color:var(--blue)} +.glossary-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(150px,1fr));gap:8px} +.gloss-item{ + background:var(--card);border:1px solid var(--border);border-radius:8px;padding:9px 12px;cursor:pointer;transition:.15s; +} +.gloss-item:hover{border-color:var(--blue);background:rgba(77,166,255,.06)} +.gloss-item .gi-title{font-size:.85rem;font-weight:600;color:var(--text)} +.gloss-item .gi-sub{font-size:.7rem;color:var(--text2);margin-top:2px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap} +.list-meta{font-size:.76rem;color:var(--text2);margin-bottom:10px} + +/* Markdown 內文渲染 */ +.md{font-size:.9rem;line-height:1.75;color:var(--text)} +.md h1{font-size:1.5rem;font-weight:700;margin:.2em 0 .5em} +.md h2{font-size:1.18rem;font-weight:700;margin:1.3em 0 .5em;padding-bottom:.3em;border-bottom:1px solid var(--border)} +.md h3{font-size:1.02rem;font-weight:700;margin:1.1em 0 .4em;color:var(--text)} +.md h4{font-size:.92rem;font-weight:700;margin:1em 0 .3em;color:var(--text2)} +.md p{margin:.6em 0} +.md ul,.md ol{margin:.5em 0 .5em 1.3em} +.md li{margin:.25em 0} +.md blockquote{border-left:3px solid var(--blue);background:var(--surface);margin:.8em 0;padding:.6em 1em; + color:var(--text2);border-radius:0 8px 8px 0} +.md blockquote p{margin:.2em 0} +.md code{background:var(--surface);padding:2px 6px;border-radius:4px;color:var(--yellow);font-size:.86em; + font-family:ui-monospace,SFMono-Regular,Menlo,monospace} +.md pre{background:var(--surface);border:1px solid var(--border);border-radius:8px;padding:12px 14px;overflow:auto;margin:.8em 0} +.md pre code{background:none;padding:0;color:var(--text2)} +.md hr{border:none;border-top:1px solid var(--border);margin:1.2em 0} +.md table{border-collapse:collapse;width:100%;margin:.9em 0;font-size:.84rem;display:block;overflow-x:auto} +.md th,.md td{border:1px solid var(--border);padding:7px 11px;text-align:left;vertical-align:top} +.md th{background:var(--surface);font-weight:600;color:var(--text);white-space:nowrap} +.md td{color:var(--text2)} +.md a{color:var(--blue)} +.md .wlink{color:var(--purple);border-bottom:1px dashed rgba(179,136,255,.4);cursor:pointer} +.md .wlink:hover{border-bottom-style:solid} +.md .wlink.dead{color:var(--text2);border-bottom-color:transparent;cursor:default} + +.back-link{display:inline-flex;align-items:center;gap:6px;font-size:.82rem;color:var(--text2);cursor:pointer;margin-bottom:14px} +.back-link:hover{color:var(--blue)} +.note-frontmatter{display:flex;flex-wrap:wrap;gap:6px;margin-bottom:14px} +.fm-tag{font-size:.7rem;color:var(--text2);background:var(--surface);border:1px solid var(--border);border-radius:20px;padding:2px 10px} + +/* 練習題庫 */ +.quiz-q{background:var(--card);border:1px solid var(--border);border-radius:10px;padding:14px 16px;margin-bottom:10px} +.quiz-q .q-text{font-size:.9rem;line-height:1.6} +.quiz-q .q-src{font-size:.72rem;color:var(--text2);margin-top:8px;cursor:pointer} +.quiz-q .q-src:hover{color:var(--blue)} + +/* ═══════════ 財報健檢 ═══════════ */ +.finbox-search{display:flex;gap:8px;margin-bottom:6px;max-width:520px} +.finbox-search input{ + flex:1;background:var(--surface);border:1px solid var(--border);border-radius:8px;color:var(--text); + padding:11px 15px;font-size:1rem;outline:none;font-family:inherit;letter-spacing:.04em;text-transform:uppercase; +} +.finbox-search input:focus{border-color:var(--blue)} +.finbox-search button{ + background:var(--blue);color:#08111d;border:none;padding:0 22px;border-radius:8px;font-weight:700;font-size:.92rem;cursor:pointer; +} +.finbox-search button:disabled{opacity:.5;cursor:wait} +.finbox-examples{font-size:.76rem;color:var(--text2);margin-bottom:18px} +.finbox-examples b{cursor:pointer;color:var(--blue);font-weight:600;margin:0 4px} + +.fin-summary{background:var(--card);border:1px solid var(--border);border-radius:12px;padding:20px 24px;margin-bottom:18px; + display:grid;grid-template-columns:auto 1fr;gap:24px;align-items:center} +.fin-verdict{text-align:center} +.fin-verdict .v-big{font-size:2.4rem;font-weight:800;line-height:1} +.fin-verdict .v-sub{font-size:.78rem;color:var(--text2);margin-top:4px} +.fin-lights{display:flex;gap:18px} +.fin-light{text-align:center} +.fin-light .fl-num{font-size:1.6rem;font-weight:700;line-height:1} +.fin-light .fl-lab{font-size:.72rem;color:var(--text2);margin-top:3px} +.fin-co{font-size:.82rem;color:var(--text2);margin-bottom:8px} +.fin-co b{color:var(--text);font-size:1.05rem} +.fin-fresh{display:flex;justify-content:space-between;align-items:center;gap:12px;flex-wrap:wrap; + font-size:.74rem;color:var(--text2);margin-bottom:16px} + +.fin-step{margin-bottom:18px} +.fin-step-head{display:flex;align-items:center;gap:10px;margin-bottom:8px} +.fin-step-num{width:24px;height:24px;border-radius:7px;background:rgba(77,166,255,.15);color:var(--blue); + font-size:.78rem;font-weight:700;display:flex;align-items:center;justify-content:center} +.fin-step-title{font-size:1rem;font-weight:700} +.check-row{ + background:var(--card);border:1px solid var(--border);border-radius:9px;padding:11px 14px;margin-bottom:8px; + display:grid;grid-template-columns:8px 1fr auto;gap:12px;align-items:center;border-left:3px solid var(--border); +} +.check-row.good{border-left-color:var(--green)} +.check-row.warn{border-left-color:var(--yellow)} +.check-row.bad{border-left-color:var(--red)} +.check-row.na{border-left-color:var(--text2);opacity:.7} +.check-dot{width:9px;height:9px;border-radius:50%} +.check-row.good .check-dot{background:var(--green)} +.check-row.warn .check-dot{background:var(--yellow)} +.check-row.bad .check-dot{background:var(--red)} +.check-row.na .check-dot{background:var(--text2)} +.check-main .ck-label{font-size:.88rem;font-weight:600} +.check-main .ck-note{font-size:.78rem;color:var(--text2);line-height:1.55;margin-top:3px} +.check-main .ck-links{margin-top:5px;display:flex;flex-wrap:wrap;gap:6px} +.check-main .ck-links .wlink{font-size:.72rem} +.check-val{font-size:1.05rem;font-weight:700;text-align:right;white-space:nowrap} +.check-val.good{color:var(--green)}.check-val.warn{color:var(--yellow)}.check-val.bad{color:var(--red)}.check-val.na{color:var(--text2)} + +/* ═══════════ 交易復盤 ═══════════ */ +.stat-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(150px,1fr));gap:12px;margin-bottom:22px} +.stat-card{background:var(--card);border:1px solid var(--border);border-radius:var(--radius);padding:16px 18px} +.stat-card .st-lab{font-size:.74rem;color:var(--text2);margin-bottom:6px} +.stat-card .st-val{font-size:1.7rem;font-weight:700;line-height:1} +.stat-card .st-sub{font-size:.72rem;color:var(--text2);margin-top:4px} + +.btn{background:var(--blue);color:#08111d;border:none;padding:8px 16px;border-radius:7px;font-weight:600;font-size:.85rem;cursor:pointer;transition:.15s} +.btn:hover{filter:brightness(1.08)} +.btn.ghost{background:var(--surface);border:1px solid var(--border);color:var(--text2)} +.btn.ghost:hover{border-color:var(--blue);color:var(--blue)} +.btn.danger{background:var(--surface);border:1px solid var(--border);color:var(--red)} +.btn.danger:hover{border-color:var(--red)} +.btn.sm{padding:4px 10px;font-size:.76rem} + +.journal-bar{display:flex;justify-content:space-between;align-items:center;gap:12px;margin-bottom:14px;flex-wrap:wrap} +.seg{display:flex;gap:4px;background:var(--surface);border:1px solid var(--border);border-radius:8px;padding:3px} +.seg a{padding:6px 14px;border-radius:6px;font-size:.82rem;color:var(--text2);cursor:pointer;transition:.15s} +.seg a.active{background:var(--card);color:var(--text)} + +.trade-table{width:100%;border-collapse:collapse;font-size:.82rem} +.trade-table th{text-align:left;padding:9px 10px;color:var(--text2);font-weight:600;font-size:.74rem; + border-bottom:1px solid var(--border);white-space:nowrap} +.trade-table td{padding:10px;border-bottom:1px solid var(--border);vertical-align:middle} +.trade-table tr:hover td{background:rgba(77,166,255,.04)} +.t-sym{font-weight:700;color:var(--text)} +.t-sym .t-name{font-weight:400;color:var(--text2);font-size:.76rem;margin-left:5px} +.pill{font-size:.68rem;font-weight:600;padding:2px 8px;border-radius:20px;white-space:nowrap} +.pill.long{background:rgba(0,212,170,.12);color:var(--green)} +.pill.short{background:rgba(255,77,106,.12);color:var(--red)} +.pill.invest{background:rgba(77,166,255,.12);color:var(--blue)} +.pill.trade{background:rgba(179,136,255,.12);color:var(--purple)} +.pill.open{background:rgba(255,193,77,.12);color:var(--yellow)} +.pill.mistake{background:rgba(255,77,106,.14);color:var(--red)} +.pnl-pos{color:var(--green);font-weight:700} +.pnl-neg{color:var(--red);font-weight:700} +.t-actions{display:flex;gap:6px;justify-content:flex-end} +.empty-state{text-align:center;color:var(--text2);padding:50px 20px;font-size:.9rem} + +.group-stat{background:var(--card);border:1px solid var(--border);border-radius:10px;padding:14px 16px;margin-bottom:10px} +.group-stat h4{font-size:.86rem;margin-bottom:10px;color:var(--text)} +.gs-row{display:grid;grid-template-columns:1fr auto auto auto;gap:10px;font-size:.8rem;padding:5px 0;border-top:1px solid var(--border)} +.gs-row:first-of-type{border-top:none} +.gs-row .gs-name{color:var(--text)} +.gs-row .gs-cell{color:var(--text2);text-align:right;min-width:64px} + +/* Modal 表單（沿用 index.html 的 #modalOverlay 樣式，這裡補表單元素） */ +.form-grid{display:grid;grid-template-columns:1fr 1fr;gap:12px 14px;margin-top:6px} +.form-grid .full{grid-column:1/-1} +.field label{display:block;font-size:.74rem;color:var(--text2);margin-bottom:4px} +.field input,.field select,.field textarea{ + width:100%;background:var(--surface);border:1px solid var(--border);border-radius:7px;color:var(--text); + padding:8px 11px;font-size:.86rem;outline:none;font-family:inherit; +} +.field input:focus,.field select:focus,.field textarea:focus{border-color:var(--blue)} +.field textarea{resize:vertical;min-height:60px} +.form-actions{display:flex;justify-content:flex-end;gap:10px;margin-top:18px} +.check-inline{display:flex;align-items:center;gap:8px;font-size:.84rem;color:var(--text)} +.check-inline input{width:auto} +@media(max-width:600px){ .form-grid{grid-template-columns:1fr} } + +/* ═══════════ 個股工具（子分頁 / 圖表 / 投資地圖 / 回測）═══════════ */ +.sub-tabs{display:flex;gap:4px;background:var(--surface);border:1px solid var(--border);border-radius:9px;padding:3px;margin:4px 0 18px;flex-wrap:wrap;width:fit-content} +.sub-tabs a{padding:7px 16px;border-radius:7px;font-size:.85rem;font-weight:600;color:var(--text2);cursor:pointer;transition:.15s} +.sub-tabs a:hover{color:var(--text)} +.sub-tabs a.active{background:var(--card);color:var(--blue)} +.stk-pane[hidden]{display:none} + +/* 共用折線圖 */ +.chart-wrap{position:relative;width:100%;background:var(--surface);border:1px solid var(--border);border-radius:10px;padding:8px} +.chart-wrap svg{display:block;width:100%;height:auto} +.chart-empty{padding:40px 0;text-align:center;color:var(--text2);font-size:.85rem} +.chart-legend{display:flex;gap:16px;font-size:.78rem;color:var(--text2);margin-bottom:6px} +.chart-legend i{display:inline-block;width:11px;height:11px;border-radius:3px;margin-right:5px;vertical-align:middle} +.chart-hover{font-size:.78rem;color:var(--text2);margin-top:6px;min-height:1.2em} +.range-btns{display:flex;gap:5px;flex-wrap:wrap;margin-bottom:12px} +.range-btns button{background:var(--surface);border:1px solid var(--border);color:var(--text2);border-radius:7px; + padding:5px 13px;font-size:.8rem;cursor:pointer;font-family:inherit;transition:.15s} +.range-btns button:hover{border-color:var(--blue);color:var(--text)} +.range-btns button.active{background:rgba(77,166,255,.16);border-color:var(--blue);color:var(--blue);font-weight:600} + +/* 投資地圖 */ +.map-core{background:rgba(179,136,255,.08);border:1px solid rgba(179,136,255,.25);border-radius:10px; + padding:13px 16px;font-size:.85rem;font-weight:700;color:var(--purple);margin-bottom:14px;line-height:1.5} +.map-core span{display:block;font-weight:400;color:var(--text2);font-size:.8rem;margin-top:5px;line-height:1.6} +.map-verdict{background:var(--card);border:1px solid var(--border);border-radius:11px;padding:15px 18px;margin-bottom:16px; + border-left:4px solid var(--text2)} +.map-verdict.good{border-left-color:var(--green)} +.map-verdict.warn{border-left-color:var(--yellow)} +.map-verdict.bad{border-left-color:var(--red)} +.map-verdict .mv-lab{font-size:.74rem;color:var(--text2);margin-bottom:4px} +.map-verdict .mv-text{font-size:.96rem;font-weight:700;line-height:1.5} +.map-verdict .mv-actions{display:flex;gap:8px;margin-top:12px} +.map-layer{background:var(--card);border:1px solid var(--border);border-radius:11px;padding:15px 18px;margin-bottom:12px; + border-left:3px solid var(--border)} +.map-layer.pass{border-left-color:var(--green)} +.map-layer.watch{border-left-color:var(--yellow)} +.map-layer.out{border-left-color:var(--red)} +.ml-head{display:flex;align-items:center;gap:10px;margin-bottom:6px} +.ml-num{width:24px;height:24px;border-radius:7px;background:rgba(77,166,255,.15);color:var(--blue); + font-size:.78rem;font-weight:700;display:flex;align-items:center;justify-content:center;flex-shrink:0} +.ml-title{font-size:1rem;font-weight:700;flex:1} +.ml-badge{font-size:.68rem;font-weight:700;padding:2px 10px;border-radius:20px} +.ml-badge.good{background:rgba(0,212,170,.14);color:var(--green)} +.ml-badge.warn{background:rgba(255,193,77,.14);color:var(--yellow)} +.ml-badge.bad{background:rgba(255,77,106,.14);color:var(--red)} +.ml-badge.na{background:var(--surface);color:var(--text2)} +.ml-ask{font-size:.82rem;color:var(--text);line-height:1.6} +.ml-pillar{font-size:.74rem;color:var(--text2);margin:3px 0 10px} +.map-q{border-top:1px solid var(--border);padding:10px 0} +.map-q:last-of-type{border-bottom:1px solid var(--border)} +.mq-text{font-size:.85rem;line-height:1.55;margin-bottom:7px} +.mq-text .gate{font-size:.64rem;font-weight:700;background:rgba(255,138,77,.16);color:var(--orange); + border-radius:4px;padding:1px 6px;margin-right:7px;vertical-align:middle} +.mq-ans{display:flex;gap:7px;flex-wrap:wrap} +.ans{font-size:.78rem;padding:4px 13px;border-radius:7px;border:1px solid var(--border);background:var(--surface); + color:var(--text2);cursor:pointer;transition:.15s;user-select:none} +.ans input{display:none} +.ans:hover{border-color:var(--blue)} +.ans.yes.on{background:rgba(0,212,170,.16);border-color:var(--green);color:var(--green)} +.ans.unsure.on{background:rgba(255,193,77,.16);border-color:var(--yellow);color:var(--yellow)} +.ans.no.on{background:rgba(255,77,106,.16);border-color:var(--red);color:var(--red)} +.ml-out{font-size:.72rem;color:var(--text2);margin-top:9px;font-style:italic} +.map-q .ck-links{margin-top:6px;display:flex;flex-wrap:wrap;gap:6px} +.map-q .ck-links .wlink{font-size:.72rem} + +/* 回測 */ +.bt-controls{display:flex;gap:12px;align-items:flex-end;flex-wrap:wrap;background:var(--card);border:1px solid var(--border); + border-radius:10px;padding:14px 16px;margin-bottom:16px} +.bt-params{display:flex;gap:12px;flex-wrap:wrap} +.bt-field{display:flex;flex-direction:column;gap:4px} +.bt-field label{font-size:.72rem;color:var(--text2)} +.bt-field select,.bt-field input{background:var(--surface);border:1px solid var(--border);border-radius:7px;color:var(--text); + padding:8px 11px;font-size:.85rem;outline:none;font-family:inherit;min-width:120px} +.bt-field input{width:100px;min-width:0} +.bt-field select:focus,.bt-field input:focus{border-color:var(--blue)} +.bt-controls .btn{align-self:flex-end} +.bt-stats{display:grid;grid-template-columns:1fr 1fr;gap:12px;margin-top:14px} +.bt-stat{background:var(--card);border:1px solid var(--border);border-radius:10px;padding:14px 16px} +.bt-stat .bts-title{font-size:.84rem;font-weight:700;margin-bottom:10px} +.bts-grid{display:grid;grid-template-columns:1fr 1fr;gap:9px 14px} +.bts-grid div{display:flex;flex-direction:column;gap:2px} +.bts-grid span{font-size:.7rem;color:var(--text2)} +.bts-grid b{font-size:1.02rem;font-weight:700} +.bt-note{font-size:.76rem;color:var(--text2);margin-top:12px;line-height:1.6} +@media(max-width:680px){ .bt-stats{grid-template-columns:1fr} } diff --git a/app.js b/app.js new file mode 100644 index 0000000..b14d376 --- /dev/null +++ b/app.js @@ -0,0 +1,898 @@ +// ═══════════════════════════════════════════════════════════ +// Emmy 投資台 — 學習教材 / 財報健檢 / 交易復盤 +// 本檔在 index.html 的內聯 script 之後載入，可使用其全域函式 +// （lineChart、HEX、cssVar…），並負責主視圖切換與三個新分頁。 +// ═══════════════════════════════════════════════════════════ + +const $ = (s, r = document) => r.querySelector(s); +const $$ = (s, r = document) => [...r.querySelectorAll(s)]; + +function escapeHtml(s) { + return String(s == null ? '' : s) + .replace(/&/g, '&').replace(//g, '>') + .replace(/"/g, '"').replace(/'/g, '''); +} +async function api(path, opts) { + const res = await fetch(path, opts); + const data = await res.json().catch(() => ({})); + if (!res.ok) throw Object.assign(new Error(data.message || res.statusText), { data }); + return data; +} +function fmtNum(v, d = 0) { + if (v == null || isNaN(v)) return '—'; + return Number(v).toLocaleString('en-US', { minimumFractionDigits: d, maximumFractionDigits: d }); +} +function fmtPct(v, d = 1) { return v == null || isNaN(v) ? '—' : (v >= 0 ? '' : '') + Number(v).toFixed(d) + '%'; } +function fmtMoney(v) { + if (v == null || isNaN(v)) return '—'; + const a = Math.abs(v), s = v < 0 ? '-' : ''; + if (a >= 1e12) return s + '$' + (a / 1e12).toFixed(2) + 'T'; + if (a >= 1e9) return s + '$' + (a / 1e9).toFixed(2) + 'B'; + if (a >= 1e6) return s + '$' + (a / 1e6).toFixed(2) + 'M'; + if (a >= 1e3) return s + '$' + (a / 1e3).toFixed(1) + 'K'; + return s + '$' + a.toFixed(2); +} + +// ═══════════════════════════════════════════════════════════ +// 輕量 Markdown 渲染（支援標題/清單/表格/引用/粗體/行內碼/[[wikilink]]） +// ═══════════════════════════════════════════════════════════ +function mdInline(t) { + t = escapeHtml(t); + t = t.replace(/`([^`]+)`/g, (m, c) => '' + c + ''); + t = t.replace(/\[\[([^\]]+)\]\]/g, (m, inner) => wlinkHTML(inner)); + t = t.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '$1'); + t = t.replace(/\*\*([^*]+)\*\*/g, '$1'); + t = t.replace(/(^|[^*])\*([^*\n]+)\*/g, '$1$2'); + return t; +} +function wlinkHTML(inner) { + let [target, display] = inner.split('|'); + target = (target || '').trim(); + display = (display || '').trim(); + if (!display) display = target.includes('#') ? target.split('#').pop() : target.split('/').pop(); + return '' + escapeHtml(display) + ''; +} +function splitRow(line) { + return line.trim().replace(/^\|/, '').replace(/\|$/, '').split('|').map(c => c.trim()); +} +function renderTable(header, rows) { + let h = '' + header.map(c => '').join('') + ''; + for (const r of rows) h += '' + header.map((_, j) => '').join('') + ''; + return h + '
' + mdInline(c) + '
' + mdInline(r[j] || '') + '
'; +} +function renderListBlock(lines) { + const root = { children: [] }; + const stack = [{ indent: -1, node: root }]; + for (const raw of lines) { + const m = raw.match(/^(\s*)([-*]|\d+\.)\s+(.*)$/); + if (!m) continue; + const indent = m[1].replace(/\t/g, ' ').length; + const ordered = /\d/.test(m[2]); + const item = { ordered, html: mdInline(m[3]), children: [] }; + while (stack.length > 1 && indent <= stack[stack.length - 1].indent) stack.pop(); + stack[stack.length - 1].node.children.push(item); + stack.push({ indent, node: item }); + } + const emit = (node) => { + if (!node.children.length) return ''; + const ordered = node.children[0].ordered; + let h = '<' + (ordered ? 'ol' : 'ul') + '>'; + for (const c of node.children) h += '
  • ' + c.html + emit(c) + '
    • '; + return h + ''; + }; + return emit(root); +} +function renderMarkdown(md) { + md = String(md || '').replace(/\r\n/g, '\n'); + const fences = []; + md = md.replace(/```[\s\S]*?```/g, (m) => { fences.push(m); return '\u0000F' + (fences.length - 1) + '\u0000'; }); + const lines = md.split('\n'); + const blank = s => !s.trim(); + let html = '', i = 0; + while (i < lines.length) { + const line = lines[i]; + if (blank(line)) { i++; continue; } + const fm = line.match(/^\u0000F(\d+)\u0000$/); + if (fm) { const code = fences[+fm[1]].replace(/^```[^\n]*\n?/, '').replace(/```\s*$/, ''); html += '
    ' + escapeHtml(code) + '
    '; i++; continue; } + const h = line.match(/^(#{1,6})\s+(.*)$/); + if (h) { const l = h[1].length; html += `${mdInline(h[2])}`; i++; continue; } + if (/^(-{3,}|\*{3,}|_{3,})$/.test(line.trim())) { html += '
    '; i++; continue; } + if (line.includes('|') && i + 1 < lines.length && /^\s*\|?[\s:|-]+\|?\s*$/.test(lines[i + 1]) && lines[i + 1].includes('-')) { + const header = splitRow(line); i += 2; const rows = []; + while (i < lines.length && lines[i].includes('|') && !blank(lines[i])) { rows.push(splitRow(lines[i])); i++; } + html += renderTable(header, rows); continue; + } + if (/^\s*>/.test(line)) { const buf = []; while (i < lines.length && /^\s*>/.test(lines[i])) { buf.push(lines[i].replace(/^\s*>\s?/, '')); i++; } html += '
    ' + renderMarkdown(buf.join('\n')) + '
    '; continue; } + if (/^\s*([-*]|\d+\.)\s+/.test(line)) { const buf = []; while (i < lines.length && /^\s*([-*]|\d+\.)\s+/.test(lines[i])) { buf.push(lines[i]); i++; } html += renderListBlock(buf); continue; } + const buf = []; + while (i < lines.length && !blank(lines[i]) && !/^(#{1,6})\s/.test(lines[i]) && !/^\s*([-*]|\d+\.)\s+/.test(lines[i]) && !/^\s*>/.test(lines[i]) && !/^\u0000F\d+\u0000$/.test(lines[i]) && !/^(-{3,}|\*{3,}|_{3,})$/.test(lines[i].trim()) && !(lines[i].includes('|') && i + 1 < lines.length && /^\s*\|?[\s:|-]+\|?\s*$/.test(lines[i + 1]))) { buf.push(lines[i]); i++; } + if (buf.length) html += '

    ' + mdInline(buf.join(' ')) + '

    '; + } + return html; +} +// 把容器內所有 [[wikilink]] 綁定成站內跳轉；無法解析的標成 dead +function bindWlinks(container) { + $$('.wlink[data-link]', container).forEach(elx => { + const t = elx.dataset.link; + const hit = (KB.linkMap && (KB.linkMap[t] || KB.linkMap[t.split('#').pop()] || KB.linkMap[t.split('/').pop()])) || null; + if (!hit) { elx.classList.add('dead'); return; } + elx.addEventListener('click', () => openNote(hit.kind, hit.id)); + }); +} + +// ═══════════════════════════════════════════════════════════ +// 主視圖路由 +// ═══════════════════════════════════════════════════════════ +const VIEW_IDS = ['macro', 'learn', 'stock', 'journal']; +const inited = {}; +function parseHash() { const m = location.hash.match(/^#\/(\w+)/); const v = m ? m[1] : 'macro'; return VIEW_IDS.includes(v) ? v : 'macro'; } +function setView(view) { + document.body.dataset.view = view; + VIEW_IDS.forEach(v => { const e = $('#view-' + v); if (e) e.hidden = v !== view; }); + $$('#viewTabs a').forEach(a => a.classList.toggle('active', a.dataset.view === view)); + if (view === 'learn' && !inited.learn) { inited.learn = true; initLearn(); } + if (view === 'stock' && !inited.stock) { inited.stock = true; initStock(); } + if (view === 'journal' && !inited.journal) { inited.journal = true; initJournal(); } + if (view !== 'macro') window.scrollTo({ top: 0 }); +} +$$('#viewTabs a').forEach(a => a.addEventListener('click', () => { + location.hash = a.dataset.view === 'macro' ? '#/' : '#/' + a.dataset.view; +})); +window.addEventListener('hashchange', () => setView(parseHash())); + +// ═══════════════════════════════════════════════════════════ +// 知識庫資料 +// ═══════════════════════════════════════════════════════════ +let KB = { loaded: false, linkMap: {} }; +async function ensureKnowledge() { + if (KB.loaded) return KB; + KB = await api('/api/knowledge'); + KB.loaded = true; + KB.linkMap = KB.linkMap || {}; + return KB; +} +// 從任何視圖點連結要看的、但 initLearn 尚未建好 DOM 時，先暫存於此，由 initLearn 收尾渲染 +let pendingNote = null; +// 把一篇筆記打開在「學習教材」視圖；macro/個股→切到 learn +async function openNote(kind, id) { + await ensureKnowledge(); + let note = findLocalNote(kind, id); + if (!note) { try { note = await api(`/api/note/${encodeURIComponent(kind)}/${encodeURIComponent(id)}`); } catch (e) { note = null; } } + const finalNote = note || { body: `# 找不到這篇筆記\n（${kind} / ${id}）` }; + if (!inited.learn) { + // 學習教材還沒初始化：暫存，切到 learn 後由 initLearn 渲染（避免被課綱總覽蓋掉） + pendingNote = finalNote; + location.hash = '#/learn'; + return; + } + if (document.body.dataset.view !== 'learn') location.hash = '#/learn'; + renderNote(finalNote); +} +function findLocalNote(kind, id) { + if (kind === 'overview') return KB.overview; + if (kind === 'principleMap') return KB.principleMap; + if (kind === 'quiz') return KB.quiz; + if (kind === 'category') return (KB.categories || []).find(c => c.id === id); + if (kind === 'case') return (KB.cases || []).find(c => c.id === id); + if (kind === 'principle') return (KB.principles || []).find(p => p.id === id); + return null; +} +function renderNote(note) { + const content = $('#learnContent'); + const fm = note.frontmatter || {}; + let tags = ''; + if (fm.ticker) tags += `代號 ${escapeHtml([].concat(fm.ticker).join(' / '))}`; + if (fm.sector) tags += `${escapeHtml(fm.sector)}`; + if (fm.category) tags += `${escapeHtml(fm.category)}`; + if (fm.date) tags += `${escapeHtml(fm.date)}`; + if (Array.isArray(fm.aliases) && fm.aliases.length) tags += `別名 ${escapeHtml(fm.aliases.join(' · '))}`; + content.innerHTML = + `← 返回` + + (tags ? `
    ${tags}
    ` : '') + + `
    ${renderMarkdown(note.body || '')}
    `; + bindWlinks(content); + $('#noteBack').addEventListener('click', () => showSection(LEARN.lastSection || 'overview')); + window.scrollTo({ top: 0 }); +} + +// ═══════════════════════════════════════════════════════════ +// 學習教材視圖 +// ═══════════════════════════════════════════════════════════ +const LEARN = { lastSection: 'overview' }; +function setLearnActive(section) { + $$('#learnSide a').forEach(a => a.classList.toggle('active', a.dataset.section === section)); +} +async function initLearn() { + const view = $('#view-learn'); + view.innerHTML = `
    正在載入知識庫…
    `; + try { await ensureKnowledge(); } catch (e) { + view.innerHTML = `
    知識庫尚未建立。請先在 web/ 目錄執行 npm run build:knowledge 產生 data/knowledge.json，再重新整理。
    `; + return; + } + const c = KB.counts || {}; + view.innerHTML = ` +
    +
    +
    📚 學習教材
    +
    把 Emmy 的知識整理成從零到能跟著判斷的學習路徑：三階段課綱、心法、案例、名詞與公司速查、練習題庫。點任何 紫色連結 都能跳到對應筆記。
    +
    +
    + +
    +
    +
    `; + $$('#learnSide a').forEach(a => a.addEventListener('click', () => showSection(a.dataset.section))); + if (pendingNote) { const n = pendingNote; pendingNote = null; renderNote(n); } + else showSection('overview'); +} +function showSection(section) { + LEARN.lastSection = section; + setLearnActive(section); + const content = $('#learnContent'); + if (!content) return; + if (section === 'overview') return renderNote(KB.overview || { body: '# 課綱總覽\n（尚無內容）' }); + if (section === 'principleMap') return renderNote(KB.principleMap || { body: '# 心法地圖\n（尚無內容）' }); + if (section === 'quiz') return renderQuiz(); + if (section === 'categories') return renderCardList('學習分類', KB.categories, 'category'); + if (section === 'cases') return renderCardList('案例講解', KB.cases, 'case'); + if (section === 'principles') return renderPrincipleList(); + if (['terms', 'companies', 'episodes'].includes(section)) return renderGlossary(section); +} +function renderCardList(title, items, kind) { + const content = $('#learnContent'); + const cards = (items || []).map(it => ` +
    +
    ${escapeHtml(it.title)}
    + ${it.summary ? `
    ${escapeHtml(it.summary)}
    ` : ''} +
    `).join(''); + content.innerHTML = `
    ${escapeHtml(title)}
    ${cards || '
    尚無內容。
    '}
    `; + $$('.module-card', content).forEach(el => el.addEventListener('click', () => openNote(kind, el.dataset.id))); + window.scrollTo({ top: 0 }); +} +function renderPrincipleList() { + const content = $('#learnContent'); + const cards = (KB.principles || []).map(p => ` +
    +
    ${escapeHtml(p.title)}
    +
    `).join(''); + content.innerHTML = `
    Emmy 投資心法
    +
    共 ${(KB.principles || []).length} 條原則。完整分群與決策流程請看「心法地圖」。
    +
    ${cards}
    `; + $$('.module-card', content).forEach(el => el.addEventListener('click', () => openNote('principle', el.dataset.id))); + window.scrollTo({ top: 0 }); +} +function renderGlossary(section) { + const content = $('#learnContent'); + const kind = { terms: 'term', companies: 'company', episodes: 'episode' }[section]; + const all = (KB.index || []).filter(x => x.kind === kind); + const title = { terms: '名詞速查', companies: '公司速查', episodes: '單集速查' }[section]; + content.innerHTML = ` +
    ${title}
    +
    +
    +
    `; + const grid = $('#glossGrid'), countEl = $('#glossCount'); + const draw = (q) => { + q = (q || '').trim().toLowerCase(); + const list = !q ? all : all.filter(x => + x.title.toLowerCase().includes(q) || + (x.aliases || []).some(a => a.toLowerCase().includes(q)) || + (x.sub || '').toLowerCase().includes(q)); + countEl.textContent = `${list.length} 筆${q ? `（搜尋「${q}」）` : ''}`; + grid.innerHTML = list.slice(0, 400).map(x => ` +
    +
    ${escapeHtml(x.title)}
    + ${x.sub ? `
    ${escapeHtml(x.sub)}
    ` : ''} +
    `).join('') || '
    找不到符合的項目。
    '; + $$('.gloss-item', grid).forEach(el => el.addEventListener('click', () => openNote(kind, el.dataset.id))); + if (list.length > 400) countEl.textContent += '，只顯示前 400 筆，請用搜尋縮小範圍。'; + }; + $('#glossSearch').addEventListener('input', e => draw(e.target.value)); + draw(''); + window.scrollTo({ top: 0 }); +} +function renderQuiz() { + renderNote(KB.quiz || { body: '# 練習題庫\n（尚無內容）' }); +} + +// ═══════════════════════════════════════════════════════════ +// 共用 SVG 折線圖（價格走勢 / 回測權益曲線共用，支援多條線 + hover） +// ═══════════════════════════════════════════════════════════ +let _chartSeq = 0; +function drawLineChart(el, series, opts = {}) { + series = (series || []).filter(s => s.points && s.points.length >= 2); + if (!series.length) { el.innerHTML = '
    資料不足，無法繪圖。
    '; return; } + const uid = 'c' + (++_chartSeq); + const w = 760, h = opts.height || 300, padL = 60, padR = 14, padT = 16, padB = 28; + const plotW = w - padL - padR, plotH = h - padT - padB; + const n = Math.min(...series.map(s => s.points.length)); + const dates = series[0].points.map(p => p.date); + const allVals = []; series.forEach(s => s.points.forEach(p => allVals.push(p.val))); + let yMin = opts.yMin != null ? opts.yMin : Math.min(...allVals); + let yMax = opts.yMax != null ? opts.yMax : Math.max(...allVals); + if (yMin === yMax) { yMin -= 1; yMax += 1; } + if (opts.yMin == null) { const p = (yMax - yMin) * 0.08; yMin -= p; yMax += p; } + const yRange = yMax - yMin || 1; + const fmt = opts.fmt || (v => fmtNum(v, opts.decimals != null ? opts.decimals : 0)); + const toX = i => padL + (i / (n - 1)) * plotW; + const toY = v => padT + (1 - (v - yMin) / yRange) * plotH; + let grid = ''; + for (let k = 0; k <= 5; k++) { const v = yMin + yRange * k / 5; const y = toY(v); grid += `${fmt(v)}`; } + let xlab = ''; const xt = Math.min(5, n); + for (let k = 0; k < xt; k++) { const idx = Math.round(k * (n - 1) / (xt - 1)); xlab += `${(dates[idx] || '').slice(2, 7).replace('-', '/')}`; } + let paths = '', dots = ''; + series.forEach(s => { + const d = s.points.slice(0, n).map((p, i) => `${i === 0 ? 'M' : 'L'}${toX(i).toFixed(1)},${toY(p.val).toFixed(1)}`).join(' '); + paths += ``; + dots += `