@xiangyang9999/folib-server-scan-export-sync 1.0.0 → 1.0.1

package/README.md

@@ -1,80 +1,73 @@
 # @xiangyang9999/folib-server-scan-export-sync
 
-`folib-server` 扫描报告异步/定时导出功能的**离线手工同步资料包**，用于受网络限制、只能手工输入代码的环境。**不是可直接加载到 folib-server 的业务功能插件**。
+版本 `1.0.1`：扫描报告导出测试修复的离线手工同步增量包。
 
-- 来源 Git 提交：`a28ada525f48cf8b6ea3024d4f3eda83cc6d358a`
-- 仅包含该提交的相关变更；已排除 `tools/scan-export/` 全目录。
-- 涉及 50 个文件，保留原目录结构。
-- 安装或运行此包不会修改 `folib-server` 项目文件。
+- 源提交：`454e63ce953114b039fe3de06185f5a9a4d1c812`。
+- 相对父提交：`d272e5684448e626126ad070cf9a52a3cc9f1eef`。
+- 使用前提：已同步扫描导出功能提交 `a28ada525f48cf8b6ea3024d4f3eda83cc6d358a`，或旧资料包 `1.0.0`。
+- 共 7 个文件：新增 1 个、修改 6 个；沿用旧包范围，排除 `tools/scan-export/`。
+- 这 7 个文件在 `a28ada52` 与修复提交的父提交之间没有其他改动，可直接接在旧包后同步。
+- 本包从 Git 提交提取代码，不包含当前工作区未提交的修改或中间的前端依赖提交。
 
-## 包内文件
+## 修复内容
 
-| 包内路径 | 说明 |
-| --- | --- |
-| `payload/内网手工同步修改说明.docx` | Word 逐文件手敲说明：新增文件完整代码、现有文件的精确差异、同步顺序及检查项 |
-| `payload/涉及文件_按原路径.zip` | 50 个提交版本文件，另附文件清单；保持原有项目路径 |
-| `payload/完整变更补丁_供核对.patch` | 该提交相对父提交的完整变更，用于差异比对 |
+恢复固定的 `org.mockito.internal.creation.bytebuddy.SubclassByteBuddyMockMaker`，移除 web POM 中本功能新增的 MockMaker 属性和测试资源过滤。两个新增导出测试改用真实请求上下文、RepositoryPath 和普通 mock。storage 模块新增 9 项 Repository 查询测试，并修复原漏洞筛选测试的 mock 链及断言。
 
-## 安装和提取
+`ArtifactRepository.java` 的生产实现、storage POM、前端及数据库均没有本次增量变更。旧包中的扫描导出业务代码继续保留；web POM 的变更是恢复原有配置，不添加新的打包或覆盖率参数。
 
-使用 npm 包内命令，将三个资料文件复制到任意输出目录。**只复制资料，不直接把代码覆盖到项目中。**
+## 包内资料
 
-```bash
-# 已发布到可访问的 npm 仓库后：
-npx --yes --package @xiangyang9999/folib-server-scan-export-sync folib-scan-export-sync extract ./folib-sync
+| 路径 | 内容 |
+| --- | --- |
+| `payload/内网手工同步修改说明.docx` | 同步前提、逐文件说明、新增文件完整代码、修改文件精确差异及验证命令 |
+| `payload/涉及文件_按原路径.zip` | 7 个提交版本文件，保留原路径；附文件清单和含 SHA-256 的 `manifest.json` |
+| `payload/完整变更补丁_供核对.patch` | 本次 7 个文件的精确增量补丁；排除 tools 目录 |
 
-# 或先安装，再执行：
-npm install @xiangyang9999/folib-server-scan-export-sync
-npx folib-scan-export-sync list
-npx folib-scan-export-sync extract ./folib-sync
-```
+ZIP 中既有文件提供的是完整提交版本，主要用于核对；手工同步时按 Word 或补丁逐段修改，避免覆盖目标环境自身的其他改动。
+
+## 离线安装与提取
 
-命令默认不覆盖目标目录中已经存在的文件。如果需要覆盖，请显式加 `--force`：
+将 `.tgz` 复制到目标机器后执行：
 
 ```bash
-npx folib-scan-export-sync extract ./folib-sync --force
+npm install ./xiangyang9999-folib-server-scan-export-sync-1.0.1.tgz
+npx --no-install folib-scan-export-sync list
+npx --no-install folib-scan-export-sync extract ./folib-sync-454e63ce9
 ```
 
-在不能联网的机器上，也可将生成的 `.tgz` 拷贝进去，然后：
+提取命令只复制三个资料文件，不修改项目代码。默认拒绝覆盖已有资料；需要替换时显式添加 `--force`。
 
 ```bash
-npm install ./xiangyang9999-folib-server-scan-export-sync-1.0.0.tgz
-npx folib-scan-export-sync extract ./folib-sync
+npx --no-install folib-scan-export-sync extract ./folib-sync-454e63ce9 --force
 ```
 
-## 发布到 npm 仓库（需要拥有对应 scope 的发布权限）
+## 手工同步顺序
 
-在 **`npm-package` 目录** 内执行：
+1. 确认旧包 `1.0.0` 对应的导出功能已同步。
+2. 恢复 `folib-web-core/pom.xml` 中原有配置及固定的 MockMaker 资源。
+3. 同步两个 web 导出测试的差异。
+4. 新增 storage 的 `ArtifactRepositoryScanExportTest.java`，修复 `ArtifactRepositoryTest.java` 中的漏洞筛选用例。
+5. 更新 `SCAN_EXPORT.md`，执行其中的定向测试命令，按现有 CI 流程收集 storage 覆盖率。
 
-```bash
-npm pack --dry-run
-npm pack
-```
+## 已完成的本地验证
 
-**优先使用内网私有 npm Registry**（例如公司已有的 npm 仓库，示例 URL 请替换）：
+2026-10-10：web 定向回归 141 项通过，其中包含 10 类导出测试的 77 项；storage 新增 9 项与修复的 1 项测试全部通过。使用本地临时命令行 JaCoCo agent，`ArtifactRepository.java` 第 205–277 行的 49 个可执行行全部命中，分支覆盖 74/81。没有修改 storage 的 Surefire 配置。
 
-```bash
-npm login --registry=https://npm.example.internal/
-npm publish --registry=https://npm.example.internal/
-```
+上述结果来自本地验证，Jenkins 的实际覆盖率仍需由现有 CI 执行及收集。定向 `package` 验证不等同于正式发行包验收。
+
+## 重新打包
 
-如果已经取得源码公开分发授权、确实打算发布到公开的 npmjs.com，才运行：
+在 `npm-package` 目录中执行：
 
 ```bash
-npm login --registry=https://registry.npmjs.org/
-npm publish --access public --registry=https://registry.npmjs.org/
+npm pack --dry-run --ignore-scripts
+npm pack --ignore-scripts
 ```
 
-**重要提醒：本包包含项目源码及其修改差异。发布到公开 npm Registry 后，包内容可被任何人下载。发布前请确认源码授权、内部地址、凭据及其他敏感信息均允许分发。** 不要把 `--access public` 当作普通内网发布参数。
+如需上传到内网 npm 仓库，在该目录执行并替换仓库地址：
 
-更新源代码资料后，应同步更新 `payload/` 文件，修改 `package.json` 的 `version`，再重新打包发布；npm 不能覆盖已发布的同名同版本。
-
-## 手工同步顺序
-
-1. 按 Word 文档先处理数据库 Liquibase 变更和后端 Repository/Adapter。
-2. 录入后端 `export/`、Mapper、Controller 等新增文件及原代码修改。
-3. 录入前端 API、组件、国际化和页面修改。
-4. 对照 `.patch` 和 ZIP 源文件，核查手敲代码。
-5. 在内网独立进行编译、数据库迁移、权限和导出功能验证。
+```bash
+npm publish --registry=https://npm.example.internal/
+```
 
-本包只对源提交内容作离线整理，**不保证内网目标代码版本兼容，也不代表已经通过项目集成测试**。
+本目录生成的是本地安装包，未执行发布。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xiangyang9999/folib-server-scan-export-sync",
-  "version": "1.0.0",
-  "description": "Offline manual-sync bundle for folib-server artifact scan report export commit a28ada52 (Word, source archive and diff).",
+  "version": "1.0.1",
+  "description": "Offline incremental sync bundle for folib-server scan export Mockito compatibility and coverage fix commit 454e63ce9.",
   "license": "UNLICENSED",
   "bin": {
     "folib-scan-export-sync": "./bin/folib-scan-export-sync.js"
@@ -20,5 +20,7 @@
     "offline-sync",
     "manual-migration",
     "internal-code"
-  ]
+  ],
+  "sourceCommit": "454e63ce953114b039fe3de06185f5a9a4d1c812",
+  "syncBaseCommit": "a28ada525f48cf8b6ea3024d4f3eda83cc6d358a"
 }