docs(m5a): README 表列类型与 models/*.json 对齐 + 补 init/data.json 种子导入步骤

README.md

@@ -60,14 +60,14 @@ PBL（项目式学习）的**产出物与学习证据**模块。它做两件事
 |----|------|------|
 | `id` | str(32) PK | 主键 |
 | `tenant_id` | str(32) NOT NULL | 租户（强制打头，缺失 fail-closed） |
-| `artifact_uid` | str(64) | 业务唯一码，与 tenant 组成唯一键 |
+| `artifact_uid` | str(32) | 业务唯一码，与 tenant 组成唯一键 |
 | `session_id` / `blueprint_id` / `team_id` | str(32) | 会话 / 蓝图 / 团队归属 |
 | `creator_id` | str(32) | 作者（学习者） |
-| `title` | str(255) | 标题 |
-| `artifact_type` | str(64) | 类型（编码 `pbl_artifact_type`） |
+| `title` | str(128) | 标题 |
+| `artifact_type` | str(64) | 类型（编码 `pbl_artifact_type`，默认 `other`） |
 | `content_json` | text | 产出物内容（序列化 JSON） |
-| `version_no` | str(32) | 版本号（内联，版本快照由蓝图侧维护） |
-| `status` | str(32) | 状态（编码 `pbl_artifact_status`） |
+| `version_no` | int | 版本号（内联，默认 1；版本快照由蓝图侧维护） |
+| `status` | str(64) | 状态（编码 `pbl_artifact_status`，默认 `draft`） |
 | `submitted_at` / `created_at` / `updated_at` | datetime | 时间与审计列（**应用层写入**，sqlor 不自动填） |
 
 索引：`uk_art_uid(tenant_id, artifact_uid)` 唯一；`idx_art_session` / `idx_art_blueprint` /
@@ -80,7 +80,7 @@ PBL（项目式学习）的**产出物与学习证据**模块。它做两件事
 | `id` | str(32) PK | 主键 |
 | `tenant_id` | str(32) NOT NULL | 租户 |
 | `artifact_id` | str(32) | 归属产出物（`'0'` = 无强归属的观测类证据） |
-| `evidence_type` | str(64) | 证据类型（编码 `pbl_evidence_type`，8 类） |
+| `evidence_type` | str(64) | 证据类型（编码 `pbl_evidence_type`，8 类，源自 `evidence_map.EVIDENCE_TYPES`） |
 | `source_event_id` | str(32) NOT NULL | 来源 runtime_event 事件 ID（幂等锚点） |
 | `session_id` / `learner_id` / `blueprint_id` | str(32) | 查询维度 |
 | `payload_json` | text | 证据体（事件摘要序列化 JSON） |
@@ -115,7 +115,11 @@ mysql -h <db_host> -u<user> -p<pwd> <dbname> < mysql.ddl.sql
 # 3) 生成 CRUD 前端（可选；已有手写 api/ dspy 时按 build.sh 流程执行）
 cd json && xls2ui -m ../models -o ../wwwroot pbl_evidence *.json
 
-# 4) 登记 RBAC 权限（双层：模块层 + 中央宿主层，见下）
+# 4) 导入编码种子（3 组 appcodes：pbl_artifact_type / pbl_artifact_status / pbl_evidence_type）
+#    Format B，由宿主 scripts/init_data.py（或 dbloader）读入 init/data.json 落 appcodes + appcodes_kv
+python3 -c "import json;d=json.load(open('init/data.json'));print('groups:',[g['parentid'] for g in d['appcodes']])"
+
+# 5) 登记 RBAC 权限（双层：模块层 + 中央宿主层，见下）
 python3 scripts/load_path.py --check          # 清单与 wwwroot 磁盘一致性核对（不连库）
 RBAC_SET_PERM=/path/to/set_role_perm.py python3 scripts/load_path.py   # 实际写权限
 ```