Add manual catalog management

README.md

@@ -167,7 +167,7 @@ docker compose down -v
 
 ### 3.3 数据管理页
 
-数据管理页按左侧导航分为四部分。
+数据管理页按左侧导航分为五部分。
 
 #### 品牌列表
 
@@ -184,6 +184,30 @@ docker compose down -v
 - 厂商归属调整
 - 品牌展示不符合预期时排查
 
+#### 手动补录
+
+这里维护本地覆盖库。
+
+这里可做的事：
+
+- 新增独立品牌
+- 在品牌下补录设备
+- 编辑或删除本地补录记录
+
+适用场景：
+
+- 上游暂未收录的新品牌
+- 学习机、教育终端、定制设备
+- 需要立即参与页面查询和 MySQL 查询的补录数据
+
+使用说明：
+
+1. 品牌先建在本地覆盖库
+2. 设备标识填客户端真实上报值
+3. 保存后自动重建索引和 MySQL seed
+4. 如果开启 MySQL 自动装载，会继续自动刷新 MySQL
+5. 本地覆盖库不会被“原始数据同步”覆盖
+
 #### 数据来源
 
 这里维护来源优先级。
@@ -339,7 +363,12 @@ NOH-AL00   -> nohal00
 
 ### 5.1 数据来源
 
-项目的原始数据主要来自 `workspace/brands/*.md`。这些原始 markdown 是后续索引与 MySQL 数据生成的基础。
+项目的数据来源分为两部分：
+
+- 上游原始数据：`workspace/brands/*.md`
+- 本地覆盖库：`workspace/local/manual_catalog.json`
+
+上游原始数据用于同步官方或社区维护的数据，本地覆盖库用于补录当前业务需要但上游暂未收录的品牌和设备。
 
 ### 5.2 数据生成链路
 
@@ -347,9 +376,10 @@ NOH-AL00   -> nohal00
 
 1. 同步上游原始 markdown
 2. 解析 `workspace/brands/*.md`
-3. 构建 `dist/device_index.json`
-4. 导出 `dist/mobilemodels_mysql_seed.sql`
-5. 加载 MySQL schema 与 seed
+3. 合并 `workspace/local/manual_catalog.json`
+4. 构建 `dist/device_index.json`
+5. 导出 `dist/mobilemodels_mysql_seed.sql`
+6. 按配置决定是否自动装载 MySQL
 
 ### 5.3 关键产物
 
@@ -366,6 +396,22 @@ NOH-AL00   -> nohal00
 
 适用于品牌展示或厂商归属不符合预期的情况。
 
+#### 手动补录品牌或设备
+
+适用于上游未收录，但业务需要立即支持的设备。
+
+维护方式：
+
+1. 在 `数据管理 -> 手动补录` 中新增品牌或设备
+2. 保存后自动刷新索引与 MySQL seed
+3. 如关闭了 MySQL 自动装载，需按需手动初始化或刷新外部 MySQL
+
+说明：
+
+- 本地覆盖库不会被上游同步覆盖
+- 本地补录来源默认优先级更高
+- 适合维护学习机、教育设备、定制终端
+
 #### 调整来源顺序
 
 适用于多个来源的优先级需要重新定义的情况。