@xpert-ai/plugin-live-dashboard 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (153) hide show
  1. package/.xpertai-plugin/plugin.json +10 -2
  2. package/README.md +70 -0
  3. package/assets/branding/cover-v1.prompt.txt +27 -0
  4. package/assets/branding/cover-v1.webp +0 -0
  5. package/assets/previews/customer-brief.png +0 -0
  6. package/assets/previews/profit-atlas.png +0 -0
  7. package/assets/previews/trend-workspace.png +0 -0
  8. package/dist/index.js +14 -1
  9. package/dist/lib/agent.schema.d.ts +43 -37
  10. package/dist/lib/agent.schema.js +2 -1
  11. package/dist/lib/app-config.d.ts +62 -0
  12. package/dist/lib/app-config.js +38 -0
  13. package/dist/lib/artifact-type.provider.d.ts +15 -0
  14. package/dist/lib/artifact-type.provider.js +78 -0
  15. package/dist/lib/assistant-template.d.ts +2 -0
  16. package/dist/lib/assistant-template.js +7 -0
  17. package/dist/lib/content.provider.js +13 -5
  18. package/dist/lib/dashboard-navigation.d.ts +58 -14
  19. package/dist/lib/dashboard-navigation.js +11 -10
  20. package/dist/lib/dashboard-view.schema.d.ts +197 -46
  21. package/dist/lib/dashboard-view.schema.js +8 -1
  22. package/dist/lib/dashboard.service.d.ts +39 -2
  23. package/dist/lib/dashboard.service.js +52 -28
  24. package/dist/lib/document-libraries.d.ts +1 -1
  25. package/dist/lib/document-libraries.js +3 -2
  26. package/dist/lib/document-network.d.ts +1 -1
  27. package/dist/lib/document-network.js +2 -6
  28. package/dist/lib/editing-feedback.d.ts +5 -0
  29. package/dist/lib/editing-feedback.js +19 -0
  30. package/dist/lib/editing-patch.d.ts +22 -0
  31. package/dist/lib/editing-patch.js +46 -0
  32. package/dist/lib/editing-session.d.ts +167 -0
  33. package/dist/lib/editing-session.js +53 -0
  34. package/dist/lib/editing.d.ts +92 -60
  35. package/dist/lib/editing.js +36 -24
  36. package/dist/lib/html-guidance.d.ts +1 -1
  37. package/dist/lib/html-guidance.js +1 -1
  38. package/dist/lib/middleware.js +48 -20
  39. package/dist/lib/monitor.d.ts +70 -0
  40. package/dist/lib/monitor.js +101 -0
  41. package/dist/lib/plugin.js +5 -1
  42. package/dist/lib/project.d.ts +106 -0
  43. package/dist/lib/project.js +17 -0
  44. package/dist/lib/projects.schema.d.ts +49 -0
  45. package/dist/lib/projects.schema.js +7 -0
  46. package/dist/lib/projects.service.d.ts +23 -0
  47. package/dist/lib/projects.service.js +65 -0
  48. package/dist/lib/prompt-workflows.d.ts +3 -2
  49. package/dist/lib/prompt-workflows.js +17 -3
  50. package/dist/lib/provider-options.controller.d.ts +10 -0
  51. package/dist/lib/provider-options.controller.js +49 -0
  52. package/dist/lib/resource-card.js +1 -1
  53. package/dist/lib/runtime-context.d.ts +3 -0
  54. package/dist/lib/runtime-context.js +13 -0
  55. package/dist/lib/save-evidence.d.ts +1 -1
  56. package/dist/lib/templates.d.ts +2 -0
  57. package/dist/lib/templates.js +55 -0
  58. package/dist/lib/view.provider.d.ts +97 -7
  59. package/dist/lib/view.provider.js +39 -10
  60. package/dist/libraries/TREND-WORKSPACE-ICONS-LICENSE.txt +43 -0
  61. package/dist/libraries/catalog.json +1 -1
  62. package/dist/remote/app.css +1 -1
  63. package/dist/remote/app.js +33 -33
  64. package/dist/remote/build-manifest.json +118 -32
  65. package/dist/sandbox-actions/action.json +1 -1
  66. package/dist/sandbox-actions/bundle/host.js +2 -2
  67. package/dist/sandbox-actions/bundle/resource-cache.mjs +2 -1
  68. package/dist/sandbox-actions/bundle/validate.mjs +1 -1
  69. package/docs/docs.json +7 -0
  70. package/docs/frontend-libraries.mdx +12 -4
  71. package/docs/html-mode.md +3 -3
  72. package/docs/quick-start-acceptance.mdx +50 -0
  73. package/docs/quick-start.mdx +64 -0
  74. package/docs/superstore.mdx +38 -0
  75. package/docs/team-sharing.mdx +6 -2
  76. package/docs/trend-workspace-acceptance.mdx +43 -0
  77. package/docs/trend-workspace.mdx +30 -0
  78. package/docs/verification.mdx +4 -2
  79. package/docs/visual-styles-acceptance.mdx +40 -0
  80. package/docs/visual-styles.mdx +46 -0
  81. package/package.json +25 -18
  82. package/scripts/import-prompts.mjs +108 -0
  83. package/skills/live-dashboard/SKILL.md +27 -3
  84. package/skills/live-dashboard/examples/README.md +25 -0
  85. package/skills/live-dashboard/examples/catalog.json +79 -0
  86. package/skills/live-dashboard/examples/production-quality/README.md +25 -0
  87. package/skills/live-dashboard/examples/production-quality/dashboard.html +129 -0
  88. package/skills/live-dashboard/examples/production-quality/definition.json +67 -0
  89. package/skills/live-dashboard/examples/production-quality/demo.csv +7 -0
  90. package/skills/live-dashboard/examples/production-quality/demo.json +44 -0
  91. package/skills/live-dashboard/examples/production-quality/expected.json +26 -0
  92. package/skills/live-dashboard/examples/production-quality/preview.png +0 -0
  93. package/skills/live-dashboard/examples/production-quality/query.json +53 -0
  94. package/skills/live-dashboard/examples/regional-sales/README.md +25 -0
  95. package/skills/live-dashboard/examples/regional-sales/dashboard-create.json +35 -0
  96. package/skills/live-dashboard/examples/regional-sales/definition.json +35 -0
  97. package/skills/live-dashboard/examples/regional-sales/demo.csv +5 -0
  98. package/skills/live-dashboard/examples/regional-sales/demo.json +18 -0
  99. package/skills/live-dashboard/examples/regional-sales/expected.json +19 -0
  100. package/skills/live-dashboard/examples/regional-sales/preview.png +0 -0
  101. package/skills/live-dashboard/examples/regional-sales/query.json +45 -0
  102. package/skills/live-dashboard/examples/sales-overview/README.md +25 -0
  103. package/skills/live-dashboard/examples/sales-overview/dashboard.html +129 -0
  104. package/skills/live-dashboard/examples/sales-overview/definition.json +57 -0
  105. package/skills/live-dashboard/examples/sales-overview/demo.csv +7 -0
  106. package/skills/live-dashboard/examples/sales-overview/demo.json +38 -0
  107. package/skills/live-dashboard/examples/sales-overview/expected.json +22 -0
  108. package/skills/live-dashboard/examples/sales-overview/preview.png +0 -0
  109. package/skills/live-dashboard/examples/sales-overview/query.json +52 -0
  110. package/skills/live-dashboard/examples/superstore/README.md +64 -0
  111. package/skills/live-dashboard/examples/superstore/THIRD_PARTY_LICENSE.txt +207 -0
  112. package/skills/live-dashboard/examples/superstore/build_data.py +155 -0
  113. package/skills/live-dashboard/examples/superstore/build_pages.py +129 -0
  114. package/skills/live-dashboard/examples/superstore/checks.json +104 -0
  115. package/skills/live-dashboard/examples/superstore/customers-mobile-dark.png +0 -0
  116. package/skills/live-dashboard/examples/superstore/customers-select.png +0 -0
  117. package/skills/live-dashboard/examples/superstore/customers.html +316 -0
  118. package/skills/live-dashboard/examples/superstore/customers.png +0 -0
  119. package/skills/live-dashboard/examples/superstore/customers.queries.json +512 -0
  120. package/skills/live-dashboard/examples/superstore/expected.json +4069 -0
  121. package/skills/live-dashboard/examples/superstore/import.json +200 -0
  122. package/skills/live-dashboard/examples/superstore/orders.csv +10195 -0
  123. package/skills/live-dashboard/examples/superstore/overview-mobile-dark.png +0 -0
  124. package/skills/live-dashboard/examples/superstore/overview-select.png +0 -0
  125. package/skills/live-dashboard/examples/superstore/overview.html +310 -0
  126. package/skills/live-dashboard/examples/superstore/overview.png +0 -0
  127. package/skills/live-dashboard/examples/superstore/overview.queries.json +636 -0
  128. package/skills/live-dashboard/examples/superstore/page.js +109 -0
  129. package/skills/live-dashboard/examples/superstore/profitability-mobile-dark.png +0 -0
  130. package/skills/live-dashboard/examples/superstore/profitability-select.png +0 -0
  131. package/skills/live-dashboard/examples/superstore/profitability.html +307 -0
  132. package/skills/live-dashboard/examples/superstore/profitability.png +0 -0
  133. package/skills/live-dashboard/examples/superstore/profitability.queries.json +334 -0
  134. package/skills/live-dashboard/examples/superstore/provenance.json +24 -0
  135. package/skills/live-dashboard/examples/superstore/semantic-model.json +220 -0
  136. package/skills/live-dashboard/examples/superstore/test_data.py +62 -0
  137. package/skills/live-dashboard/references/html-runtime.md +1 -1
  138. package/skills/live-dashboard/themes/README.md +50 -0
  139. package/skills/live-dashboard/themes/customer-brief/README.md +47 -0
  140. package/skills/live-dashboard/themes/customer-brief/charts.js +17 -0
  141. package/skills/live-dashboard/themes/customer-brief/layout.html +22 -0
  142. package/skills/live-dashboard/themes/customer-brief/theme.css +108 -0
  143. package/skills/live-dashboard/themes/profit-atlas/README.md +43 -0
  144. package/skills/live-dashboard/themes/profit-atlas/charts.js +30 -0
  145. package/skills/live-dashboard/themes/profit-atlas/layout.html +19 -0
  146. package/skills/live-dashboard/themes/profit-atlas/theme.css +75 -0
  147. package/skills/live-dashboard/themes/trend-workspace/ICON_LICENSE.txt +43 -0
  148. package/skills/live-dashboard/themes/trend-workspace/README.md +144 -0
  149. package/skills/live-dashboard/themes/trend-workspace/charts.js +60 -0
  150. package/skills/live-dashboard/themes/trend-workspace/icons.js +11 -0
  151. package/skills/live-dashboard/themes/trend-workspace/layout.html +45 -0
  152. package/skills/live-dashboard/themes/trend-workspace/select.js +127 -0
  153. package/skills/live-dashboard/themes/trend-workspace/theme.css +137 -0
package/skills/live-dashboard/examples/superstore/checks.json ADDED
@@ -0,0 +1,104 @@
1
+ [
2
+ {
3
+ "case": "all",
4
+ "controls": {
5
+ "year": "",
6
+ "region": "",
7
+ "category": ""
8
+ },
9
+ "summary": {
10
+ "Sales": "2326534.354300",
11
+ "Profit": "292296.814600",
12
+ "Quantity": "38654",
13
+ "Orders": "5111",
14
+ "Customers": "804",
15
+ "ReturnedOrders": "296",
16
+ "ReturnedSales": "180504.277900"
17
+ }
18
+ },
19
+ {
20
+ "case": "west",
21
+ "controls": {
22
+ "year": "",
23
+ "region": "West",
24
+ "category": ""
25
+ },
26
+ "summary": {
27
+ "Sales": "739813.608500",
28
+ "Profit": "110798.817000",
29
+ "Quantity": "12466",
30
+ "Orders": "1635",
31
+ "Customers": "686",
32
+ "ReturnedOrders": "189",
33
+ "ReturnedSales": "107483.057500"
34
+ }
35
+ },
36
+ {
37
+ "case": "east",
38
+ "controls": {
39
+ "year": "",
40
+ "region": "East",
41
+ "category": ""
42
+ },
43
+ "summary": {
44
+ "Sales": "691828.168000",
45
+ "Profit": "94883.260300",
46
+ "Quantity": "11159",
47
+ "Orders": "1475",
48
+ "Customers": "685",
49
+ "ReturnedOrders": "44",
50
+ "ReturnedSales": "41705.144000"
51
+ }
52
+ },
53
+ {
54
+ "case": "year2024",
55
+ "controls": {
56
+ "year": "2024",
57
+ "region": "",
58
+ "category": ""
59
+ },
60
+ "summary": {
61
+ "Sales": "745567.531200",
62
+ "Profit": "95926.347600",
63
+ "Quantity": "12737",
64
+ "Orders": "1723",
65
+ "Customers": "704",
66
+ "ReturnedOrders": "105",
67
+ "ReturnedSales": "75502.063900"
68
+ }
69
+ },
70
+ {
71
+ "case": "furniture",
72
+ "controls": {
73
+ "year": "",
74
+ "region": "",
75
+ "category": "Furniture"
76
+ },
77
+ "summary": {
78
+ "Sales": "754747.761300",
79
+ "Profit": "19729.995600",
80
+ "Quantity": "8369",
81
+ "Orders": "1819",
82
+ "Customers": "714",
83
+ "ReturnedOrders": "136",
84
+ "ReturnedSales": "59219.174900"
85
+ }
86
+ },
87
+ {
88
+ "case": "west2024furniture",
89
+ "controls": {
90
+ "year": "2024",
91
+ "region": "West",
92
+ "category": "Furniture"
93
+ },
94
+ "summary": {
95
+ "Sales": "74155.119500",
96
+ "Profit": "2892.830000",
97
+ "Quantity": "909",
98
+ "Orders": "202",
99
+ "Customers": "184",
100
+ "ReturnedOrders": "36",
101
+ "ReturnedSales": "11587.636500"
102
+ }
103
+ }
104
+ ]
package/skills/live-dashboard/examples/superstore/customers.html ADDED
@@ -0,0 +1,316 @@
1
+ <!doctype html>
2
+ <html lang="zh-Hans">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width,initial-scale=1">
6
+ <title>Superstore · 客户与退货分析</title>
7
+ </head>
8
+ <body data-page="customers" data-dashboard-theme="customer-brief@1">
9
+ <main class="workspace">
10
+ <header class="brief-header">
11
+ <div>
12
+ <h1>客户与退货分析</h1>
13
+ <p class="description">理解客户结构，关注退货表现</p>
14
+ <span class="demo">Superstore 演示数据 · 2021–2024</span>
15
+ </div>
16
+ <div class="filters" aria-label="分析筛选">
17
+ <div class="filter-field">
18
+ <label for="filter-year">年份</label>
19
+ <select id="filter-year" data-dashboard-control="year" disabled>
20
+ </select>
21
+ </div>
22
+ <div class="filter-field">
23
+ <label for="filter-region">区域</label>
24
+ <select id="filter-region" data-dashboard-control="region" disabled>
25
+ </select>
26
+ </div>
27
+ <div class="filter-field">
28
+ <label for="filter-category">品类</label>
29
+ <select id="filter-category" data-dashboard-control="category" disabled>
30
+ </select>
31
+ </div>
32
+ </div>
33
+ </header>
34
+ <section class="brief-metrics" aria-label="当前筛选主要指标">
35
+ <div class="brief-primary-metrics">
36
+ <div class="metric">
37
+ <p>客户数</p>
38
+ <output id="metric-0">—</output>
39
+ <small>Customer ID 去重</small>
40
+ </div>
41
+ <div class="metric">
42
+ <p>订单数</p>
43
+ <output id="metric-1">—</output>
44
+ <small>Order ID 去重</small>
45
+ </div>
46
+ <div class="metric">
47
+ <p>客单价（USD）</p>
48
+ <output id="metric-2">—</output>
49
+ <small>销售额 ÷ 订单数</small>
50
+ </div>
51
+ </div>
52
+ <div class="brief-return-metrics">
53
+ <div class="metric">
54
+ <p>退货订单占比</p>
55
+ <output id="metric-4">—</output>
56
+ <small>退货订单数 ÷ 订单数</small>
57
+ </div>
58
+ <div class="metric">
59
+ <p>退货订单数</p>
60
+ <output id="metric-3">—</output>
61
+ <small>退货 Order ID 去重</small>
62
+ </div>
63
+ </div>
64
+ </section>
65
+ <div class="analysis">
66
+ <div class="brief-plots">
67
+ <section class="panel">
68
+ <h2>
69
+ <span class="section-number" aria-hidden="true">01</span>客户分群销售贡献</h2>
70
+ <p class="note">USD · 客户数在当前范围内去重</p>
71
+ <div id="chart-primary" class="chart" role="img" aria-label="客户分群销售贡献">
72
+ </div>
73
+ </section>
74
+ <section class="panel">
75
+ <h2>
76
+ <span class="section-number" aria-hidden="true">02</span>各区域退货订单数</h2>
77
+ <p class="note">按 Order ID 去重；不代表退货商品件数</p>
78
+ <div id="chart-secondary" class="chart" role="img" aria-label="各区域退货订单数">
79
+ </div>
80
+ </section>
81
+ </div>
82
+ <div class="full-details">
83
+ <section class="details">
84
+ <h2>客户分群与退货明细</h2>
85
+ <p class="note">USD · 同一筛选范围</p>
86
+ <div class="table-scroll" tabindex="0" role="region" aria-label="客户分群与退货明细">
87
+ <table>
88
+ <thead>
89
+ <tr>
90
+ <th scope="col">客户分群</th>
91
+ <th scope="col">销售额（USD）</th>
92
+ <th scope="col">订单数</th>
93
+ <th scope="col">客户数</th>
94
+ <th scope="col">退货订单数</th>
95
+ <th scope="col">退货订单占比</th>
96
+ <th scope="col">退货关联销售额（USD）</th>
97
+ </tr>
98
+ </thead>
99
+ <tbody id="details-rows">
100
+ </tbody>
101
+ </table>
102
+ </div>
103
+ </section>
104
+ </div>
105
+ <p id="status" class="status" role="status">正在加载…</p>
106
+ <details class="methodology">
107
+ <summary>数据与指标口径</summary>
108
+ <p>来源：Tableau Superstore 虚构教学工作簿，2021–2024 年，金额单位 USD。退货表先按订单去重，再关联订单行。退货关联销售额不等于退款或收入损失。利润率为合计利润除以合计销售额；订单数与客户数由后端在当前范围内去重，不能累加分组计数。各看板筛选状态独立。</p>
109
+ </details>
110
+ </div>
111
+ <footer>
112
+ <span>2021–2024 · 演示数据 · Data Xpert</span>
113
+ <span id="freshness">尚无当前查询结果</span>
114
+ </footer>
115
+ </main>
116
+ <script>const config={
117
+ "key": "customers",
118
+ "title": "客户与退货分析",
119
+ "description": "客户结构、订单价值与退货订单关联表现",
120
+ "bindings": [
121
+ "summary",
122
+ "segments",
123
+ "regions"
124
+ ],
125
+ "panels": [
126
+ "客户分群销售贡献",
127
+ "各区域退货订单数"
128
+ ],
129
+ "notes": [
130
+ "USD · 客户数在当前范围内去重",
131
+ "按 Order ID 去重；不代表退货商品件数"
132
+ ],
133
+ "dimension": "客户分群",
134
+ "table": "客户分群与退货明细",
135
+ "options": {
136
+ "year": [
137
+ [
138
+ "",
139
+ "全部年份"
140
+ ],
141
+ [
142
+ "2021",
143
+ "2021"
144
+ ],
145
+ [
146
+ "2022",
147
+ "2022"
148
+ ],
149
+ [
150
+ "2023",
151
+ "2023"
152
+ ],
153
+ [
154
+ "2024",
155
+ "2024"
156
+ ]
157
+ ],
158
+ "region": [
159
+ [
160
+ "",
161
+ "全部区域"
162
+ ],
163
+ [
164
+ "Central",
165
+ "Central"
166
+ ],
167
+ [
168
+ "East",
169
+ "East"
170
+ ],
171
+ [
172
+ "South",
173
+ "South"
174
+ ],
175
+ [
176
+ "West",
177
+ "West"
178
+ ]
179
+ ],
180
+ "category": [
181
+ [
182
+ "",
183
+ "全部品类"
184
+ ],
185
+ [
186
+ "Furniture",
187
+ "Furniture"
188
+ ],
189
+ [
190
+ "Office Supplies",
191
+ "Office Supplies"
192
+ ],
193
+ [
194
+ "Technology",
195
+ "Technology"
196
+ ]
197
+ ]
198
+ },
199
+ "measures": [
200
+ "Sales",
201
+ "Orders",
202
+ "Customers",
203
+ "ReturnedOrders",
204
+ "ReturnedSales"
205
+ ]
206
+ };
207
+ // No rows or backend endpoints belong here. All panels use governed query results.
208
+ (async () => {
209
+ const live = window.xpertLiveArtifact;
210
+ const {enhanceSelect:enhanceDashboardSelect,charts:DashboardCharts}=window.CustomerBrief;
211
+ const status = document.getElementById('status');
212
+ const selects = [...document.querySelectorAll('select[data-dashboard-control]')];
213
+ const datasets = new Map();
214
+ const chartIds = ['chart-primary', 'chart-secondary', ...(config.key === 'overview' ? ['chart-profit'] : [])];
215
+ const charts = chartIds.map(id => window.echarts.init(document.getElementById(id), null, {renderer:'svg'}));
216
+ const controls = {year:'',region:'',category:''};
217
+ const integer = new Intl.NumberFormat('en-US',{maximumFractionDigits:0});
218
+ const decimal = new Intl.NumberFormat('en-US',{minimumFractionDigits:2,maximumFractionDigits:2});
219
+ const fields = config.measures;
220
+ let failure = false;
221
+ function number(value) {
222
+ if ((typeof value !== 'number' && typeof value !== 'string') || String(value).trim() === '') throw Error('查询结果缺少必要指标。');
223
+ const n=Number(value);if(!Number.isFinite(n)||Math.abs(n)>Number.MAX_SAFE_INTEGER)throw Error('数值超出安全展示范围。');return n;
224
+ }
225
+ function precise(value) {
226
+ // Keep decimal strings exact until two-place display rounding; Number is only for ratios/plots.
227
+ const raw=String(value);if(!/^-?\d+(\.\d+)?$/.test(raw))throw Error('金额格式不符合数据契约。');
228
+ const negative=raw.startsWith('-');const [whole,tail='']=raw.replace('-','').split('.');
229
+ let cents=BigInt(whole)*100n+BigInt((tail+'00').slice(0,2));if(Number(tail[2]??0)>=5)cents+=1n;
230
+ return (negative&&cents?'-':'')+(cents/100n).toLocaleString('en-US')+'.'+String(cents%100n).padStart(2,'0');
231
+ }
232
+ function ratio(a,b){return b?decimal.format(a/b*100)+'%':'—';}
233
+ function clear(message,isError=false){
234
+ document.querySelectorAll('output').forEach(el=>el.textContent='—');
235
+ document.getElementById('details-rows').replaceChildren();charts.forEach(chart=>{ chart.clear(); chart.getDom().removeAttribute('aria-label'); });
236
+ status.textContent=message;status.classList.toggle('error',isError);
237
+ document.getElementById('freshness').textContent='尚无当前查询结果';
238
+ }
239
+ function fail(message){failure=true;datasets.clear();clear(message,true);}
240
+ function table(rows,dimension){
241
+ const max=Math.max(1,...rows.map(row=>number(row.Sales)));
242
+ document.getElementById('details-rows').replaceChildren(...rows.map(row=>{
243
+ const tr=document.createElement('tr');
244
+ const values=config.key==='customers'
245
+ ?[row[dimension],precise(row.Sales),integer.format(number(row.Orders)),integer.format(number(row.Customers)),integer.format(number(row.ReturnedOrders)),ratio(number(row.ReturnedOrders),number(row.Orders)),precise(row.ReturnedSales)]
246
+ :[row[dimension],precise(row.Sales),precise(row.Profit),ratio(number(row.Profit),number(row.Sales)),integer.format(number(row.Orders)),integer.format(number(row.Customers))];
247
+ if(config.key==='overview')values.splice(4);
248
+ for(const [index,value]of values.entries()){
249
+ const td=document.createElement('td');td.textContent=String(value);
250
+ if(config.key!=='customers'&&(index===2||index===3)&&number(row.Profit)<0)td.className='negative';
251
+ if(index===1){const bar=document.createElement('span');bar.className='table-bar';bar.style.width=(Math.max(0,number(row.Sales))/max*100)+'%';bar.setAttribute('aria-hidden','true');td.append(bar);}
252
+ tr.append(td);
253
+ }return tr;
254
+ }));
255
+ }
256
+ function render(){
257
+ if(failure||config.bindings.some(id=>!datasets.has(id)))return;
258
+ const summary=datasets.get('summary').rows;
259
+ if(!summary.length||number(summary[0].Orders)===0){clear('当前筛选下没有订单，请调整年份、区域或品类。');return;}
260
+ if(summary.length!==1)throw Error('总计必须由一个后端聚合行提供。');
261
+ const s=summary[0];const sales=number(s.Sales),profit=config.key==='customers'?0:number(s.Profit),orders=number(s.Orders),customers=number(s.Customers),returned=config.key==='customers'?number(s.ReturnedOrders):0;
262
+ const values=config.key==='customers'
263
+ ?[integer.format(customers),integer.format(orders),orders?decimal.format(sales/orders):'—',integer.format(returned),ratio(returned,orders)]
264
+ :[precise(s.Sales),precise(s.Profit),ratio(profit,sales),integer.format(orders),integer.format(customers)];
265
+ values.forEach((value,i)=>{document.getElementById('metric-'+i).textContent=value;});
266
+ const chartsUI = DashboardCharts;
267
+ const ranked = (rows, field) => [...rows].sort((a,b) => number(b[field]) - number(a[field]));
268
+ if(config.key==='overview'){
269
+ const trend=[...datasets.get('trend').rows].sort((a,b)=>a.OrderMonth.localeCompare(b.OrderMonth));
270
+ chartsUI.line(charts[0],trend,{dimension:'OrderMonth',measure:'Sales',label:'销售额（USD）'});
271
+ chartsUI.line(charts[2],trend,{dimension:'OrderMonth',measure:'Profit',label:'利润（USD）',color:'teal'});
272
+ chartsUI.horizontal(charts[1],ranked(datasets.get('regions').rows,'Sales'),{dimension:'Region',measure:'Sales',label:'销售额（USD）'});
273
+ table(ranked(datasets.get('categories').rows,'Sales'),'Category');
274
+ }else if(config.key==='profitability'){
275
+ const rows=ranked(datasets.get('subcategories').rows,'Profit');
276
+ chartsUI.horizontal(charts[0],rows,{dimension:'SubCategory',measure:'Profit',label:'利润（USD）',color:'teal'});
277
+ chartsUI.scatter(charts[1],rows,{dimension:'SubCategory',x:'Sales',y:'Profit',xLabel:'销售额（USD）',yLabel:'利润（USD）'});
278
+ table([...rows].reverse(),'SubCategory');
279
+ }else{
280
+ chartsUI.horizontal(charts[0],ranked(datasets.get('segments').rows,'Sales'),{dimension:'Segment',measure:'Sales',label:'销售额（USD）',palette:['blue','segment-two','segment-three']});
281
+ chartsUI.horizontal(charts[1],ranked(datasets.get('regions').rows,'ReturnedOrders'),{dimension:'Region',measure:'ReturnedOrders',label:'退货订单数',decimals:0,palette:['returns']});
282
+ table(datasets.get('segments').rows,'Segment');
283
+ }
284
+ status.textContent='所有指标与图表已按当前筛选更新。';status.classList.remove('error');
285
+ const times=config.bindings.map(id=>datasets.get(id).freshness?.sourceFetchedAt).filter(Boolean).sort();
286
+ document.getElementById('freshness').textContent=times.length?'查询时间：'+new Date(times[0]).toLocaleString('zh-CN'):'查询已完成（来源未提供时间）';
287
+ }
288
+ async function queryAll(){
289
+ failure=false;datasets.clear();clear('正在查询当前筛选…');selects.forEach(el=>el.disabled=true);
290
+ try{const results=await Promise.allSettled(config.bindings.map(id=>live.query(id,{...controls})));if(results.some(r=>r.status==='rejected'))throw Error('查询失败');}
291
+ catch{fail('查询未完成，请检查数据权限或刷新重试。');}
292
+ finally{selects.forEach(el=>el.disabled=false);}
293
+ }
294
+ try{
295
+ const context=await live.ready();document.body.classList.toggle('dark',context.theme==='dark');
296
+ if(config.bindings.length!==context.bindingIds.length||config.bindings.some(id=>!context.bindingIds.includes(id)))throw Error('看板缺少必要的数据绑定，请重新按完整配方制作。');
297
+ Object.assign(controls,context.defaults);
298
+ for(const id of config.bindings)live.subscribe(id,dataset=>{
299
+ try{
300
+ if(!dataset.completeness||dataset.completeness.truncated)throw Error('查询结果不完整，请缩小范围后重试。');
301
+ for(const row of dataset.rows){for(const field of fields){if(row[field]===null||row[field]===undefined){if(field==='Sales'||field==='Profit'||field==='Quantity'||field==='ReturnedSales'){if(Number(row.Orders)===0)continue;}throw Error('必要指标为空，无法展示完整结果。');}number(row[field]);}}
302
+ failure=false;datasets.set(id,dataset);render();
303
+ }catch(error){fail(error.message||'查询结果不可用。');}
304
+ });
305
+ for(const select of selects){
306
+ const key=select.dataset.dashboardControl;
307
+ for(const [value,label]of config.options[key])select.add(new Option(label,JSON.stringify(value)));
308
+ select.value=JSON.stringify(controls[key]);
309
+ enhanceDashboardSelect(select);
310
+ select.addEventListener('change',()=>{controls[key]=JSON.parse(select.value);void queryAll();});
311
+ }
312
+ const observer=new ResizeObserver(()=>charts.forEach(chart=>chart.resize()));observer.observe(document.querySelector('.analysis'));
313
+ await queryAll();
314
+ }catch(error){fail(error.message||'看板初始化失败，请刷新重试。');}
315
+ })();
316
+ </script></body></html>