kneo_marketplace/docs/operations-memo.md
Warren Chen 3ce43df93c Add product hero section and homepage hero products component
- Introduced a new view component for product hardware hero section (_ProductHardwarePrHero.cshtml) that displays product details including titles, features, and a copy with expandable text.
- Created a homepage hero products component (Default.cshtml) to showcase the first product in a list and provide navigation dots for additional products.
- Added a placeholder for when no products are available, guiding users to set products in the backend.
- Included a new image asset (vehicle-transportation.png) for use in the product hero section.
2026-05-07 00:37:33 +09:00

49 lines
2.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 操作備忘錄(通用)
## 用途
本文件用於記錄「部署或資料調整時不可漏掉的操作步驟」。
不限定分類調整,後續所有會影響既有資料或上線流程的改動都追加在此。
---
## 2026-05-03 ~ 2026-05-05分類骨架調整與首頁資料前置
### 執行目標
1. 建立新分類骨架:`Hardware``Software``AI Application`6 子類)、`Books`3 子類)
2. 補齊分類中文多語系
3. 處理舊 `Software` 子類別清理
4. 保留可回滾資料
### SQL 檔案
1. [category-restructure-20260503.sql](/Users/chenyanhan/Documents/Projects/Kneo_marketplace/docs/sql/category-restructure-20260503.sql)
2. [category-delete-legacy-software-children-20260503.sql](/Users/chenyanhan/Documents/Projects/Kneo_marketplace/docs/sql/category-delete-legacy-software-children-20260503.sql)
3. [category-localization-backfill-tw-20260503.sql](/Users/chenyanhan/Documents/Projects/Kneo_marketplace/docs/sql/category-localization-backfill-tw-20260503.sql)
### 操作重點
1. 先執行分類重構 SQL再執行舊子類清理 SQL。
2. 語系代碼需支援 `tw`,否則中文多語系不會落地。
3. `Software` 下舊子類刪除邏輯已改為「依父節點刪除」,不再依名稱比對。
4. 刪除前會備份 `Category``Product_Category_Mapping``LocalizedProperty``UrlRecord` 到備份表。
### 手動設定
1. 後台手動調整分類顯示順序:`Hardware = 10``Software = 20`
2. 前台若未即時反映中文名稱,需清除應用程式快取。
### 驗證項目
1. `AI Application` 下應有 6 個子類。
2. `Books` 下應有 3 個子類(英文預設名,中文靠多語系)。
3. `Software` 下子類應為空(新骨架目標)。
4. 13 個目標分類的中文多語系需存在於 `LocalizedProperty`
### 回滾原則
1. 先恢復分類可見性或重新建立父子關係。
2. 若資料已刪除,從備份表回補 `Category``Product_Category_Mapping``LocalizedProperty``UrlRecord`