From 7c9e5c373ac5d44d8569f1a73fe2fab3e55b45fd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=83=AD=E5=BA=86=E6=B3=B0?=
 <12369755+htcloud1@user.noreply.gitee.com>
Date: Tue, 18 Aug 2026 22:17:28 +0800
Subject: [PATCH] =?UTF-8?q?docs(manager=5Fprojects):=20=C2=A76.3=20?=
 =?UTF-8?q?=E5=8A=A0=E4=B8=AD=E6=96=87=E5=88=97=E5=90=8D=E5=88=97=20(DB=20?=
 =?UTF-8?q?COMMENT=20=E4=BC=98=E5=85=88,=20=E5=8A=A0=E9=80=9F=E7=B1=BB?=
 =?UTF-8?q?=E5=9E=8B=E4=B8=8D=E4=B8=80=E8=87=B4=E6=8E=92=E6=9F=A5)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

每行从 5 列扩到 6 列: 实体字段 / 中文列名 (DB COMMENT) / 类型 / 表字段 / 类型 / 一致?
中文名来源 (按优先级):
  1. SQL information_schema.COLUMNS.COLUMN_COMMENT (DDL COMMENT, 最权威)
  2. 前端 UI label (table header / form label)
  3. 实体 @Excel(name) (导出列头, 兜底)
好处: 一眼看出"哪个中文字段对哪个英文 DB 列", §6.3 之前发现的 projectId String vs project_id bigint / startTime String vs start_time datetime 这类 bug 一目了然。
---
 _self/manager_projects.md | 83 +++++++++++++++++++++------------------
 1 file changed, 44 insertions(+), 39 deletions(-)

diff --git a/_self/manager_projects.md b/_self/manager_projects.md
index 1c523ed..9eb9f81 100644
--- a/_self/manager_projects.md
+++ b/_self/manager_projects.md
@@ -232,45 +232,50 @@ CREATE TABLE `biz_project` (
 
 ### 6.3 Entity ↔ 表字段对照 (BizProject.java)
 
-| 实体字段 | 类型 | 表字段 | 类型 | 一致? |
-|---|---|---|---|---|
-| projectId | Long | project_id | bigint | ✅ 已修 (2026-08-18, 见 §修复记录) |
-| projectNo | String | project_no | varchar(50) | ✅ |
-| projectName | String | project_name | varchar(200) | ✅ |
-| totalSessions | Long | total_sessions | int | ✅ |
-| doneSessions | Long | done_sessions | int | ✅ |
-| todoSessions | Long | todo_sessions | int | ✅ |
-| totalAmount | BigDecimal | total_amount | decimal(15,2) | ✅ |
-| availableAmount | BigDecimal | available_amount | decimal(15,2) | ✅ |
-| paidLaborAmount | BigDecimal | paid_labor_amount | decimal(15,2) | ✅ |
-| paidMeetingAmount | BigDecimal | paid_meeting_amount | decimal(15,2) | ✅ |
-| managerScore | BigDecimal | manager_score | decimal(3,1) | ✅ |
-| sponsorScore | BigDecimal | sponsor_score | decimal(3,1) | ✅ |
-| sponsorAdminUserName | String | sponsor_admin_user_name | varchar(200) | ✅ |
-| projectForm | String | project_form | varchar(20) | ✅ |
-| isFinished | String | is_finished | char(1) | ✅ |
-| isSettled | String | is_settled | char(1) | ✅ |
-| sponsorAdminUserId | Long | sponsor_admin_user_id | bigint | ✅ |
-| leadUserId | Long | lead_user_id | bigint | ✅ |
-| isBidProject | String | is_bid_project | char(1) | ✅ |
-| createBy/createTime | | (BaseEntity) | | ✅ |
-| manageFee | BigDecimal | manage_fee | decimal(15,2) | ✅ |
-| startTime | Date | start_time | datetime | ✅ 已修 (2026-08-18, 加 @JsonFormat, 见 §修复记录) |
-| endTime | Date | end_time | datetime | ✅ 已修 (2026-08-18, 同上) |
-| submitDeadlineDays | Integer | submit_deadline_days | int | ✅ |
-| supportContractUrl / executeContractUrl / invitationUrl / supportLetterUrl / publishUrl | String | (同名 varchar(500)) | | ✅ |
-| assignedSessions | Long | ❌ **无对应字段** | — | ⚠️ **派生字段**,只在 executor 端 SQL 用 |
-| assignedAmount | BigDecimal | ❌ **无对应字段** | — | ⚠️ 同上 |
-| sponsorOrgName | String | ❌ **无对应字段** | — | ⚠️ JOIN biz_org 派生 |
-| execOrgName | String | ❌ **无对应字段** | — | ⚠️ 查询参数,不入库 |
-| execOrgNames | String | ❌ **无对应字段** | — | ⚠️ GROUP_CONCAT 派生 |
-| leadUserName | String | ❌ **无对应字段** | — | ⚠️ JOIN sys_user 派生 |
-| noticeUrl | String | ❌ **DDL 中不存在** | — | 🐛 **实体有但表无** |
-| scheduleUrl | String | ❌ **DDL 中不存在** | — | 🐛 同上 |
-| isPublished | String | ❌ **DDL 中不存在** | — | 🐛 同上,被 `confirmDeleteAnn` 当字段更新 |
-| publishTime | Date | ❌ **DDL 中不存在** | — | 🐛 同上 |
-| announcementType | String | ❌ **DDL 中不存在** | — | 🐛 同上 |
-| sponsorRating, sponsorQ1-4, sponsorRemark | | ❌ **DDL 中不存在** | — | 🐛 残留支持方评分字段,未使用 |
+| 实体字段 | 中文列名 (DB COMMENT) | 类型 | 表字段 | 类型 | 一致? |
+|---|---|---|---|---|---|
+| projectId | 项目ID | Long | project_id | bigint | ✅ 已修 (2026-08-18, 见 §修复记录) |
+| projectNo | 项目编号 ZH-2026-658 | String | project_no | varchar(50) | ✅ |
+| projectName | 项目名称 | String | project_name | varchar(200) | ✅ |
+| totalSessions | 总场次/总期数 | Long | total_sessions | int | ✅ |
+| doneSessions | 已执行 | Long | done_sessions | int | ✅ |
+| todoSessions | 未执行 | Long | todo_sessions | int | ✅ |
+| totalAmount | 总金额 | BigDecimal | total_amount | decimal(15,2) | ✅ |
+| availableAmount | 可用金额 | BigDecimal | available_amount | decimal(15,2) | ✅ |
+| paidLaborAmount | 已支付劳务费 | BigDecimal | paid_labor_amount | decimal(15,2) | ✅ |
+| paidMeetingAmount | 已支付会务费 | BigDecimal | paid_meeting_amount | decimal(15,2) | ✅ |
+| manageFee | 管理费及税金 | BigDecimal | manage_fee | decimal(15,2) | ✅ |
+| managerScore | 合规管理员评均分 | BigDecimal | manager_score | decimal(3,1) | ✅ |
+| sponsorScore | 支持方评均分 | BigDecimal | sponsor_score | decimal(3,1) | ✅ |
+| sponsorAdminUserName | 赞助方负责人用户名(冗余) | String | sponsor_admin_user_name | varchar(200) | ✅ |
+| sponsorAdminUserId | 赞助方负责人用户ID | Long | sponsor_admin_user_id | bigint | ✅ |
+| leadUserId | 项目负责人 user_id | Long | lead_user_id | bigint | ✅ |
+| projectForm | 项目形式 线上/线下/线上+线下/其他 | String | project_form | varchar(20) | ✅ |
+| isFinished | 是否结题 0否 1是 | String | is_finished | char(1) | ✅ |
+| isSettled | 是否结算 N否 Y是 | String | is_settled | char(1) | ✅ |
+| isBidProject | 是否招标项目 Y/N (默认 N) | String | is_bid_project | char(1) | ✅ |
+| startTime | 项目开始时间 | Date | start_time | datetime | ✅ 已修 (2026-08-18, 加 @JsonFormat, 见 §修复记录) |
+| endTime | 项目结束时间 | Date | end_time | datetime | ✅ 已修 (2026-08-18, 同上) |
+| submitDeadlineDays | 提交材料截止天数 | Integer | submit_deadline_days | int | ✅ |
+| supportContractUrl | 支持合同文件URL | String | support_contract_url | varchar(500) | ✅ |
+| executeContractUrl | 执行合同文件URL | String | execute_contract_url | varchar(500) | ✅ |
+| invitationUrl | 邀请函文件URL | String | invitation_url | varchar(500) | ✅ |
+| supportLetterUrl | 支持函文件URL | String | support_letter_url | varchar(500) | ✅ |
+| publishUrl | 已发布公告URL | String | publish_url | varchar(500) | ✅ |
+| createBy/createTime | 创建者 / 创建时间 | | (BaseEntity) | | ✅ |
+| updateBy/updateTime | 更新者 / 更新时间 | | (BaseEntity) | | ✅ |
+| assignedSessions | (派生) | Long | ❌ **无对应字段** | — | ⚠️ **派生字段**,只在 executor 端 SQL 用 |
+| assignedAmount | (派生) | BigDecimal | ❌ **无对应字段** | — | ⚠️ 同上 |
+| sponsorOrgName | (派生) | String | ❌ **无对应字段** | — | ⚠️ JOIN biz_org 派生 |
+| execOrgName | (派生) | String | ❌ **无对应字段** | — | ⚠️ 查询参数,不入库 |
+| execOrgNames | (派生) | String | ❌ **无对应字段** | — | ⚠️ GROUP_CONCAT 派生 |
+| leadUserName | (派生) | String | ❌ **无对应字段** | — | ⚠️ JOIN sys_user 派生 |
+| noticeUrl | (DDL 中不存在) | String | ❌ **DDL 中不存在** | — | 🐛 **实体有但表无** |
+| scheduleUrl | (DDL 中不存在) | String | ❌ **DDL 中不存在** | — | 🐛 同上 |
+| isPublished | (DDL 中不存在) | String | ❌ **DDL 中不存在** | — | 🐛 同上,被 `confirmDeleteAnn` 当字段更新 |
+| publishTime | (DDL 中不存在) | Date | ❌ **DDL 中不存在** | — | 🐛 同上 |
+| announcementType | (DDL 中不存在) | String | ❌ **DDL 中不存在** | — | � 同上 |
+| sponsorRating, sponsorQ1-4, sponsorRemark | (DDL 中不存在) | | ❌ **DDL 中不存在** | — | 🐛 残留支持方评分字段,未使用 |
 
 ### 修订标记