refactor platform admin from backend contract

frontend/platform_admin/src/api/resources.ts

@@ -1,54 +1,61 @@
-export type ResourceMode = 'writable' | 'readonly' | 'append_only';
+export type ResourceMode = 'writable' | 'readonly' | 'append_only' | 'managed';
 export type ResourcePageKind = 'list' | 'tree';
 export type ResourceFieldType =
   | 'text'
   | 'password'
   | 'identity'
-  | 'role-code'
-  | 'menu-identities'
+  | 'identity-list'
   | 'number'
   | 'boolean'
   | 'date'
   | 'datetime'
-  | 'textarea';
+  | 'textarea'
+  | 'select';
+
 export type ResourceField = {
   key: string;
   label: string;
-  type: ResourceFieldType;
+  type?: ResourceFieldType;
   required?: boolean;
+  relation?: string;
+  options?: Array<{ label: string; value: string }>;
 };
+
 export type DetailAction = {
   name: string;
   resource: string;
-  fields: ResourceField[];
-  payload?: Record<string, unknown>;
+  method?: 'POST' | 'PUT' | 'PATCH';
+  danger?: boolean;
+  fields?: ResourceField[];
 };
+
 export type ResourceUiDefinition = {
   key: string;
   name: string;
-  resource: string;
+  resource: `/${string}`;
   title: string;
   mode: ResourceMode;
   pageKind: ResourcePageKind;
   fields: ResourceField[];
-  requiredIdentities: string[];
   detailActions?: DetailAction[];
 };
 
-const labels: Record<string, string> = {
+const fieldLabels: Record<string, string> = {
   code: '编码',
   name: '名称',
-  credit_code: '统一信用代码',
-  principal: '负责人',
-  address: '地址',
-  longitude: '经度',
-  latitude: '纬度',
   username: '用户名',
   password: '密码',
   display_name: '显示名称',
   role_code: '角色编码',
-  delivery_code: '配送编码',
+  platform_role_code: '平台角色',
+  credit_code: '统一社会信用代码',
+  principal: '负责人',
+  manager: '库房负责人',
   phone: '联系电话',
+  address: '地址',
+  longitude: '经度',
+  latitude: '纬度',
+  delivery_code: '配送站编码',
   avatar: '头像',
   work_status: '工作状态',
   credential_type: '资质类型',
@@ -56,483 +63,265 @@ const labels: Record<string, string> = {
   expired_at: '到期时间',
   real_name: '实名姓名',
   is_default: '默认地址',
-  device_no: '设备编号',
-  model: '设备型号',
-  online_status: '在线状态',
-  effective_at: '生效时间',
-  reported_at: '上报时间',
-  payload: '遥测数据',
-  version_no: '版本号',
+  params: '产品参数',
+  produced_at: '生产时间',
+  enabled_at: '启用时间',
+  is_enabled: '是否启用',
+  repair_no: '检修单号',
+  repair_type: '检修类型',
+  started_at: '开始时间',
+  completed_at: '完成时间',
+  result: '检修结果',
+  target_status: '目标状态',
+  content: '内容',
+  operator: '操作人员',
+  remark: '备注',
+  action: '动作',
+  occurred_at: '发生时间',
+  reason: '原因',
+  operator_identity: '操作人标识',
+  operator_name: '操作人',
+  owner_type: '归属类型',
+  owner_identity: '归属标识',
+  alipay_id: '支付宝账号',
+  alipay_name: '支付宝账户名',
+  wxpay_id: '微信账号',
+  wxpay_name: '微信账户名',
+  balance: '余额（分）',
+  withdrawal_balance: '可提现余额（分）',
+  card_no_last4: '银行卡末四位',
+  bank_name: '银行名称',
+  card_owner: '持卡人',
+  payment_no: '支付单号',
+  order_no: '订单号',
+  trade_no: '第三方流水号',
+  payment_type: '支付业务类型',
+  pay_channel: '支付渠道',
+  pay_type: '支付类型',
+  amount: '金额（分）',
+  fee: '手续费（分）',
+  args: '支付参数',
+  callback_msg: '回调信息',
+  record_no: '流水号',
+  request_no: '请求流水号',
+  direction: '收支方向',
+  trade_type: '交易类型',
+  balance_after: '变动后余额（分）',
+  withdrawal_balance_after: '变动后可提现余额（分）',
+  refund_no: '退款单号',
+  cash_no: '提现单号',
+  channel: '渠道',
+  review_reason: '审核原因',
+  reviewed_at: '审核时间',
+  ymd: '日期',
+  ym: '月份',
+  contract_no: '合同编号',
   title: '标题',
-  reason: '处置原因',
-  sort_no: '排序号',
+  terms: '合同条款',
+  file_uri: '附件地址',
+  default_delivery_fee: '默认配送费（分）',
+  signed_at: '签署时间',
+  effective_at: '生效时间',
+  unit_price: '单价（分）',
+  unbound_at: '解绑时间',
+  revision_no: '修订号',
+  creator_type: '创建方类型',
+  creator_identity: '创建方标识',
+  contact_name: '联系人',
+  contact_phone: '联系电话',
+  discount_amount: '优惠金额（分）',
+  total_amount: '总金额（分）',
+  delivery_fee: '配送费（分）',
+  assigned_at: '分配时间',
+  from_status: '原状态',
+  to_status: '新状态',
+  track_no: '轨迹编号',
+  attempt_no: '尝试次数',
+  point_type: '轨迹点类型',
+  confirmed_at: '确认时间',
+  sort_no: '排序',
   product_code: '商品编码',
-  price_amount: '售价',
+  price_amount: '售价（分）',
   stock_quantity: '库存',
   value: '属性值',
   image_uri: '图片地址',
   is_cover: '封面图',
   quantity: '数量',
   selected: '是否选中',
-  order_no: '订单号',
-  total_amount: '订单金额',
   product_snapshot: '商品快照',
-  sale_amount: '成交金额',
+  sale_amount: '成交金额（分）',
   score: '评分',
-  channel: '渠道',
-  amount: '金额',
   paid_at: '支付时间',
   settlement_no: '结算单号',
-  subject_type: '结算对象类型',
+  subject_type: '结算主体类型',
   period_start: '结算开始时间',
   period_end: '结算结束时间',
   bill_date: '账单日期',
-  difference_amount: '差异金额',
+  difference_amount: '差异金额（分）',
   content_type: '内容类型',
   body: '正文',
+  version_no: '版本号',
   publish_status: '发布状态',
-  template_code: '模板编码',
-  content: '内容',
   ticket_no: '工单号',
   category: '分类',
   priority: '优先级',
-  platform_role_code: '平台角色',
-  menu_identities: '菜单权限',
   data_scope: '数据范围',
+  parent_identity: '父级',
   menu_code: '菜单编码',
   icon: '图标',
-  path: '路径',
-  balance_amount: '余额',
-  frozen_amount: '冻结金额',
-  balance_after: '变动后余额',
-  report_code: '报表编码',
-  report_type: '报表类型',
-  stat_period: '统计周期',
-  generated_at: '生成时间',
-  dimension: '维度',
-  metric_code: '指标编码',
-  metric_value: '指标值',
-  scope_type: '范围类型',
-  stat_at: '统计时间',
-  applicant_identity: '申请人标识',
-  business_type: '业务类型',
-  business_identity: '业务标识',
-  handler_identity: '处理人标识',
-  opinion: '审批意见',
-  purpose: '用途',
-  field_scope: '字段范围',
-  approved_at: '批准时间',
-  file_uri: '文件地址',
-  operator_identity: '操作人标识',
-  object_identity: '对象标识',
-  resource_type: '资源类型',
-  handled_at: '处理时间',
-  created_at: '创建时间',
+  path: '路由',
+  menu_identities: '菜单权限',
   status: '状态',
 };
-const numberFields = new Set([
-  'version_no',
-  'level',
-  'sort_no',
-  'price_amount',
-  'stock_quantity',
-  'quantity',
-  'total_amount',
-  'sale_amount',
-  'score',
-  'amount',
-  'difference_amount',
-  'balance_amount',
-  'frozen_amount',
-  'balance_after',
+
+const numbers = new Set([
+  'sort_no', 'unit_price', 'amount', 'fee', 'balance', 'withdrawal_balance',
+  'balance_after', 'withdrawal_balance_after', 'default_delivery_fee',
+  'discount_amount', 'total_amount', 'delivery_fee', 'price_amount',
+  'stock_quantity', 'quantity', 'sale_amount', 'score', 'version_no',
+  'difference_amount', 'attempt_no',
 ]);
-const booleanFields = new Set(['is_default', 'is_cover', 'selected']);
-const dateFields = new Set(['bill_date']);
-const datetimeFields = new Set([
-  'expired_at',
-  'effective_at',
-  'reported_at',
-  'occurred_at',
-  'started_at',
-  'completed_at',
-  'paid_at',
-  'period_start',
-  'period_end',
-  'generated_at',
-  'stat_at',
-  'approved_at',
-  'handled_at',
-  'created_at',
+const booleans = new Set(['is_default', 'is_enabled', 'is_cover', 'selected', 'withdrawable']);
+const dates = new Set(['bill_date']);
+const datetimes = new Set([
+  'expired_at', 'produced_at', 'enabled_at', 'started_at', 'completed_at',
+  'occurred_at', 'reviewed_at', 'signed_at', 'effective_at', 'unbound_at',
+  'assigned_at', 'confirmed_at', 'paid_at', 'period_start', 'period_end',
 ]);
-// 大文本字段按普通文本处理，不再要求或解析 JSON。
-const textareaFields = new Set([
-  'body',
-  'content',
-  'reason',
-  'opinion',
-  'payload',
-  'product_snapshot',
+const textareas = new Set([
+  'params', 'content', 'remark', 'reason', 'terms', 'args', 'callback_msg',
+  'review_reason', 'product_snapshot', 'body',
 ]);
-const fieldType = (key: string): ResourceFieldType => {
-  if (key === 'platform_role_code') return 'role-code';
-  if (key === 'menu_identities') return 'menu-identities';
-  if (key.endsWith('_identity')) return 'identity';
-  if (key === 'password') return 'password';
-  if (numberFields.has(key)) return 'number';
-  if (booleanFields.has(key)) return 'boolean';
-  if (dateFields.has(key)) return 'date';
-  if (datetimeFields.has(key)) return 'datetime';
-  if (textareaFields.has(key)) return 'textarea';
-  return 'text';
-};
-const field = (value: string): ResourceField => {
-  const key = value.replace(/!$/, '');
-  return {
-    key,
-    label:
-      labels[key] ?? (key.endsWith('_identity') ? '关联业务标识' : '业务字段'),
-    type: fieldType(key),
-    required: value.endsWith('!') || undefined,
-  };
-};
-const titles: Record<string, string> = {
-  gas_basic: '气站管理',
-  gas_account: '气站账户',
-  delivery_basic: '配送点管理',
-  delivery_account: '配送账户',
-  delivery_task: '配送任务',
-  delivery_track: '配送轨迹',
-  delivery_track_point: '轨迹点',
-  staff_account: '服务人员',
-  staff_credential: '人员资质',
-  user_account: '用户账户',
-  user_address: '用户地址',
-  user_service_relation: '用户服务关系',
-  dev_smart_cylinder_valve: '智能钢瓶阀',
-  dev_device_binding: '设备绑定',
-  dev_telemetry: '设备遥测',
-  ec_category: '商品分类',
-  ec_product: '商品管理',
-  ec_product_attribute: '商品属性',
-  ec_product_image: '商品图片',
-  ec_cart: '购物车',
-  ec_order: '订单管理',
-  ec_order_item: '订单明细',
-  ec_review: '商品评价',
-  fin_payment: '支付记录',
-  fin_settlement: '财务结算',
-  fin_reconciliation: '财务对账',
-  cms_content: '内容管理',
-  cs_ticket: '客服工单',
-  platfrom_account: '平台账户',
-  platform_role: '平台角色',
-  platform_menu: '平台菜单',
-  wallet: '钱包',
-  wallet_ledger: '钱包流水',
-  wallet_recharge: '钱包充值',
-  wallet_withdrawal: '钱包提现',
-};
-const define = (
+
+function f(key: string, options: Partial<ResourceField> = {}): ResourceField {
+  const type: ResourceFieldType = key.endsWith('_identity')
+    ? 'identity'
+    : numbers.has(key)
+      ? 'number'
+      : booleans.has(key)
+        ? 'boolean'
+        : dates.has(key)
+          ? 'date'
+          : datetimes.has(key)
+            ? 'datetime'
+            : textareas.has(key)
+              ? 'textarea'
+              : key === 'password'
+                ? 'password'
+                : 'text';
+  return { key, label: fieldLabels[key] ?? key, type, ...options };
+}
+
+function relation(key: string, resource: string, required = false): ResourceField {
+  return f(key, { type: 'identity', relation: resource, required });
+}
+
+function define(
   name: string,
-  resource: string,
+  title: string,
   mode: ResourceMode,
-  pageKind: ResourcePageKind,
-  keys: string[],
+  fields: ResourceField[],
+  pageKind: ResourcePageKind = 'list',
   detailActions?: DetailAction[],
-): ResourceUiDefinition => {
-  const fields = keys.map(field);
+): ResourceUiDefinition {
   return {
     key: name.replace(/_/g, '-'),
     name,
-    resource,
-    title: titles[name] ?? '业务资源',
+    resource: `/${name}`,
+    title,
     mode,
     pageKind,
     fields,
-    requiredIdentities: fields
-      .filter((item) => item.required && item.key.endsWith('_identity'))
-      .map((item) => item.key),
     ...(detailActions ? { detailActions } : {}),
   };
-};
-const action = (
-  name: string,
-  resource: string,
-  keys: string[],
-  payload?: Record<string, unknown>,
-): DetailAction => ({
-  name,
-  resource,
-  fields: keys.map(field),
-  ...(payload ? { payload } : {}),
-});
+}
+
+const reason = [f('reason', { required: true })];
 
-/** Exact UI contract for every backend ExpectedResources entry. */
 export const resources: ResourceUiDefinition[] = [
-  define('gas_basic', '/gas/gas_basic', 'writable', 'list', [
-    'code!',
-    'name!',
-    'credit_code',
-    'principal',
-    'address',
-    'longitude',
-    'latitude',
+  define('gas_basic', '气站', 'writable', [f('code', { required: true }), f('name', { required: true }), f('credit_code'), f('principal'), f('address'), f('longitude'), f('latitude')]),
+  define('gas_account', '气站账户', 'writable', [f('username', { required: true }), f('password', { required: true }), f('display_name'), f('role_code'), relation('gas_basic_identity', '/gas_basic', true)]),
+  define('delivery_basic', '配送站', 'writable', [f('delivery_code', { required: true }), f('name', { required: true }), relation('gas_basic_identity', '/gas_basic'), f('principal'), f('address')]),
+  define('delivery_account', '配送站账户', 'writable', [f('username', { required: true }), f('password', { required: true }), f('display_name'), f('role_code'), relation('delivery_basic_identity', '/delivery_basic', true)]),
+  define('staff_account', '工作人员', 'writable', [f('username', { required: true }), f('password', { required: true }), f('name', { required: true }), f('phone'), f('avatar'), f('role_code'), relation('gas_basic_identity', '/gas_basic'), relation('delivery_basic_identity', '/delivery_basic'), f('work_status')]),
+  define('staff_credential', '工作人员资质', 'writable', [relation('staff_account_identity', '/staff_account', true), f('credential_type', { required: true }), f('credential_no'), f('expired_at')]),
+  define('user_account', '用户账户', 'writable', [f('username', { required: true }), f('password', { required: true }), f('name', { required: true }), f('phone'), f('avatar'), f('real_name')]),
+  define('user_address', '用户地址', 'writable', [relation('user_account_identity', '/user_account', true), f('address', { required: true }), f('longitude'), f('latitude'), f('is_default')]),
+  define('user_service_relation', '用户服务关系', 'writable', [relation('user_account_identity', '/user_account', true), relation('gas_basic_identity', '/gas_basic'), relation('delivery_basic_identity', '/delivery_basic'), relation('staff_account_identity', '/staff_account')]),
+
+  define('product_type', '产品类型', 'writable', [f('code', { required: true }), f('name', { required: true })]),
+  define('product_warehouse', '库房', 'writable', [f('code', { required: true }), f('name', { required: true }), f('address'), f('manager'), f('phone'), f('is_enabled')]),
+  define('product_info', '产品信息', 'managed', [f('code', { required: true }), f('name', { required: true }), relation('product_type_identity', '/product_type', true), f('params', { required: true }), relation('warehouse_identity', '/product_warehouse'), relation('gas_basic_identity', '/gas_basic'), relation('delivery_basic_identity', '/delivery_basic'), relation('user_account_identity', '/user_account'), f('produced_at', { required: true }), f('is_enabled')], 'list', [
+    { name: '修改启用状态', resource: '/product_info/:identity/status', method: 'PATCH', fields: [f('status', { required: true, type: 'select', options: [{ label: '启用', value: 'enabled' }, { label: '停用', value: 'disabled' }] })] },
   ]),
-  define('gas_account', '/gas/gas_account', 'writable', 'list', [
-    'username!',
-    'password!',
-    'display_name',
-    'role_code',
-    'gas_basic_identity!',
+  define('product_repair', '产品检修记录', 'writable', [relation('product_info_identity', '/product_info', true), f('repair_no', { required: true }), f('repair_type', { required: true }), f('started_at', { required: true }), f('completed_at'), f('result'), f('target_status'), f('content'), f('operator'), f('remark')]),
+  define('product_owner', '产品归属记录', 'append_only', [relation('product_info_identity', '/product_info', true), relation('warehouse_identity', '/product_warehouse'), relation('gas_basic_identity', '/gas_basic'), relation('delivery_basic_identity', '/delivery_basic'), relation('user_account_identity', '/user_account'), f('action', { required: true }), f('occurred_at', { required: true }), f('reason'), f('remark')]),
+
+  define('gasorder_contract', '配送合同', 'managed', [f('contract_no', { required: true }), relation('user_account_identity', '/user_account', true), relation('gas_basic_identity', '/gas_basic', true), relation('delivery_basic_identity', '/delivery_basic'), f('title', { required: true }), f('terms'), f('file_uri'), f('default_delivery_fee'), f('signed_at', { required: true }), f('effective_at', { required: true }), f('expired_at')], 'list', [
+    { name: '启用合同', resource: '/gasorder_contract/:identity/activate', fields: reason },
+    { name: '续签合同', resource: '/gasorder_contract/:identity/renew', fields: [f('effective_at', { required: true }), f('expired_at'), ...reason] },
+    { name: '终止合同', resource: '/gasorder_contract/:identity/terminate', danger: true, fields: reason },
   ]),
-  define('delivery_basic', '/delivery/delivery_basic', 'writable', 'list', [
-    'delivery_code!',
-    'name!',
-    'gas_basic_identity',
-    'principal',
-    'address',
+  define('gasorder_contract_product', '合同气瓶', 'append_only', [relation('gasorder_contract_identity', '/gasorder_contract', true), relation('product_info_identity', '/product_info', true), f('unit_price')], 'list', [
+    { name: '解绑气瓶', resource: '/gasorder_contract_product/:identity/unbind', danger: true, fields: reason },
   ]),
-  define('delivery_account', '/delivery/delivery_account', 'writable', 'list', [
-    'username!',
-    'password!',
-    'display_name',
-    'role_code',
-    'delivery_basic_identity!',
+  define('gasorder_contract_revision', '合同修订记录', 'readonly', []),
+  define('gasorder_basic', '气体配送订单', 'managed', [f('request_no', { required: true }), relation('gasorder_contract_identity', '/gasorder_contract', true), f('creator_type', { required: true, type: 'select', options: [{ label: '用户', value: 'user' }, { label: '工作人员', value: 'staff' }, { label: '配送站', value: 'delivery' }, { label: '气站', value: 'gas' }] }), f('creator_identity', { required: true }), relation('user_address_identity', '/user_address', true), f('gasorder_contract_product_identities', { required: true, type: 'identity-list', relation: '/gasorder_contract_product' }), f('contact_name', { required: true }), f('contact_phone', { required: true }), f('discount_amount'), f('remark')], 'list', [
+    { name: '分配订单', resource: '/gasorder_basic/:identity/assign', fields: [relation('delivery_basic_identity', '/delivery_basic', true), relation('staff_account_identity', '/staff_account', true), ...reason] },
+    { name: '开始罐装', resource: '/gasorder_basic/:identity/filling', fields: reason },
+    { name: '待配送', resource: '/gasorder_basic/:identity/ready', fields: reason },
+    { name: '标记异常', resource: '/gasorder_basic/:identity/exception', fields: reason },
+    { name: '恢复订单', resource: '/gasorder_basic/:identity/recover', fields: reason },
+    { name: '取消订单', resource: '/gasorder_basic/:identity/cancel', danger: true, fields: reason },
   ]),
-  define('delivery_task', '/delivery/delivery_task', 'writable', 'list', [
-    'ec_order_identity!',
-    'delivery_basic_identity!',
-    'staff_account_identity',
+  define('gasorder_item', '订单明细', 'readonly', []),
+  define('gasorder_assign', '分配记录', 'readonly', []),
+  define('gasorder_status', '状态记录', 'readonly', []),
+  define('gasorder_track', '运行轨迹', 'readonly', []),
+  define('gasorder_track_point', '轨迹点', 'readonly', []),
+  define('gasorder_confirm', '确认记录', 'readonly', []),
+  define('gasorder_payment', '支付记录', 'readonly', []),
+
+  define('ec_category', '商品分类', 'writable', [relation('parent_identity', '/ec_category'), f('name', { required: true }), f('sort_no')], 'tree'),
+  define('ec_product', '商品', 'writable', [relation('ec_category_identity', '/ec_category', true), f('product_code', { required: true }), f('name', { required: true }), f('price_amount', { required: true }), f('stock_quantity')]),
+  define('ec_product_attribute', '商品属性', 'writable', [relation('ec_product_identity', '/ec_product', true), f('name', { required: true }), f('value', { required: true }), f('sort_no')]),
+  define('ec_product_image', '商品图片', 'writable', [relation('ec_product_identity', '/ec_product', true), f('image_uri', { required: true }), f('sort_no'), f('is_cover')]),
+  define('ec_cart', '购物车', 'writable', [relation('user_account_identity', '/user_account', true), relation('ec_product_identity', '/ec_product', true), f('quantity', { required: true }), f('selected')]),
+  define('ec_order', '商城订单', 'writable', [relation('user_account_identity', '/user_account', true), relation('gas_basic_identity', '/gas_basic'), relation('delivery_basic_identity', '/delivery_basic'), f('order_no', { required: true }), f('total_amount', { required: true })]),
+  define('ec_order_item', '商城订单明细', 'writable', [relation('ec_order_identity', '/ec_order', true), relation('ec_product_identity', '/ec_product', true), f('product_snapshot', { required: true }), f('quantity', { required: true }), f('sale_amount', { required: true })]),
+  define('ec_review', '商品评价', 'writable', [relation('ec_order_identity', '/ec_order', true), relation('ec_product_identity', '/ec_product', true), relation('user_account_identity', '/user_account', true), f('score', { required: true }), f('content', { required: true })]),
+
+  define('wallet_basic', '钱包', 'managed', [f('owner_type'), f('owner_identity'), f('alipay_id'), f('alipay_name'), f('wxpay_id'), f('wxpay_name'), f('balance'), f('withdrawal_balance')], 'list', [
+    { name: '后台充值', resource: '/wallet_basic/:identity/recharge', fields: [f('request_no', { required: true }), f('amount', { required: true }), f('withdrawable'), ...reason, f('remark')] },
+    { name: '修改钱包状态', resource: '/wallet_basic/:identity/status', method: 'PATCH', fields: [f('status', { required: true, type: 'select', options: [{ label: '启用', value: 'enabled' }, { label: '停用', value: 'disabled' }, { label: '冻结', value: 'frozen' }] })] },
   ]),
-  define('delivery_track', '/delivery/delivery_track', 'writable', 'list', [
-    'delivery_task_identity!',
-    'started_at',
-    'completed_at',
+  define('wallet_bank', '银行卡', 'readonly', []),
+  define('wallet_payment', '钱包支付记录', 'readonly', []),
+  define('wallet_record', '钱包流水', 'readonly', []),
+  define('wallet_refund', '退款记录', 'readonly', []),
+  define('wallet_apply_cash', '提现申请', 'managed', [], 'list', [
+    { name: '审核通过', resource: '/wallet_apply_cash/:identity/approve', fields: reason },
+    { name: '审核驳回', resource: '/wallet_apply_cash/:identity/reject', danger: true, fields: reason },
   ]),
-  define(
-    'delivery_track_point',
-    '/delivery/delivery_track_point',
-    'readonly',
-    'list',
-    [
-      'delivery_track_identity',
-      'point_type',
-      'occurred_at',
-      'longitude',
-      'latitude',
-    ],
-  ),
-  define('staff_account', '/staff/account', 'writable', 'list', [
-    'username!',
-    'password!',
-    'name!',
-    'phone',
-    'avatar',
-    'role_code',
-    'gas_basic_identity',
-    'delivery_basic_identity',
-    'work_status',
-  ]),
-  define('staff_credential', '/staff/credential', 'writable', 'list', [
-    'staff_account_identity!',
-    'credential_type!',
-    'credential_no',
-    'expired_at',
-  ]),
-  define('user_account', '/user/account', 'writable', 'list', [
-    'username!',
-    'password!',
-    'name!',
-    'phone',
-    'avatar',
-    'real_name',
-  ]),
-  define('user_address', '/user/address', 'writable', 'list', [
-    'user_account_identity!',
-    'address!',
-    'longitude',
-    'latitude',
-    'is_default',
-  ]),
-  define(
-    'user_service_relation',
-    '/user/service_relation',
-    'writable',
-    'list',
-    [
-      'user_account_identity!',
-      'gas_basic_identity',
-      'delivery_basic_identity',
-      'staff_account_identity',
-    ],
-  ),
-  define(
-    'dev_smart_cylinder_valve',
-    '/device/dev_smart_cylinder_valve',
-    'writable',
-    'list',
-    ['device_no!', 'model', 'online_status', 'owner_identity'],
-  ),
-  define(
-    'dev_device_binding',
-    '/device/dev_device_binding',
-    'writable',
-    'list',
-    [
-      'smart_cylinder_valve_identity!',
-      'user_account_identity!',
-      'effective_at',
-      'expired_at',
-    ],
-  ),
-  define('dev_telemetry', '/device/dev_telemetry', 'readonly', 'list', [
-    'smart_cylinder_valve_identity',
-    'reported_at',
-    'payload',
-  ]),
-  define('ec_category', '/ec/ec_category', 'writable', 'tree', [
-    'parent_identity',
-    'name!',
-    'sort_no',
-  ]),
-  define('ec_product', '/ec/ec_product', 'writable', 'list', [
-    'ec_category_identity!',
-    'product_code!',
-    'name!',
-    'price_amount!',
-    'stock_quantity',
-  ]),
-  define(
-    'ec_product_attribute',
-    '/ec/ec_product_attribute',
-    'writable',
-    'list',
-    ['ec_product_identity!', 'name!', 'value!', 'sort_no'],
-  ),
-  define('ec_product_image', '/ec/ec_product_image', 'writable', 'list', [
-    'ec_product_identity!',
-    'image_uri!',
-    'sort_no',
-    'is_cover',
-  ]),
-  define('ec_cart', '/ec/ec_cart', 'writable', 'list', [
-    'user_account_identity!',
-    'ec_product_identity!',
-    'quantity!',
-    'selected',
-  ]),
-  define('ec_order', '/ec/ec_order', 'writable', 'list', [
-    'user_account_identity!',
-    'gas_basic_identity',
-    'delivery_basic_identity',
-    'order_no!',
-    'total_amount!',
-  ]),
-  define('ec_order_item', '/ec/ec_order_item', 'writable', 'list', [
-    'ec_order_identity!',
-    'ec_product_identity!',
-    'product_snapshot!',
-    'quantity!',
-    'sale_amount!',
-  ]),
-  define('ec_review', '/ec/ec_review', 'writable', 'list', [
-    'ec_order_identity!',
-    'ec_product_identity!',
-    'user_account_identity!',
-    'score!',
-    'content!',
-  ]),
-  define('fin_payment', '/finance/fin_payment', 'writable', 'list', [
-    'ec_order_identity!',
-    'channel!',
-    'amount!',
-    'paid_at',
-  ]),
-  define('fin_settlement', '/finance/fin_settlement', 'writable', 'list', [
-    'settlement_no!',
-    'subject_type!',
-    'subject_identity!',
-    'period_start!',
-    'period_end!',
-  ]),
-  define(
-    'fin_reconciliation',
-    '/finance/fin_reconciliation',
-    'writable',
-    'list',
-    ['channel!', 'bill_date!', 'difference_amount!'],
-  ),
-  define('cms_content', '/content/cms_content', 'writable', 'list', [
-    'content_type!',
-    'title!',
-    'body!',
-    'version_no',
-    'publish_status',
-  ]),
-  define('cs_ticket', '/customer_service/cs_ticket', 'writable', 'list', [
-    'user_account_identity!',
-    'ticket_no!',
-    'category!',
-    'priority!',
-  ]),
-  define('platfrom_account', '/platform/platfrom_account', 'writable', 'list', [
-    'username!',
-    'password!',
-    'display_name',
-    'avatar',
-    'platform_role_code!',
-    'phone',
-  ]),
-  define(
-    'platform_role',
-    '/platform/platform_role',
-    'writable',
-    'list',
-    ['role_code!', 'name!', 'data_scope!'],
-    [
-      action(
-        '分配菜单',
-        '/platform/platform_role/:identity/menu',
-        ['menu_identities'],
-      ),
-    ],
-  ),
-  define('platform_menu', '/platform/platform_menu', 'writable', 'tree', [
-    'parent_identity',
-    'menu_code!',
-    'name!',
-    'icon',
-    'path',
-    'sort_no',
-  ]),
-  define('wallet', '/wallet/wallet', 'readonly', 'list', [
-    'owner_identity',
-    'balance_amount',
-    'frozen_amount',
-    'status',
-  ]),
-  define('wallet_ledger', '/wallet/wallet_ledger', 'readonly', 'list', [
-    'wallet_identity',
-    'amount',
-    'balance_after',
-  ]),
-  define('wallet_recharge', '/wallet/wallet_recharge', 'readonly', 'list', [
-    'wallet_identity',
-    'amount',
-    'status',
-  ]),
-  define('wallet_withdrawal', '/wallet/wallet_withdrawal', 'readonly', 'list', [
-    'wallet_identity',
-    'amount',
-    'status',
+
+  define('fin_payment', '财务支付记录', 'writable', [relation('ec_order_identity', '/ec_order', true), f('channel', { required: true }), f('amount', { required: true }), f('paid_at')]),
+  define('fin_settlement', '财务结算', 'writable', [f('settlement_no', { required: true }), f('subject_type', { required: true }), f('subject_identity', { required: true }), f('period_start', { required: true }), f('period_end', { required: true })]),
+  define('fin_reconciliation', '财务对账', 'writable', [f('channel', { required: true }), f('bill_date', { required: true }), f('difference_amount', { required: true })]),
+  define('cms_content', '内容', 'writable', [f('content_type', { required: true }), f('title', { required: true }), f('body', { required: true }), f('version_no'), f('publish_status')]),
+  define('cs_ticket', '客服工单', 'writable', [relation('user_account_identity', '/user_account', true), f('ticket_no', { required: true }), f('category', { required: true }), f('priority', { required: true })]),
+  define('platfrom_account', '平台账户', 'writable', [f('username', { required: true }), f('password', { required: true }), f('display_name'), f('avatar'), f('platform_role_code', { required: true }), f('phone')]),
+  define('platform_role', '平台角色', 'writable', [f('role_code', { required: true }), f('name', { required: true }), f('data_scope', { required: true })], 'list', [
+    { name: '分配菜单', resource: '/platform_role/:identity/menu', method: 'PUT', fields: [f('menu_identities', { type: 'identity-list', relation: '/platform_menu' })] },
   ]),
+  define('platform_menu', '平台菜单', 'writable', [relation('parent_identity', '/platform_menu'), f('menu_code', { required: true }), f('name', { required: true }), f('icon'), f('path'), f('sort_no')], 'tree'),
 ];
 
-export const resourceByName = Object.fromEntries(
+export const resourceByPath = Object.fromEntries(
   resources.map((definition) => [definition.resource, definition]),
 ) as Record<string, ResourceUiDefinition>;
+
 export function getResource(resourcePath: string): ResourceUiDefinition {
-  const definition = resourceByName[resourcePath];
-  if (!definition) throw new Error('Unknown resource: ' + resourcePath);
+  const definition = resourceByPath[resourcePath];
+  if (!definition) throw new Error(`未知资源：${resourcePath}`);
   return definition;
 }