admin/guoju0808
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(manager_projects): §6.3 加中文列名列 (DB COMMENT 优先, 加速类型不一致排查)

Browse Source 
每行从 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 一目了然。
This commit is contained in:
郭庆泰
2026-08-18 22:17:28 +08:00
parent c3b6212478
commit 7c9e5c373a
1 changed files with 44 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files
_self/manager_projects.md
+44 -39
View File
@@ -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 中不存在** | — | 🐛 残留支持方评分字段,未使用 |
### 修订标记