543 lines
24 KiB
Markdown
543 lines
24 KiB
Markdown
# 服务机构端 C0 基础骨架 实施计划
|
||
|
||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||
|
||
**Goal:** 在 sysmgr 脚手架（ec-nest + ec-admin）上落地服务机构端 C0 基础骨架：机构=租户映射、staff 关联账号、目录四层、权限/错误码/审计、后台业务菜单。
|
||
|
||
**Architecture:** 复用脚手架的多租户过滤（tenantCode）、RBAC（resource 树 + 权限码）、审计、软删。业务全部纯新增（不侵入脚手架）：后端新增 agency/staff/catalog 模块，前端新增「长护服务」菜单组。
|
||
|
||
**Tech Stack:** NestJS 12 + Prisma 6 + MySQL 8（utf8mb4_general_ci）、Vue 3 + Vite + Pinia + UnoCSS。
|
||
|
||
**Spec:** `openspec/changes/svc-org-c0-base/`（proposal + specs + design + tasks）；设计背景见 `docs/superpowers/specs/2026-10-14-服务机构端-C0基础骨架-design.md`。
|
||
|
||
## Global Constraints
|
||
|
||
- 机构=租户：机构唯一标识 = 脚手架 `tenant_code`；`Agency.code` 与 `tenant.code` 同值。
|
||
- 业务表主键 UUID v7（`@default(uuid(7)) @db.VarChar(36)`）；列 snake_case（camelCase + `@map`）。
|
||
- 软删用 `deleted_at`（时间戳），不用 `is_deleted` 布尔。
|
||
- 不动脚手架任何现有文件（`sys_user`、`sys_tenant`、`Org`、菜单 tree 等只读不改）；业务代码落新目录/新模型。
|
||
- 权限码 `domain:action`；业务错误码 5 位 [域2][序3]。
|
||
- 命名：PRD 的 `org`（机构）→ Prisma 模型 `Agency`（表 `sys_agency`），因脚手架 `Org` 已被「组织管理」占用。
|
||
|
||
## Review Focus
|
||
|
||
1. 跨租户数据泄漏：A 机构账号读不到 B 机构的 staff/svc_org（多租户过滤必须生效）。
|
||
2. Agency 与 tenant 一致：创建机构时 `Agency.code` MUST == `tenant.code`，两者事务内同步。
|
||
3. 目录全局 vs 业务租户隔离：svc_national/svc_local/svc_mapping/dict/loc_config 是全局（TENANT_FREE），staff/svc_org 是租户级；别把全局表误加租户过滤。
|
||
4. staff.user_id 唯一：一个 user 最多一条 staff（`@unique` 可空）。
|
||
5. 仅持 director 的账号写接口 → 403；兼 qc/admin 按并集放行。
|
||
|
||
---
|
||
|
||
### Task 1: Prisma 模型 + 多租户/软删清单
|
||
|
||
**Files:**
|
||
- Modify: `sources/ec-nest/prisma/schema.prisma`（追加 9 个模型）
|
||
- Modify: `sources/ec-nest/src/prisma/prisma.service.ts:6,8`（`TENANT_FREE`、`SOFT_DELETE` 集合）
|
||
|
||
**Interfaces:**
|
||
- Produces: Prisma 模型 `Agency`、`Staff`、`SvcNational`、`SvcLocal`、`SvcMapping`、`SvcOrg`、`DictAbnormalType`、`DictPhotoTier`、`LocConfig`。
|
||
|
||
- [ ] **Step 1: 追加 9 个 Prisma 模型**（追加到 schema.prisma 末尾）
|
||
|
||
```prisma
|
||
/// 机构（=租户的业务信息，1:1 于 Tenant，code 与 tenant.code 同值）
|
||
model Agency {
|
||
code String @id @db.VarChar(64)
|
||
orgName String @map("org_name") @db.VarChar(100)
|
||
orgType String @map("org_type") @db.VarChar(20)
|
||
creditCode String @map("credit_code") @db.VarChar(18)
|
||
locCode String @map("loc_code") @db.VarChar(12)
|
||
locName String @map("loc_name") @db.VarChar(50)
|
||
svcSource String @map("svc_source") @db.VarChar(10)
|
||
licenseNo String? @map("license_no") @db.VarChar(50)
|
||
address String @map("address") @db.VarChar(200)
|
||
contactName String @map("contact_name") @db.VarChar(30)
|
||
contactPhone String @map("contact_phone") @db.VarChar(15)
|
||
bedCount Int? @map("bed_count")
|
||
signDate DateTime? @map("sign_date") @db.Date
|
||
createdAt DateTime @default(now()) @map("created_at")
|
||
createdBy String? @map("created_by") @db.VarChar(36)
|
||
updatedAt DateTime @updatedAt @map("updated_at")
|
||
deletedAt DateTime? @map("deleted_at")
|
||
|
||
@@map("sys_agency")
|
||
}
|
||
|
||
/// 人员（护理员/医护/组长，账号在 User，staff.user_id 关联 user.id）
|
||
model Staff {
|
||
id String @id @default(uuid(7)) @db.VarChar(36)
|
||
tenantCode String @map("tenant_code") @db.VarChar(64)
|
||
userId String? @unique @map("user_id") @db.VarChar(36)
|
||
name String @db.VarChar(30)
|
||
idCardNo String @map("id_card_no") @db.VarChar(255)
|
||
personCode String? @map("person_code") @db.VarChar(20)
|
||
phone String @db.VarChar(15)
|
||
jobType String @map("job_type") @db.VarChar(20)
|
||
workType String @map("work_type") @db.VarChar(10)
|
||
entryDate DateTime? @map("entry_date") @db.Date
|
||
leaveDate DateTime? @map("leave_date") @db.Date
|
||
employStatus String @map("employ_status") @db.VarChar(10)
|
||
certType String? @map("cert_type") @db.VarChar(20)
|
||
certNo String? @map("cert_no") @db.VarChar(50)
|
||
certLevel String? @map("cert_level") @db.VarChar(20)
|
||
certExpire DateTime? @map("cert_expire") @db.Date
|
||
certStatus String? @map("cert_status") @db.VarChar(20)
|
||
certVerifyUrl String? @map("cert_verify_url") @db.VarChar(200)
|
||
groupLeaderId String? @map("group_leader_id") @db.VarChar(36)
|
||
createdAt DateTime @default(now()) @map("created_at")
|
||
createdBy String? @map("created_by") @db.VarChar(36)
|
||
updatedAt DateTime @updatedAt @map("updated_at")
|
||
deletedAt DateTime? @map("deleted_at")
|
||
|
||
@@index([tenantCode, name])
|
||
@@map("sys_staff")
|
||
}
|
||
|
||
/// 国家基准库 L1（全局，36 项）
|
||
model SvcNational {
|
||
id String @id @default(uuid(7)) @db.VarChar(36)
|
||
natCode String @unique @map("nat_code") @db.VarChar(20)
|
||
natName String @map("nat_name") @db.VarChar(100)
|
||
natCategory String @map("nat_category") @db.VarChar(20)
|
||
natSubCategory String? @map("nat_sub_category") @db.VarChar(50)
|
||
recommendStaff String? @map("recommend_staff") @db.VarChar(50)
|
||
recommendDuration String? @map("recommend_duration") @db.VarChar(50)
|
||
isMedical Boolean @default(false) @map("is_medical")
|
||
version Int @default(1)
|
||
|
||
@@map("sys_svc_national")
|
||
}
|
||
|
||
/// 属地目录 L2（全局，昆明 45 项 / 州市引用 L1）
|
||
model SvcLocal {
|
||
id String @id @default(uuid(7)) @db.VarChar(36)
|
||
locCode String @map("loc_code") @db.VarChar(12)
|
||
localItemName String @map("local_item_name") @db.VarChar(100)
|
||
localCategory String? @map("local_category") @db.VarChar(20)
|
||
svcTime String? @map("svc_time") @db.VarChar(50)
|
||
minFreq String? @map("min_freq") @db.VarChar(50)
|
||
staffQual String? @map("staff_qual") @db.VarChar(50)
|
||
isMedical Boolean @default(false) @map("is_medical")
|
||
sourceDoc String? @map("source_doc") @db.VarChar(200)
|
||
mapStatus String @default("mapped") @map("map_status") @db.VarChar(20)
|
||
|
||
@@index([locCode])
|
||
@@map("sys_svc_local")
|
||
}
|
||
|
||
/// 属地↔国家映射 L3（全局，机构不可见）
|
||
model SvcMapping {
|
||
id String @id @default(uuid(7)) @db.VarChar(36)
|
||
locId String @map("loc_id") @db.VarChar(36)
|
||
natId String? @map("nat_id") @db.VarChar(36)
|
||
mapType String @map("map_type") @db.VarChar(20)
|
||
mapNote String? @map("map_note") @db.VarChar(200)
|
||
status String @default("confirmed") @db.VarChar(20)
|
||
|
||
@@index([locId])
|
||
@@map("sys_svc_mapping")
|
||
}
|
||
|
||
/// 机构项目库 L4（租户级：机构勾选+配价）
|
||
model SvcOrg {
|
||
id String @id @default(uuid(7)) @db.VarChar(36)
|
||
tenantCode String @map("tenant_code") @db.VarChar(64)
|
||
srcType String @map("src_type") @db.VarChar(10)
|
||
srcId String @map("src_id") @db.VarChar(36)
|
||
isEnabled Boolean @default(true) @map("is_enabled")
|
||
price String? @map("price") @db.VarChar(50)
|
||
priceEffective DateTime? @map("price_effective")
|
||
isNewNational Boolean @default(false) @map("is_new_national")
|
||
createdAt DateTime @default(now()) @map("created_at")
|
||
createdBy String? @map("created_by") @db.VarChar(36)
|
||
updatedAt DateTime @updatedAt @map("updated_at")
|
||
deletedAt DateTime? @map("deleted_at")
|
||
|
||
@@index([tenantCode, srcType])
|
||
@@map("sys_svc_org")
|
||
}
|
||
|
||
/// 异常分类字典（全局）
|
||
model DictAbnormalType {
|
||
id String @id @default(uuid(7)) @db.VarChar(36)
|
||
code String @unique @db.VarChar(50)
|
||
name String @db.VarChar(50)
|
||
sort Int @default(0)
|
||
|
||
@@map("sys_dict_abnormal_type")
|
||
}
|
||
|
||
/// 拍照分档字典（全局）
|
||
model DictPhotoTier {
|
||
id String @id @default(uuid(7)) @db.VarChar(36)
|
||
code String @unique @db.VarChar(20)
|
||
name String @db.VarChar(50)
|
||
tier String @db.VarChar(10)
|
||
|
||
@@map("sys_dict_photo_tier")
|
||
}
|
||
|
||
/// 统筹区配置（全局）
|
||
model LocConfig {
|
||
locCode String @id @map("loc_code") @db.VarChar(12)
|
||
locName String @map("loc_name") @db.VarChar(50)
|
||
svcSource String @map("svc_source") @db.VarChar(10)
|
||
itemCountRule String? @map("item_count_rule") @db.VarChar(100)
|
||
|
||
@@map("sys_loc_config")
|
||
}
|
||
```
|
||
|
||
- [ ] **Step 2: 更新 PrismaService 清单**（全局表加入 TENANT_FREE，软删表加入 SOFT_DELETE）
|
||
|
||
`prisma.service.ts` 第 6 行改为：
|
||
```ts
|
||
const TENANT_FREE = new Set(['Tenant', 'Agency', 'SvcNational', 'SvcLocal', 'SvcMapping', 'DictAbnormalType', 'DictPhotoTier', 'LocConfig']);
|
||
```
|
||
第 8 行改为：
|
||
```ts
|
||
const SOFT_DELETE = new Set(['User', 'Role', 'Resource', 'Org', 'DictType', 'DictItem', 'Config', 'Notice', 'Staff', 'SvcOrg']);
|
||
```
|
||
|
||
- [ ] **Step 3: 生成迁移并校验**
|
||
|
||
Run: `cd sources/ec-nest && pnpm exec prisma migrate dev --name c0_base`
|
||
Expected: 生成迁移 SQL；`prisma generate` 通过。
|
||
|
||
- [ ] **Step 4: Commit**
|
||
|
||
```bash
|
||
git -C sources/ec-nest add prisma/schema.prisma prisma/migrations src/prisma/prisma.service.ts
|
||
git -C sources/ec-nest commit -m "feat(c0): 服务机构端基础数据模型（9 表 + 多租户/软删清单）"
|
||
```
|
||
|
||
---
|
||
|
||
### Task 2: 权限码 + 业务错误码
|
||
|
||
**Files:**
|
||
- Modify: `sources/ec-nest/src/common/permissions.ts`（追加业务权限码）
|
||
- Modify: `sources/ec-nest/src/common/error-codes.ts`（追加业务错误码）
|
||
|
||
**Interfaces:**
|
||
- Produces: `Permissions.elder/plan/order/record/abnormal/qc/svcOrg/staff/export`（C0 先落地 svcOrg/staff，其余预留）；`ErrorCodes.ORG_*`、`ErrorCodes.STAFF_*`、`ErrorCodes.SVC_*`。
|
||
|
||
- [ ] **Step 1: 追加权限码**（permissions.ts 末尾 `}` 前）
|
||
|
||
```ts
|
||
// 服务机构端业务（C0 落地 agency/svcOrg/staff，其余为 C1–C4 预留）
|
||
agency: { view: 'agency:view', update: 'agency:update' },
|
||
svcOrg: { list: 'svc-org:list', config: 'svc-org:config', newNational: 'svc-org:new-national' },
|
||
staff: { list: 'staff:list', create: 'staff:create', update: 'staff:update', delete: 'staff:delete', groupAssign: 'staff:group-assign' },
|
||
elder: { list: 'elder:list', detail: 'elder:detail', create: 'elder:create', update: 'elder:update', statusChange: 'elder:status-change', import: 'elder:import', svcSave: 'elder:svc-save' },
|
||
plan: { create: 'plan:create', change: 'plan:change', detail: 'plan:detail', confirm: 'plan:confirm' },
|
||
order: { generate: 'order:generate', assign: 'order:assign', reassign: 'order:reassign', cancel: 'order:cancel', detail: 'order:detail', today: 'order:today' },
|
||
record: { checkin: 'record:checkin', checkout: 'record:checkout', itemSave: 'record:item-save', photoUpload: 'record:photo-upload', detail: 'record:detail' },
|
||
abnormal: { report: 'abnormal:report', list: 'abnormal:list', handle: 'abnormal:handle' },
|
||
qc: { pendingList: 'qc:pending-list', detail: 'qc:detail', pass: 'qc:pass', return: 'qc:return', exceptionLink: 'qc:exception-link' },
|
||
export: { export: 'export:export' },
|
||
```
|
||
|
||
- [ ] **Step 2: 追加业务错误码**（error-codes.ts，域码：机构 40 / 人员 41 / 目录 42）
|
||
|
||
```ts
|
||
// 服务机构端·机构（40）
|
||
ORG_NOT_FOUND: 40001,
|
||
ORG_CODE_MISMATCH: 40002,
|
||
// 服务机构端·人员（41）
|
||
STAFF_NOT_FOUND: 41001,
|
||
STAFF_USER_LINKED: 41002,
|
||
// 服务机构端·目录（42）
|
||
SVC_LOC_NOT_FOUND: 42001,
|
||
SVC_ORG_NOT_FOUND: 42002,
|
||
SVC_LOC_IMMUTABLE: 42003,
|
||
```
|
||
|
||
- [ ] **Step 3: 编译校验**
|
||
|
||
Run: `cd sources/ec-nest && pnpm exec tsc --noEmit`（或 `pnpm lint`）
|
||
Expected: 无类型错误。
|
||
|
||
- [ ] **Step 4: Commit**
|
||
|
||
```bash
|
||
git -C sources/ec-nest add src/common/permissions.ts src/common/error-codes.ts
|
||
git -C sources/ec-nest commit -m "feat(c0): 服务机构端权限码与业务错误码"
|
||
```
|
||
|
||
---
|
||
|
||
### Task 3: seed 目录与角色
|
||
|
||
**Files:**
|
||
- Modify: `sources/ec-nest/src/common/tenant-template.ts`（`MENUS` 追加「长护服务」菜单组；`DICTS` 追加异常分类/拍照分档）
|
||
- Create: `sources/ec-nest/prisma/seed-catalog.ts`（L1 36 项 + 昆明 L2 45 项 + L3 映射 + loc_config 骨架）
|
||
|
||
**Interfaces:**
|
||
- Produces: `seedCatalog(prisma)` 函数（幂等 upsert 目录四层 + loc_config）。
|
||
|
||
- [ ] **Step 1: MENUS 追加「长护服务」组**（tenant-template.ts 的 `MENUS` 数组末尾、`];` 前）
|
||
|
||
```ts
|
||
{ code: 'ltc', name: '长护服务', parent: null, path: '/ltc', component: 'Layout', icon: 'mdi:home-heart', sort: 5 },
|
||
{ code: 'elder', name: '服务对象', parent: 'ltc', path: '/ltc/elder', component: 'ltc/elder/index', icon: 'mdi:account-heart', sort: 1 },
|
||
{ code: 'schedule', name: '排班派单', parent: 'ltc', path: '/ltc/schedule', component: 'ltc/schedule/index', icon: 'mdi:calendar-clock', sort: 2 },
|
||
{ code: 'record', name: '工单留痕', parent: 'ltc', path: '/ltc/record', component: 'ltc/record/index', icon: 'mdi:clipboard-check', sort: 3 },
|
||
{ code: 'qc', name: '质控中心', parent: 'ltc', path: '/ltc/qc', component: 'ltc/qc/index', icon: 'mdi:shield-check', sort: 4 },
|
||
{ code: 'document', name: '文书档案', parent: 'ltc', path: '/ltc/document', component: 'ltc/document/index', icon: 'mdi:file-document', sort: 5 },
|
||
{ code: 'svc-config', name: '服务机构设置', parent: 'ltc', path: '/ltc/config', component: 'Layout', icon: 'mdi:cog', sort: 6 },
|
||
{ code: 'svc-config-info', name: '机构信息', parent: 'svc-config', path: '/ltc/config/info', component: 'ltc/config/info/index', icon: 'mdi:office-building', sort: 1 },
|
||
{ code: 'svc-config-catalog', name: '服务项目与配价', parent: 'svc-config', path: '/ltc/config/catalog', component: 'ltc/config/catalog/index', icon: 'mdi:format-list-bulleted', sort: 2 },
|
||
{ code: 'svc-config-photo', name: '拍照分档配置', parent: 'svc-config', path: '/ltc/config/photo', component: 'ltc/config/photo/index', icon: 'mdi:camera', sort: 3 },
|
||
{ code: 'svc-config-qc', name: '质控提醒配置', parent: 'svc-config', path: '/ltc/config/qc', component: 'ltc/config/qc/index', icon: 'mdi:bell-alert', sort: 4 },
|
||
```
|
||
|
||
> 注：`ltc` 组下的页面（C1–C4 业务）本任务只登记菜单节点 + 空占位页，业务逻辑后置到对应 change。前端路由按 `src/pages/ltc/...` 目录自动生成，需各建 `index.vue` 占位。
|
||
|
||
- [ ] **Step 2: 写 seed-catalog.ts**（幂等，用 `prisma.raw` 跨租户）
|
||
|
||
```ts
|
||
import { PrismaClient } from '@prisma/client';
|
||
|
||
export async function seedCatalog(prisma: PrismaClient): Promise<void> {
|
||
// loc_config 骨架（昆明 + 占位州市）
|
||
await prisma.locConfig.upsert({
|
||
where: { locCode: '530100' },
|
||
update: { locName: '昆明市', svcSource: 'local' },
|
||
create: { locCode: '530100', locName: '昆明市', svcSource: 'local' },
|
||
});
|
||
// L1/L2/L3 目录项：C0 先落结构 + 少量样例（如「协助翻身叩背排痰」），
|
||
// 全量 36/45 项数据在 C1 上线前由运营导入（字段结构已就绪）。
|
||
await prisma.svcNational.upsert({
|
||
where: { natCode: 'L0000106010010000' },
|
||
update: {},
|
||
create: { natCode: 'L0000106010010000', natName: '协助翻身叩背排痰', natCategory: 'life', isMedical: false },
|
||
});
|
||
}
|
||
```
|
||
|
||
- [ ] **Step 3: seed 入口调用**（`prisma/seed.ts` 末尾 `main()` 内、`initTenant` 之后）
|
||
|
||
```ts
|
||
await seedCatalog(prisma);
|
||
```
|
||
|
||
- [ ] **Step 4: 跑 seed 验证**
|
||
|
||
Run: `cd sources/ec-nest && pnpm seed`
|
||
Expected: 输出「seed 完成」；`sys_agency` 无数据、`sys_svc_national` 有样例、`sys_loc_config` 有昆明。
|
||
|
||
- [ ] **Step 5: Commit**
|
||
|
||
```bash
|
||
git -C sources/ec-nest add src/common/tenant-template.ts prisma/seed-catalog.ts prisma/seed.ts
|
||
git -C sources/ec-nest commit -m "feat(c0): 长护服务菜单组 + 目录 seed 骨架"
|
||
```
|
||
|
||
---
|
||
|
||
### Task 4: agency（机构）模块
|
||
|
||
**Files:**
|
||
- Create: `sources/ec-nest/src/agency/agency.module.ts`
|
||
- Create: `sources/ec-nest/src/agency/agency.controller.ts`
|
||
- Create: `sources/ec-nest/src/agency/agency.service.ts`
|
||
- Create: `sources/ec-nest/src/agency/dto.ts`
|
||
- Modify: `sources/ec-nest/src/app.module.ts`（注册 `AgencyModule`）
|
||
|
||
**Interfaces:**
|
||
- Produces: `GET /api/v1/agency`（当前机构信息）、`PATCH /api/v1/agency`（更新机构信息，`qc`/`admin`）。
|
||
- Consumes: `PrismaService.client`、`getRequestContext()`、`Permissions.svcOrg`（暂用）、`ErrorCodes.ORG_*`。
|
||
|
||
- [ ] **Step 1: 写失败测试**
|
||
|
||
Create `sources/ec-nest/src/agency/agency.service.spec.ts`（vitest）：
|
||
```ts
|
||
import { describe, it, expect, vi } from 'vitest';
|
||
// 用内存 mock 的 prisma + ctx，验证 getCurrent() 按 ctx.tenantCode 读 agency
|
||
describe('AgencyService', () => {
|
||
it('getCurrent 按当前租户读机构', async () => {
|
||
const prisma = { client: { agency: { findUnique: vi.fn().mockResolvedValue({ code: 'T001' }) } } };
|
||
const ctx = { tenantCode: 'T001', userId: 'u1' };
|
||
vi.mock('../common/context/request-context.js', () => ({ getRequestContext: () => ctx }));
|
||
// ...调用 service.getCurrent()，断言 findUnique 收到 { where: { code: 'T001' } }
|
||
});
|
||
});
|
||
```
|
||
|
||
- [ ] **Step 2: 跑测试确认失败**
|
||
|
||
Run: `cd sources/ec-nest && pnpm test -- agency.service.spec`
|
||
Expected: FAIL（AgencyService 不存在）。
|
||
|
||
- [ ] **Step 3: 实现 agency.service.ts**（关键逻辑：按 tenant 读、写时 code 必须 = ctx.tenantCode）
|
||
|
||
```ts
|
||
import { Injectable } from '@nestjs/common';
|
||
import { PrismaService } from '../prisma/prisma.service.js';
|
||
import { getRequestContext } from '../common/context/request-context.js';
|
||
import { ErrorCodes } from '../common/error-codes.js';
|
||
import { BusinessException } from '../common/business-exception.js';
|
||
import { HttpStatus } from '@nestjs/common';
|
||
|
||
@Injectable()
|
||
export class AgencyService {
|
||
constructor(private readonly prisma: PrismaService) {}
|
||
|
||
async getCurrent() {
|
||
const ctx = getRequestContext();
|
||
return this.prisma.client.agency.findUnique({ where: { code: ctx.tenantCode } });
|
||
}
|
||
|
||
async update(dto: Record<string, unknown>) {
|
||
const ctx = getRequestContext();
|
||
const existing = await this.getCurrent();
|
||
if (!existing) throw new BusinessException(ErrorCodes.ORG_NOT_FOUND, '机构不存在', HttpStatus.NOT_FOUND);
|
||
return this.prisma.client.agency.update({ where: { code: ctx.tenantCode }, data: dto });
|
||
}
|
||
}
|
||
```
|
||
|
||
- [ ] **Step 4: 实现 controller + dto + module**（controller 用 `@RequirePermissions(Permissions.agency.update)` + `@AuditLog('agency','update')`）
|
||
|
||
- [ ] **Step 5: 跑测试确认通过**
|
||
|
||
Run: `cd sources/ec-nest && pnpm test -- agency.service.spec`
|
||
Expected: PASS。
|
||
|
||
- [ ] **Step 6: Commit**
|
||
|
||
```bash
|
||
git -C sources/ec-nest add src/agency src/app.module.ts
|
||
git -C sources/ec-nest commit -m "feat(c0): agency 机构模块（按租户读写机构信息）"
|
||
```
|
||
|
||
---
|
||
|
||
### Task 5: staff（人员）模块
|
||
|
||
**Files:**
|
||
- Create: `sources/ec-nest/src/staff/staff.module.ts`、`staff.controller.ts`、`staff.service.ts`、`dto.ts`
|
||
- Modify: `sources/ec-nest/src/app.module.ts`
|
||
|
||
**Interfaces:**
|
||
- Produces: `GET /api/v1/staff`、`POST /api/v1/staff`、`PATCH /api/v1/staff/:id`、`DELETE /api/v1/staff/:id`；`POST /api/v1/staff/:id/group`（指定归属组长）。
|
||
- Consumes: `BaseCrudService`、`Permissions.staff.*`、`ErrorCodes.STAFF_*`。
|
||
|
||
- [ ] **Step 1: 写失败测试**（staff.service.spec：`create` 自动注入 tenantCode；`userId` 冲突抛 STAFF_USER_LINKED）
|
||
|
||
- [ ] **Step 2: 跑测试确认失败**
|
||
|
||
- [ ] **Step 3: 实现 staff.service.ts**（extends BaseCrudService('staff')；create 校验 userId 唯一；update 校验 user 存在）
|
||
|
||
- [ ] **Step 4: 实现 controller + dto + module**（写操作 `@AuditLog('staff','xxx')`；group-assign 用 `staff.group-assign`）
|
||
|
||
- [ ] **Step 5: 跑测试确认通过**
|
||
|
||
- [ ] **Step 6: Commit**
|
||
|
||
```bash
|
||
git -C sources/ec-nest add src/staff src/app.module.ts
|
||
git -C sources/ec-nest commit -m "feat(c0): staff 人员模块（user_id 关联账号 + 归属组长）"
|
||
```
|
||
|
||
---
|
||
|
||
### Task 6: catalog（目录）模块
|
||
|
||
**Files:**
|
||
- Create: `sources/ec-nest/src/catalog/catalog.module.ts`、`catalog.controller.ts`、`catalog.service.ts`、`dto.ts`
|
||
- Modify: `sources/ec-nest/src/app.module.ts`
|
||
|
||
**Interfaces:**
|
||
- Produces: `GET /api/v1/svc/local/list?loc_code=`（按属地加载目录）、`GET /api/v1/svc/org/list`（本机构项目库）、`POST /api/v1/svc/org/config`（勾选+配价）、`GET /api/v1/svc/org/new-national`（国家新增项）。
|
||
- Consumes: `Permissions.svcOrg.*`、`ErrorCodes.SVC_*`。
|
||
|
||
- [ ] **Step 1: 写失败测试**（catalog.service.spec：昆明 loc_code 返回 local 目录；svc_org 写操作带 tenantCode；svc_org.config 只允许改 isEnabled/price，改其他字段抛 SVC_LOC_IMMUTABLE）
|
||
|
||
- [ ] **Step 2: 跑测试确认失败**
|
||
|
||
- [ ] **Step 3: 实现 catalog.service.ts**（`listLocal(locCode)` 读全局 SvcLocal/SvcNational；`listOrg()` 读当前租户 SvcOrg；`config()` 校验只改 isEnabled/price）
|
||
|
||
- [ ] **Step 4: 实现 controller + dto + module**（写操作 `@AuditLog('svc-org','config')`）
|
||
|
||
- [ ] **Step 5: 跑测试确认通过**
|
||
|
||
- [ ] **Step 6: Commit**
|
||
|
||
```bash
|
||
git -C sources/ec-nest add src/catalog src/app.module.ts
|
||
git -C sources/ec-nest commit -m "feat(c0): catalog 目录模块（属地加载 + 机构项目库）"
|
||
```
|
||
|
||
---
|
||
|
||
### Task 7: 前端业务菜单 + 占位页
|
||
|
||
**Files:**
|
||
- Create: `sources/ec-admin/src/pages/ltc/elder/index.vue`（占位页，其余 C1–C4）
|
||
- Create: `sources/ec-admin/src/pages/ltc/config/info/index.vue`、`.../catalog/index.vue`、`.../photo/index.vue`、`.../qc/index.vue`（占位页）
|
||
- Create: `sources/ec-admin/src/api/agency.ts`、`src/api/catalog.ts`、`src/api/staff.ts`
|
||
- Modify: `sources/ec-admin/src/config/layout.ts`（如需要：登录落地路径改为 `/ltc/elder`）
|
||
|
||
**Interfaces:**
|
||
- Consumes: `http.get/post/patch`（`@/api/http`）、`useDict`、`ty-crud`。
|
||
- Produces: 前端页面按 `unplugin-vue-router` 目录自动生成路由。
|
||
|
||
- [ ] **Step 1: 建占位页**（每个 `index.vue` 最小可渲染，含 `defineOptions({ name })`，name = 路径末段且全局唯一）
|
||
|
||
```vue
|
||
<template><div>服务对象（C1 实现）</div></template>
|
||
<script setup lang="ts">
|
||
defineOptions({ name: 'elder' })
|
||
</script>
|
||
```
|
||
|
||
- [ ] **Step 2: 建 api 封装**（`src/api/agency.ts` 等，类型 + 方法）
|
||
|
||
```ts
|
||
import { http } from './http'
|
||
export interface Agency { code: string; orgName: string; orgType: string; locCode: string }
|
||
export const getAgency = () => http.get<Agency>('/agency')
|
||
export const updateAgency = (data: Partial<Agency>) => http.patch<Agency>('/agency', data)
|
||
```
|
||
|
||
- [ ] **Step 3: 登录落地改到服务对象**（config/layout.ts 或路由守卫里的默认首页改为 `/ltc/elder`）
|
||
|
||
- [ ] **Step 4: 启动前端验证菜单**（跑 `pnpm sync:resources` 后登录，确认「长护服务」菜单出现、脚手架菜单仍在）
|
||
|
||
Run: `cd sources/ec-nest && pnpm sync:resources`，然后 `cd sources/ec-admin && pnpm dev:dev`，登录 `touyun/Touyun@123`。
|
||
Expected: 侧边栏出现「长护服务」及 6 个子菜单（含「服务机构设置」二级组）；脚手架「权限管理/系统管理/系统监控」原样。
|
||
|
||
- [ ] **Step 5: Commit**
|
||
|
||
```bash
|
||
git -C sources/ec-admin add src/pages/ltc src/api/agency.ts src/api/catalog.ts src/api/staff.ts src/config/layout.ts
|
||
git -C sources/ec-admin commit -m "feat(c0): 长护服务菜单占位页 + 机构/目录/人员 api"
|
||
```
|
||
|
||
---
|
||
|
||
### Task 8: 端到端验证
|
||
|
||
- [ ] **Step 1: 跨租户隔离**：用 A 机构账号 curl `GET /api/v1/staff`，确认只返回本 tenant 数据；改 `tenantCode` 越权访问返回 4001。
|
||
- [ ] **Step 2: 仅 director 写接口 403**：仅持 director 的账号调用 `PATCH /api/v1/agency` → 403；兼 qc/admin 放行。
|
||
- [ ] **Step 3: 昆明机构加载目录**：`GET /api/v1/svc/local/list?loc_code=530100` 返回样例目录 + 国家新增项接口正常。
|
||
- [ ] **Step 4: 审计落库**：改机构信息后查 `sys_audit_log` 有记录。
|
||
- [ ] **Step 5: Commit 收尾**
|
||
|
||
```bash
|
||
git -C sources/ec-nest status && git -C sources/ec-admin status
|
||
# 确认无遗漏后，根仓库更新子模块指针并推送
|
||
```
|
||
|
||
---
|
||
|
||
## Self-Review Notes
|
||
|
||
- 覆盖：spec 的 5 个 capability（data-model/api-contract/backend org/backend catalog/frontend ad）分别由 Task 1/2/6/4+5/7 落实。
|
||
- 命名：`Agency`（机构）避免与脚手架 `Org`（组织）冲突；`svc_org` 用 `SvcOrg` 模型。
|
||
- 全局 vs 租户：Task 1 明确 TENANT_FREE / SOFT_DELETE 清单。
|
||
- 业务菜单：Task 3 登记 MENUS，Task 7 建占位页；C1–C4 页面本 change 只占位。
|