diff --git a/AGENTS.md b/AGENTS.md index 2a2e661..b98b7b9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -3,7 +3,7 @@ ## 项目定位 - 本项目是入驻企业及其成员使用的客户工作台,所有业务数据都处于企业租户上下文中。 -- 当前范围包括注册、业务总览、企业资料、企业成员、企业角色与权限、头程订单和客户财务账单只读查询。 +- 当前范围包括注册、业务总览、企业资料、企业成员、企业角色与权限、头程订单,以及客户财务账单查询与客户确认。 - 不在本项目实现平台内部运营管理、品牌官网、仓库 PDA 作业或仅属于原生移动端的能力。 ## 技术基线 @@ -48,7 +48,7 @@ | 企业成员消息收件箱 | `src/modules/notifications/` | Backend `iam/src/main/java/com/baiyue/iam/notification/`;列表、详情、已读与未读数契约见 `iam/src/main/resources/openapi/notification-v1.yaml` | | 头程下单、订单、箱唛与履约进度 | `src/modules/first-leg/`;箱唛下载消费者从 `views/FirstLegOrdersView.vue`、`api/firstLeg.ts` 进入 | Backend `order/`、`firstleg/`、`warehouse/`;稳定箱码与打印契约先读 Backend `firstleg/AGENTS.md` | | 统一订单展示 | `src/modules/order-management/` | `src/modules/first-leg/` 与对应后端订单契约 | -| 客户财务账单、收款与未收余额 | `src/modules/finance/` | Backend `finance/`;以登录态客户隔离,只读接口从 `api/finance.ts` 进入 | +| 客户财务账单、收款、未收余额与客户确认 | `src/modules/finance/` | Backend `finance/`;以登录态客户隔离,查询和确认接口从 `api/finance.ts` 进入 | | 跨境与海外仓候选能力 | `src/modules/cross-border/`、`src/modules/overseas-warehouse/` | 先核对各自 `routes.ts` 的发布状态与阶段范围,不自动扩展实现 | ## 租户、认证与数据安全 diff --git a/src/modules/finance/views/FinanceBillsView.test.mjs b/src/modules/finance/views/FinanceBillsView.test.mjs index da7f842..84d81f7 100644 --- a/src/modules/finance/views/FinanceBillsView.test.mjs +++ b/src/modules/finance/views/FinanceBillsView.test.mjs @@ -131,4 +131,6 @@ test('keeps the existing customer finance view permission mapping', () => { assert.match(permissionSource, /merchant:finance:statement:list/) assert.match(permissionSource, /merchant:finance:statement:view/) assert.match(permissionSource, /FRONTEND_PERMISSIONS_REQUIRING_ALL_BACKEND_CODES/) + assert.match(permissionSource, /code: 'finance:bill:confirm'/) + assert.match(permissionSource, /'finance:bill:confirm': \['merchant:finance:statement:confirm'\]/) }) diff --git a/src/modules/tenant-management/contracts.ts b/src/modules/tenant-management/contracts.ts index 08a8694..52a0831 100644 --- a/src/modules/tenant-management/contracts.ts +++ b/src/modules/tenant-management/contracts.ts @@ -28,7 +28,10 @@ export const TENANT_PERMISSION_GROUPS: readonly TenantPermissionGroup[] = [ { key: 'finance', label: '财务账单', - items: [{ code: 'finance:bill:view', label: '查看客户账单', description: '查看本企业账单、收款记录和未收余额;不包含任何财务写操作' }], + items: [ + { code: 'finance:bill:view', label: '查看客户账单', description: '查看本企业账单、收款记录和未收余额' }, + { code: 'finance:bill:confirm', label: '确认客户账单', description: '确认本企业已出账且待客户确认的对账单' }, + ], }, { key: 'orders', @@ -102,6 +105,7 @@ export const FRONTEND_TO_MERCHANT_PERMISSION_CODES: Readonly