feat: add care execution workspace

This commit is contained in:
2026-07-03 00:35:04 -07:00
parent df7c2efcc5
commit b6b15acc69
20 changed files with 4270 additions and 18 deletions

View File

@@ -1,5 +1,5 @@
import CarePage from "../../care/page";
export default function ScopedCarePage(): React.ReactElement {
export default async function ScopedCarePage(): Promise<React.ReactElement> {
return CarePage();
}

View File

@@ -1,15 +1,26 @@
import { ClipboardCheck } from "lucide-react";
import { redirect } from "next/navigation";
import { ModulePage } from "@/modules/shared/components/ModulePage";
import { getCurrentAuthContext } from "@/modules/core/server/auth";
import { hasPermission } from "@/modules/core/server/permissions";
import { listCareExecutionData } from "@/modules/care/server/operations";
import { CareWorkspaceClient } from "@/modules/care/components/CareWorkspaceClient";
import { getWorkspaceHref } from "@/modules/shared/lib/workspace-routing";
export default function CarePage(): React.ReactElement {
return (
<ModulePage
title="护理服务"
eyebrow="护理计划、任务与巡检"
description="待接入护理等级、护理计划、任务派发、执行记录和逾期状态数据源。"
icon={ClipboardCheck}
phase="待接入"
/>
);
export default async function CarePage(): Promise<React.ReactElement> {
const context = await getCurrentAuthContext();
if (!context) {
redirect("/login");
}
if (!hasPermission(context.permissions, "care:read")) {
redirect(getWorkspaceHref(context.organization?.slug, "/dashboard"));
}
const organizationId = context.organization?.id;
if (!organizationId) {
redirect(getWorkspaceHref(context.organization?.slug, "/dashboard"));
}
const data = await listCareExecutionData(organizationId);
return <CareWorkspaceClient canManage={hasPermission(context.permissions, "care:manage")} initialData={data} />;
}

View File

@@ -0,0 +1,234 @@
import { beforeEach, describe, expect, it, vi } from "vitest";
import { recordAuditLog } from "@/modules/core/server/audit";
import { requirePermission } from "@/modules/core/server/auth";
import type { AuthContext } from "@/modules/core/types";
import type { CareExecutionData, CareTask } from "@/modules/care/types";
import { listCareExecutionData, updateCareTaskStatus } from "@/modules/care/server/operations";
vi.mock("@/modules/core/server/auth", () => ({
requirePermission: vi.fn(),
}));
vi.mock("@/modules/core/server/audit", () => ({
recordAuditLog: vi.fn(),
}));
vi.mock("@/modules/care/server/operations", () => ({
isCareMutationFailure: vi.fn((value: unknown) => typeof value === "object" && value !== null && "success" in value && value.success === false),
listCareExecutionData: vi.fn(),
updateCareTaskStatus: vi.fn(),
}));
const account: AuthContext["account"] = {
id: "account-1",
name: "Admin",
email: "admin@example.com",
avatarUrl: "",
role: "org_admin",
status: "active",
createdAt: "2026-07-02T00:00:00.000Z",
updatedAt: "2026-07-02T00:00:00.000Z",
};
function createAuthContext(overrides: Partial<AuthContext> = {}): AuthContext {
return {
account,
organization: {
id: "org-1",
name: "Demo Org",
slug: "demo-org",
status: "active",
registrationEnabled: true,
oidcEnabled: false,
oidcIssuerUrl: "",
oidcClientId: "",
oidcHasClientSecret: false,
oidcScopes: "openid profile email",
oidcRedirectUri: "",
oidcAvatarClaim: "picture",
oidcAutoProvision: false,
createdAt: "2026-07-02T00:00:00.000Z",
updatedAt: "2026-07-02T00:00:00.000Z",
},
organizations: [],
permissions: ["care:read", "care:manage"],
session: {
id: "session-1",
accountId: "account-1",
activeOrganizationId: "org-1",
createdAt: "2026-07-02T00:00:00.000Z",
expiresAt: "2026-07-09T00:00:00.000Z",
},
...overrides,
};
}
const careTask: CareTask = {
id: "task-1",
organizationId: "org-1",
elderId: "elder-1",
elderName: "王桂兰",
title: "晨间协助洗漱",
careType: "daily_care",
priority: "normal",
status: "pending",
scheduledAt: "2026-07-02T08:00:00.000Z",
assigneeLabel: "一号护理组",
executionNotes: "",
completedAt: undefined,
completedByAccountId: undefined,
completedByName: undefined,
createdAt: "2026-07-02T00:00:00.000Z",
updatedAt: "2026-07-02T00:00:00.000Z",
};
const careExecutionData: CareExecutionData = {
metrics: {
pending: 1,
inProgress: 1,
completedToday: 1,
highPriority: 1,
},
tasks: [careTask],
};
function allowAuth(): void {
vi.mocked(requirePermission).mockResolvedValue({
success: true,
context: createAuthContext(),
});
}
function jsonRequest(body: Record<string, unknown>): Request {
return new Request("http://localhost/api/care/tasks", {
method: "PATCH",
headers: { "content-type": "application/json" },
body: JSON.stringify(body),
});
}
async function readJson(response: Response): Promise<Record<string, unknown>> {
return (await response.json()) as Record<string, unknown>;
}
beforeEach(() => {
vi.clearAllMocks();
allowAuth();
});
describe("care execution API routes", () => {
it("loads care execution data for the active organization", async () => {
vi.mocked(listCareExecutionData).mockResolvedValue(careExecutionData);
const { GET } = await import("./tasks/route");
const response = await GET();
const body = await readJson(response);
expect(response.status).toBe(200);
expect(body.success).toBe(true);
expect(body.data).toEqual(careExecutionData);
expect(listCareExecutionData).toHaveBeenCalledWith("org-1");
});
it("returns permission failures before loading care tasks", async () => {
const denied = Response.json({ success: false, reason: "权限不足" }, { status: 403 });
vi.mocked(requirePermission).mockResolvedValue({ success: false, response: denied });
const { GET } = await import("./tasks/route");
const response = await GET();
const body = await readJson(response);
expect(response.status).toBe(403);
expect(body.reason).toBe("权限不足");
expect(listCareExecutionData).not.toHaveBeenCalled();
});
it("requires an active organization before loading care tasks", async () => {
vi.mocked(requirePermission).mockResolvedValue({
success: true,
context: createAuthContext({ organization: undefined }),
});
const { GET } = await import("./tasks/route");
const response = await GET();
const body = await readJson(response);
expect(response.status).toBe(400);
expect(body.reason).toBe("请选择机构后查看护理任务");
expect(listCareExecutionData).not.toHaveBeenCalled();
});
it("marks a care task as in progress", async () => {
vi.mocked(updateCareTaskStatus).mockResolvedValue({
...careTask,
status: "in_progress",
updatedAt: "2026-07-02T08:10:00.000Z",
});
const { PATCH } = await import("./tasks/[id]/route");
const response = await PATCH(jsonRequest({ status: "in_progress" }), {
params: Promise.resolve({ id: "task-1" }),
});
const body = await readJson(response);
expect(response.status).toBe(200);
expect(body.success).toBe(true);
expect(updateCareTaskStatus).toHaveBeenCalledWith(expect.objectContaining({ accountId: "account-1", id: "task-1", organizationId: "org-1" }));
expect(recordAuditLog).toHaveBeenCalledWith(expect.objectContaining({ action: "care.task.update" }));
});
it("completes a care task with notes", async () => {
vi.mocked(updateCareTaskStatus).mockResolvedValue({
...careTask,
status: "completed",
executionNotes: "已完成并观察无异常",
completedAt: "2026-07-02T08:30:00.000Z",
completedByAccountId: "account-1",
completedByName: "Admin",
updatedAt: "2026-07-02T08:30:00.000Z",
});
const { PATCH } = await import("./tasks/[id]/route");
const response = await PATCH(jsonRequest({ status: "completed", executionNotes: "已完成并观察无异常" }), {
params: Promise.resolve({ id: "task-1" }),
});
const body = await readJson(response);
expect(response.status).toBe(200);
expect(body.success).toBe(true);
expect(updateCareTaskStatus).toHaveBeenCalledWith(expect.objectContaining({ executionNotes: "已完成并观察无异常", status: "completed" }));
expect(recordAuditLog).toHaveBeenCalledWith(expect.objectContaining({ action: "care.task.update" }));
});
it("rejects invalid care task status", async () => {
const { PATCH } = await import("./tasks/[id]/route");
const response = await PATCH(jsonRequest({ status: "done" }), {
params: Promise.resolve({ id: "task-1" }),
});
const body = await readJson(response);
expect(response.status).toBe(400);
expect(body.reason).toBe("护理任务状态无效");
expect(updateCareTaskStatus).not.toHaveBeenCalled();
expect(recordAuditLog).not.toHaveBeenCalled();
});
it("returns structured failures for missing or cross-organization care tasks", async () => {
vi.mocked(updateCareTaskStatus).mockResolvedValue({
success: false,
reason: "护理任务不存在",
status: 404,
});
const { PATCH } = await import("./tasks/[id]/route");
const response = await PATCH(jsonRequest({ status: "in_progress" }), {
params: Promise.resolve({ id: "task-from-other-org" }),
});
const body = await readJson(response);
expect(response.status).toBe(404);
expect(body.reason).toBe("护理任务不存在");
expect(recordAuditLog).not.toHaveBeenCalled();
});
});

View File

@@ -0,0 +1,56 @@
import { jsonFailure, jsonSuccess, readJsonBody } from "@/modules/core/server/api";
import { recordAuditLog } from "@/modules/core/server/audit";
import { requirePermission } from "@/modules/core/server/auth";
import { isCareMutationFailure, updateCareTaskStatus } from "@/modules/care/server/operations";
import { validateCareTaskStatusUpdateInput } from "@/modules/care/types";
type RouteContext = {
params: Promise<{
id: string;
}>;
};
export async function PATCH(request: Request, context: RouteContext): Promise<Response> {
const { id } = await context.params;
const auth = await requirePermission("care:manage", {
action: "care.task.update",
targetType: "care_task",
targetId: id,
});
if (!auth.success) {
return auth.response;
}
const organizationId = auth.context.organization?.id;
if (!organizationId) {
return jsonFailure("请选择机构后处理护理任务", 400);
}
const input = validateCareTaskStatusUpdateInput(await readJsonBody(request));
if (!input.success) {
return jsonFailure(input.reason);
}
const task = await updateCareTaskStatus({
...input.data,
id,
organizationId,
accountId: auth.context.account.id,
});
if (isCareMutationFailure(task)) {
return jsonFailure(task.reason, task.status);
}
await recordAuditLog({
actor: auth.context.account,
organizationId,
action: "care.task.update",
targetType: "care_task",
targetId: task.id,
result: "success",
reason: `处理护理任务:${task.title}`,
});
return jsonSuccess("护理任务已更新", { task });
}

View File

@@ -0,0 +1,22 @@
import { jsonFailure, jsonSuccess } from "@/modules/core/server/api";
import { requirePermission } from "@/modules/core/server/auth";
import { listCareExecutionData } from "@/modules/care/server/operations";
export async function GET(): Promise<Response> {
const auth = await requirePermission("care:read", {
action: "care.task.list",
targetType: "care_task",
});
if (!auth.success) {
return auth.response;
}
const organizationId = auth.context.organization?.id;
if (!organizationId) {
return jsonFailure("请选择机构后查看护理任务", 400);
}
const data = await listCareExecutionData(organizationId);
return jsonSuccess("护理任务已加载", { data });
}