MyHomeware SEO 看板 · 业务参考文档 ← 全部文档打开线上页面 ↗

模块编辑(CRUD / 导入导出)

页面地址:/pages/editor-module?m=keywords · 站点:mhw.schwuaclawai.top

页面用途

五类核心数据的在线表格编辑:m=keywords|tdh|content|internal|infohub。支持搜索、分页加载、单条保存、Excel 模板下载、异步导出、关键词批量导入(带预览确认)。

业务定位

运营/编辑的主数据维护界面,替代旧版 tdh-tasks / content-tasks 等分散页面。核心约束:Excel 导入必须先预览确认,防止误覆盖全库。

业务逻辑(深度)

1. 五模块与表关系

每个关键词在 keywords_basic 有一条主记录;TDH/内容/内链/InfoHub 各 0–1 条计划行(按 keyword_id 关联)。

keywords 保存时可勾选 sync_*,自动为子表创建占位行(状态「待进行」、继承 executor / planned_finish)。

删除关键词不会级联删子表(需注意孤儿数据);导入用 upsert 按 keyword 文本或 ID 对齐。

2. 列表与编辑交互

游标分页:after_id + limit,避免大 OFFSET。搜索支持关键词模糊或纯数字 ID。

弹窗编辑:GET 拉整行 → 前端改 → POST JSON save。保存后子表字段与主表 target_url 变更可触发同步逻辑(见 editor_svc_keywords_save)。

3. 导入导出闭环

导出:异步 job(session 绑定 token)→ 轮询 status → 一次性下载 xlsx 后服务端删文件。

导入

  1. 上传 → import_preview 解析前 10 行 + 总行数,文件暂存 /tmp;
  2. 用户确认 → import_confirm 带 preview_token 全量写入;
  3. keywords 导入可带 sync 选项,一次录入主表+四子表。

internal_logs / infohub_logs 仅支持导入,无在线 list/save(量大、结构固定)。

4. 与看板的数据契约

看板只读这些表;运营在 editor-module 改 status、完成日、TDH 字段后,首页统计与单词看板下次刷新即生效,无需额外同步任务。

模块与数据表

m 参数主表
keywordskeywords_basic
tdhonpage_tdh_records
contentonpage_content_records
internalinternal_link_plans
infohubinfohub_link_plans

应用接口

详见 Editor API 接口文档

关键代码

pages/editor-module.phppages/editor-api.phpincludes/editor_service.php