浅念
8cea7dee20
- SiteForge Enterprise V8.10.0-dev.1 upstream source (210 tests) - Fix: v8_workflows._mapped_input now reads both 类型/分类 columns so WXR imports keep post/product types instead of collapsing to page - Docs: trade-pro theme port spec (R3) and implementation plan Co-Authored-By: Claude Code <noreply@anthropic.com>
46 lines
4.4 KiB
Markdown
46 lines
4.4 KiB
Markdown
# SiteForge Enterprise V8.3.0-dev.1 — WordPress 分类、标签与媒体目录
|
|
|
|
## 已实现（可在本地固定夹具测试）
|
|
|
|
- 保留 V8.2 WordPress REST 分页文章和页面扫描、Worker 任务、Sitemap 审计和媒体本地化。
|
|
- 新增 `wp_migration_v83.py`：公开 WP REST `categories`、`tags`、`media` 目录的逐页采集。每类资源独立保存页码、累计数量和是否完成；每页最多 50 条、每类最多 5,000 条；所有远程访问走项目安全 HTTP 客户端。
|
|
- 保存源 WP taxonomy/media ID、名称、slug、parent、源归档 URL、媒体 MIME/尺寸/替代文本的有限元数据；逐项关系使用 `wp_catalog_refs` 表保存。数据仍保持在原迁移会话作用域。
|
|
- WP 文章的源 ID、分类/标签 ID、特色媒体 ID 和部分公开 ACF 快照进入分批暂存数据的 `meta.wp_source`；ACF 过大不存储原值，只记录字段名与需复核提示。不自动执行或重建 Elementor、插件脚本。
|
|
- 已同步名称自动补齐暂存内容 `meta.fields.category/tags`，确认导入后随内容保存；新同步不会修改已经正式提交或人工编辑的正文。
|
|
- 分类/标签归档原 URL 在 `finalize` 时进入 SEO 基线，不会凭空生成不存在的归档页面；不匹配仍须由 URL/SEO 审计处理。
|
|
- 未找到的关系、缺失上级分类、空名称、跨域归档 URL、ACF 等进入人工复核。只有全部审核完才允许按既有发布门禁继续。
|
|
- Web 工作台新加“分类 / 标签 / 媒体库”分页同步与目录进度查询。
|
|
|
|
## API（需已登录 + CSRF + 站点权限）
|
|
|
|
- `GET /api/migrations/sites/{site}/wordpress/sessions/{session}/catalog`：查询资源采集检查点及数量
|
|
- `POST /api/migrations/sites/{site}/wordpress/sessions/{session}/catalog/categories/next`：同步下一页公开分类
|
|
- `POST /api/migrations/sites/{site}/wordpress/sessions/{session}/catalog/tags/next`：同步下一页公开标签
|
|
- `POST /api/migrations/sites/{site}/wordpress/sessions/{session}/catalog/media/next`：同步下一页公开媒体库元数据
|
|
- `POST /api/migrations/sites/{site}/wordpress/sessions/{session}/catalog/refresh`：手动刷新待导入文章里的分类和标签名称
|
|
|
|
**操作顺序**：建立迁移会话 → 采集 WordPress 页面与文章（Worker）→ 同步分类、标签、媒体库元数据直到各目录 `done=true` → 执行 V8.2 媒体本地化 → 核对 Sitemap 缺失 URL 与分类归档 URL → 确认正式导入 → SEO/发布审核。
|
|
|
|
## 已验证
|
|
|
|
- 旧有 120 项及新增 10 项，合计 **130 项 pytest 通过**。
|
|
- 覆盖源 ID 保存、分类和标签关联、独立媒体清单、幂等分页、网络故障游标保护、越权、目录同步 API、人工复核、归档 URL 基线等。
|
|
- Python 编译、JavaScript 语法、版本核查见 `scripts/check.sh` 和 `scripts/verify_release.py`。
|
|
|
|
## 未完成 / 严禁误标为生产完成
|
|
|
|
- WordPress 分类/标签 **元数据同步** 不等于完整重建分类归档页内容和样式。保存原 URL 以便后续修复或人工批准的重定向。
|
|
- WordPress 媒体库 **目录同步** 不等于下载了全量媒体二进制；只下载 V8.2 明确扫描并授权的正文、封面图片，其他附件、PDF、CDN、`srcset`、CSS 背景仍需继续处理。
|
|
- 公开 WP REST 对 ACF、Elementor、WooCommerce 变体/库存/属性的暴露程度因站而异；本版只保留有限元数据和复核提示，不做复杂插件的布局无损转换。
|
|
- 目录同步目前是“一次一页”的同步 API，不是长时独立 Worker 任务；大规模任务应继续入队列。
|
|
- 未做真实 Docker Engine、授权生产 WordPress 全站、GitHub 云 CI、正式 Art Design Pro 构建和远程 SFTP/S3 发布验收。
|
|
- 旧数据库上的原地升级、数据库备份与正式回滚仍需要在隔离环境演练。
|
|
|
|
## 下一批具体开发建议
|
|
|
|
1. 完成分类/标签归档模板生成或经过人工批准的 301 重定向映射，并纳入 URL/SEO 验收。
|
|
2. 实现媒体附件全量清单 + 授权可下载资产、失败可续传、二进制校验与附件引用关系。
|
|
3. 针对真实 ACF / Elementor / WooCommerce 导出文件，建立固定测试夹具和受限字段适配器。
|
|
4. 把分类、标签、媒体目录同步放入独立 Worker 任务，具备取消、进度和故障恢复。
|
|
5. 在稳定的 P2 迁移流程后启动 P3 API/XML/只读数据库连接器和 P4 编辑器增强。
|