@nocobase/app-plugin-office-flows-example 0.0.0-stage → 0.1.0-beta.0

package/dist/shared/data-request.js

@@ -0,0 +1,182 @@
+/**
+ * The data usage request form: which fields exist, which options they offer
+ * and when they appear. The page renders from these rules and the server
+ * validates with them, so the two cannot drift apart.
+ */
+export const VOLUMES = [
+    'x<50',
+    '50≤x<2万',
+    '2万≤x<50万',
+    'x≥50万',
+];
+export const FREQUENCIES = [
+    { value: 'once', label: '一次性' },
+    { value: 'quarterly', label: '每季度' },
+    { value: 'monthly', label: '每月' },
+    { value: 'weekly', label: '每周' },
+    { value: 'daily', label: '每日' },
+    { value: 'other', label: '其他固定频次' },
+];
+export const SCOPES = [
+    { value: 'external', label: '对外交付' },
+    { value: 'internal', label: '内部离线使用' },
+];
+export const CONSUMERS = {
+    external: [
+        '监管机构',
+        '第三方合作',
+        '客户',
+        '公检法',
+        '股东',
+        '外部合规风险审计',
+    ],
+    internal: ['内部合规风险审计', '内部管理及分析'],
+};
+export const WEEKDAYS = [
+    '周一',
+    '周二',
+    '周三',
+    '周四',
+    '周五',
+    '周六',
+    '周日',
+];
+export const INTERNAL_ANALYSIS = '内部管理及分析';
+export const THIRD_PARTY = '第三方合作';
+export function emptyDataRequest() {
+    return {
+        subject: '',
+        reason: '',
+        volume: '',
+        frequency: '',
+        deliveryDate: '',
+        firstUseDate: '',
+        lastDeliveryDate: '',
+        quarterDay: null,
+        monthDay: null,
+        weekDay: null,
+        frequencyNote: '',
+        scope: '',
+        consumers: [],
+        fileShieldAccepted: null,
+        fileShieldScope: '',
+        fileShieldCopy: null,
+        fileShieldValidUntil: '',
+        ndaFiles: [],
+        securityFiles: [],
+    };
+}
+export function visibility(form) {
+    const periodic = form.frequency !== '' && form.frequency !== 'once';
+    return {
+        deliveryDate: form.frequency === 'once',
+        periodDates: periodic,
+        quarterDay: form.frequency === 'quarterly',
+        monthDay: form.frequency === 'monthly',
+        weekDay: form.frequency === 'weekly',
+        frequencyNote: form.frequency === 'other',
+        fileShield: form.consumers.includes(INTERNAL_ANALYSIS),
+        thirdParty: form.consumers.includes(THIRD_PARTY),
+    };
+}
+/** The consumer types the chosen scope offers. */
+export function consumerOptions(scope) {
+    return scope === '' ? [] : CONSUMERS[scope];
+}
+const DATE = /^\d{4}-\d{2}-\d{2}$/;
+/** A `YYYY-MM-DD` that names a real day: `2026-02-31` is refused, not moved to March. */
+export function isDate(value) {
+    if (!DATE.test(value))
+        return false;
+    const time = Date.parse(`${value}T00:00:00Z`);
+    return (!Number.isNaN(time) && new Date(time).toISOString().slice(0, 10) === value);
+}
+/**
+ * Field → message for every problem; empty when the form may be submitted.
+ * Fields that are hidden for these values are neither required nor checked.
+ */
+export function validateDataRequest(form) {
+    const errors = {};
+    const shown = visibility(form);
+    if (!form.subject.trim())
+        errors.subject = '请填写主题';
+    if (!form.reason.trim())
+        errors.reason = '请填写原因';
+    if (!VOLUMES.includes(form.volume))
+        errors.volume = '请选择预估数据量';
+    if (!FREQUENCIES.some((item) => item.value === form.frequency))
+        errors.frequency = '请选择数据使用频次';
+    if (shown.deliveryDate && !isDate(form.deliveryDate))
+        errors.deliveryDate = '请填写数据交付日期';
+    if (shown.periodDates) {
+        if (!isDate(form.firstUseDate))
+            errors.firstUseDate = '请填写数据首次使用日期';
+        if (!isDate(form.lastDeliveryDate))
+            errors.lastDeliveryDate = '请填写最后一次交付日期';
+        else if (isDate(form.firstUseDate) &&
+            form.lastDeliveryDate < form.firstUseDate)
+            errors.lastDeliveryDate = '最后一次交付日期不能早于首次使用日期';
+    }
+    if (shown.quarterDay &&
+        !(Number.isInteger(form.quarterDay) &&
+            form.quarterDay >= 1 &&
+            form.quarterDay <= 92))
+        errors.quarterDay = '请填写每季度的第几天（1–92）';
+    if (shown.monthDay &&
+        !(Number.isInteger(form.monthDay) &&
+            form.monthDay >= 1 &&
+            form.monthDay <= 31))
+        errors.monthDay = '请填写每月几号（1–31）';
+    if (shown.weekDay &&
+        !(Number.isInteger(form.weekDay) &&
+            form.weekDay >= 1 &&
+            form.weekDay <= 7))
+        errors.weekDay = '请选择周几';
+    if (shown.frequencyNote && !form.frequencyNote.trim())
+        errors.frequencyNote = '请填写其他频次描述';
+    if (!SCOPES.some((item) => item.value === form.scope))
+        errors.scope = '请选择数据使用范围';
+    const allowed = consumerOptions(form.scope);
+    if (!form.consumers.length)
+        errors.consumers = '请选择使用方类型';
+    else if (form.consumers.some((item) => !allowed.includes(item)))
+        errors.consumers = '使用方类型与数据使用范围不符';
+    if (shown.fileShield) {
+        if (form.fileShieldAccepted === null)
+            errors.fileShieldAccepted = '请选择是否接受使用文件盾';
+        if (!form.fileShieldScope.trim())
+            errors.fileShieldScope = '请填写授权人员范围';
+        if (form.fileShieldCopy === null)
+            errors.fileShieldCopy = '请选择复制权限';
+        if (!isDate(form.fileShieldValidUntil))
+            errors.fileShieldValidUntil = '请填写数据有效截至日期';
+    }
+    if (shown.thirdParty && !form.ndaFiles.length)
+        errors.ndaFiles = '请上传第三方保密协议';
+    return errors;
+}
+/**
+ * Drops the values of fields the choices hide, so a stored request never
+ * carries an answer to a question it did not ask.
+ */
+export function normalizeDataRequest(form) {
+    const shown = visibility(form);
+    return {
+        ...form,
+        deliveryDate: shown.deliveryDate ? form.deliveryDate : '',
+        firstUseDate: shown.periodDates ? form.firstUseDate : '',
+        lastDeliveryDate: shown.periodDates ? form.lastDeliveryDate : '',
+        quarterDay: shown.quarterDay ? form.quarterDay : null,
+        monthDay: shown.monthDay ? form.monthDay : null,
+        weekDay: shown.weekDay ? form.weekDay : null,
+        frequencyNote: shown.frequencyNote ? form.frequencyNote : '',
+        consumers: form.consumers.filter((item) => consumerOptions(form.scope).includes(item)),
+        fileShieldAccepted: shown.fileShield ? form.fileShieldAccepted : null,
+        fileShieldScope: shown.fileShield ? form.fileShieldScope : '',
+        fileShieldCopy: shown.fileShield ? form.fileShieldCopy : null,
+        fileShieldValidUntil: shown.fileShield ? form.fileShieldValidUntil : '',
+        ndaFiles: shown.thirdParty ? form.ndaFiles : [],
+        securityFiles: shown.thirdParty ? form.securityFiles : [],
+    };
+}
+//# sourceMappingURL=data-request.js.map

package/dist/shared/data-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-request.js","sourceRoot":"","sources":["../../shared/data-request.ts"],"names":[],"mappings":"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"}

package/dist/shared/fields.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The fields a page may edit on each kind of record, in the state that
+ * allows it. The server keeps only these, and the pages send only these, so
+ * an edit never writes back a whole record it read.
+ */
+export declare const INCOMING_FIELDS: readonly string[];
+export declare const EXTRACTION_FIELDS: readonly string[];
+export type TaskKind = 'clerk' | 'team' | 'executor';
+export declare const TASK_FIELDS: Readonly<Record<TaskKind, readonly string[]>>;
+/** `values` with only `fields`, as an edit sends them. */
+export declare function pickEditable(values: Readonly<Record<string, unknown>>, fields: readonly string[]): Record<string, unknown>;
+//# sourceMappingURL=fields.d.ts.map

package/dist/shared/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../shared/fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAY5C,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAW9C,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;AAErD,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC,CAUrE,CAAC;AAEF,0DAA0D;AAC1D,wBAAgB,YAAY,CAC1B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB"}

package/dist/shared/fields.js

@@ -0,0 +1,48 @@
+/**
+ * The fields a page may edit on each kind of record, in the state that
+ * allows it. The server keeps only these, and the pages send only these, so
+ * an edit never writes back a whole record it read.
+ */
+export const INCOMING_FIELDS = [
+    'title',
+    'code',
+    'sender',
+    'senderRef',
+    'summary',
+    'officeOpinion',
+    'attachments',
+    'distributionType',
+    'officeHeadId',
+    'officeLeaderId',
+    'ccManagement',
+];
+export const EXTRACTION_FIELDS = [
+    'category',
+    'complexity',
+    'agreedDeliveryAt',
+    'sourceSystem',
+    'needsDownload',
+    'feedbackNote',
+    'feedbackFiles',
+    'reviewerId',
+    'managerId',
+    'confirmerId',
+];
+export const TASK_FIELDS = {
+    clerk: [
+        'opinion',
+        'redHeadFeedback',
+        'outgoingRef',
+        'attachments',
+        'feedback',
+    ],
+    team: ['opinion', 'redHeadFeedback', 'attachments', 'feedback'],
+    executor: ['redHeadFeedback', 'attachments', 'feedback'],
+};
+/** `values` with only `fields`, as an edit sends them. */
+export function pickEditable(values, fields) {
+    return Object.fromEntries(fields
+        .filter((field) => field in values)
+        .map((field) => [field, values[field]]));
+}
+//# sourceMappingURL=fields.js.map

package/dist/shared/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../shared/fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,OAAO;IACP,MAAM;IACN,QAAQ;IACR,WAAW;IACX,SAAS;IACT,eAAe;IACf,aAAa;IACb,kBAAkB;IAClB,cAAc;IACd,gBAAgB;IAChB,cAAc;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,UAAU;IACV,YAAY;IACZ,kBAAkB;IAClB,cAAc;IACd,eAAe;IACf,cAAc;IACd,eAAe;IACf,YAAY;IACZ,WAAW;IACX,aAAa;CACd,CAAC;AAIF,MAAM,CAAC,MAAM,WAAW,GAAkD;IACxE,KAAK,EAAE;QACL,SAAS;QACT,iBAAiB;QACjB,aAAa;QACb,aAAa;QACb,UAAU;KACX;IACD,IAAI,EAAE,CAAC,SAAS,EAAE,iBAAiB,EAAE,aAAa,EAAE,UAAU,CAAC;IAC/D,QAAQ,EAAE,CAAC,iBAAiB,EAAE,aAAa,EAAE,UAAU,CAAC;CACzD,CAAC;AAEF,0DAA0D;AAC1D,MAAM,UAAU,YAAY,CAC1B,MAAyC,EACzC,MAAyB;IAEzB,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM;SACH,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,MAAM,CAAC;SAClC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAC1C,CAAC;AACJ,CAAC"}

package/dist/shared/people.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The people the example's pages let you act as. A real application takes
+ * the actor from the signed-in user and its organization; the example keeps
+ * a fixed cast so one person can play every role.
+ */
+export interface Person {
+    readonly id: string;
+    readonly name: string;
+    readonly title: string;
+}
+export declare const PEOPLE: readonly Person[];
+export declare function isPerson(id: unknown): id is string;
+export declare function personName(id: string): string;
+/** The fixed approval chain of a data usage request. */
+export declare const DATA_REQUEST_ROLES: {
+    readonly applicant: string;
+    readonly level1: string;
+    readonly level2: string;
+    readonly level3: string;
+    readonly acceptor: string;
+    readonly executors: readonly string[];
+};
+/** The office roles of an incoming document. */
+export declare const INCOMING_ROLES: {
+    readonly registrar: string;
+    readonly officeHead: string;
+    readonly officeLeader: string;
+};
+//# sourceMappingURL=people.d.ts.map

package/dist/shared/people.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"people.d.ts","sourceRoot":"","sources":["../../shared/people.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,MAAM,EAAE,SAAS,MAAM,EA8BnC,CAAC;AAMF,wBAAgB,QAAQ,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,MAAM,CAElD;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wDAAwD;AACxD,eAAO,MAAM,kBAAkB,EAAE;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAQtC,CAAC;AAEH,gDAAgD;AAChD,eAAO,MAAM,cAAc,EAAE;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAK9B,CAAC"}

package/dist/shared/people.js

@@ -0,0 +1,54 @@
+export const PEOPLE = [
+    // Data usage request
+    { id: 'zhangwei', name: '张伟', title: '业务部门 · 申请人' },
+    { id: 'lina', name: '李娜', title: '一级主管' },
+    { id: 'wangqiang', name: '王强', title: '二级主管' },
+    { id: 'zhaomin', name: '赵敏', title: '三级主管' },
+    { id: 'chenjing', name: '陈静', title: '数据管理 · 抽数受理' },
+    { id: 'liuyang', name: '刘洋', title: '抽数执行人' },
+    { id: 'sunli', name: '孙丽', title: '抽数执行人' },
+    // Incoming documents: the office
+    { id: 'zhoujie', name: '周杰', title: '办公室 · 收文员' },
+    { id: 'wuhua', name: '吴华', title: '办公室部门主管' },
+    { id: 'zhengkai', name: '郑凯', title: '办公室分管领导' },
+    // Incoming documents: departments
+    { id: 'huangtao', name: '黄涛', title: '信息技术部 · 办事人员' },
+    { id: 'xulei', name: '徐磊', title: '信息技术部 · 部门主管' },
+    { id: 'gaoyan', name: '高燕', title: '财务部 · 办事人员' },
+    { id: 'linfeng', name: '林峰', title: '财务部 · 办事人员' },
+    { id: 'heming', name: '何明', title: '财务部、工会 · 部门主管' },
+    { id: 'mahui', name: '马慧', title: '分管领导' },
+    { id: 'luoxin', name: '罗欣', title: '工会 · 办事人员' },
+    { id: 'songyu', name: '宋雨', title: '分管领导' },
+    { id: 'tangjun', name: '唐军', title: '董事会办公室 · 办事人员' },
+    { id: 'fanqing', name: '范青', title: '董事会办公室 · 部门主管' },
+    { id: 'guoning', name: '郭宁', title: '风险管理部 · 办事人员' },
+    { id: 'denghui', name: '邓辉', title: '风险管理部 · 部门主管' },
+    // Company management
+    { id: 'yeqing', name: '叶青', title: '公司管理层' },
+    { id: 'caobin', name: '曹斌', title: '公司管理层' },
+    { id: 'jiangli', name: '江丽', title: '公司管理层' },
+];
+const BY_ID = new Map(PEOPLE.map((person) => [person.id, person]));
+export function isPerson(id) {
+    return typeof id === 'string' && BY_ID.has(id);
+}
+export function personName(id) {
+    return BY_ID.get(id)?.name ?? id;
+}
+/** The fixed approval chain of a data usage request. */
+export const DATA_REQUEST_ROLES = Object.freeze({
+    applicant: 'zhangwei',
+    level1: 'lina',
+    level2: 'wangqiang',
+    level3: 'zhaomin',
+    acceptor: 'chenjing',
+    executors: ['liuyang', 'sunli'],
+});
+/** The office roles of an incoming document. */
+export const INCOMING_ROLES = Object.freeze({
+    registrar: 'zhoujie',
+    officeHead: 'wuhua',
+    officeLeader: 'zhengkai',
+});
+//# sourceMappingURL=people.js.map

package/dist/shared/people.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"people.js","sourceRoot":"","sources":["../../shared/people.ts"],"names":[],"mappings":"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"}

package/dist/shared/routes.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Where this plugin's routes start, relative to the API base: the plugin's
+ * namespace, and so the domain of its errors. Every server route and the
+ * client's requests read it, so they cannot drift apart.
+ */
+export declare const OFFICE_FLOWS_ROUTES: string;
+//# sourceMappingURL=routes.d.ts.map

package/dist/shared/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../shared/routes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAA6B,CAAC"}

package/dist/shared/routes.js

@@ -0,0 +1,7 @@
+/**
+ * Where this plugin's routes start, relative to the API base: the plugin's
+ * namespace, and so the domain of its errors. Every server route and the
+ * client's requests read it, so they cannot drift apart.
+ */
+export const OFFICE_FLOWS_ROUTES = 'officeFlowsExample';
+//# sourceMappingURL=routes.js.map

package/dist/shared/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../shared/routes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAW,oBAAoB,CAAC"}

package/dist/shared/text.d.ts

@@ -0,0 +1,3 @@
+/** A stored scalar as display text; anything else is empty. */
+export declare function text(value: unknown): string;
+//# sourceMappingURL=text.d.ts.map

package/dist/shared/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../shared/text.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAK3C"}

package/dist/shared/text.js

@@ -0,0 +1,9 @@
+/** A stored scalar as display text; anything else is empty. */
+export function text(value) {
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    return '';
+}
+//# sourceMappingURL=text.js.map

package/dist/shared/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../shared/text.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,UAAU,IAAI,CAAC,KAAc;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QACzD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/package.json

@@ -1,6 +1,75 @@
 {
   "name": "@nocobase/app-plugin-office-flows-example",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "displayName": "Office Flows Example App Plugin",
+  "description": "Example app plugin running two office processes on record lifecycles: a data usage request with scheduled extraction tasks, and incoming document distribution with three levels of sub-tasks.",
+  "version": "0.1.0-beta.0",
+  "type": "module",
+  "prettier": "@nocobase/dev-config/prettier",
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "sideEffects": false,
+  "exports": {
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "hono": "^4.13.2",
+    "zod": "^4.6.5"
+  },
+  "peerDependencies": {
+    "@base-ui/react": "^1.6.0",
+    "class-variance-authority": "^0.7.1",
+    "cn": "^0.4.0",
+    "lucide-react": "^0.487.0",
+    "react": "^19.0.0",
+    "@nocobase/app-client": "^2.0.0-beta.2",
+    "@nocobase/app-plugin-authentication": "^2.0.0-beta.2",
+    "@nocobase/app-server": "^2.0.0-beta.1",
+    "@nocobase/db": "^1.0.0-beta.18",
+    "@nocobase/i18n": "^1.0.0-beta.5",
+    "@nocobase/jobs": "^0.1.0-beta.2",
+    "@nocobase/lifecycle": "^0.1.0-beta.0",
+    "@nocobase/service-provider": "^0.0.2-beta.1"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^7.0.0",
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "^24.0.0",
+    "@types/react": "^19.2.0",
+    "eslint": "^10.0.0",
+    "jsdom": "^30.0.1",
+    "prettier": "^3.9.6",
+    "react-dom": "^19.2.8",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10",
+    "@nocobase/app-testing": "0.1.0-beta.1",
+    "@nocobase/dev-config": "0.1.0-beta.19"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && nocobase-db-manifests",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "lint": "eslint . --max-warnings 0",
+    "lint:fix": "eslint . --fix --max-warnings 0",
+    "format": "prettier . --write",
+    "format:check": "prettier . --check",
+    "check": "pnpm lint && pnpm format:check && pnpm typecheck && pnpm test && pnpm build",
+    "fix": "pnpm lint:fix && pnpm format"
+  }
 }