openyida 2026.7.18 → 2026.7.21

package/lib/samples/yida-canvas-custom-page/split-pane-detail.canvas.jsx

@@ -8,7 +8,7 @@
  * @openyida-theme-scope {{OPENYIDA_THEME_SCOPE}}
  * @openyida-blocks {{OPENYIDA_BLOCKS}}
  */
-import React, { useMemo, useState } from 'react';
+import React, { useMemo, useState, useEffect } from 'react';
 import { ConfigProvider, Button, Input, Select, Tag, Typography } from 'antd';
 
 const { Title, Text, Paragraph } = Typography;
@@ -84,7 +84,7 @@ const DEFAULT_ROADMAP = [
   { stage: '03', title: '推进处理', text: '完成分派、备注或状态更新。' },
 ];
 const DEFAULT_THEME_PROFILE = { followRuntimeTheme: false, name: 'amber-client-file', themeColor: '#B7791F', themeColorDeep: '#7C4A03', themeColorSoft: '#FFF8E7', themeColorTint: 'rgba(183, 121, 31, 0.18)', palette: ['#B7791F', '#0F9F8E', '#E11D48', '#2563EB', '#F97316'] };
-const DEFAULT_DATA_BINDING = { enabled: false, mode: 'seed' };
+const DEFAULT_DATA_BINDING = { enabled: false, mode: 'seed', seedStrategy: 'sample-only' };
 const DEFAULT_INSIGHTS = [{ conclusion: '双栏详情页适合高频查阅和逐条处理。' }];
 const BACKGROUND_IMAGES = {
   detail: 'https://images.unsplash.com/photo-1771147372627-7fffe86cf00b?auto=format&fit=crop&w=1400&q=80',
@@ -98,6 +98,7 @@ const THEME_PROFILE = parseTemplateJson('{{OPENYIDA_THEME_PROFILE_JSON}}', DEFAU
 const THEME_SCOPE = withFallback('{{OPENYIDA_THEME_SCOPE}}', 'page');
 const DATA_BINDING = parseTemplateJson('{{OPENYIDA_DATA_BINDING_JSON}}', DEFAULT_DATA_BINDING);
 const INSIGHTS = parseTemplateJson('{{OPENYIDA_INSIGHTS_JSON}}', DEFAULT_INSIGHTS);
+const RESEARCH_LEVEL = withFallback('{{OPENYIDA_RESEARCH_LEVEL}}', 'sample');
 
 function getThemeColor(fallback) {
   if (typeof window === 'undefined' || !window.getComputedStyle) {
@@ -152,6 +153,163 @@ function getSeedRows() {
   ];
 }
 
+function isDataBindingEnabled(binding) {
+  return Boolean(binding && binding.enabled && binding.mode && binding.mode !== 'seed');
+}
+
+function isSampleSeedPreview(binding) {
+  const mode = binding && binding.mode ? binding.mode : 'seed';
+  return RESEARCH_LEVEL === 'sample' && !isDataBindingEnabled(binding) && mode === 'seed';
+}
+
+function getCsrfToken() {
+  try {
+    return (window.g_config && (window.g_config._csrf_token || window.g_config.csrfToken)) || '';
+  } catch (err) {
+    return '';
+  }
+}
+
+function buildDataRequest(binding) {
+  if (binding.mode === 'form' && binding.appType && binding.formUuid) {
+    const qs = new URLSearchParams({
+      formUuid: binding.formUuid,
+      appType: binding.appType,
+      currentPage: String(binding.pageNumber || 1),
+      pageSize: String(binding.pageSize || 20),
+      searchFieldJson: JSON.stringify(binding.query || {}),
+    }).toString();
+    return {
+      url: '/dingtalk/web/' + binding.appType + '/v1/form/searchFormDatas.json?' + qs,
+      method: 'GET',
+      body: {},
+    };
+  }
+  return {
+    url: binding.endpoint,
+    method: binding.method || 'GET',
+    body: binding.body || {},
+  };
+}
+
+function requestJson(req, signal) {
+  const csrfToken = getCsrfToken();
+  const headers = { 'Content-Type': 'application/json' };
+  if (csrfToken) {
+    headers.global_csrf_token = csrfToken;
+  }
+  return fetch(req.url, {
+    method: req.method || 'GET',
+    credentials: 'include',
+    headers,
+    body: req.method === 'GET' ? undefined : JSON.stringify(req.body || {}),
+    signal,
+  }).then((resp) => {
+    if (!resp.ok) {
+      throw new Error('HTTP ' + resp.status);
+    }
+    return resp.json();
+  }).then((json) => {
+    if (json && json.success === false) {
+      throw new Error(json.errorMsg || json.message || 'request failed');
+    }
+    return json;
+  });
+}
+
+function unwrapRows(payload) {
+  const queue = [payload];
+  const seen = [];
+  while (queue.length) {
+    const item = queue.shift();
+    if (!item || seen.indexOf(item) >= 0) { continue; }
+    seen.push(item);
+    if (Array.isArray(item)) { return item; }
+    ['data', 'list', 'values', 'records'].forEach((key) => {
+      if (Array.isArray(item[key])) {
+        queue.unshift(item[key]);
+      }
+    });
+    ['result', 'content', 'value'].forEach((key) => {
+      if (item[key] && typeof item[key] === 'object') {
+        queue.push(item[key]);
+      }
+    });
+  }
+  return [];
+}
+
+function getTotalCount(payload) {
+  const queue = [payload];
+  const seen = [];
+  while (queue.length) {
+    const item = queue.shift();
+    if (!item || seen.indexOf(item) >= 0) { continue; }
+    seen.push(item);
+    if (typeof item.totalCount === 'number') { return item.totalCount; }
+    if (typeof item.total === 'number') { return item.total; }
+    if (typeof item.count === 'number') { return item.count; }
+    ['result', 'content', 'data', 'value'].forEach((key) => {
+      if (item[key] && typeof item[key] === 'object') {
+        queue.push(item[key]);
+      }
+    });
+  }
+  return null;
+}
+
+function pickField(row, fieldId, fallbackKeys) {
+  const data = row.formData || row.data || row;
+  if (fieldId && data[fieldId] !== undefined) {
+    return data[fieldId];
+  }
+  for (let i = 0; i < fallbackKeys.length; i++) {
+    if (data[fallbackKeys[i]] !== undefined) {
+      return data[fallbackKeys[i]];
+    }
+  }
+  return '';
+}
+
+function normalizeBoundRows(rows, binding) {
+  const fields = binding.fields || {};
+  return rows.map((row, index) => ({
+    id: row.formInstanceId || row.instanceId || row.id || ('ROW-' + (index + 1)),
+    title: pickField(row, fields.title || fields.code, ['title', 'name', 'code']) || ('记录 ' + (index + 1)),
+    desc: pickField(row, fields.desc || fields.summary || fields.description, ['desc', 'summary', 'description', 'content']) || '',
+    status: pickField(row, fields.status, ['status', 'state', 'progress']) || '待处理',
+    owner: pickField(row, fields.owner, ['owner', 'creator', 'dept']) || '未分配',
+    amount: pickField(row, fields.amount || fields.value, ['amount', 'value', 'count']) || '-',
+  }));
+}
+
+function useYidaData(binding) {
+  const [state, setState] = React.useState(() => ({ loading: isDataBindingEnabled(binding), error: '', rows: [], totalCount: null }));
+  React.useEffect(() => {
+    if (!isDataBindingEnabled(binding)) { return undefined; }
+    const controller = new AbortController();
+    const req = buildDataRequest(binding);
+    if (!req.url) {
+      setState({ loading: false, error: '数据绑定缺少 endpoint 或 appType/formUuid', rows: [], totalCount: null });
+      return undefined;
+    }
+    setState({ loading: true, error: '', rows: [], totalCount: null });
+    requestJson(req, controller.signal).then((json) => {
+      const rows = unwrapRows(json);
+      const totalCount = getTotalCount(json);
+      if (binding.emptyAsError !== false && totalCount > 0 && rows.length === 0) {
+        throw new Error('接口返回结构未识别：totalCount=' + totalCount + ' 但 rows=0');
+      }
+      setState({ loading: false, error: '', rows: normalizeBoundRows(rows, binding), totalCount });
+    }).catch((err) => {
+      if (err.name === 'AbortError') { return; }
+      setState({ loading: false, error: err.message || String(err), rows: [], totalCount: null });
+    });
+    return () => controller.abort();
+  }, []);
+  return state;
+}
+
 function getStatusColor(status) {
   if (/高|异常|风险|超时/.test(status)) {
     return 'error';
@@ -164,7 +322,7 @@ function getStatusColor(status) {
 
 const QUEUE_STATUS = { high: '高优先级', pending: '待跟进' };
 
-function SplitQueue({ rows, selectedId, onSelect, filters, onFilterChange }) {
+function SplitQueue({ rows, selectedId, onSelect, filters, onFilterChange, emptyText }) {
   return (
     <aside className="oy-split-queue">
       <div className="oy-filter-bar">
@@ -181,7 +339,7 @@ function SplitQueue({ rows, selectedId, onSelect, filters, onFilterChange }) {
       </div>
       <div className="oy-queue-list">
         {rows.length === 0 ? (
-          <div className="oy-queue-empty"><Text>无匹配工单，试试清空搜索或切换状态</Text></div>
+          <div className="oy-queue-empty"><Text>{emptyText || '无匹配工单，试试清空搜索或切换状态'}</Text></div>
         ) : rows.map((row) => (
           <button
             type="button"
@@ -203,6 +361,28 @@ function SplitQueue({ rows, selectedId, onSelect, filters, onFilterChange }) {
 
 function DetailPane({ item }) {
   const insight = INSIGHTS[0] || { conclusion: PAGE.ctaText, evidence: '', suggestion: '' };
+  if (!item) {
+    return (
+      <section className="oy-detail-pane oy-empty-detail">
+        <div className="oy-detail-hero">
+          <Tag color="default">空态入口</Tag>
+          <Title level={2}>等待真实记录</Title>
+          <Paragraph>未接入真实表单数据时，交付态不会展示前端 seed 详情。请在 page-spec.json 写入 dataBinding.mode=form，或先登记真实表单记录。</Paragraph>
+          <div className="oy-detail-actions">
+            <Button type="primary">{PAGE.primaryCta}</Button>
+            <Button>刷新数据</Button>
+          </div>
+        </div>
+      </section>
+    );
+  }
+  const metricItems = isSampleSeedPreview(DATA_BINDING)
+    ? METRICS
+    : [
+      { label: '当前状态', value: item.status || '-' },
+      { label: '负责人', value: item.owner || '-' },
+      { label: '金额/数值', value: item.amount || '-' },
+    ];
   return (
     <section className="oy-detail-pane">
       <div className="oy-detail-hero">
@@ -215,7 +395,7 @@ function DetailPane({ item }) {
         </div>
       </div>
       <div className="oy-detail-grid">
-        {METRICS.map((metric) => (
+        {metricItems.map((metric) => (
           <div className="oy-metric-card" key={metric.label}>
             <Text>{metric.label}</Text>
             <strong>{metric.value}</strong>
@@ -245,9 +425,12 @@ function DetailPane({ item }) {
 }
 
 function YidaComp() {
-  updateShellTheme();
-  const rows = useMemo(() => getSeedRows(), []);
-  const [selectedId, setSelectedId] = useState(rows[0] && rows[0].id);
+  useEffect(() => { updateShellTheme(); }, []);
+  const seedRows = useMemo(() => getSeedRows(), []);
+  const usesSeedRows = isSampleSeedPreview(DATA_BINDING);
+  const dataState = useYidaData(DATA_BINDING);
+  const rows = dataState.rows.length ? dataState.rows : (usesSeedRows ? seedRows : []);
+  const [selectedId, setSelectedId] = useState(() => usesSeedRows && seedRows[0] ? seedRows[0].id : null);
   const [queueFilters, setQueueFilters] = useState({ keyword: '', status: 'all' });
   const handleQueueFilter = (key, value) => setQueueFilters((prev) => Object.assign({}, prev, { [key]: value }));
   const filteredRows = useMemo(() => {
@@ -262,8 +445,13 @@ function YidaComp() {
     });
   }, [rows, queueFilters]);
   const visibleSelectedId = filteredRows.some((row) => row.id === selectedId) ? selectedId : (filteredRows[0] && filteredRows[0].id);
-  const selected = rows.find((row) => row.id === visibleSelectedId) || rows[0];
+  const selected = rows.find((row) => row.id === visibleSelectedId) || null;
   const themeVars = buildScopedThemeVars();
+  const queueEmptyText = isDataBindingEnabled(DATA_BINDING)
+    ? dataState.loading ? '正在读取真实表单数据' : '暂无真实表单记录。若需要演示内容，请先通过表单数据写入链路创建 demo records。'
+    : usesSeedRows
+      ? '无匹配 sample 记录，试试清空搜索或切换状态'
+      : '未接入真实表单数据。完整应用交付页不会用前端 seedRows 冒充业务队列。';
 
   return (
     <ConfigProvider getPopupContainer={(triggerNode) => (triggerNode && triggerNode.parentElement) || document.body}>
@@ -334,14 +522,22 @@ function YidaComp() {
               <div className="oy-brand-mark">{PAGE.brandInitials}</div>
               <div>
                 <Tag color="warning">{PAGE.tagline}</Tag>
+                {isDataBindingEnabled(DATA_BINDING) ? <Tag color={dataState.error ? 'error' : dataState.loading ? 'processing' : 'green'}>DataBridge</Tag> : usesSeedRows ? <Tag color="warning">Sample seed</Tag> : <Tag>未接数据</Tag>}
                 <h1>{PAGE.brandName}</h1>
                 <p>{PAGE.heroText}</p>
+                <p className="oy-data-status">
+                  {isDataBindingEnabled(DATA_BINDING)
+                    ? dataState.error || (dataState.loading ? '正在读取真实数据' : '真实数据已接入' + (dataState.totalCount === null ? '' : '：' + dataState.totalCount + ' 条'))
+                    : usesSeedRows
+                      ? '当前为 sample/seed 预览数据，未接真实表单。'
+                      : '未配置真实表单 dataBinding，当前不显示前端 seed 队列。'}
+                </p>
               </div>
             </div>
             <Button type="primary">{PAGE.primaryCta}</Button>
           </header>
           <section className="oy-split-layout">
-            <SplitQueue rows={filteredRows} selectedId={visibleSelectedId} onSelect={setSelectedId} filters={queueFilters} onFilterChange={handleQueueFilter} />
+            <SplitQueue rows={filteredRows} selectedId={visibleSelectedId} onSelect={setSelectedId} filters={queueFilters} onFilterChange={handleQueueFilter} emptyText={queueEmptyText} />
             <DetailPane item={selected} />
           </section>
         </div>

package/lib/samples/yida-custom-page/data-management.oyd.jsx

@@ -75,14 +75,19 @@ export function injectControlReset() {
     style.id = id;
     document.head.appendChild(style);
   }
-  style.innerHTML = CONTROL_RESET_CSS;
+  style.textContent = CONTROL_RESET_CSS;
 }
 
 export function didMount() {
   this.injectControlReset();
 }
 
-export function didUnmount() {}
+export function didUnmount() {
+  var style = document.getElementById('openyida-asset-control-reset');
+  if (style && style.parentNode) {
+    style.parentNode.removeChild(style);
+  }
+}
 
 export function chooseCategory(value) {
   _customState.category = value;
@@ -166,6 +171,12 @@ export function renderJsx() {
     return { text: due + ' 天后保养', color: colors.inkSoft, bg: colors.lineSoft };
   };
 
+  var healthColorOf = function (health) {
+    if (health >= 80) { return colors.success; }
+    if (health >= 60) { return colors.warning; }
+    return colors.danger;
+  };
+
   return (
     <div className="oyd-page oyd-asset-page" style={styles.page}>
       <div style={{ display: 'none' }}>{this.state && this.state.timestamp}</div>
@@ -229,7 +240,7 @@ export function renderJsx() {
               {filtered.map((d) => {
                 var st = statusMap[d.status] || statusMap.stopped;
                 var dt = dueTag(d.due);
-                var healthColor = d.health >= 80 ? colors.success : d.health >= 60 ? colors.warning : colors.danger;
+                var healthColor = healthColorOf(d.health);
                 return (
                   <div key={d.id} onClick={(e) => { self.openDevice(d.id); }} style={{ display: isMobile ? 'block' : 'grid', gridTemplateColumns: '2.2fr 1.4fr 1fr 1.1fr 0.9fr', alignItems: 'center', padding: isMobile ? '14px 16px' : '14px 18px', borderTop: '1px solid ' + colors.lineSoft, cursor: 'pointer' }}>
                     <div>

package/lib/samples/yida-custom-page/design-tokens.js

@@ -10,8 +10,8 @@ var colors = {
   active:        '#EDE9FE',  // 通用浅色激活/按下底
   disabled:      '#DDD6FE',  // 禁用态：浅、去饱和
   primaryLight:  '#EDE9FE',  // 主色浅背景：选中行底、标签高亮底
-  controlSelectedBg: 'var(--oyd-control-selected-bg, rgba(47,111,237,.08))', // native 控件选中浅底
-  controlInfoBg:     'var(--oyd-control-info-bg, rgba(47,111,237,.08))',     // native 提示块浅底
+  controlSelectedBg: 'var(--oyd-control-selected-bg, rgba(124,58,237,.08))', // native 控件选中浅底
+  controlInfoBg:     'var(--oyd-control-info-bg, rgba(124,58,237,.08))',     // native 提示块浅底
 
   // 语义色（固定，不随主题变——保证成功/警告/错误语义稳定）
   success:        '#52C41A',

package/lib/samples/yida-custom-page/detail-profile.oyd.jsx

@@ -221,7 +221,7 @@ export function renderJsx() {
                 {HISTORY.map((h, idx) => {
                   var dot = h.tone === 'warn' ? colors.warning : colors.primary;
                   return (
-                    <div key={idx} style={{ position: 'relative', paddingBottom: idx === HISTORY.length - 1 ? 0 : 18 }}>
+                    <div key={h.date + '-' + h.title} style={{ position: 'relative', paddingBottom: idx === HISTORY.length - 1 ? 0 : 18 }}>
                       <span style={{ position: 'absolute', left: -19, top: 3, width: 10, height: 10, borderRadius: 999, background: '#fff', border: '2.5px solid ' + dot }}></span>
                       <div style={{ display: 'flex', alignItems: 'baseline', gap: 10, flexWrap: 'wrap' }}>
                         <span style={{ fontSize: 14, fontWeight: 700, color: colors.ink }}>{h.title}</span>

package/lib/samples/yida-custom-page/portal-shell-home.oyd.jsx

@@ -96,14 +96,19 @@ export function injectControlReset() {
     style.id = id;
     document.head.appendChild(style);
   }
-  style.innerHTML = CONTROL_RESET_CSS;
+  style.textContent = CONTROL_RESET_CSS;
 }
 
 export function didMount() {
   this.injectControlReset();
 }
 
-export function didUnmount() {}
+export function didUnmount() {
+  var style = document.getElementById('openyida-portal-control-reset');
+  if (style && style.parentNode) {
+    style.parentNode.removeChild(style);
+  }
+}
 
 export function handleSearchInput(e) {
   if (_customState._isComposing) { return; }

package/lib/samples/yida-custom-page/split-pane-detail.oyd.jsx

@@ -139,6 +139,7 @@ export function renderJsx() {
     normal: { label: '常规', color: colors.inkSoft, bg: colors.chipBg },
   };
   var slaColor = { danger: colors.danger, warn: colors.warning, ok: colors.success };
+  var slaBg = { danger: colors.dangerBg, warn: colors.warningBg, ok: colors.successBg };
 
   var list = self.getVisibleTickets();
   var current = self.getSelected();
@@ -202,7 +203,7 @@ export function renderJsx() {
                 </div>
                 <div style={{ marginTop: 8, fontSize: 13, color: colors.inkSoft }}>{current.id} · {current.requester} · {current.channel} · 最近更新 {current.updated}</div>
               </div>
-              <span style={{ height: 30, padding: '0 12px', borderRadius: 8, background: colors.dangerBg, color: slaColor[current.slaLevel], fontSize: 13, fontWeight: 700, display: 'inline-flex', alignItems: 'center', gap: 6 }}>
+              <span style={{ height: 30, padding: '0 12px', borderRadius: 8, background: slaBg[current.slaLevel] || colors.dangerBg, color: slaColor[current.slaLevel], fontSize: 13, fontWeight: 700, display: 'inline-flex', alignItems: 'center', gap: 6 }}>
                 <svg width="14" height="14" viewBox="0 0 16 16" aria-hidden="true"><circle cx="8" cy="8.5" r="5.5" fill="none" stroke="currentColor" strokeWidth="1.4" /><path d="M8 5.5v3l2 1.2M8 2h0" stroke="currentColor" strokeWidth="1.4" strokeLinecap="round" /></svg>
                 SLA {current.sla}
               </span>

package/lib/schema/adapters/app-adapter.js

@@ -0,0 +1,210 @@
+'use strict';
+
+const { validateSemanticKey } = require('./keys');
+const { schemaError } = require('../errors');
+const { createRemoteMissingError } = require('../remote-missing');
+const { readApp } = require('../../app/services/app-reader');
+const { createAppResource, updateAppResource } = require('../../app/services/app-service');
+const { isDeepStrictEqual } = require('util');
+
+const appAdapter = {
+  resourceType: 'app',
+  adapterVersion: 1,
+  validate(entry) {
+    const app = entry.definition;
+    validateSemanticKey(app.key, '/app/key');
+  },
+
+  normalize(entry) {
+    this.validate(entry);
+    const app = entry.definition;
+
+    const desired = {
+      key: app.key,
+      name: app.name,
+    };
+
+    return {
+      resourceType: 'app',
+      key: app.key,
+      desired,
+      dependsOn: [],
+      dependencySources: {},
+    };
+  },
+
+  async readObserved(binding, context = {}) {
+    const normalized = normalizeAppBindings(binding);
+    if (!normalized.appType) {
+      throw schemaError('SCHEMA_OBSERVED_BINDING_MISSING', 'App observed read requires appType binding.', {
+        details: { resourceType: 'app' },
+      });
+    }
+    const reader = context.services && context.services.readApp || readApp;
+    try {
+      return await reader(context, { appType: normalized.appType });
+    } catch (error) {
+      if (error && error.code === 'APP_READ_NOT_FOUND') {
+        throw createRemoteMissingError();
+      }
+      throw error;
+    }
+  },
+
+  projectObserved(observed, binding, context = {}) {
+    const normalized = normalizeAppBindings(binding);
+    const resource = context.resource || {};
+    const desired = resource.desired || {};
+    const managed = {
+      key: desired.key || resource.key,
+    };
+    const name = normalizeObservedAppName(observed && (observed.appName || observed.name));
+    if (name) {
+      managed.name = name;
+    }
+    return {
+      managed,
+      bindings: {
+        appType: normalized.appType,
+      },
+    };
+  },
+
+  async create(desired, context = {}) {
+    const creator = context.services && context.services.createAppResource || createAppResource;
+    const result = await creator(context, {
+      appName: desired.name,
+      description: desired.name,
+      contentLocale: context.contentLocale,
+    });
+    if (typeof context.checkpointCreateIdentity === 'function') {
+      await context.checkpointCreateIdentity(result);
+    }
+    return result;
+  },
+
+  async resumeCreate(desired, createIdentity, context = {}) {
+    const bindings = normalizeAppBindings(createIdentity);
+    return { appType: bindings.appType };
+  },
+
+  async update(desired, observed, binding, context = {}) {
+    const normalized = normalizeAppBindings(binding);
+    const updater = context.services && context.services.updateAppResource || updateAppResource;
+    return updater(context, {
+      appType: normalized.appType,
+      name: desired.name,
+    });
+  },
+
+  buildBindings(result, context = {}) {
+    const existing = normalizeAppBindings(context.stateResource);
+    const appType = result && result.appType || existing.appType;
+    if (!appType) {
+      throw schemaError('SCHEMA_APPLY_VERIFY_FAILED', 'App operation did not produce app bindings.', {
+        details: { resourceType: 'app' },
+      });
+    }
+    return { appType };
+  },
+
+  projectOperationResult(_result, stateResource, context = {}) {
+    if (context.operation !== 'create') {
+      return null;
+    }
+    const bindings = normalizeAppBindings(stateResource);
+    if (!bindings.appType) {
+      throw schemaError('SCHEMA_APPLY_VERIFY_FAILED', 'App operation did not produce app bindings.', {
+        details: { resourceType: 'app' },
+      });
+    }
+    return {
+      managed: cloneManagedApp(context.resource && context.resource.desired),
+      bindings: {
+        appType: bindings.appType,
+      },
+    };
+  },
+
+  verify(projection, context = {}) {
+    if (!projection || !isDeepStrictEqual(projection.managed, context.resource && context.resource.desired)) {
+      throw schemaError('SCHEMA_APPLY_VERIFY_FAILED', 'App observed projection does not match desired managed state.', {
+        details: {
+          resourceType: 'app',
+          key: context.resource && context.resource.key,
+        },
+      });
+    }
+    return projection;
+  },
+
+  validateStateResource(entry) {
+    const state = entry.state || {};
+    assertAllowedKeys(state.bindings, ['appType'], `${entry.path}/bindings`);
+    if (!state.bindings.appType || typeof state.bindings.appType !== 'string') {
+      throw schemaError('SCHEMA_STATE_INVALID', 'App state bindings must include appType.', {
+        path: `${entry.path}/bindings/appType`,
+      });
+    }
+    if (state.lastApplied !== undefined) {
+      validateManagedApp(state.lastApplied, `${entry.path}/lastApplied`);
+    }
+  },
+};
+
+function normalizeAppBindings(binding) {
+  const source = binding && binding.bindings ? binding.bindings : binding || {};
+  return {
+    appType: source.appType || '',
+  };
+}
+
+function normalizeObservedAppName(value) {
+  if (value && typeof value === 'object' && !Array.isArray(value)) {
+    return value.zh_CN || value.en_US || Object.keys(value).sort().map(key => value[key]).find(Boolean) || '';
+  }
+  return value ? String(value) : '';
+}
+
+function cloneManagedApp(value) {
+  return value === undefined ? undefined : JSON.parse(JSON.stringify(value));
+}
+
+function validateManagedApp(value, pointer) {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    throw schemaError('SCHEMA_STATE_INVALID', 'App lastApplied must be a compact managed object.', {
+      path: pointer,
+    });
+  }
+  assertAllowedKeys(value, ['key', 'name'], pointer);
+  if (typeof value.key !== 'string' || !value.key) {
+    throw schemaError('SCHEMA_STATE_INVALID', 'App lastApplied must include key.', {
+      path: `${pointer}/key`,
+    });
+  }
+  if (typeof value.name !== 'string' || !value.name) {
+    throw schemaError('SCHEMA_STATE_INVALID', 'App lastApplied must include name.', {
+      path: `${pointer}/name`,
+    });
+  }
+}
+
+function assertAllowedKeys(value, allowedKeys, pointer) {
+  const allowed = new Set(allowedKeys);
+  Object.keys(value || {}).forEach((key) => {
+    if (!allowed.has(key)) {
+      throw schemaError('SCHEMA_STATE_INVALID', 'State contains an unknown property.', {
+        path: `${pointer}/${escapePointer(key)}`,
+        details: { property: key },
+      });
+    }
+  });
+}
+
+function escapePointer(value) {
+  return String(value).replace(/~/g, '~0').replace(/\//g, '~1');
+}
+
+module.exports = {
+  appAdapter,
+};