基线:鉴权会话+工作组+工作台三区修复+编排工作区+产品设计文档

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
2026-07-27 20:43:35 +08:00
parent 61fe181678
commit ac85ecf2ea
119 changed files with 16634 additions and 1246 deletions
@@ -3,6 +3,7 @@
 * 工作台五要素:任务 / 审批 / 消息 / 纪要 / 汇报 —— 同一份过程事实的五种投影。
 */
 import { z } from 'zod';
+/** 我是谁 —— 无会话即 401,前端据此落登录页(ADR-010) */
 export declare const sessionRoute: {
    readonly method: "GET";
    readonly path: "/api/session";
@@ -55,6 +56,74 @@ export declare const sessionRoute: {
        }, z.core.$strip>>;
    }, z.core.$strip>;
 };
+/**
+ * 登录 —— 单组织 cookie session(编码规范 §4 / ADR-010)。
+ * 成功即种 `jcai_session`(HttpOnly);失败只回一句话,不区分账号不存在还是口令错。
+ */
+export declare const loginRoute: {
+    readonly method: "POST";
+    readonly path: "/api/login";
+    readonly body: z.ZodObject<{
+        account: z.ZodString;
+        password: z.ZodString;
+    }, z.core.$strip>;
+    readonly output: z.ZodObject<{
+        staff: z.ZodObject<{
+            id: z.core.$ZodBranded<z.ZodString, "StaffId", "out">;
+            account: z.ZodString;
+            name: z.ZodString;
+            positionId: z.core.$ZodBranded<z.ZodString, "PositionId", "out">;
+            state: z.ZodDefault<z.ZodEnum<{
+                active: "active";
+                disabled: "disabled";
+            }>>;
+        }, z.core.$strip>;
+        position: z.ZodObject<{
+            id: z.core.$ZodBranded<z.ZodString, "PositionId", "out">;
+            code: z.ZodString;
+            name: z.ZodString;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        grants: z.ZodArray<z.ZodObject<{
+            positionId: z.core.$ZodBranded<z.ZodString, "PositionId", "out">;
+            object: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"data">;
+                domain: z.ZodString;
+                object: z.ZodString;
+                field: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"governance">;
+                function: z.ZodEnum<{
+                    data: "data";
+                    task: "task";
+                    trigger: "trigger";
+                    system: "system";
+                    tool: "tool";
+                    activity: "activity";
+                    staff: "staff";
+                    process: "process";
+                    memory: "memory";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"task">;
+                activityId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "kind">;
+            action: z.ZodEnum<{
+                read: "read";
+                write: "write";
+                govern: "govern";
+            }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+};
+/** 登出 —— 服务端会话立刻作废,不等 cookie 到期 */
+export declare const logoutRoute: {
+    readonly method: "POST";
+    readonly path: "/api/logout";
+    readonly output: z.ZodObject<{
+        ok: z.ZodBoolean;
+    }, z.core.$strip>;
+};
 export declare const healthRoute: {
    readonly method: "GET";
    readonly path: "/api/health";
@@ -137,6 +206,26 @@ export declare const listTasksRoute: {
        }, z.core.$strip>>;
    }, z.core.$strip>;
 };
+/**
+ * 流程链上的一环 —— 「一条 = 一个活动的一次运行」之外,人还要看见自己在整条流程的哪儿。
+ * 别人负责的节点也在链上(只读),但不进任务清单。
+ */
+export declare const chainNodeSchema: z.ZodObject<{
+    nodeId: z.ZodString;
+    label: z.ZodString;
+    kind: z.ZodEnum<{
+        activity: "activity";
+        approval: "approval";
+    }>;
+    ownerName: z.ZodString;
+    ownerRole: z.ZodString;
+    state: z.ZodEnum<{
+        done: "done";
+        current: "current";
+        todo: "todo";
+    }>;
+}, z.core.$strip>;
+export type ChainNode = z.infer<typeof chainNodeSchema>;
 /** 任务详情 —— 工作区与对话区的服务端投影(前端零过程状态,刷新即重建) */
 export declare const taskDetailSchema: z.ZodObject<{
    card: z.ZodObject<{
@@ -171,6 +260,25 @@ export declare const taskDetailSchema: z.ZodObject<{
        startedAt: z.ZodString;
    }, z.core.$strip>;
    goal: z.ZodString;
+    owner: z.ZodObject<{
+        name: z.ZodString;
+        role: z.ZodString;
+    }, z.core.$strip>;
+    chain: z.ZodArray<z.ZodObject<{
+        nodeId: z.ZodString;
+        label: z.ZodString;
+        kind: z.ZodEnum<{
+            activity: "activity";
+            approval: "approval";
+        }>;
+        ownerName: z.ZodString;
+        ownerRole: z.ZodString;
+        state: z.ZodEnum<{
+            done: "done";
+            current: "current";
+            todo: "todo";
+        }>;
+    }, z.core.$strip>>;
    budget: z.ZodObject<{
        steps: z.ZodString;
        tokens: z.ZodString;
@@ -290,6 +398,10 @@ export declare const taskDetailSchema: z.ZodObject<{
                name: z.ZodString;
                meta: z.ZodOptional<z.ZodString>;
                file: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"html">;
+                    name: z.ZodString;
+                    html: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
                    kind: z.ZodLiteral<"markdown">;
                    name: z.ZodString;
                    md: z.ZodString;
@@ -359,6 +471,10 @@ export declare const taskDetailSchema: z.ZodObject<{
                label: z.ZodString;
                desc: z.ZodString;
                file: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"html">;
+                    name: z.ZodString;
+                    html: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
                    kind: z.ZodLiteral<"markdown">;
                    name: z.ZodString;
                    md: z.ZodString;
@@ -396,6 +512,43 @@ export declare const taskDetailSchema: z.ZodObject<{
        }>;
        at: z.ZodOptional<z.ZodString>;
    }, z.core.$strip>>;
+    results: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        desc: z.ZodString;
+        at: z.ZodOptional<z.ZodString>;
+        file: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"html">;
+            name: z.ZodString;
+            html: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"markdown">;
+            name: z.ZodString;
+            md: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"excel">;
+            name: z.ZodString;
+            sheet: z.ZodString;
+            rows: z.ZodArray<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"word">;
+            name: z.ZodString;
+            blocks: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                t: z.ZodEnum<{
+                    h1: "h1";
+                    h2: "h2";
+                    p: "p";
+                }>;
+                text: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                t: z.ZodLiteral<"ul">;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>]>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"pdf">;
+            name: z.ZodString;
+            src: z.ZodString;
+        }, z.core.$strip>], "kind">;
+    }, z.core.$strip>>;
    workOrders: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
        mode: z.ZodLiteral<"execution">;
        preset: z.ZodOptional<z.ZodEnum<{
@@ -507,6 +660,10 @@ export declare const taskDetailSchema: z.ZodObject<{
                name: z.ZodString;
                meta: z.ZodOptional<z.ZodString>;
                file: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"html">;
+                    name: z.ZodString;
+                    html: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
                    kind: z.ZodLiteral<"markdown">;
                    name: z.ZodString;
                    md: z.ZodString;
@@ -576,6 +733,10 @@ export declare const taskDetailSchema: z.ZodObject<{
                label: z.ZodString;
                desc: z.ZodString;
                file: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"html">;
+                    name: z.ZodString;
+                    html: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
                    kind: z.ZodLiteral<"markdown">;
                    name: z.ZodString;
                    md: z.ZodString;
@@ -644,7 +805,12 @@ export declare const taskDetailSchema: z.ZodObject<{
        done: z.ZodOptional<z.ZodObject<{
            at: z.ZodISODateTime;
            by: z.core.$ZodBranded<z.ZodString, "StaffId", "out">;
-            result: z.ZodString;
+            result: z.ZodEnum<{
+                redo: "redo";
+                revise: "revise";
+                submitted: "submitted";
+                pass: "pass";
+            }>;
            values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
        }, z.core.$strip>>;
    }, z.core.$strip>, z.ZodObject<{
@@ -708,7 +874,12 @@ export declare const taskDetailSchema: z.ZodObject<{
        done: z.ZodOptional<z.ZodObject<{
            at: z.ZodISODateTime;
            by: z.core.$ZodBranded<z.ZodString, "StaffId", "out">;
-            result: z.ZodString;
+            result: z.ZodEnum<{
+                redo: "redo";
+                revise: "revise";
+                submitted: "submitted";
+                pass: "pass";
+            }>;
            values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
        }, z.core.$strip>>;
    }, z.core.$strip>], "mode">>;
@@ -902,6 +1073,10 @@ export declare const taskDetailSchema: z.ZodObject<{
            name: z.ZodString;
            meta: z.ZodOptional<z.ZodString>;
            file: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"html">;
+                name: z.ZodString;
+                html: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
                kind: z.ZodLiteral<"markdown">;
                name: z.ZodString;
                md: z.ZodString;
@@ -971,6 +1146,10 @@ export declare const taskDetailSchema: z.ZodObject<{
            label: z.ZodString;
            desc: z.ZodString;
            file: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"html">;
+                name: z.ZodString;
+                html: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
                kind: z.ZodLiteral<"markdown">;
                name: z.ZodString;
                md: z.ZodString;
@@ -1055,6 +1234,25 @@ export declare const taskDetailRoute: {
            startedAt: z.ZodString;
        }, z.core.$strip>;
        goal: z.ZodString;
+        owner: z.ZodObject<{
+            name: z.ZodString;
+            role: z.ZodString;
+        }, z.core.$strip>;
+        chain: z.ZodArray<z.ZodObject<{
+            nodeId: z.ZodString;
+            label: z.ZodString;
+            kind: z.ZodEnum<{
+                activity: "activity";
+                approval: "approval";
+            }>;
+            ownerName: z.ZodString;
+            ownerRole: z.ZodString;
+            state: z.ZodEnum<{
+                done: "done";
+                current: "current";
+                todo: "todo";
+            }>;
+        }, z.core.$strip>>;
        budget: z.ZodObject<{
            steps: z.ZodString;
            tokens: z.ZodString;
@@ -1174,6 +1372,10 @@ export declare const taskDetailRoute: {
                    name: z.ZodString;
                    meta: z.ZodOptional<z.ZodString>;
                    file: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        kind: z.ZodLiteral<"html">;
+                        name: z.ZodString;
+                        html: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
                        kind: z.ZodLiteral<"markdown">;
                        name: z.ZodString;
                        md: z.ZodString;
@@ -1243,6 +1445,10 @@ export declare const taskDetailRoute: {
                    label: z.ZodString;
                    desc: z.ZodString;
                    file: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        kind: z.ZodLiteral<"html">;
+                        name: z.ZodString;
+                        html: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
                        kind: z.ZodLiteral<"markdown">;
                        name: z.ZodString;
                        md: z.ZodString;
@@ -1280,6 +1486,43 @@ export declare const taskDetailRoute: {
            }>;
            at: z.ZodOptional<z.ZodString>;
        }, z.core.$strip>>;
+        results: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            desc: z.ZodString;
+            at: z.ZodOptional<z.ZodString>;
+            file: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"html">;
+                name: z.ZodString;
+                html: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"markdown">;
+                name: z.ZodString;
+                md: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"excel">;
+                name: z.ZodString;
+                sheet: z.ZodString;
+                rows: z.ZodArray<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"word">;
+                name: z.ZodString;
+                blocks: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                    t: z.ZodEnum<{
+                        h1: "h1";
+                        h2: "h2";
+                        p: "p";
+                    }>;
+                    text: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    t: z.ZodLiteral<"ul">;
+                    items: z.ZodArray<z.ZodString>;
+                }, z.core.$strip>]>>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"pdf">;
+                name: z.ZodString;
+                src: z.ZodString;
+            }, z.core.$strip>], "kind">;
+        }, z.core.$strip>>;
        workOrders: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
            mode: z.ZodLiteral<"execution">;
            preset: z.ZodOptional<z.ZodEnum<{
@@ -1391,6 +1634,10 @@ export declare const taskDetailRoute: {
                    name: z.ZodString;
                    meta: z.ZodOptional<z.ZodString>;
                    file: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        kind: z.ZodLiteral<"html">;
+                        name: z.ZodString;
+                        html: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
                        kind: z.ZodLiteral<"markdown">;
                        name: z.ZodString;
                        md: z.ZodString;
@@ -1460,6 +1707,10 @@ export declare const taskDetailRoute: {
                    label: z.ZodString;
                    desc: z.ZodString;
                    file: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        kind: z.ZodLiteral<"html">;
+                        name: z.ZodString;
+                        html: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
                        kind: z.ZodLiteral<"markdown">;
                        name: z.ZodString;
                        md: z.ZodString;
@@ -1528,7 +1779,12 @@ export declare const taskDetailRoute: {
            done: z.ZodOptional<z.ZodObject<{
                at: z.ZodISODateTime;
                by: z.core.$ZodBranded<z.ZodString, "StaffId", "out">;
-                result: z.ZodString;
+                result: z.ZodEnum<{
+                    redo: "redo";
+                    revise: "revise";
+                    submitted: "submitted";
+                    pass: "pass";
+                }>;
                values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
            }, z.core.$strip>>;
        }, z.core.$strip>, z.ZodObject<{
@@ -1592,7 +1848,12 @@ export declare const taskDetailRoute: {
            done: z.ZodOptional<z.ZodObject<{
                at: z.ZodISODateTime;
                by: z.core.$ZodBranded<z.ZodString, "StaffId", "out">;
-                result: z.ZodString;
+                result: z.ZodEnum<{
+                    redo: "redo";
+                    revise: "revise";
+                    submitted: "submitted";
+                    pass: "pass";
+                }>;
                values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
            }, z.core.$strip>>;
        }, z.core.$strip>], "mode">>;
@@ -1786,6 +2047,10 @@ export declare const taskDetailRoute: {
                name: z.ZodString;
                meta: z.ZodOptional<z.ZodString>;
                file: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"html">;
+                    name: z.ZodString;
+                    html: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
                    kind: z.ZodLiteral<"markdown">;
                    name: z.ZodString;
                    md: z.ZodString;
@@ -1855,6 +2120,10 @@ export declare const taskDetailRoute: {
                label: z.ZodString;
                desc: z.ZodString;
                file: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"html">;
+                    name: z.ZodString;
+                    html: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
                    kind: z.ZodLiteral<"markdown">;
                    name: z.ZodString;
                    md: z.ZodString;
@@ -1912,6 +2181,20 @@ export declare const replyWorkOrderRoute: {
        producesCompletion: z.ZodBoolean;
    }, z.core.$strip>;
 };
+/**
+ * 对话卡回传(决策 / 补全 / 评价)—— 与后端回传校验**同 schema**。
+ * 对话流是一切回环输入的唯一入口(OS 4.1):卡就长在对话流上,答也就地答。
+ */
+export declare const replyChatCardRoute: {
+    readonly method: "POST";
+    readonly path: "/api/desk/chat-cards/reply";
+    readonly body: z.ZodObject<{
+        reply: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>;
+    readonly output: z.ZodObject<{
+        ok: z.ZodBoolean;
+    }, z.core.$strip>;
+};
 /** 负责人的自由输入 —— 人事件的第二形态 */
 export declare const sayRoute: {
    readonly method: "POST";
@@ -2582,3 +2865,37 @@ export declare const decideApprovalRoute: {
    }, z.core.$strip>;
 };
 export type ListApprovalsForMeOutput = z.infer<typeof listApprovalsForMeRoute.output>;
+/**
+ * 「登记触发 —— 人工起单的统一形态:登记人选择流程包、按调用接口 schema 填写输入
+ *  (表单由 schema 自动渲染)、提交即起单。」**登记人即来源**。
+ */
+export declare const listRegistrationTriggersRoute: {
+    readonly method: "GET";
+    readonly path: "/api/triggers/registration";
+    readonly output: z.ZodObject<{
+        triggers: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            processPackageId: z.ZodString;
+            enabled: z.ZodBoolean;
+            inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+};
+export declare const fireRegistrationRoute: {
+    readonly method: "POST";
+    readonly path: "/api/triggers/:triggerId/register";
+    readonly params: z.ZodObject<{
+        triggerId: z.ZodString;
+    }, z.core.$strip>;
+    readonly body: z.ZodObject<{
+        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>;
+    readonly output: z.ZodObject<{
+        ok: z.ZodBoolean;
+        workflowId: z.ZodOptional<z.ZodString>;
+        skipped: z.ZodOptional<z.ZodString>;
+        missing: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+};
+export type ListRegistrationTriggersOutput = z.infer<typeof listRegistrationTriggersRoute.output>;