|
8
|
2
|
8
|
1
|
|
0
|
代码审查报告：main 分支 - 测试提交内容21
|
## 代码审查自动报告
**分支**: main
**提交**: 930eca9fb53f66e8 ## 代码审查自动报告
**分支**: main
**提交**: 930eca9fb53f66e8bd5c691867946eecb08d648e
**时间**: 2026-03-17 10:25:46
[2026-03-17 10:24:16] 正在调用 Qwen API 进行代码审查...
## 📋 审查摘要
- **变更文件数**: 1
- **主要变更**: 修改了 `pc/index.php` 入口文件，增加了基于 URL 路径的分支名称识别逻辑（`BRANCHNAME`），定义了多个新的项目常量（如 `BASE_URL`, `COMMONCLASS` 等），并保留了 CodeIgniter 框架的基础引导代码。但代码中混入了大量无效字符和调试信息。
## 🐛 发现的问题
### 问题 1: 致命语法错误 (Syntax Error)
- **严重程度**: 严重
- **文件**: pc/index.php
- **行号**: 第 4, 5, 8 行左右
- **问题描述**: 代码中混入了非 PHP 语法的随机文本，这将导致 PHP 解析失败，网站无法访问（500 错误）。
- 第 4 行：`define('BASE_DOMAIN', 'g-hi');sss 所得到的`
- 第 5 行：`define('DEBUG_VERSION','test-');dwdwdw`
- 第 8 行：`$pattern='/pc-(.*?)\//is';收拾收拾`
- PHP 无法识别分号后的 `sss 所得到的`、`dwdwdw`、`收拾收拾` 等字符，会抛出 Parse Error。
- **建议修复**: 删除所有语句末尾的无关文本，确保每行 PHP 代码语法纯净。
```php
// 修复后示例
define('BASE_DOMAIN', 'g-hi');
define('DEBUG_VERSION', 'test-');
$pattern = '/pc-(.*?)\//is';
```
### 问题 2: 环境变量安全风险 (Environment Security)
- **严重程度**: 高
- **文件**: pc/index.php
- **行号**: 约 65 行
- **问题描述**: `ENVIRONMENT` 常量直接依赖于 `$_SERVER['CI_ENV']`。
```php
define('ENVIRONMENT', isset($_SERVER['CI_ENV']) ? $_SERVER['CI_ENV'] : 'development');
```
如果服务器配置不当（如 CGI/FastCGI 配置问题），攻击者可能通过伪造请求头或环境变量将环境强制设置为 `development`。这将导致 `display_errors` 被开启，敏感信息（路径、SQL 语句、堆栈跟踪）可能泄露给终端用户。
- **建议修复**:
1. 在生产环境中，建议在 Web 服务器配置（Nginx/Apache）中固定 `CI_ENV` 环境变量，而不是在 PHP 代码中信任 `$_SERVER`。
2. 或者在 PHP 中对 `$_SERVER['CI_ENV']` 的值进行白名单验证。
```php
$env = isset($_SERVER['CI_ENV']) ? $_SERVER['CI_ENV'] : 'production';
if (!in_array($env, ['development', 'testing', 'production'])) {
$env = 'production';
}
define('ENVIRONMENT', $env);
```
### 问题 3: 硬编码绝对路径 (Hardcoded Paths)
- **严重程度**: 中等
- **文件**: pc/index.php
- **行号**: 约 75-78 行
- **问题描述**: 代码中硬编码了服务器特定的绝对路径，如 `/mnt/data/www/CommonClass` 和 `/mnt/data/`。
```php
define('MNTDATA', dirname(ROOTWEB).DIRECTORY_SEPARATOR);//mnt/data/
define('COMMONCLASS', "/mnt/data/www/CommonClass".DIRECTORY_SEPARATOR);
```
这导致代码缺乏可移植性，如果部署到其他服务器或目录结构变更，代码将失效。
- **建议修复**: 使用相对路径，或将这些路径配置移到独立的配置文件（如 `config.php`）中，根据不同环境加载不同配置。
### 问题 4: 代码整洁度与调试残留 (Code Cleanliness)
- **严重程度**: 轻微
- **文件**: pc/index.php
- **行号**: 第 3 行，第 80 行等
- **问题描述**: 存在无意义的注释和调试残留。
- 第 3 行：`//ssssss`
- 第 80 行：`//17.3.9 增加几个定义`
- 第 4 行注释中混入中文文本 `sss 所得���的`（除了导致语法错误外，也是脏数据）。
- **建议修复**: 清理所有无意义的注释和调试代码，保持代码库整洁。
### 问题 5: URL 路径解析逻辑潜在风险
- **严重程度**: 中等
- **文件**: pc/index.php
- **行号**: 约 6-12 行
- **问题描述**: 使用 `$_SERVER['PHP_SELF']` 进行正则匹配来获取分支名。
```php
$now_url = str_replace("/index.php","",$_SERVER['PHP_SELF']);
preg_match($pattern, $now_url, $preg_url);
// ...
define('BRANCHNAME',"pc-".$preg_url[1]);
```
`$_SERVER['PHP_SELF']` 在某些服务器配置下可能被用户操纵（尽管较难）。如果 `BRANCHNAME` 后续被用于文件包含、数据库表名拼接等操作，可能存在注入风险。
- **建议修复**: 对 `$preg_url[1]` 进行严格的白名单验证（如只允许字母数字），确保 `BRANCHNAME` 安全。
## ✅ 代码亮点
- **路径存在性检查**: 代码中包含了对 `system`、`application` 和 `view` 目录是否存在的有效检查，并在检查失败时返回 503 状态码，这有助于避免服务器暴露内部错误信息。
- **错误报告分级**: 根据 `ENVIRONMENT` 不同设置了不同的 `error_reporting` 级别，符合最佳实践（尽管 `ENVIRONMENT` 的设定方式有待改进）。
## 📝 总体建议
当前代码**不可直接部署**，因为存在致命的语法错误，会导致网站立即瘫痪。
1. **紧急修复**: 首先必须删除所有导致语法错误的垃圾文本（`sss 所得到的` 等）。
2. **安全加固**: 重新评估 `ENVIRONMENT` 的设定方式，防止生产环境被意外切换为调试模式。
3. **配置分离**: 建议将硬编码的路径和域名配置提取到单独的配置文件中，便于多环境管理。
4. **代码清理**: 提交前请运行代码格式化工具，并删除所有调试注释。
5. **输入验证**: 对从 URL 解析出的分支名称进行验证，防止潜在的逻辑注入。
建议在修复上述问题后，再进行本地测试和代码审查。
---
*此 Issue 由代码审查服务自动创建*
...
|
0
|
0
|
0
|
0
|
0
|
|
0
|
1773714346
|
1773714346
|
0
|
0
|
0
|
0
|
Edit
Delete
|
|
5
|
2
|
5
|
1
|
|
0
|
代码审查报告：main 分支 - 测试提交内容2
|
## 代码审查自动报告
**分支**: main
**提交**: e81717d4e0161b88 ## 代码审查自动报告
**分支**: main
**提交**: e81717d4e0161b8859cf8a712eeb882a87987e78
**时间**: 2026-03-17 10:21:46
[2026-03-17 10:21:19] 正在调用 Qwen API 进行代码审查...
## 📋 审查摘要
- 变更文件数：1
- 主要变更：修改了 `pc/index.php` 入口文件，添加了分支路径识别逻辑、多个常量定义，保留了 CodeIgniter 框架初始化代码
## 🐛 发现的问题
### 问题 1: 存在明显的调试/垃圾代码未清理
- **严重程度**: 中等
- **文件**: pc/index.php
- **行号**: 2-4
- **问题描述**: 代码开头存在明显的调试痕迹和垃圾字符，如 `//ssssss`、`sss 所得到的`、`dwdwdw` 等，这表明代码未经过清理就提交了
- **建议修复**: 删除所有调试注释和无意义字符，保持代码整洁
### 问题 2: $_SERVER['PHP_SELF'] 未做安全过滤
- **严重程度**: 严重
- **文件**: pc/index.php
- **行号**: 5
- **问题描述**: 直接使用 `$_SERVER['PHP_SELF']` 获取 URL 路径，该变量可被用户操控，存在 XSS 和路径注入风险
- **建议修复**: 使用 `filter_input()` 或对输入进行白名单验证，例如：
```php
$now_url = filter_input(INPUT_SERVER, 'PHP_SELF', FILTER_SANITIZE_URL);
```
### 问题 3: 正则表达式存在潜在安全风险
- **严重程度**: 中等
- **文件**: pc/index.php
- **行号**: 6-7
- **问题描述**: `preg_match` 使用用户可控的 URL 路径作为输入，正则模式 `/pc-(.*?)\//is` 可能被恶意构造的路径绕过或导致意外匹配
- **建议修复**: 对匹配结果进行白名单验证，限制分支名称只能包含字母、数字、下划线：
```php
if(isset($preg_url[1]) && !empty($preg_url[1]) && preg_match('/^[a-zA-Z0-9_-]+$/', $preg_url[1])){
```
### 问题 4: 敏感信息硬编码
- **严重程度**: 严重
- **文件**: pc/index.php
- **行号**: 3, 185-191
- **问题描述**: 域名、路径、OSS 地址等敏感配置硬编码在代码中，不同环境需要修改代码，且可能泄露基础设施信息
- **建议修复**: 将配置移至独立配置文件或环境变量，例如：
```php
define('BASE_DOMAIN', getenv('BASE_DOMAIN') ?: 'g-hi');
```
### 问题 5: 开发环境配置可能泄露到生产环境
- **严重程度**: 严重
- **文件**: pc/index.php
- **行号**: 108-110
- **问题描述**: `error_reporting(-1)` 和 `ini_set('display_errors', 1)` 在 development 模式下会显示所有错误，如果 ENVIRONMENT 判断被绕过，敏感信息将泄露
- **建议修复**: 确保生产环境强制关闭错误显示，添加额外的环境检测机制
### 问题 6: 常量定义重复
- **严重程度**: 轻微
- **文件**: pc/index.php
- **行号**: 185, 189
- **问题描述**: `BASE_URL` 和 `PC_BASE_URL` 定义完全相同，造成冗余
- **建议修复**: 删除重复定义，或明确区分两者用途
### 问题 7: 路径常量依赖特定服务器结构
- **严重程度**: 中等
- **文件**: pc/index.php
- **行号**: 179-182
- **问题描述**: `MNTDATA`、`COMMONCLASS` 等路径硬编码为 `/mnt/data/`，在不同服务器环境下会导致路径错误
- **建议修复**: 使用相对路径或可配置的路径前缀
### 问题 8: 缺少输入验证和错误处理
- **严重程度**: 中等
- **文件**: pc/index.php
- **行号**: 8-15
- **问题描述**: 分支名称提取后没有验证合法性，可能注入恶意值到常量中
- **建议修复**: 添加分支名称白名单验证，限制长度和字符集
## ✅ 代码亮点
- 保留了 CodeIgniter 框架的标准初始化结构
- 对不同环境（development/testing/production）做了错误报告区分
- 添加了路径存在性检查，避免静默失败
## 📝 总体建议
**代码质量评级：⚠️ 需要重大改进**
主要问题集中在：
1. **安全性**：多处用户输入未过滤，存在注入风险
2. **代码整洁度**：包含大量调试垃圾代码
3. **可维护性**：硬编码过多，不利于多环境部署
**优先修复建议**：
1. 立即清理调试代码和垃圾字符
2. 对所有用户输入进行严格验证和过滤
3. 将配置项移至独立配置文件
4. 添加分支名称的白名单验证机制
5. 确保生产环境不会泄露错误信息
建议在合并前进行安全测试，特别是针对 URL 参数注入和路径遍历的测试。
---
*此 Issue 由代码审查服务自动创建*
...
|
0
|
0
|
0
|
0
|
0
|
|
0
|
1773714106
|
1773714106
|
0
|
0
|
0
|
0
|
Edit
Delete
|
|
6
|
2
|
6
|
1
|
|
0
|
代码审查报告：main 分支 - 测试提交内容2
|
## 代码审查自动报告
**分支**: main
**提交**: e81717d4e0161b88 ## 代码审查自动报告
**分支**: main
**提交**: e81717d4e0161b8859cf8a712eeb882a87987e78
**时间**: 2026-03-17 10:22:17
[2026-03-17 10:21:19] 正在调用 Qwen API 进行代码审查...
## 📋 审查摘要
- **变更文件数**: 1
- **主要变更**: 修改了 `pc/index.php` 入口文件，增加了动态分支名称定义、域名配置及一些硬编码路径，但引入了严重的语法错误和安全隐患。
## 🐛 发现的问题
### 问题 1: 严重的语法错误与输出污染 (Critical)
- **严重程度**: 严重
- **文件**: pc/index.php
- **行号**: 4-5
- **问题描述**: 代码中存在明显的调试残留文本 `sss 所得到的` 和 `dwdwdw` 直接写在 `define` 语句之后。
```php
define('BASE_DOMAIN', 'g-hi');sss 所得到的
define('DEBUG_VERSION','test-');dwdwdw
```
在 PHP 中，这些文本会被视为直接输出到浏览器。由于 `index.php` 是入口文件，这会导致在发送任何 HTTP 头（如 `header()` 重定向或错误码）之前就有输出，从而引发 **"Headers already sent"** 错误，导致整个应用无法正常运行。
- **建议修复**: 删除所有非代码的残留文本，确保 PHP 语句后没有多余字符，或将其放入注释中。
```php
define('BASE_DOMAIN', 'g-hi');
define('DEBUG_VERSION', 'test-');
```
### 问题 2: 环境变量可被用户伪造 (Security)
- **严重程度**: 严重
- **文件**: pc/index.php
- **行号**: 67
- **问题描述**: 环境变量 `ENVIRONMENT` 直接依赖于 `$_SERVER['CI_ENV']`。
```php
define('ENVIRONMENT', isset($_SERVER['CI_ENV']) ? $_SERVER['CI_ENV'] : 'development');
```
在某些服务器配置下，攻击者可以通过发送自定义 HTTP 头（如 `CI_ENV`）来伪造此变量。如果攻击者将其设置为 `development`，会导致 `display_errors` 开启，泄露服务器路径、SQL 语句等敏感信息。且默认值为 `development`，生产环境风险极高。
- **建议修复**: 不要直接从用户可控的 `$_SERVER` 变量中读取环境配置。应在服务器层面（如 Nginx/Apache 配置或 `.env` 文件）设置环境变量，并在代码中白名单验证。
```php
$env = $_SERVER['CI_ENV'] ?? 'production';
if (!in_array($env, ['development', 'testing', 'production'])) {
$env = 'production';
}
define('ENVIRONMENT', $env);
```
### 问题 3: 不安全的 URL 解析逻辑 (Logic/Security)
- **严重程度**: 中等
- **文件**: pc/index.php
- **行号**: 7-14
- **问题描述**: 使用 `$_SERVER['PHP_SELF']` 和正则表达式来解析分支名称。
```php
$now_url = str_replace("/index.php","",$_SERVER['PHP_SELF']);
$pattern='/pc-(.*?)\//is';
preg_match($pattern, $now_url, $preg_url);
```
`$_SERVER['PHP_SELF']` 在某些配置下可被用户操纵。此外，依赖 URL 路径结构来定义常量（`BRANCHNAME`）非常脆弱，一旦 URL 重写规则变化，逻辑就会失效。
- **建议修复**: 分支逻辑应通过配置文件或服务器环境变量管理，而不是在入口文件中解析 URL。如果必须解析，请使用更安全的 `$_SERVER['REQUEST_URI']` 并进行严格过滤。
### 问题 4: 硬编码绝对路径 (Maintainability)
- **严重程度**: 中等
- **文件**: pc/index.php
- **行号**: 135
- **问题描述**: 代码中硬编码了服务器绝对路径 `/mnt/data/www/CommonClass`。
```php
define('COMMONCLASS', "/mnt/data/www/CommonClass".DIRECTORY_SEPARATOR);
```
这导致代码无法在其他目录结构不同���服务器（如开发环境、测试环境）上运行，降低了可移植性。
- **建议修复**: 使用相对路径，或通过独立的配置文件（如 `config.php`）根据当前服务器环境定义路径。
### 问题 5: 调试代码未清理 (Code Quality)
- **严重程度**: 轻微
- **文件**: pc/index.php
- **行号**: 3
- **问题描述**: 存在无意义的调试注释 `//ssssss`。
- **建议修复**: 提交前清理所有无关注释和调试代码，保持代码整洁。
## ✅ 代码亮点
- **目录检查**: 保留了 CodeIgniter 标准的系统目录和应用目录存在性检查，并在失败时返回 503 状态码，这有助于防止因路径配置错误导致的白屏。
- **错误报告分级**: 根据环境不同设置了不同的错误报告级别，符合基本的安全实践（尽管环境变量的获取方式有问题）。
## 📝 总体建议
当前代码**不可直接发布到生产环境**。
1. **紧急修复**: 必须立即删除第 4-5 行的垃圾文本，否则网站将无法访问（报 500 错误或 Headers already sent）。
2. **安全加固**: 严禁通过 `$_SERVER` 直接控制 `ENVIRONMENT`，这是高危漏洞。请改为读取服务器固定配置。
3. **配置分离**: 将域名、路径、分支名等配置移入独立的配置文件（如 `application/config/config.php`），保持入口文件 `index.php` 的纯净。
4. **代码清理**: 提交前请运行代码格式化工具，并移除所有调试残留。
建议将此变更回退，修复上述严重问题后再重新提交。
---
*此 Issue 由代码审查服务自动创建*
...
|
0
|
0
|
0
|
0
|
0
|
|
0
|
1773714137
|
1773714137
|
0
|
0
|
0
|
0
|
Edit
Delete
|
|
3
|
2
|
3
|
1
|
|
0
|
代码审查报告：main 分支 - 测试提交内容
|
## 代码审查自动报告
**分支**: main
**提交**: e8a92e1ba30259f2 ## 代码审查自动报告
**分支**: main
**提交**: e8a92e1ba30259f2607d811af202d67a1e14c6f6
**时间**: 2026-03-17 10:17:02
[2026-03-17 10:16:28] 正在调用 Qwen API 进行代码审查...
## 📋 审查摘要
- 变更文件数：0 (未提供实际代码 diff)
- 主要变更：仅提供了工作目录和仓库 URL 的日志元数据，未包含任何实际的代码变更内容。
## 🐛 发现的问题
### 问题 1: 缺少实际的代码变更内容
- **严重程度**: 严重
- **文件**: 输入内容
- **行号**: 全部
- **问题描述**: 提供的文本片段仅为执行日志或环境元数据（包含时间戳、工作目录、仓库 URL），不包含任何编程语言源代码、Git diff 标记（如 `+`, `-`, `diff --git` 等）或文件路径变更。无法进行逻辑、安全或质量审查。
- **建议修复**: 请提供实际的 `git diff` 输出内容，或具体文件的代码变更片段，以便进行有效的代码审查。
### 问题 2: 潜在的信息泄露风险
- **严重程度**: 轻微
- **文件**: 输入文本
- **行号**: 2
- **问题描述**: 文本中暴露了具体的内部仓库 URL (`https://gitea.g-hi.com/juhai/testpc.git`)。如果这是内部私有仓库，将其发送给外部 AI 服务可能存在信息泄露风险。
- **建议修复**: 在分享日志或配置信息时，建议对内部域名、IP 地址、仓库路径等敏感信息进行脱敏处理（例如替换为 `example.com` 或 `***`）。
### 问题 3: 系统时间异常（观察项）
- **严重程度**: 轻微
- **文件**: 输入文本
- **行号**: 1
- **问题描述**: 日志时间显示为 `2026-03-17`，这是一个未来时间。这可能意味着生成该日志的系统时钟配置错误，或者是测试用的模拟数据。
- **建议修复**: 检查生成该日志的服务器或容器系统时间设置，确保时间同步准确，以免影响日志审计和证书验证。
## ✅ 代码亮点
- 无实际代码可供评估。
## 📝 总体建议
当前提供的输入内容**无法进行代码审查**。这看起来像是 CI/CD 流水线或脚本执行时的日志头信息，而不是代码变更本身。
为了获得有效的审查结果，请补充以下信息：
1. **实际的代码 Diff**：使用 `git diff HEAD~1` 或类似命令生成的具体内容。
2. **具体的文件路径**：指明哪些文件被修改。
3. **上下文信息**：如果可能，说明这次变更的业务目的。
请注意信息安全，避免在公共渠道泄露内部仓库地址和系统路径。
---
*此 Issue 由代码审查服务自动创建*
...
|
0
|
0
|
0
|
0
|
0
|
|
0
|
1773713822
|
1773713822
|
0
|
0
|
0
|
0
|
Edit
Delete
|
|
4
|
2
|
4
|
1
|
|
0
|
代码审查报告：main 分支 - 测试提交内容
|
## 代码审查自动报告
**分支**: main
**提交**: e8a92e1ba30259f2 ## 代码审查自动报告
**分支**: main
**提交**: e8a92e1ba30259f2607d811af202d67a1e14c6f6
**时间**: 2026-03-17 10:17:07
[2026-03-17 10:16:27] 正在调用 Qwen API 进行代码审查...
## 📋 审查摘要
- 变更文件数：0 (未提供实际源代码文件)
- 主要变更：提供的内容为执行日志或环境元数据，而非代码差异（Diff）
## 🐛 发现的问题
### 问题 1: 缺少实际源代码变更
- **严重程度**: 严重
- **文件**: 无
- **行号**: N/A
- **问题描述**: 提供的“代码变更内容”实际上是一段日志输出或环境信息，不包含任何编程语言（如 Python, Java, C++ 等）的源代码差异。无法对逻辑、算法、性能或具体的代码规范进行审查。
- **建议修复**: 请提供实际的 `git diff` 输出或源代码文件变更内容，以便进行有效的技术审查。
### 问题 2: 潜在的信息泄露风险
- **严重程度**: 中等
- **文件**: 日志/配置输出
- **行号**: 第 2 行
- **问题描述**: 日志中暴露了内部仓库 URL (`https://gitea.g-hi.com/juhai/testpc.git`) 和临时工作目录路径 (`/tmp/tmp.8GvVjC6ZU0`)。如果此日志被公开或在非受控环境中输出，可能泄露内部基础设施结构或项目命名规范。
- **建议修复**: 在生产环境或公开日志中，建议脱敏内部域名和具体路径信息。确保日志级别配置正确，避免敏感信息泄露。
### 问题 3: 时间戳异常
- **严重程度**: 轻微
- **文件**: 日志/配置输出
- **行号**: 第 1-2 行
- **问题描述**: 日志时间戳显示为 `2026-03-17`，这是一个未来时间（相对于当前实际时间）。这可能表明系统时钟配置错误、测试数据硬编码，或者是模拟数据。
- **建议修复**: 检查生成该日志的系统时钟同步设置（如 NTP），或确认是否为测试用的 Mock 数据。如果是生产代码，需确保时间源准确。
### 问题 4: 格式不符合 Diff 规范
- **严重程度**: 轻微
- **文件**: 输入内容
- **行号**: 全部
- **问题描述**: 提供的内容标记为 `diff` 代码块，但实际内容不包含标准的 Diff 格式头（如 `diff --git`, `index`, `---`, `+++`, `@@` 等）。这会导致自动化审查工具无法解析。
- **建议修复**: 确保使用 `git diff` 或类似工具生成标准的差异文件后再提交审查。
## ✅ 代码亮点
- 无实际代码可供评估。
## 📝 总体建议
本次提交的内容**无法进行有效的代码质量审查**，因为缺少实际的源代码变更。
1. **补充材料**：请重新提交包含实际代码逻辑变更的 Diff 内容。
2. **安全意识**：注意检查日志系统，避免将内部仓库地址、临时路径等基础设施信息打印到标准输出或公共日志中。
3. **环境检查**：核实生成日志的系统时间配置，确保时间戳准确，以免影响日志审计和故障排查。
请提供正确的代码变更内容后，我将很乐意为您进行详细的审查。
---
*此 Issue 由代码审查服务自动创建*
...
|
0
|
0
|
0
|
0
|
0
|
|
0
|
1773713827
|
1773713827
|
0
|
0
|
0
|
0
|
Edit
Delete
|
|
1
|
2
|
1
|
1
|
|
0
|
代码审查报告：main 分支 - 111122
|
## 代码审查自动报告
**分支**: main
**提交**: 29b5655925cbfa8c ## 代码审查自动报告
**分支**: main
**提交**: 29b5655925cbfa8c56c5447ee5bb8dc020b74c5b
**时间**: 2026-03-17 10:12:36
[2026-03-17 10:11:59] 正在调用 Qwen API 进行代码审查...
## 📋 审查摘要
- 变更文件数：0 (未提供实际代码文件)
- 主要变更：仅提供了构建/运行环境的日志信息（工作目录、仓库 URL），**未包含任何实际的源代码变更内容（Diff）**。
## 🐛 发现的问题
### 问题 1: 缺失实际代码变更内容
- **严重程度**: 严重
- **文件**: N/A (输入内容)
- **行号**: 全部
- **问题描述**: 提供的文本仅为 CI/CD 或脚本执行的日志头信息，不包含任何编程语言（如 Python, Java, Go 等）的代码逻辑、Diff 对比或文件修改内容。无法进行逻辑、性能或安全性审查。
- **建议修复**: 请提供实际的 `git diff` 输出内容，或直接粘贴修改过的源代码文件内容。
### 问题 2: 潜在敏感信息泄露
- **严重程度**: 中等
- **文件**: 日志信息
- **行号**: 第 2 行
- **问题描述**: 日志中包含了内部仓库 URL (`https://gitea.g-hi.com/juhai/testpc.git`)。如果这是企业内部私有仓库，将其暴露在公共网络或 AI 对话中可能存在信息泄露风险。
- **建议修复**: 在分享日志或调试信息时，建议对内部域名、IP 地址、仓库路径等敏感信息进行脱敏处理（例如替换为 `example.com` 或 `***`）。
### 问题 3: 时间戳异常
- **严重程度**: 轻微
- **文件**: 日志信息
- **行号**: 第 1 行
- **问题描述**: 日志时间显示为 `[2026-03-17 10:11:56]`，这是一个未来的时间（相对于当前实际时间）。这可能意味着系统时钟配置错误、测试数据伪造或日志生成逻辑存在问题。
- **建议修复**: 检查生成该日志的系统时钟设置，或确认是否为预期的测试数据。如果是生产环境日志，需立即排查时间同步服务（如 NTP）。
## ✅ 代码亮点
- 由于未提供实际代码，无法评估代码亮点。
## 📝 总体建议
本次提交的内容**无法进行有效的代码审查**，因为缺少核心的源代码变更部分。
1. **补充材料**：请重新提交包含实际代码修改（Diff）的内容。
2. **安全意识**：在未来的分享中，请注意脱敏内部仓库地址、API 密钥、密码等敏感信息。
3. **环境检查**：请验证生成日志的系统时间是否准确，避免因时间戳问题导致日志分析或审计困难。
期待您提供具体的代码变更内容，以便我进行更深入的技术审查。
---
*此 Issue 由代码审查服务自动创建*
...
|
0
|
0
|
0
|
0
|
0
|
|
0
|
1773713556
|
1773713556
|
0
|
0
|
0
|
0
|
Edit
Delete
|
|
2
|
2
|
2
|
1
|
|
0
|
代码审查报告：main 分支 - 111122
|
## 代码审查自动报告
**分支**: main
**提交**: 29b5655925cbfa8c ## 代码审查自动报告
**分支**: main
**提交**: 29b5655925cbfa8c56c5447ee5bb8dc020b74c5b
**时间**: 2026-03-17 10:12:49
[2026-03-17 10:12:02] 正在调用 Qwen API 进行代码审查...
## 📋 审查摘要
- 变更文件数：0 (未提供有效的代码 Diff)
- 主要变更：提供的內容仅为运行日志或环境元数据（工作目录、仓库 URL），不包含任何实际的源代码变更（如 Python, Java, C++ 等）。
## 🐛 发现的问题
### 问题 1: 缺少可审查的源代码
- **严重程度**: 严重
- **文件**: N/A
- **行号**: N/A
- **问题描述**: 本次提交的内容不包含任何编程语言的代码逻辑、函数变更或配置文件的修改。仅包含两行日志输出信息。作为代码审查专家，无法基于此内容评估逻辑正确性、性能或架构问题。
- **建议修复**: 请提供实际的代码 Diff 内容（例如包含 `+` 和 `-` 标记的代码变更块），以便进行有效的技术审查。
### 问题 2: 敏感信息潜在泄露 (信息泄露)
- **严重程度**: 中等
- **文件**: 日志/输出内容
- **行号**: 第 2 行 (`仓库 URL: ...`)
- **问题描述**: 日志中明文打印了内部仓库 URL (`https://gitea.g-hi.com/juhai/testpc.git`)。如果此日志被提交到公共仓库、发送给外部人员或记录在公开系统中，可能导致内部项目结构暴露。此外，`/tmp/` 下的随机目录名虽通常无害，但结合仓库 URL 可能辅助攻击者推测构建环境。
- **建议修复**:
1. 确保日志脱敏，不要在日志中硬编码或打印完整的内部仓库 URL。
2. 检查是否误将日志文件提交到了版本控制系统中（日志文件应加入 `.gitignore`）。
### 问题 3: 系统时间配置异常
- **严重程度**: 轻微
- **文件**: 日志/输出内容
- **行号**: 第 1 行 (`[2026-03-17 ...]`)
- **问题描述**: 日志显示的时间为 `2026 年`，这是一个未来时间。这可能是由于：
1. 服务器系统时间配置错误。
2. 这是一个测试用的 Mock 数据。
3. 代码中硬编码了时间戳。
如果是生产环境日志，时间错误会导致日志分析、审计追踪和故障排查严重混乱。
- **建议修复**: 检查服务器 NTP 同步服务，或确认代码中是否存在硬编码的时间戳逻辑。
## ✅ 代码亮点
- 无（因未提供实际源代码）。
## 📝 总体建议
1. **补充材料**：当前提供的内容无法构成有效的代码审查。请补充具体的源代码变更 Diff。
2. **安全意识**：在分享日志、截图或配置文件时，请务必抹去内部域名、IP 地址、仓库路径等敏感信息。
3. **规范日志**：确保生产环境的日志时间戳准确，且不包含敏感的基础设施信息。
4. **版本控制**：确认该日志内容不是被意外 `git add` 的文件，日志文件应当被忽略。
**结论**: 无法进行实质性代码审查，请提供正确的代码变更内容。
---
*此 Issue 由代码审查服务自动创建*
...
|
0
|
0
|
0
|
0
|
0
|
|
0
|
1773713569
|
1773713569
|
0
|
0
|
0
|
0
|
Edit
Delete
|
|
704
|
22
|
89
|
1
|
|
0
|
一些bug
|
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1784801850
|
1784801855
|
1784801855
|
0
|
0
|
0
|
Edit
Delete
|
|
705
|
22
|
90
|
1
|
|
0
|
一些bug
|
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1784801871
|
1784871268
|
1784801879
|
0
|
0
|
0
|
Edit
Delete
|
|
134
|
6
|
8
|
5
|
|
0
|
test(governance): AI Agent/获客域过时 E2E 选择器对齐 canonic test(governance): AI Agent/获客域过时 E2E 选择器对齐 canonical...
|
AI Agent 员工中心 / 获客中心域审计验收后残留 E2E 过时选择器对齐 canonical AI Agent 员工中心 / 获客中心域审计验收后残留 E2E 过时选择器对齐 canonical（curl/页面实证），两 spec 单跑+合并复跑 14/14 全绿，未放宽断言或 skip。
🤖 Generated with [Claude Code](https://claude.com/claude-code)...
|
0
|
0
|
0
|
1
|
0
|
|
0
|
1779070186
|
1779328857
|
0
|
0
|
0
|
0
|
Edit
Delete
|
|
44
|
6
|
1
|
5
|
|
0
|
test(finance): add finance mainline smoke and hard test(finance): add finance mainline smoke and harden invoice detail formatting...
|
## Summary
- add a finance-role mainline smoke tha ## Summary
- add a finance-role mainline smoke that covers invoices, AR ledger, and finance dashboard
- treat reconciliation 403 as the current permission boundary for the finance fixture
- harden invoice detail amount formatting so null values no longer trip the page
## Validation
- E2E_SKIP_WEB_SERVER=true E2E_USE_SYSTEM_CHROME=true pnpm -C e2e exec playwright test tests/auth/finance-mainline-flow-smoke.spec.ts --project=chromium-no-auth
- result: 1 passed (9.4s)
## Note
- git fetch/clone against the current Gitea main is currently failing with upload-pack not our ref, so this patch was replayed through the Gitea contents API on top of the live main history....
|
0
|
0
|
1
|
1
|
1
|
|
0
|
1774950058
|
1779328857
|
1778625303
|
0
|
0
|
0
|
Edit
Delete
|
|
691
|
50
|
1
|
5
|
|
0
|
fix(web): update Lyra product labels
|
<!--
PR 治理模板。提交前请逐项确认，确保符合 docs/standards 下的 <!--
PR 治理模板。提交前请逐项确认，确保符合 docs/standards 下的工程规范。
CI 会执行：pnpm check（命名 + 单源漂移 + 治理棘轮 + lint + typecheck）；
有测试 DB 的流水线另执行 DATABASE_URL=... pnpm check:runtime。
-->
## 变更内容
<!-- 简述这次改了什么、为什么改（聚焦 why） -->
-
## 涉及业务概念
<!-- 列出涉及的业务词典英文名，例如 store / order / verification。参见 docs/domain-glossary.md -->
-
## 检查清单
### 命名一致性
- [ ] 业务概念使用了词典中的标准英文名（未出现 shop/branch/seller/voucher/writeOff 等禁用词）
- [ ] 数据库 snake_case + 复数表名；API/JSON 字段 camelCase；类型 PascalCase；常量 SCREAMING_SNAKE_CASE
- [ ] `pnpm check:naming` 通过
- [ ] `pnpm check:schema` 通过，未新增第二份状态/契约真源
### API / 契约
- [ ] 不涉及 API 变更
- [ ] 新增/修改了 API，路由符合 `/api/v1/{resources}` 规范
- [ ] 已更新 `packages/contracts` 中的 Zod schema / DTO / 类型（前后端共用同一份）
- [ ] 无破坏前端兼容的字段删除/重命名（如有，已在描述中说明迁移方案）
### 数据库
- [ ] 不涉及数据库变更
- [ ] 新增/修改了表或字段，已通过 migration review（表名复数、字段 snake_case、外键 xxx_id、时间 _at、状态 status）
- [ ] 高增长表已考虑分区；涉及多租户的表带 tenant_id
- [ ] 写链显式带 tenant_id；跨租户读写按 404/隔离口径处理
### 数据库迁移（迁移即代码：版本/顺序/内容/环境/发布/回滚一致）
- [ ] 改 schema.prisma 的同时**已生成并提交 migration**（`pnpm db:migrate:dev --name <change>`），未只改 schema 不落迁移
- [ ] **未修改已发布过的历史 migration 文件**（内容一致：历史不可变，新变更走新迁移）
- [ ] `pnpm check:migrations` 通过（迁移历史在位 / 无未豁免高危 DDL / schema 表、enum、`@map` 列均已落迁移）
- [ ] 破坏性变更（删表/删列/改名/改类型/加 NOT NULL/加唯一约束）走 **expand→migrate→contract** 三阶段，不一次切
- [ ] 大表加索引用 `CREATE INDEX CONCURRENTLY`；大批量回填走 BullMQ 分批任务，不塞进 migration
- [ ] 高危但确需的 DDL 已加 `-- migration-allow:<原因>` 留痕，并在下方回滚方案说明
- [ ] 非开发环境只用 `migrate deploy`（禁止 `db push` / 线上手动 ALTER）；发布前 `pnpm db:migrate:status` 无 drift
### 实时 / 队列
- [ ] 不涉及
- [ ] 关键业务事件进入 BullMQ 或持久化事件表（未仅依赖 Redis Pub/Sub）
- [ ] 写库事件与真实写操作在同一 tx 写入 outbox，未在 commit 后旁路 publish
- [ ] 实时通道选型符合规范（订单/看板/通知用 SSE；设备在线/包间控制/IM 用 WebSocket）
### 质量与发布
- [ ] 通过 `pnpm lint` 与 `pnpm typecheck`
- [ ] 通过 `pnpm check:governance`，`reports/*.latest.json` 已刷新且无棘轮回退
- [ ] 涉及写链 / DB / 租户 / 状态机时，通过 `DATABASE_URL=... pnpm check:runtime`，`reports/runtime-acceptance.latest.json` 已刷新
- [ ] 已补充/更新必要的测试
- [ ] 不需要回滚方案
- [ ] 需要回滚方案，已在下方说明
## 回滚方案 / 其他说明
-
...
|
0
|
0
|
0
|
1
|
0
|
|
0
|
1783327279
|
1783431501
|
0
|
0
|
0
|
0
|
Edit
Delete
|
|
122
|
6
|
4
|
5
|
|
0
|
fix(governance): Wave 4 解封 + capability-graph HIGH fix(governance): Wave 4 解封 + capability-graph HIGH 清零 + vitest 7 项真回归...
|
## 模块治理摘要
- 模块：`capability-graph` / `ai-review-qu ## 模块治理摘要
- 模块：`capability-graph` / `ai-review-queue` / `campaigns` / `marketing` / `quotes`
- 战区：Wave 4（AI/Process 嵌入式闭环）+ harness 红线收口
- lane：模块专项通过
- 阶段：W4-T03/T06 解封 → Wave 4 收口
- 分类：`模块专项通过`
- 结论：W4-T06 状态 `PARTIAL → PASS`；harness `HIGH 3 → 0`；18 个原 stale baseline 失败文件 `373/373` 全绿
- 战役卡：W4-T03（AI Review Queue 真实 DB 验收）
- 验收卡：`docs/governance/ai-process-evidence-bundle-2026-05-10.md`
- runner evidence bundle：commits `566b7fe1d` + `921a6ce55`
## 关键变更
### 1. W4-T03 真实 DB 验收解封
- `tests/api/ai-review-queue.test.ts:204` + `:262` 两处 `listRes.body.data.data.some(...)` → `listRes.body.data.some(...)`，对齐 Governance 3.0 扁平 `paginated()` 契约 `{ data: [], meta: { pagination } }`
- 真实 DB（`juhi-postgres-test:5433` / `juhi-redis-test:6380`）复跑 4/4 全绿（10.47s）
- 覆盖：未认证 401 + 白名单守卫 + list/stats/claim/approve/reject 真实链路 + execution guard
### 2. capability-graph HIGH 3 → 0
- 新增 `HR_TRAINING_EVENTS.COMPETENCY_ASSESSMENT_CREATED / _DERIVED` 两个 event 常量
- `kafka.ts` 新增 `hr_competency_assessment → HR_EVENTS` topic 映射
- `assessByUser` (`:95`) + `deriveBehaviorBasedAssessment` (`:556`) 写入包进 `prisma.$transaction({tx => create + publishEvent(tx)})`，outbox 原子化
- `event-publishing-audit` capability-graph 行：`none=1` → `full=1`
### 3. vitest 7 项真回归修复
背景：`reports/vitest.backend.latest.json` 是 2026-02-18 别的开发机产物，95 failures 绝大多数是 stale。复跑 18 个失败文件后只有 7 项真回归。
| 文件 | 修复 |
|---|---|
| `marketing.service.test.ts` 完成执行中活动 | 补第 4 个 findFirst onceValue（assertTransition / update 状态校验 / ensureExistsById / refresh 四次调用） |
| `quote.service.test.ts` 创建报价单 | biz-code mock 补 `createWithBizCodeRetry` / `generateBizCodes` / `generateBizId` |
| `campaign.service.enhanced.test.ts` 5+6 项 | beforeEach 加 `findFirst/updateMany/findFirstOrThrow.mockReset()` 防 sticky 串扰；mock 补 `findFirstOrThrow`；8 处状态机生命周期/事件发布/取消测试补第 4 个 findFirst onceValue；execute 测试将第 3 个 findFirst onceValue 改为 findFirstOrThrow onceValue |
剥离 stale 后真实回归 7 项，但 `mockReset()` 同时暴露 6 项原本被 sticky 状态掩盖的同类问题，一并修复（共 13 处 onceValue 补齐）。
## 验证命令
| 命令 | 结果 | 备注 |
| --- | --- | --- |
| `npx vitest run --workspace vitest.workspace.ts --project api tests/api/ai-review-queue.test.ts` | ✅ 4/4 passed (10.47s) | 真实 DB |
| `npx vitest run --workspace vitest.workspace.ts --project unit src/modules/campaigns/campaign.service.enhanced.test.ts src/modules/marketing/marketing.service.test.ts tests/unit/services/quote.service.test.ts` | ✅ 3 files / 71+25 tests passed | unit |
| `npx vitest run --project unit` (18 个 stale 失败文件全集) | ✅ 18 files / 373 tests passed | unit 回归 |
| `npx tsx scripts/audit-prisma-zod-contract.ts` | ✅ PASS (length=0 / required=0 / enum=0) | |
| `npx tsx scripts/audit-event-publishing.ts` | ✅ 99.01% 覆盖率，capability-graph 全覆盖 | |
| `pnpm harness report` | ✅ CRITICAL=0 / HIGH=0 / MEDIUM=8 / total=6028 | HIGH 从 3 降 0 |
| pre-commit Fast Gate (6 项) + Smart Gate (3 项���后端 type-check) | ✅ 全 PASS | NODE_OPTIONS=12G |
## 审计命中
- `audit:tenant`：未跑（变更未触及租户中间件）
- `audit:events`：✅ 0 finding（capability-graph 修复后从 7 降 0）
- `audit:route-contract`：未跑（变更未触及路由层）
- `audit:docs-single-source`：未跑（仅 governance 增量；CLAUDE/AGENTS/README/GEMINI 同步待后续 owner PR）
- `audit:prisma-zod-contract`：✅ 0 finding
- `audit:state-machines`：✅ 0 finding
## 前端 / 页面验收
- canonical 入口：`/ai-agents/review-queue`（未变更，本 PR 只动 API 测试 + 后端）
- smoke / auth-scope：未跑（无前端代码改动）
- alias / compat 回归：N/A
## 残余风险
- 风险 1：harness 仍有 `MEDIUM=8`，全部来自既有 baseline 数据（迁移安全检查 5215 LOW 分类边界 / 业务时间流分析 117 INFO / 类型债务追踪 41），非本 PR 引入。CI 治理硬门禁（`HIGH+CRITICAL+MEDIUM > 0`）会阻塞，需后续 owner 决定是否豁免或继续治理。
- 风险 2：full unit suite 仍剩 28 个 *其他* test 文件 / 135 failures（dimension-transform / social-auto-replies / opportunity.machine.test label / rma / content-* 等），均与本 PR 无关，是更老的 pre-existing 失败。建议作为独立后续 PR 处理。
- 风险 3：本 PR 修复的 `mockReset()` 模式应推广到其他使用 `prisma.$transaction` 的服务单测——下次治理可重点扫描。
## 文档同步
- [ ] `CLAUDE.md`
- [ ] `AGENTS.md`
- [ ] `README.md`
- [ ] `GEMINI.md`
- [x] 治理经验库：`docs/governance/ai-process-evidence-bundle-2026-05-10.md` 已升 PASS + 补 Real DB Suite + Test Contract Fix 章节
## 口径确认
- [x] 本 PR 只宣称模块级通过，不把模块结果外推为工作区全绿
- [x] 若存在工作区漂移，已明确标记且未误记到当前模块（135 项其他失败已列入残余风险）
- [x] 若存在热修 lane，已与全域补证据 / build-out lane 隔离
---
> ⚠️ GitHub 镜像 PR #51 因 Actions 账单问题阻塞，故改在 Gitea 创建本 PR 作为主验收入口。
🤖 Generated with Claude Code...
|
0
|
0
|
1
|
1
|
1
|
|
0
|
1778679717
|
1779328857
|
1778891027
|
0
|
0
|
0
|
Edit
Delete
|
|
790
|
116
|
1
|
5
|
|
0
|
fix(contracts): 注册中心规则补失败关闭与摘要规范化——三个入口此前抛 TypeErr fix(contracts): 注册中心规则补失败关闭与摘要规范化——三个入口此前抛 TypeError，同一摘要的两种写法此前分叉成两个复核键...
|
蓝图 docs/domain/registry-snapshot-blueprint.md 从迁入起 蓝图 docs/domain/registry-snapshot-blueprint.md 从迁入起就写着「失败关闭」与
「review key 仅用于人工复核幂等」两条不变量，实测三处不成立。本次按蓝图自己的口径补齐，
改动只在 contracts/src/domain/application-contract-registry/：不新增写入点、不新增宿主、
不动 Catalog 与 Schema，每条输出仍固定 activationAllowed=false / registryWriteAllowed=false /
humanApprovalRequired=true。
1. 失败关闭：assessRegistrySnapshot / assessRegistryTransition /
reviewCandidateSnapshotUpgrade 对畸形输入抛 TypeError（快照缺字段、now 不是 Date、
decisions 整个缺失都会抛），四个入口里只有 LocalManifestAdmissionPlanner.plan 是
失败关闭的。现四个入口一致返回 REJECT + 原因码。这不是洁癖：check-fixtures 把抛出当
配置错误处理，实测一次 TypeError 会让整套 15 例逐例判定塌成一条 configuration 失败。
2. 十六进制引用规范化：digest / commit 的正则带 /i 收大小写两种写法，比较与入键却
大小写敏感——同一摘要写成大写会得到另一个 reviewIdempotencyKey，同版本大小写翻转被判成
SAME_VERSION_DIGEST_CHANGED，大写回滚 pin 被判成 ROLLBACK_PIN_MUST_MATCH_CURRENT。
现一律规范化为小写后再比较、再入键，ACCEPT 回吐规范化后的值。
3. 版本文法收敛：一个模块三套（快照流与清单准入用 \d+\.\d+\.\d+，升级复核用严格 SemVer），
新增 registry-primitives.ts 作单一来源，含预发布序；DEC-009—012 此前在两份文件各写一份，
一并收敛。snapshot-upgrade-review.ts 因此净减约 60 行重复实现。
两处语义变化（蓝图新增一节已如实登记）：
- 收紧：1.02.0 这类前导零版本此前被放行，现在拒；assessRegistrySnapshot 另开始拒 latest
这类可变标签——此前它能过体检却必然过不了迁移规则。
- 放宽：1.0.0-rc.1 这类预发布版本此前被快照流整条挡在外面，现在按 SemVer 序参与迁移。
平台自己发的就是 1.0.0-rc.N，升级复核那一侧本来就这么判。风险面有限：本模块所有出口
都不激活、不写 Registry，多进人工复核队列不等于多放行制品。
证据（本分支隔离工作树，clean）：注册中心单测 44/44（原 34 + 加固 10）；
contracts check:local 302/302；check:fixtures 九个契约域套件 100 例 0 失败，
其中本套件 15 例（正 4 / 反 11，原 8 例）。篡改必红实测两次：sameHexRef 退回大小写敏感
→ 单测 1 红 + 夹具 P03 红；去掉快照入口守卫 → 整套塌成 0 例 1 配置失败。
仍为仓内候选 sdk_e2，不代表正式 Registry、Snapshot 发布或跨仓 Required Check 已上线。
清单登记的 C01.04 / C01.06 是「接线」型缺口且前置 Q01 运行宿主未裁，本次未动。
reports/fixtures.latest.json 未回绑：它是 17 套件的聚合报告，只跑 9 个套件去覆盖会缩小结论面，
应在整批（含并行会话的 public-file / IM / 跨域流程改动）落定后统一重跑回绑。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>...
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1789742918
|
1789744064
|
1789742925
|
0
|
0
|
0
|
Edit
Delete
|
|
130
|
6
|
5
|
5
|
|
0
|
feat: 培训管理种子 + MQL 评分规则 + Gitea CI 迁移
|
对应 GitHub PR #52。
- backend/prisma/seeds/22-hr-tr 对应 GitHub PR #52。
- backend/prisma/seeds/22-hr-training-content.ts: 培训管理 12 张表种子
- backend/prisma/seeds/23-lead-scoring-rules.ts: MQL 默认评分规则集(修复 /lead-qualification 评估 400)
- .gitea/workflows/ci.yml: Gitea Actions CI(取代账户计费阻塞的 GitHub Actions)
- frontend course-marketplace.ts: array-guard 修复
- 已合并 origin/main 至 97a07d598,冲突全部解决
GitHub Actions 已仓库级禁用,CI 迁移到本 Gitea PR 验证。...
|
0
|
0
|
0
|
1
|
0
|
|
0
|
1778885087
|
1778891427
|
0
|
0
|
0
|
0
|
Edit
Delete
|
|
743
|
57
|
3
|
5
|
|
0
|
feat(script): 接入大语言模型——歌词/文案 → 拍摄脚本 → 角色确认 → 定格图
|
本仓此前零 LLM 接入（全仓只有 DashScope 的图像调用），「歌词成图」屏是纯前端
原型 本仓此前零 LLM 接入（全仓只有 DashScope 的图像调用），「歌词成图」屏是纯前端
原型（procedural.ts 画色块 + setTimeout 假装推理，不落库不接后端）。本轮把这条
动线升级为真链路 + 真持久化。
契约单源（packages/contracts/src/script.ts）
- 角色确认状态机 scriptRoleMachine、脚本状态机 shootingScriptMachine
- 景别/运镜用枚举而非自由文本：LLM 一旦自由发挥，下游 prompt 与统计就没有稳定口径
- scriptDraftSchema 是 LLM 输出的唯一判据；prompt 构造器单源，两后端禁止各拼一份
- evaluateRoleReadiness：本域核心不变量，双后端硬拦截 + 前端同源即时反馈
- 前端私有的 findBannedHits 上收为 contracts 的 findBannedWords（后端也要逐镜标记，
两份并行就是双真源）
LLM 不是权威
- sidecar /v1/script 只保证「返回长得像脚本的 JSON」，两个后端各自再 parse 一次才落库
- 模型引用未声明角色键 → 422 SCRIPT_ROLE_KEYS_DANGLING（幻觉护栏）
- 连续给不出合法 JSON → 502 LLM_OUTPUT_UNPARSEABLE，绝不返回占位脚本
- parse_json_object 只剥围栏、截首尾花括号，不做字段猜测或补齐
角色必须先确认才允许出定格图
- 判据 = status CONFIRMED 且有 referenceAssetId（没有参考图就没有一致性锚点）
- CONFIRMED --reset--> DRAFT 会解除参考图绑定：人确认的是那一张图，不是那个名字
- 出图时按 roleKeys 顺序喂参考图，与指令里「第 N 张参考图」编号严格对齐
写链纪律与物料链路同构：tenant 全覆盖、updateMany 带状态前置条件（0 行即 409）、
终态与 outbox 同 tx、能力不可用 → job BLOCKED + 诚实 reason，禁止静默降级。
品牌准绳只逐镜标记不拒绝整份脚本（脚本属创作内容），硬拦截点在出定格图这个受控出口，
显式放行需带参数且落审计事件。
顺带修掉三个既有缺陷
1. 合并遗留：sidecarEdit 用 sidecarGenerateResponseSchema 校验响应（要求 steps/
loadSeconds），但 run_hosted_edit 两个字段都不返回 —— 托管改字会在客户端边界
直接 Zod 抛错（本地路径返回这两个字段，所以一直没暴露）
2. check-migrations 的列检查只扫 CREATE TABLE，凡 ALTER TABLE ADD COLUMN 追加的
@map 列一律误报 drift（此前唯一的 ALTER 列 brand_kits.profile 没 @map 才没现形）
3. ktv-poster-master.png 血统在合并两侧打架，git log --all 证明该文件自初始化提交后
从未重新生成，取诚实标注 prototype-demo-master
验收
- 新增 pnpm check:script → reports/script-acceptance.latest.json（双后端各 8 passed
+ 1 skipped-live）；own-tests floor 10→14，棘轮已收紧
- pnpm check / check:runtime 均 exit 0
- 浏览器实测：未确认角色 → 按钮 disabled 且提示缺哪个角色；绕过前端直打后端 → 422
ROLE_NOT_CONFIRMED；跨租户 404；无凭证生成 → UI 显示 503 且不产生占位脚本
诚实边界（已写入 CLAUDE.md）
- liveLlmAsserted=false：本机无 DASHSCOPE_API_KEY，真调 LLM 的 live 断言被 skip，
门禁成立 ≠ LLM 出脚本已验证
- check:inference 在本机为 failed（动手前即为 failed）：本工作副本的模型权重是
git-lfs 指针存根，非本轮改动导致；基线表该行已从 GREEN 改为 OPEN
- ui-acceptance 报告早于本屏，未覆盖 script 屏，已标 STALE
- 新开缺口 G16（LLM 只做结构校验、无事实性校验）、G17（同步 HTTP 挂分钟级推理 /
render_jobs 索引非 CONCURRENTLY / 本地多图 I2I 未在本机验证）
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
<!--
PR 治理模板。提交前请逐项确认，确保符合 docs/standards 下的工程规范。
CI 会执行：pnpm check（命名 + 单源漂移 + 治理棘轮 + lint + typecheck）；
有测试 DB 的流水线另执行 DATABASE_URL=... pnpm check:runtime。
-->
## 变更内容
<!-- 简述这次改了什么、为什么改（聚焦 why） -->
-
## 涉及业务概念
<!-- 列出涉及的业务词典英文名，例如 store / order / verification。参见 docs/domain-glossary.md -->
-
## 检查清单
### 命名一致性
- [ ] 业务概念使用了词典中的标准英文名（未出现 shop/branch/seller/voucher/writeOff 等禁用词）
- [ ] 数据库 snake_case + 复数表名；API/JSON 字段 camelCase；类型 PascalCase；常量 SCREAMING_SNAKE_CASE
- [ ] `pnpm check:naming` 通过
- [ ] `pnpm check:schema` 通过，未新增第二份状态/契约真源
### API / 契约
- [ ] 不涉及 API 变更
- [ ] 新增/修改了 API，路由符合 `/api/v1/{resources}` 规范
- [ ] 已更新 `packages/contracts` 中的 Zod schema / DTO / 类型（前后端共用同一份）
- [ ] 无破坏前端兼容的字段删除/重命名（如有，已在描述中说明迁移方案）
### 数据库
- [ ] 不涉及数据库变更
- [ ] 新增/修改了表或字段，已通过 migration review（表名复数、字段 snake_case、外键 xxx_id、时间 _at、状态 status）
- [ ] 高增长表已考虑分区；涉及多租户的表带 tenant_id
- [ ] 写链显式带 tenant_id；跨租户读写按 404/隔离口径处理
### 数据库迁移（迁移即代码：版本/顺序/内容/环境/发布/回滚一致）
- [ ] 改 schema.prisma 的同时**已生成并提交 migration**（`pnpm db:migrate:dev --name <change>`），未只改 schema 不落迁移
- [ ] **未修改已发布过的历史 migration 文件**（内容一致：历史不可变，新变更走新迁移）
- [ ] `pnpm check:migrations` 通过（迁移历史在位 / 无未豁免高危 DDL / schema 表、enum、`@map` 列均已落迁移）
- [ ] 破坏性变更（删表/删列/改名/改类型/加 NOT NULL/加唯一约束）走 **expand→migrate→contract** 三阶段，不一次切
- [ ] 大表加索引用 `CREATE INDEX CONCURRENTLY`；大批量回填走 BullMQ 分批任务，不塞进 migration
- [ ] 高危但确需的 DDL 已加 `-- migration-allow:<原因>` 留痕，并在下方回滚方案说明
- [ ] 非开发环境只用 `migrate deploy`（禁止 `db push` / 线上手动 ALTER）；发布前 `pnpm db:migrate:status` 无 drift
### 实时 / 队列
- [ ] 不涉及
- [ ] 关键业务事件进入 BullMQ 或持久化事件表（未仅依赖 Redis Pub/Sub）
- [ ] 写库事件与真实写操作在同一 tx 写入 outbox，未在 commit 后旁路 publish
- [ ] 实时通道选型符合规范（订单/看板/通知用 SSE；设备在线/包间控制/IM 用 WebSocket）
### 质量与发布
- [ ] 通过 `pnpm lint` 与 `pnpm typecheck`
- [ ] 通过 `pnpm check:governance`，`reports/*.latest.json` 已刷新且无棘轮回退
- [ ] 涉及写链 / DB / 租户 / 状态机时，通过 `DATABASE_URL=... pnpm check:runtime`，`reports/runtime-acceptance.latest.json` 已刷新
- [ ] 已补充/更新必要的测试
- [ ] 不需要回滚方案
- [ ] 需要回滚方案，已在下方说明
## 回滚方案 / 其他说明
-
...
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1787029791
|
1787032807
|
1787032807
|
0
|
0
|
0
|
Edit
Delete
|
|
692
|
57
|
1
|
5
|
|
0
|
feat(material-factory): 图像模型真实推理对接 + 双后端渲染管线闭环
|
<!--
PR 治理模板。提交前请逐项确认，确保符合 docs/standards 下的 <!--
PR 治理模板。提交前请逐项确认，确保符合 docs/standards 下的工程规范。
CI 会执行：pnpm check（命名 + 单源漂移 + 治理棘轮 + lint + typecheck）；
有测试 DB 的流水线另执行 DATABASE_URL=... pnpm check:runtime。
-->
## 变更内容
<!-- 简述这次改了什么、为什么改（聚焦 why） -->
-
## 涉及业务概念
<!-- 列出涉及的业务词典英文名，例如 store / order / verification。参见 docs/domain-glossary.md -->
-
## 检查清单
### 命名一致性
- [ ] 业务概念使用了词典中的标准英文名（未出现 shop/branch/seller/voucher/writeOff 等禁用词）
- [ ] 数据库 snake_case + 复数表名；API/JSON 字段 camelCase；类型 PascalCase；常量 SCREAMING_SNAKE_CASE
- [ ] `pnpm check:naming` 通过
- [ ] `pnpm check:schema` 通过，未新增第二份状态/契约真源
### API / 契约
- [ ] 不涉及 API 变更
- [ ] 新增/修改了 API，路由符合 `/api/v1/{resources}` 规范
- [ ] 已更新 `packages/contracts` 中的 Zod schema / DTO / 类型（前后端共用同一份）
- [ ] 无破坏前端兼容的字段删除/重命名（如有，已在描述中说明迁移方案）
### 数据库
- [ ] 不涉及数据库变更
- [ ] 新增/修改了表或字段，已通过 migration review（表名复数、字段 snake_case、外键 xxx_id、时间 _at、状态 status）
- [ ] 高增长表已考虑分区；涉及多租户的表带 tenant_id
- [ ] 写链显式带 tenant_id；跨租户读写按 404/隔离口径处理
### 数据库迁移（迁移即代码：版本/顺序/内容/环境/发布/回滚一致）
- [ ] 改 schema.prisma 的同时**已生成并提交 migration**（`pnpm db:migrate:dev --name <change>`），未只改 schema 不落迁移
- [ ] **未修改已发布过的历史 migration 文件**（内容一致：历史不可变，新变更走新迁移）
- [ ] `pnpm check:migrations` 通过（迁移历史在位 / 无未豁免高危 DDL / schema 表、enum、`@map` 列均已落迁移）
- [ ] 破坏性变更（删表/删列/改名/改类型/加 NOT NULL/加唯一约束）走 **expand→migrate→contract** 三阶段，不一次切
- [ ] 大表加索引用 `CREATE INDEX CONCURRENTLY`；大批量回填走 BullMQ 分批任务，不塞进 migration
- [ ] 高危但确需的 DDL 已加 `-- migration-allow:<原因>` 留痕，并在下方回滚方案说明
- [ ] 非开发环境只用 `migrate deploy`（禁止 `db push` / 线上手动 ALTER）；发布前 `pnpm db:migrate:status` 无 drift
### 实时 / 队列
- [ ] 不涉及
- [ ] 关键业务事件进入 BullMQ 或持久化事件表（未仅依赖 Redis Pub/Sub）
- [ ] 写库事件与真实写操作在同一 tx 写入 outbox，未在 commit 后旁路 publish
- [ ] 实时通道选型符合规范（订单/看板/通知用 SSE；设备在线/包间控制/IM 用 WebSocket）
### 质量与发布
- [ ] 通过 `pnpm lint` 与 `pnpm typecheck`
- [ ] 通过 `pnpm check:governance`，`reports/*.latest.json` 已刷新且无棘轮回退
- [ ] 涉及写链 / DB / 租户 / 状态机时，通过 `DATABASE_URL=... pnpm check:runtime`，`reports/runtime-acceptance.latest.json` 已刷新
- [ ] 已补充/更新必要的测试
- [ ] 不需要回滚方案
- [ ] 需要回滚方案，已在下方说明
## 回滚方案 / 其他说明
-
...
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1783381428
|
1783381594
|
1783381594
|
0
|
0
|
0
|
Edit
Delete
|
|
96
|
6
|
3
|
5
|
|
0
|
claude/fervent-kirch-e2a254 -> origin/claude/fe claude/fervent-kirch-e2a254 -> origin/claude/fervent-kirch-e2a254...
|
## 模块治理摘要
- 模块：
- 战区：
- lane：
- 阶段：
- 分类：`模 ## 模块治理摘要
- 模块：
- 战区：
- lane：
- 阶段：
- 分类：`模块专项通过 / 工作区漂移 / 阻断`
- 结论：
- 战役卡：
- 验收卡：
- runner evidence bundle：
## 验证命令
| 命令 | 结果 | 备注 |
| --- | --- | --- |
| | | |
| | | |
| | | |
## 审计命中
- `audit:tenant`：
- `audit:events`：
- `audit:route-contract`：
- `audit:docs-single-source`：
- 如未跑全量，请说明原因：
## 前端 / 页面验收
- canonical 入口：
- smoke / auth-scope：
- alias / compat 回归：
## 残余风险
- 风险 1：
- 风险 2：
## 文档同步
- [ ] `CLAUDE.md`
- [ ] `AGENTS.md`
- [ ] `README.md`
- [ ] `GEMINI.md`
- [ ] 治理经验库 / 专项记录
## 口径确认
- [ ] 本 PR 只宣称模块级通过，不把模块结果外推为工作区全绿
- [ ] 若存在工作区漂移，已明确标记且未误记到当前模块
- [ ] 若存在热修 lane，已与全域补证据 / build-out lane 隔离
...
|
0
|
0
|
1
|
1
|
1
|
|
0
|
1777597467
|
1779328857
|
1778625303
|
0
|
0
|
0
|
Edit
Delete
|
|
731
|
57
|
2
|
5
|
|
0
|
chore: add material factory model weights
|
<!--
PR 治理模板。提交前请逐项确认，确保符合 docs/standards 下的 <!--
PR 治理模板。提交前请逐项确认，确保符合 docs/standards 下的工程规范。
CI 会执行：pnpm check（命名 + 单源漂移 + 治理棘轮 + lint + typecheck）；
有测试 DB 的流水线另执行 DATABASE_URL=... pnpm check:runtime。
-->
## 变更内容
<!-- 简述这次改了什么、为什么改（聚焦 why） -->
-
## 涉及业务概念
<!-- 列出涉及的业务词典英文名，例如 store / order / verification。参见 docs/domain-glossary.md -->
-
## 检查清单
### 命名一致性
- [ ] 业务概念使用了词典中的标准英文名（未出现 shop/branch/seller/voucher/writeOff 等禁用词）
- [ ] 数据库 snake_case + 复数表名；API/JSON 字段 camelCase；类型 PascalCase；常量 SCREAMING_SNAKE_CASE
- [ ] `pnpm check:naming` 通过
- [ ] `pnpm check:schema` 通过，未新增第二份状态/契约真源
### API / 契约
- [ ] 不涉及 API 变更
- [ ] 新增/修改了 API，路由符合 `/api/v1/{resources}` 规范
- [ ] 已更新 `packages/contracts` 中的 Zod schema / DTO / 类型（前后端共用同一份）
- [ ] 无破坏前端兼容的字段删除/重命名（如有，已在描述中说明迁移方案）
### 数据库
- [ ] 不涉及数据库变更
- [ ] 新增/修改了表或字段，已通过 migration review（表名复数、字段 snake_case、外键 xxx_id、时间 _at、状态 status）
- [ ] 高增长表已考虑分区；涉及多租户的表带 tenant_id
- [ ] 写链显式带 tenant_id；跨租户读写按 404/隔离口径处理
### 数据库迁移（迁移即代码：版本/顺序/内容/环境/发布/回滚一致）
- [ ] 改 schema.prisma 的同时**已生成并提交 migration**（`pnpm db:migrate:dev --name <change>`），未只改 schema 不落迁移
- [ ] **未修改已发布过的历史 migration 文件**（内容一致：历史不可变，新变更走新迁移）
- [ ] `pnpm check:migrations` 通过（迁移历史在位 / 无未豁免高危 DDL / schema 表、enum、`@map` 列均已落迁移）
- [ ] 破坏性变更（删表/删列/改名/改类型/加 NOT NULL/加唯一约束）走 **expand→migrate→contract** 三阶段，不一次切
- [ ] 大表加索引用 `CREATE INDEX CONCURRENTLY`；大批量回填走 BullMQ 分批任务，不塞进 migration
- [ ] 高危但确需的 DDL 已加 `-- migration-allow:<原因>` 留痕，并在下方回滚方案说明
- [ ] 非开发环境只用 `migrate deploy`（禁止 `db push` / 线上手动 ALTER）；发布前 `pnpm db:migrate:status` 无 drift
### 实时 / 队列
- [ ] 不涉及
- [ ] 关键业务事件进入 BullMQ 或持久化事件表（未仅依赖 Redis Pub/Sub）
- [ ] 写库事件与真实写操作在同一 tx 写入 outbox，未在 commit 后旁路 publish
- [ ] 实时通道选型符合规范（订单/看板/通知用 SSE；设备在线/包间控制/IM 用 WebSocket）
### 质量与发布
- [ ] 通过 `pnpm lint` 与 `pnpm typecheck`
- [ ] 通过 `pnpm check:governance`，`reports/*.latest.json` 已刷新且无棘轮回退
- [ ] 涉及写链 / DB / 租户 / 状态机时，通过 `DATABASE_URL=... pnpm check:runtime`，`reports/runtime-acceptance.latest.json` 已刷新
- [ ] 已补充/更新必要的测试
- [ ] 不需要回滚方案
- [ ] 需要回滚方案，已在下方说明
## 回滚方案 / 其他说明
-
...
|
0
|
0
|
0
|
1
|
0
|
|
0
|
1786603028
|
1786603028
|
0
|
0
|
0
|
0
|
Edit
Delete
|
|
725
|
18
|
213
|
1
|
|
0
|
bug-批量修改价格
|
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1786339439
|
1786339447
|
1786339447
|
0
|
0
|
0
|
Edit
Delete
|
|
726
|
18
|
214
|
1
|
|
0
|
bug-批量修改价格
|
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1786339478
|
1786339630
|
1786339630
|
0
|
0
|
0
|
Edit
Delete
|
|
706
|
23
|
44
|
1
|
|
0
|
bug-V2平台调音-1的商家id不显示问题
|
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1784802032
|
1784802046
|
1784802046
|
0
|
0
|
0
|
Edit
Delete
|
|
711
|
23
|
46
|
1
|
|
0
|
bug-V2平台调音-1的商家id不显示问题
|
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1784874674
|
1784874685
|
1784874685
|
0
|
0
|
0
|
Edit
Delete
|
|
712
|
18
|
211
|
1
|
|
0
|
bug
|
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1785224168
|
1785224183
|
1785224183
|
0
|
0
|
0
|
Edit
Delete
|
|
713
|
18
|
212
|
1
|
|
0
|
bug
|
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1785224202
|
1785224212
|
1785224212
|
0
|
0
|
0
|
Edit
Delete
|
|
767
|
24
|
1
|
4
|
|
0
|
[后台管理] 按省市统计设备月度新增上线数量报表
|
## 关联 Issue
Close #4 — [后台] 按省市统计设备月度新增上线数量报表
（I ## 关联 Issue
Close #4 — [后台] 按省市统计设备月度新增上线数量报表
（Issue 位于另一仓库 laiqiaojie/jh-project，Gitea 跨仓库 `Close #N` 不会自动关联，merge 后需手动去 jh-project 更新 Issue 状态）
## 变更说明
- 新增 `DeviceOnlineStats` 控制器，暴露 `getProvinceStats`（按月+省份汇总新增上线设备数）、`getCityStats`（指定省份后按城市下钻）两个接口
- `Ahead_authenticate_log_model` 新增对应查询方法：联表 `ahead_authenticate_log` → `ahead_family_servers` → `ahead_yc_shop`，权限过滤复用现有 `Ahead_manage_user_model::check_is_agent()`（超管看全国，运营商强制按 `shop._agent_id` 过滤）
- 与 plan.md 的偏差：实现与计划一致；另外在 `/code-review` 中发现并修复了两个问题（均已回归验证）：
- `month` 参数只校验格式未校验取值范围，如 `2026-00` 会被 `strtotime` 静默接受为上一年 12 月而不报错 → 正则改为 `(0[1-9]|1[0-2])` 严格校验月份范围
- 未绑定门店的设备（`room._shop_id` 为 0/未匹配）会被计入 `total` 但在 `GROUP BY shop._province` 时产生一个 province 为 null 的脏分组 → 加 `room._shop_id > 0` 过滤
## 测试说明
- 本地起 PHPStudy，登录后手动调用两个接口验证：正常月份返回 `{code:0, result:{total, list}}`；缺 `month`/非法月份（`2026-00`、`2026-13`、`0000-00`）均正确返回 400
- 用只读 SQL 直接查了云端开发库确认 JOIN 链路正确——本地测试库 `ahead_authenticate_log` 表只有 1 条 2021 年的历史数据，所以当月查询返回空列表是预期行为，不是 bug
- `tests/api/smoke.mjs` 里补充了对应的自动化用例，但该冒烟测试框架整体依赖另一个尚未推送到 `admin` 分支的提交（`694e34c`，属于另一项未提交的工作，不在本 Issue 范围内），为保持本 PR 改动范围干净，本次未包含测试框架文件，仅代码改动
- 需要 Tech Lead 重点看：`check_is_agent()` 权限过滤范围是否符合预期；`room._shop_id > 0` 过滤是否会误伤合法数据
## 产物归档
- Plan：[plan/device-online-stats-by-region-admin.md](https://gitea.g-hi.com/laiqiaojie/jh-project/src/branch/design/device-online-stats-by-region/plan/device-online-stats-by-region-admin.md)（位于 laiqiaojie/jh-project 仓库）
...
|
0
|
0
|
1
|
1
|
1
|
|
0
|
1788244598
|
1788246926
|
1788245236
|
0
|
0
|
0
|
Edit
Delete
|
|
759
|
85
|
4
|
4
|
|
0
|
[后台] 按省市统计设备月度新增上线数量报表
|
> 子任务，属于主 Issue #8「按省市统计设备月度新增上线数量报表」
## 关联 De > 子任务，属于主 Issue #8「按省市统计设备月度新增上线数量报表」
## 关联 Design PR
[PR #3 — Design: 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/3)
## 工作范围
负责后台接口实现：
- 新增查询接口，按月份统计各省份新增上线设备数量
- 支持下钻查询：指定省份，返回城市级别数据
- 按权限过滤：超管返回全国数据，运营商返回自己区域
## 产物
- （实现前提交，Tech Lead 审核后开始 Build）
## 参考
- 需求说明：[design/device-online-stats-by-region.md](https://gitea.g-hi.com/laiqiaojie/jh-project/src/branch/design/device-online-stats-by-region/design/device-online-stats-by-region.md)
- 在线原型：https://claude.ai/code/artifact/b50eaa98-689b-4742-8024-cdf74f95d5c8...
|
1
|
0
|
1
|
0
|
2
|
|
0
|
1787909526
|
1789380193
|
1789380193
|
0
|
1
|
0
|
Edit
Delete
|
|
769
|
24
|
2
|
4
|
|
0
|
[Web前端] 按省市统计设备月度新增上线数量报表
|
## 关联 Issue
Related to laiqiaojie/jh-project#5
Re ## 关联 Issue
Related to laiqiaojie/jh-project#5
Related to laiqiaojie/jh-project#8 — 按省市统计设备月度新增上线数量报表（Web 前端）
## 变更说明
- 新增 页面组件
- 省份视图：横向柱状图展示各省份当月新增上线设备数，点击下钻城市
- 城市视图：横向柱状图展示选定省份各城市分布，面包屑返回全国
- 使用 CSS 自定义 bar（不引入 ECharts），保持项目依赖不变
- 更新 ：注册 device_online_stats 组件
- 更新 ：新增 路由规则
- **修复** ： 在父菜单 为空时拼出 双斜杠，导致路由匹配失败
- **修复** ： 同一根因的双斜杠问题
## 测试说明
- 月份切换后图表重新加载
- 点击省份柱子进入城市视图，面包屑显示「全国 › XX省」
- 点击「全国」/「返回全国」返回省份视图
- 无数据月份显示空状态
- 点击「数据」顶部菜单 → 侧栏「设备上线分布」→ 组件正常渲染（已端到端验证）
## DB 变更（需手动执行）
## 产物归档
- Plan：（在 jh-project 仓库）
- 设计文档：
🤖 Generated with [Claude Code](https://claude.com/claude-code)...
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1788247154
|
1789379914
|
1789377273
|
0
|
3
|
0
|
Edit
Delete
|
|
760
|
85
|
5
|
4
|
|
0
|
[Web] 按省市统计设备月度新增上线数量报表
|
> 子任务，属于主 Issue #8「按省市统计设备月度新增上线数量报表」
## 关联 De > 子任务，属于主 Issue #8「按省市统计设备月度新增上线数量报表」
## 关联 Design PR
[PR #3 — Design: 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/3)
## 工作范围
负责 Web 前端页面实现：
- 数据报表 → 设备上线分布 页面
- 月份筛选器 + 当月总数卡片 + 省份横向柱状图
- 点击省份下钻到城市视图，支持面包屑返回
## 产物
- plan/device-online-stats-by-region-web.md（实现前提交，Tech Lead 审核后开始 Build）
## 参考
- 需求说明：[design/device-online-stats-by-region.md](https://gitea.g-hi.com/laiqiaojie/jh-project/src/branch/design/device-online-stats-by-region/design/device-online-stats-by-region.md)
- 在线原型：https://claude.ai/code/artifact/b50eaa98-689b-4742-8024-cdf74f95d5c8...
|
1
|
0
|
1
|
0
|
3
|
|
0
|
1787909556
|
1789380193
|
1789380193
|
0
|
1
|
0
|
Edit
Delete
|
|
770
|
85
|
7
|
4
|
|
0
|
[Skill] build-complete 新增接口文档归档步骤
|
Related to #8
## 说明
在 `build-complete` skill 里新增 Related to #8
## 说明
在 `build-complete` skill 里新增一步：Plan 阶段确定接口设计后、代码开发完成时，如涉及新增/修改接口，需要生成并归档接口文档：
- Apifox（规范化 OpenAPI 文档，Claude 通过 API 增量导入）
- `docs/frontend-specs/<功能名>.md`（面向其他端的对接说明文档，固定五章结构）
背景：issue #4 实现完成后发现接口文档一直没有归档，靠事后补做；这次把它固化成流程里的正式一步，插在"提交 plan.md"和"开代码 PR"之间。
同时补充了代码仓库与 jh-project 分离时的注意事项（milestone/label 可能不存在、Close #N 跨仓库不生效）。...
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1788247386
|
1789379900
|
1788247940
|
0
|
1
|
0
|
Edit
Delete
|
|
768
|
85
|
6
|
4
|
|
0
|
[Plan] 按省市统计设备月度新增上线数量报表 (后台管理)
|
Related to #8
## 关联 Issue
[#4 — [后台] 按省市统计设备月度新增 Related to #8
## 关联 Issue
[#4 — [后台] 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/issues/4)
## 说明
补交 Plan 阶段产物（此前误提交到已合并关闭的 design 分支，未能进入 main，见此 PR 重新提交）。
代码已实现并提交：[laiqiaojie/admin#1](https://gitea.g-hi.com/laiqiaojie/admin/pulls/1)
按 REVIEW.md「跳过评审的路径」，`plan/` 产物文件不需要 Tech Lead 单独审核，随此 PR 直接入库。...
|
0
|
0
|
1
|
1
|
1
|
|
0
|
1788245555
|
1789379899
|
1788245966
|
0
|
1
|
0
|
Edit
Delete
|
|
756
|
85
|
1
|
4
|
|
0
|
[Intent] 按省市统计设备月度新增上线数量报表
|
Related to #8
## 需求摘要
在「数据报表 > 设备分析」下新增报表，按月筛 Related to #8
## 需求摘要
在「数据报表 > 设备分析」下新增报表，按月筛选展示各省份新激活上线设备数量柱状图排行，支持下钻到城市维度。
## 核心决策
- 统计口径：当月**新激活**上线设备（首次上线，取 ahead_authenticate_log 表的 create_time 字段）
- 地区归属：取设备绑定**门店地址**的省/市字段
- 交互方式：点击省份**下钻**到城市排行（非 Tab 切换）
- 权限：跟随现有 agent_id 角色体系，超管看全国，运营商看自己区域
## 不在范围内
- 不做 Excel 导出
- 不做地图热力图
- 不做区/县级别
- 不做跨月趋势
## 产物文件
[intent/device-online-stats-by-region.md](https://gitea.g-hi.com/laiqiaojie/jh-project/src/branch/intent/device-online-stats-by-region/intent/device-online-stats-by-region.md)
## PM 审核清单（参考 REVIEW.md）
- [ ] 需求背景和问题描述是否准确反映了原始诉求？
- [ ] 期望结果是否可验证？
- [ ] 不在范围内的排除项是否合理？
- [ ] 受影响系统判断是否正确（admin / ahead_authenticate_log）？
- [ ] 本次是否接受排期，进入 Design 阶段？...
|
1
|
0
|
1
|
1
|
2
|
|
0
|
1787817232
|
1789379898
|
1787823622
|
0
|
5
|
0
|
Edit
Delete
|
|
757
|
85
|
2
|
4
|
|
0
|
[Design] 按省市统计设备月度新增上线数量报表
|
## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https:// ## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/1)
---
## 审核顺序：PM 先确认原型，再由 Tech Lead Approve
---
## 第一步：PM 确认原型
**原型文件：**
（从仓库拉取后浏览器直接双击打开，可点击交互）
页面状态：
- 全国省份视图 — 月份筛选器 + 当月总数卡片 + 各省份横向柱状图
- 城市下钻视图 — 点击省份柱子进入，面包屑「全国 › 广东省」+ 城市排行
交互流程：点击省份柱子进入城市视图，点击面包屑「全国」或「返回全国」按钮返回。
**PM 审核 checklist：**
- [ ] 页面布局和组件符合预期？
- [ ] 交互路径（下钻、返回）正确？
- [ ] 数据定义（新增上线 = 首次激活，归属 = 门店地址）理解一致？
- [ ] 权限范围（超管看全国，运营商看自己区域）正确？
**PM 确认方式：在本 PR 评论「原型确认 ✅」即可，无需 Approve**
---
## 第二步：Tech Lead 审核（PM 确认后进行）
**数据链路：**
> 待确认：ahead_family_servers._shop_id 是否关联 ahead_yc_shop._id，Build 阶段查库验证。
**新增接口（新建控制器 DeviceOnlineReport.php）：**
- POST /DeviceOnlineReport/getStats — 省份排行 + 当月总数
- POST /DeviceOnlineReport/getCityStats — 城市下钻
**权限：** agent_id 从 session 取，= 0 为超管不过滤
**安全：** month 正则校验、province_id intval()、agent_id 不信任前端
**Tech Lead 审核 checklist：**
- [ ] 数据链路正确？表关联关系有无误判？
- [ ] 接口设计合理？参数和响应格式符合规范？
- [ ] 权限处理方式正确？
- [ ] 安全检查要点覆盖？
- [ ] 前端方案可行（ECharts 按需引入）？
**Tech Lead Approve → Merge → 评审会议（里程碑内所有需求一起）→ Plan 阶段**...
|
1
|
0
|
1
|
1
|
0
|
|
0
|
1787824027
|
1789379887
|
1787829412
|
0
|
3
|
0
|
Edit
Delete
|
|
758
|
85
|
3
|
4
|
|
0
|
[Design] 按省市统计设备月度新增上线数量报表
|
Related to #8
## 关联 Intent
[PR #1 — 按省市统计设备月度新增上 Related to #8
## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/1)
---
## PM 确认原型
**需求说明文档：**
[design/device-online-stats-by-region.md](https://gitea.g-hi.com/laiqiaojie/jh-project/src/branch/design/device-online-stats-by-region/design/device-online-stats-by-region.md)
**在线原型（点击直接打开，可交互，无需登录）：**
https://claude.ai/code/artifact/b50eaa98-689b-4742-8024-cdf74f95d5c8
**页面状态：**
- 全国省份视图 — 月份筛选器 + 当月总数卡片 + 各省份横向柱状图
- 城市下钻视图 — 点击省份柱子进入，面包屑「全国 › 广东省」+ 城市排行
**交互流程：** 点击省份柱子进入城市视图，点击面包屑「全国」或「返回全国」按钮返回。
**审核 checklist：**
- [ ] 页面布局和组件符合预期？
- [ ] 交互路径（下钻、返回）正确？
- [ ] 数据定义（新增上线 = 首次上线，归属 = 门店注册地址）理解一致？
- [ ] 权限范围（超管看全国，运营商看自己区域）正确？
**确认方式：在本 PR 评论「原型确认 ✅」，然后 Approve + Merge**...
|
1
|
0
|
1
|
1
|
0
|
|
0
|
1787829439
|
1789379899
|
1787908921
|
0
|
7
|
0
|
Edit
Delete
|
|
132
|
6
|
7
|
5
|
|
0
|
Refresh governance coverage counts in AGENTS.md
|
## 模块治理摘要
- 模块：
- 战区：
- lane：
- 阶段：
- 分类：`模 ## 模块治理摘要
- 模块：
- 战区：
- lane：
- 阶段：
- 分类：`模块专项通过 / 工作区漂移 / 阻断`
- 结论：
- 战役卡：
- 验收卡：
- runner evidence bundle：
## 验证命令
| 命令 | 结果 | 备注 |
| --- | --- | --- |
| | | |
| | | |
| | | |
## 审计命中
- `audit:tenant`：
- `audit:events`：
- `audit:route-contract`：
- `audit:docs-single-source`：
- 如未跑全量，请说明原因：
## 前端 / 页面验收
- canonical 入口：
- smoke / auth-scope：
- alias / compat 回归：
## 残余风险
- 风险 1：
- 风险 2：
## 文档同步
- [ ] `CLAUDE.md`
- [ ] `AGENTS.md`
- [ ] `README.md`
- [ ] `GEMINI.md`
- [ ] 治理经验库 / 专项记录
## 口径确认
- [ ] 本 PR 只宣称模块级通过，不把模块结果外推为工作区全绿
- [ ] 若存在工作区漂移，已明确标记且未误记到当前模块
- [ ] 若存在热修 lane，已与全域补证据 / build-out lane 隔离
...
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1779068050
|
1779069305
|
1779068087
|
0
|
0
|
0
|
Edit
Delete
|
|
740
|
21
|
328
|
1
|
|
0
|
Merge pull request '套餐购买页“购买时长"页签根据后台设置显隐& Merge pull request '套餐购买页“购买时长"页签根据后台设置显隐' (#321) from pay into pay-260818...
|
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1786672685
|
1786672694
|
1786672694
|
0
|
0
|
0
|
Edit
Delete
|
|
671
|
18
|
204
|
1
|
|
0
|
Merge pull request '合并0519最新' (#112) from Merge pull request '合并0519最新' (#112) from pc into pc-260616...
|
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1781141864
|
1781141874
|
1781141874
|
0
|
0
|
0
|
Edit
Delete
|
|
614
|
22
|
74
|
1
|
|
0
|
Merge pull request '合并0519' (#5) from app Merge pull request '合并0519' (#5) from app into app-260616...
|
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1780972453
|
1780972468
|
1780972468
|
0
|
0
|
0
|
Edit
Delete
|
|
707
|
22
|
91
|
1
|
|
0
|
Merge pull request '一些bug' (#90) from app Merge pull request '一些bug' (#90) from app into app-260728...
|
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1784871262
|
1784871267
|
1784871267
|
0
|
0
|
0
|
Edit
Delete
|
|
672
|
21
|
308
|
1
|
|
0
|
Merge pull request '260519分支分支' (#3) from Merge pull request '260519分支分支' (#3) from pay into pay-260616...
|
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1781141923
|
1781141933
|
1781141933
|
0
|
0
|
0
|
Edit
Delete
|
|
670
|
23
|
37
|
1
|
|
0
|
Merge pull request '0519' (#3) from admin Merge pull request '0519' (#3) from admin into admin-260616...
|
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1781141783
|
1781141791
|
1781141791
|
0
|
0
|
0
|
Edit
Delete
|
|
131
|
6
|
6
|
5
|
|
0
|
Fix CRUD visible runner timeouts and permissions
|
## 模块治理摘要
- 模块：
- 战区：
- lane：
- 阶段：
- 分类：`模 ## 模块治理摘要
- 模块：
- 战区：
- lane：
- 阶段：
- 分类：`模块专项通过 / 工作区漂移 / 阻断`
- 结论：
- 战役卡：
- 验收卡：
- runner evidence bundle：
## 验证命令
| 命令 | 结果 | 备注 |
| --- | --- | --- |
| | | |
| | | |
| | | |
## 审计命中
- `audit:tenant`：
- `audit:events`：
- `audit:route-contract`：
- `audit:docs-single-source`：
- 如未跑全量，请说明原因：
## 前端 / 页面验收
- canonical 入口：
- smoke / auth-scope：
- alias / compat 回归：
## 残余风险
- 风险 1：
- 风险 2：
## 文档同步
- [ ] `CLAUDE.md`
- [ ] `AGENTS.md`
- [ ] `README.md`
- [ ] `GEMINI.md`
- [ ] 治理经验库 / 专项记录
## 口径确认
- [ ] 本 PR 只宣称模块级通过，不把模块结果外推为工作区全绿
- [ ] 若存在工作区漂移，已明确标记且未误记到当前模块
- [ ] 若存在热修 lane，已与全域补证据 / build-out lane 隔离
...
|
0
|
0
|
0
|
1
|
0
|
|
0
|
1778907435
|
1778907436
|
0
|
0
|
0
|
0
|
Edit
Delete
|
|
94
|
6
|
2
|
5
|
|
0
|
Encode DB credentials in synced local env URLs
|
## 模块治理摘要
- 模块：
- 战区：
- lane：
- 阶段：
- 分类：`模 ## 模块治理摘要
- 模块：
- 战区：
- lane：
- 阶段：
- 分类：`模块专项通过 / 工作区漂移 / 阻断`
- 结论：
- 战役卡：
- 验收卡：
- runner evidence bundle：
## 验证命令
| 命令 | 结果 | 备注 |
| --- | --- | --- |
| | | |
| | | |
| | | |
## 审计命中
- `audit:tenant`：
- `audit:events`：
- `audit:route-contract`：
- `audit:docs-single-source`：
- 如未跑全量，请说明原因：
## 前端 / 页面验收
- canonical 入口：
- smoke / auth-scope：
- alias / compat 回归：
## 残余风险
- 风险 1：
- 风险 2：
## 文档同步
- [ ] `CLAUDE.md`
- [ ] `AGENTS.md`
- [ ] `README.md`
- [ ] `GEMINI.md`
- [ ] 治理经验库 / 专项记录
## 口径确认
- [ ] 本 PR 只宣称模块级通过，不把模块结果外推为工作区全绿
- [ ] 若存在工作区漂移，已明确标记且未误记到当前模块
- [ ] 若存在热修 lane，已与全域补证据 / build-out lane 隔离
...
|
0
|
0
|
0
|
1
|
5
|
|
0
|
1777515695
|
1779328857
|
0
|
0
|
0
|
0
|
Edit
Delete
|
|
155
|
21
|
2
|
1
|
|
0
|
260519分支分支
|
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1779154516
|
1779154531
|
1779154531
|
0
|
0
|
0
|
Edit
Delete
|
|
156
|
21
|
3
|
1
|
|
0
|
260519分支分支
|
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1779154605
|
1781141934
|
1779154649
|
0
|
0
|
0
|
Edit
Delete
|
|
673
|
32
|
1
|
1
|
|
0
|
222
|
|
0
|
0
|
0
|
1
|
0
|
|
0
|
1781158798
|
1781158798
|
0
|
0
|
0
|
0
|
Edit
Delete
|
|
21
|
2
|
21
|
1
|
|
0
|
11111
|
测试
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1773910676
|
1773910796
|
1773910698
|
0
|
0
|
0
|
Edit
Delete
|
|
776
|
18
|
223
|
1
|
|
0
|
11111
|
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1789436327
|
1789436336
|
1789436336
|
0
|
0
|
0
|
Edit
Delete
|
|
375
|
18
|
166
|
1
|
|
0
|
1111
|
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1779870591
|
1779870599
|
1779870599
|
0
|
0
|
0
|
Edit
Delete
|
|
693
|
23
|
41
|
1
|
|
0
|
1111
|
|
0
|
0
|
1
|
1
|
0
|
|
0
|
1783990894
|
1783990913
|
1783990913
|
0
|
0
|
0
|
Edit
Delete
|