101創富系統 · 八大數據庫文件管理 SOP

📥 需求評估 — 是否需要建立正式文件？

📝 內容製作 — 生成正式文件

依據來源決定製作方式：

• 主公口述 → tomemo：由貞整理為標準化 HTML
• DOCX 參考文件 → HTML 轉換：讀取 docx → 生成美觀 HTML
• 多源數據整合 → 專用技能：如 toideap / updateknow

🗂️ 入庫登記 — 更新 memodata.json

嚴格執行 updatememo 防呆流程（ERR-068）：

• Step 1：讀取 memodata.json 倒數 15 行，確認現有最後一筆記錄的 id
• Step 2：計算本筆記錄的序號（新 id = 最末 id + 1）
• Step 3：用完整的最末記錄 JSON 結構作為 old_str
• Step 4：new_str = 完整最末記錄 + 逗號 + 完整新記錄 + ]\n}
• Step 5：驗證 JSON 有效性 python -c "import json; json.load(open('memodata.json'))"

🧭 導航更新 — 更新 index.html 卡片

在 index.html 中插入新文件的導航卡片：

• 確認卡片位置（通常在 <!-- #075 --> 等注釋標記之後）
• 卡片包含：序號、標題、日期、摘要、查看連結
• 顏色風格統一（避免覆蓋其他卡片）
• 同步更新相應下拉選單（如 skills-list / demands.html 等）

🚀 部署上線 — Cloudflare Pages

使用 wrangler pages deploy 部署：

• wrangler pages deploy [專案目錄] --project-name=[專案名]
• 上傳後驗證：檢查 deployment URL 確認文件可訪問
• 清理舊 deployment（如需）：delete-olddata

✅ 完工記錄 — 寫入工作記憶

每次完成後必做：

• 寫入 workmemo：記錄完成的工作內容
• 更新 workp：如該任務已列入待辦，標記狀態
• 寫入 tomemory：確保跨 session 記憶延續

🌐 線上 URL 驗證

取得新 deployment URL 後，逐一驗證：

• 新 HTML 文件可正常載入（無 404）
• 頁面內連結點擊正常
• 返回首頁連結正常

📊 memodata.html 渲染驗證

打開線上 memodata.html，確認：

• 新記錄出現在列表中
• 點擊新記錄可跳轉到正確頁面
• 卡片顯示序號、標題、日期正確

🗂️ 選單覆核

打開 index.html，下拉測試所有相關選單：

• 新檔案出現在正確的分類下
• dropdown-item 樣式正常
• hover 效果正常