Merge docs/scrub-private-host-0702: 文档清除私有托管地址
Some checks failed
ci / build-test-parity (push) Has been cancelled
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -1,6 +1,6 @@
|
|||||||
# eip4-platform CI(Gitea Actions)。
|
# eip4-platform CI(Gitea Actions)。
|
||||||
#
|
#
|
||||||
# P0 修复(2026-06-24 架构评审):原 .github/workflows/ci.yml 在 Gitea(git.latent.chat)上是孤儿
|
# P0 修复(2026-06-24 架构评审):原 .github/workflows/ci.yml 在私有 Gitea 上是孤儿
|
||||||
# (GitHub Actions 不会跑),且 java-version 写死 17(项目 JDK21)。本文件迁到 Gitea 规范位置
|
# (GitHub Actions 不会跑),且 java-version 写死 17(项目 JDK21)。本文件迁到 Gitea 规范位置
|
||||||
# .gitea/workflows/,JDK 升 21。
|
# .gitea/workflows/,JDK 升 21。
|
||||||
#
|
#
|
||||||
|
|||||||
@@ -72,7 +72,7 @@
|
|||||||
|
|
||||||
## 5. Housekeeping
|
## 5. Housekeeping
|
||||||
- 本文 + design doc(补 D6/D7)commit 进 main。
|
- 本文 + design doc(补 D6/D7)commit 进 main。
|
||||||
- main 现领先 origin/main 20 提交(AI 合并 + 3 收口),**push = 用户决策**(两仓需先 add remote / git.latent.chat,见 memory `eip3-git-remotes-latentchat`)。
|
- main 现领先 origin/main 20 提交(AI 合并 + 3 收口),**push = 用户决策**(两仓需先 add remote 到私有托管,见 memory `eip3-git-remotes-latentchat`)。
|
||||||
- worktree `eip4-platform-ai-agent` 已与 main 同 commit,可清理。
|
- worktree `eip4-platform-ai-agent` 已与 main 同 commit,可清理。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|||||||
10
docs/新人上手.md
10
docs/新人上手.md
@@ -14,17 +14,17 @@
|
|||||||
|
|
||||||
## 1. 取码
|
## 1. 取码
|
||||||
|
|
||||||
> ⚠️ **托管现状**:三仓目前在项目负责人的**私人 Gitea**(git.latent.chat),**非团队基础设施**。
|
> ⚠️ **托管现状**:三仓目前在项目负责人的**私人 Git 托管**,**非团队基础设施**。
|
||||||
> 团队接手前需二选一:迁移到团队代码托管(届时本节地址与 CONTRIBUTING 的 CI 段随之更新),
|
> 团队接手前需二选一:迁移到团队代码托管(届时本节地址与 CONTRIBUTING 的 CI 段随之更新),
|
||||||
> 或由仓主开通协作者账号。CI runner 也应部署在团队侧而非个人机器。
|
> 或由仓主开通协作者账号。CI runner 也应部署在团队侧而非个人机器。
|
||||||
|
|
||||||
Gitea:`https://git.latent.chat`(**SSH 端口 2222**,`~/.ssh/config` 里给该 Host 配 `Port 2222`)。
|
取码地址与账号**向项目负责人索取**(当前为私有 Gitea,SSH 走非标准端口,需在 `~/.ssh/config` 为该 Host 配 `Port`)。
|
||||||
clone 三个仓到同一父目录(前后端脚本按兄弟目录相互引用):
|
clone 三个仓到同一父目录(前后端脚本按兄弟目录相互引用):
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone git.latent.chat:zhengweirong/eip4-platform.git
|
git clone <GIT_HOST>:<OWNER>/eip4-platform.git
|
||||||
git clone git.latent.chat:zhengweirong/eip4-web.git
|
git clone <GIT_HOST>:<OWNER>/eip4-web.git
|
||||||
git clone git.latent.chat:zhengweirong/amis-fork.git # 渲染 SDK 源,日常开发只读,可后取
|
git clone <GIT_HOST>:<OWNER>/amis-fork.git # 渲染 SDK 源,日常开发只读,可后取
|
||||||
```
|
```
|
||||||
|
|
||||||
## 2. 后端:构建 + 开发库 + 起服务
|
## 2. 后端:构建 + 开发库 + 起服务
|
||||||
|
|||||||
@@ -123,7 +123,7 @@ classpath:`mvn -pl platform-converter dependency:build-classpath -Dmdep.output
|
|||||||
|
|
||||||
**live 验证(浏览器 dogfood,决定性证据)**:navigate `/page/71de2065...` 独立渲染表单 → 选组织「名城分公司」→ 网络实证 `GET /api/picker/SYS_DEPART/list?...&PARENTORGID=402881...0006` 自动重拉、部门下拉只显「名城分公司>经理室」→ 选该部门 → `GET .../SYS_POSITION/list?...&PARENTDEPARTID=402881...0063`、岗位下拉只显「经理室>科员/经理」。API 层亦验证(部门 48→28、岗位 75→6,匹配 DB)。「添加」按钮弹窗正常打开渲染该表单(无 bug;先前点击没弹是页面未就绪的时序问题,刷新后正常)。
|
**live 验证(浏览器 dogfood,决定性证据)**:navigate `/page/71de2065...` 独立渲染表单 → 选组织「名城分公司」→ 网络实证 `GET /api/picker/SYS_DEPART/list?...&PARENTORGID=402881...0006` 自动重拉、部门下拉只显「名城分公司>经理室」→ 选该部门 → `GET .../SYS_POSITION/list?...&PARENTDEPARTID=402881...0063`、岗位下拉只显「经理室>科员/经理」。API 层亦验证(部门 48→28、岗位 75→6,匹配 DB)。「添加」按钮弹窗正常打开渲染该表单(无 bug;先前点击没弹是页面未就绪的时序问题,刷新后正常)。
|
||||||
|
|
||||||
**部署**:转换器=schema 改动,重转 + 只导这 4 页(避免 24 噪声页 churn)即时生效;PickerController=后端改动,**已 `mvn -pl platform-app -am clean package` 重建 + 重启 8093**(新 jar 验含 `applyColumnFilters`)。备份 `/tmp/platform-app-NEW-filterscript.jar`、回滚 `/tmp/platform-app-BACKUP-running.jar`。converter 149 测试绿 + PickerControllerTest 26 绿。**改动未提交**(TemplateToAmisConverter/PickerController + 2 测试,叠加在上一轮 7 文件之上;eip4-platform 现有远程 git.latent.chat)。
|
**部署**:转换器=schema 改动,重转 + 只导这 4 页(避免 24 噪声页 churn)即时生效;PickerController=后端改动,**已 `mvn -pl platform-app -am clean package` 重建 + 重启 8093**(新 jar 验含 `applyColumnFilters`)。备份 `/tmp/platform-app-NEW-filterscript.jar`、回滚 `/tmp/platform-app-BACKUP-running.jar`。converter 149 测试绿 + PickerControllerTest 26 绿。**改动未提交**(TemplateToAmisConverter/PickerController + 2 测试,叠加在上一轮 7 文件之上;eip4-platform 现有私有远程)。
|
||||||
|
|
||||||
**剩余(P2/P3)**:P2 AUTOGENERATECODE 账号自动生成(USERORGID change 调取号端点 → bind ACCOUNT,需补后端取号端点)+ MASTERDEPART 改变设 MASTERPOSITION 必填(可 `requiredOn`);P3 非模式脚本走 `/api/script/execute-template-by-name` 运行时兜底。
|
**剩余(P2/P3)**:P2 AUTOGENERATECODE 账号自动生成(USERORGID change 调取号端点 → bind ACCOUNT,需补后端取号端点)+ MASTERDEPART 改变设 MASTERPOSITION 必填(可 `requiredOn`);P3 非模式脚本走 `/api/script/execute-template-by-name` 运行时兜底。
|
||||||
|
|
||||||
|
|||||||
@@ -196,7 +196,7 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
|
|||||||
| **RCE — `/api/script/execute` + `/api/poc/write-test`** | ✅ 已修(06-25) | `ScriptExecuteController.java:65→:193-198` 真执行请求体 Groovy(不受 facade 绑定约束=任意 Java/RCE),无 `@Profile`、无鉴权;`PocWriteTestController.java:181` `jdbcTemplate.execute("DROP TABLE IF EXISTS "+target)` 裸拼旁路 `DropTableSqlGuard`,无 `@Profile`。三个 `Poc*Controller` + 散落 `/api/poc/*` 随生产 jar 装配;全平台 `@PreAuthorize` 0 命中且无 `@EnableMethodSecurity` | 生产构建移除 / `@Profile("!prod")` 隔离全部 `Poc*`/`ScriptExecute` 端点;保留者加平台管理员级鉴权(开 `@EnableMethodSecurity`);新增 ArchUnit 规则禁生产源码出现 `Poc*` 的 `@RestController` |
|
| **RCE — `/api/script/execute` + `/api/poc/write-test`** | ✅ 已修(06-25) | `ScriptExecuteController.java:65→:193-198` 真执行请求体 Groovy(不受 facade 绑定约束=任意 Java/RCE),无 `@Profile`、无鉴权;`PocWriteTestController.java:181` `jdbcTemplate.execute("DROP TABLE IF EXISTS "+target)` 裸拼旁路 `DropTableSqlGuard`,无 `@Profile`。三个 `Poc*Controller` + 散落 `/api/poc/*` 随生产 jar 装配;全平台 `@PreAuthorize` 0 命中且无 `@EnableMethodSecurity` | 生产构建移除 / `@Profile("!prod")` 隔离全部 `Poc*`/`ScriptExecute` 端点;保留者加平台管理员级鉴权(开 `@EnableMethodSecurity`);新增 ArchUnit 规则禁生产源码出现 `Poc*` 的 `@RestController` |
|
||||||
| **安全默认 fail-open** | ✅ 已修(06-25) | `SecurityConfig.java:68-71` `@Profile("!prod")`→`anyRequest().permitAll()`(default/local/ci/dev 全放行);prod 严格链(`:50-61`)存在但仅 `@Profile("prod")`,且**仓内无 `application-prod.yml`**=prod 必须显式激活否则默认洞开;`JwtService.java:44-55` 仅校验长度,`application.yml:29` dev 默认密钥能静默签发可伪造令牌 | 补 `application-prod.yml`(JWT secret 强制环境变量、缺省启动失败);**反转 fail-safe**:未知/无 profile 默认走严格链,`permitAll` 收窄到仅 `local\|ci\|test`;prod 若 JWT secret 仍为 dev 默认值则 fail-fast |
|
| **安全默认 fail-open** | ✅ 已修(06-25) | `SecurityConfig.java:68-71` `@Profile("!prod")`→`anyRequest().permitAll()`(default/local/ci/dev 全放行);prod 严格链(`:50-61`)存在但仅 `@Profile("prod")`,且**仓内无 `application-prod.yml`**=prod 必须显式激活否则默认洞开;`JwtService.java:44-55` 仅校验长度,`application.yml:29` dev 默认密钥能静默签发可伪造令牌 | 补 `application-prod.yml`(JWT secret 强制环境变量、缺省启动失败);**反转 fail-safe**:未知/无 profile 默认走严格链,`permitAll` 收窄到仅 `local\|ci\|test`;prod 若 JWT secret 仍为 dev 默认值则 fail-fast |
|
||||||
| **`asUser/roles` 越权(prod 同样生效)** | ✅ 已修(06-25) | `EntityController.java:222-241` 客户端 `asUser/roles`(无 `@Profile` 的 `@RequestParam`)**优先于** `:247` JWT 绑定的 `UserSession.get()`,直驱 `DataPrivilegeServiceImpl` 行级数据权限,不校验是否等于 JWT 主体 | `asUser/roles` 测试通道 `@Profile("!prod")` 硬隔离;prod 引擎身份只能来自 JWT;确需 impersonation 须校验调用者持 `IMPERSONATE` 角色 |
|
| **`asUser/roles` 越权(prod 同样生效)** | ✅ 已修(06-25) | `EntityController.java:222-241` 客户端 `asUser/roles`(无 `@Profile` 的 `@RequestParam`)**优先于** `:247` JWT 绑定的 `UserSession.get()`,直驱 `DataPrivilegeServiceImpl` 行级数据权限,不校验是否等于 JWT 主体 | `asUser/roles` 测试通道 `@Profile("!prod")` 硬隔离;prod 引擎身份只能来自 JWT;确需 impersonation 须校验调用者持 `IMPERSONATE` 角色 |
|
||||||
| **CI 孤儿=自动回归实质为零** | ✅ 已修(06-25) | `eip4-platform/.github/workflows/ci.yml` 是 GitHub Actions 语法但 origin=`git.latent.chat`(Gitea 不执行 GHA);`java-version "17"` 写死(项目 JDK21,即便能跑也编译失败=从未真跑过);`eip4-web` 无任何 CI | 把 `scripts/ci.sh` 迁成 `.gitea/workflows/ci.yml`(JDK 改 21)或公司 Jenkins;前端加最小 CI(vitest + `tsc -b`);Gitea 配 branch protection。**理由:P0 安全项修完后没有门禁防再退化。** |
|
| **CI 孤儿=自动回归实质为零** | ✅ 已修(06-25) | `eip4-platform/.github/workflows/ci.yml` 是 GitHub Actions 语法但 origin=私有 Gitea(不执行 GHA);`java-version "17"` 写死(项目 JDK21,即便能跑也编译失败=从未真跑过);`eip4-web` 无任何 CI | 把 `scripts/ci.sh` 迁成 `.gitea/workflows/ci.yml`(JDK 改 21)或公司 Jenkins;前端加最小 CI(vitest + `tsc -b`);Gitea 配 branch protection。**理由:P0 安全项修完后没有门禁防再退化。** |
|
||||||
|
|
||||||
### 10.2 P1 — 稳定性 / 交付能力 / 验证体系 / 可维护性
|
### 10.2 P1 — 稳定性 / 交付能力 / 验证体系 / 可维护性
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user