From 7aa3ead427d22f62c6d648bc3905660748dbe457 Mon Sep 17 00:00:00 2001 From: ouyangxq <775153912@qq.com> Date: Fri, 31 Jul 2026 12:03:21 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BC=98=E5=8C=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 4 ++-- audit-service/AGENTS.md | 6 ++---- common-audit/AGENTS.md | 1 - file/AGENTS.md | 4 ++-- iam/README-IAM.md | 2 +- 5 files changed, 7 insertions(+), 10 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 8d1ac99f6..ac5ad24c0 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -15,7 +15,7 @@ | `common-web/` | 全局异常与请求链路标识 | `GlobalExceptionHandler.java`、`CorrelationIdFilter.java` | | `common-security/` | JWT、Redis 会话校验、认证上下文、401/403 | `JwtAuthenticationFilter.java`、`RedisAccessTokenSessionValidator.java` | | `common-openapi/` | SpringDoc 自动配置 | `BaiyueOpenApiAutoConfiguration.java`、`OpenApiProperties.java` | -| `common-audit/` | 审计注解、切面、脱敏与发送 | `BusinessAuditAspect.java`、`SensitiveDataSanitizer.java`、`AuditSink.java` | +| `common-audit/` | 审计注解、切面、脱敏与日志/HTTP 发送 | `BusinessAuditAspect.java`、`SensitiveDataSanitizer.java`、`HttpAuditSink.java` | | `common-event-contract/` | 跨区域事件信封、类型、标识、哈希与校验 | `EventEnvelope.java`、`EventTypes.java`、`EventEnvelopeValidator.java` | | `gateway/` | 路由、CORS、入口安全、访问域隔离 | `config/`、`filter/`、`src/main/resources/application*.yml` | | `auth/` | 登录、令牌、注册、账号与密码 | `controller/`、`service/`、`src/main/resources/db/` | @@ -25,7 +25,7 @@ | `warehouse/` | 仓库、地址、服务能力与往来单位 | `controller/`、`WarehouseApplicationService.java`、`PartnerQueryService.java` | | `file/` | 企业资质文件本地存储、预览与鉴权 | `controller/`、`LocalQualificationStorage.java`；元数据表结构尚未接入 | | `print/` | 打印中心边界 | 当前为应用、健康检查和 `print/src/main/resources/db/print.sql` 骨架 | -| `audit-service/` | 审计事件接收与持久化 | `AuditIngestController.java`、`AuditIngestService.java` | +| `audit-service/` | 审计事件接收与持久化 | `AuditIngestController.java`、`AuditIngestService.java`；当前接收接口未实现内部令牌保护 | | `integration-service/` | OCR、Amazon 等第三方适配 | `provider/`、`IntegrationProperties.java` | | `event-bridge-service/` | 跨区域事件接收、校验与 Inbox 幂等 | `EventBridgeController.java`、`EventInboxService.java` | diff --git a/audit-service/AGENTS.md b/audit-service/AGENTS.md index e6ab1d923..ad60fe04b 100644 --- a/audit-service/AGENTS.md +++ b/audit-service/AGENTS.md @@ -11,17 +11,15 @@ |---|---| | 应用入口 | `src/main/java/com/baiyue/audit/BaiyueAuditApplication.java` | | 内部接收 API | `controller/AuditIngestController.java`（`/internal/audit/events`） | -| 内部令牌保护 | `security/InternalServiceTokenGuard.java` | | 接收 DTO | `dto/AuditIngestRequest.java` | | 入库编排 | `service/AuditIngestService.java` | | 持久化 | `entity/AuditLogEntity.java`、`mapper/AuditLogMapper.java`、`repository/AuditEventRepository.java` | | 表结构 | `src/main/resources/db/audit.sql` | | 本地/Nacos 配置 | `src/main/resources/application.yml`、`../config/nacos/{local,cn}/audit-service.yml` | -| 内部令牌测试 | `src/test/java/com/baiyue/audit/security/InternalServiceTokenGuardTest.java` | ## 修改与验证 -- 内部接收接口必须受可信服务身份保护；不对前端直接开放。 +- 当前接收接口尚未实现内部令牌保护，仅适合受控本地/内网联调；部署到共享或生产环境前必须补齐可信服务身份校验，且不对前端开放。 - 入库前确保密码、Token、证件等敏感信息已脱敏；新增字段时同步检查 `../common-audit/src/main/java/com/baiyue/common/audit/AuditEvent.java` 与发送实现。 - 审计链路故障不得阻塞核心交易；保留幂等、超时、容量和留存策略的演进空间。 -- 从父目录运行 `mvn -pl audit-service -am test`，并验证接收、拒绝非法请求和持久化结果。 +- 当前没有专属自动化测试；从父目录运行 `mvn -pl audit-service -am test`，并按改动验证接收和持久化结果。 diff --git a/common-audit/AGENTS.md b/common-audit/AGENTS.md index cb0a8e9b8..e34c18bea 100644 --- a/common-audit/AGENTS.md +++ b/common-audit/AGENTS.md @@ -15,7 +15,6 @@ | 敏感数据脱敏 | `SensitiveDataSanitizer.java` | | `baiyue.audit` 配置 | `AuditProperties.java` | | 自动配置 | `BaiyueAuditAutoConfiguration.java` 与 `src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports` | -| 远程发送鉴权测试 | `src/test/java/com/baiyue/common/audit/HttpAuditSinkTest.java` | ## 修改与验证 diff --git a/file/AGENTS.md b/file/AGENTS.md index 7130c7f70..72f978520 100644 --- a/file/AGENTS.md +++ b/file/AGENTS.md @@ -14,9 +14,9 @@ | 平台资质查看 | `controller/PlatformQualificationFileController.java` | | 服务状态 | `controller/FileHealthController.java` | | 当前本地磁盘实现 | `service/LocalQualificationStorage.java` | +| 未被当前 Controller 使用的旧实现 | `service/QualificationFileStorage.java` | | IAM 权限协作 | `client/IamQualificationClient.java` | | 目标表结构（尚未接入） | `src/main/resources/db/file.sql` | -| 存储边界测试 | `src/test/java/com/baiyue/file/service/LocalQualificationStorageTest.java` | | 本地/Nacos 配置 | `src/main/resources/application.yml`、`../config/nacos/{local,cn}/file-service.yml` | ## 修改与验证 @@ -24,4 +24,4 @@ - 严格校验租户、文件名/路径、大小、类型和读取权限，防止目录穿越、越权访问和任意文件上传。 - 生产存储应使用对象存储或共享文件存储；容器本地目录仅适合当前本地实现，不得硬编码环境路径。 - 接入元数据持久化时需同时实现 Entity、Mapper、Repository、事务和迁移验证，并同步检查 IAM 资质流程及平台/商户 Controller。 -- 从父目录运行 `mvn -pl file -am test`，并按接口影响验证上传、预览、无权限和非法文件场景。 +- 当前没有专属自动化测试；从父目录运行 `mvn -pl file -am test`，并按接口影响验证上传、预览、无权限和非法文件场景。 diff --git a/iam/README-IAM.md b/iam/README-IAM.md index 6bb91ca65..58d0e9de6 100644 --- a/iam/README-IAM.md +++ b/iam/README-IAM.md @@ -23,7 +23,7 @@ Merge the packages under `src/main/java` into `D:/baiyue/iam/src/main/java`; exe | GET/PUT | `/api/merchant/v1/iam/tenant/profile` | MERCHANT | View/update own profile / 企业资料 | | GET/POST | `/api/merchant/v1/iam/members` | MERCHANT | List/add members / 成员 | | GET/POST | `/api/{app}/v1/iam/roles` | PLATFORM/MERCHANT | Role management / 角色 | +| GET | `/api/{app}/v1/iam/authorization/permissions` | PLATFORM/MERCHANT | Current user's active permission codes / 当前用户有效权限编码 | | GET/POST | `/api/{app}/v1/iam/permissions` | PLATFORM/MERCHANT | Permission tree / 权限树 | OpenAPI is synchronized in `openapi/iam-v1.yaml`. -