普通用户建应用(前端):新建应用的三个起点(说需求、场景模板、从已有的开始);蓝图页(对话加卡片、反问选项、关节逐组进度、试运行、发布摘要按你来定 / 助手可以修 / 要找管理员分栏、逐步打勾、接着做);问数据「做成应用」改走蓝图;问数据和画布的反问收尾;页面上直接改(选中、改字、隐藏、挪动、删除、加数据卡片、自动存草稿);文件控件;我的记录列表;个人应用的界面(我的应用、刷新与剩余次数、提交审核、审核待办卡);设置页的个人应用开关;四个新检查脚本并加进完整关口

This commit is contained in:
ThearchyHelios
2026-10-15 12:09:29 +08:00
parent 277982ead3
commit a702a5c14b
49 changed files with 6953 additions and 133 deletions
+40 -8
View File
@@ -7,12 +7,16 @@
*
* 应用编辑器的预览(FE-6)也用它:传按草稿解析出的视图模型、preview 为真——不发起运行、不提交表单,点数字照样能看出处。
* 一个组件画坏了只坏它自己(每个组件各包一层错误边界),不连累整页。
*
* 隐藏(normal-user-apps N6):作者隐藏的组件,发布版解析时服务端就跳过;按草稿解析时照样下发、带 hidden。这里只看这个
* 标记:应用页上直接改的编辑状态(editing)画成半透明、标「已隐藏」,别处(编辑器的预览)照使用者看到的样子不画。
* 编辑状态另给草稿里隐藏了的组件 id(editing.hidden):服务端没带标记的也认得出来。
*/
import { useCallback, useMemo, useState } from 'react'
import { createContext, useCallback, useContext, useMemo, useState } from 'react'
import type { ReactNode } from 'react'
import { AlertTriangle, PackageX } from 'lucide-react'
import { AlertTriangle, EyeOff, PackageX } from 'lucide-react'
import { ErrorBoundary } from '../components/ui'
import { APP_TEXT, VIEW_TEXT } from '../lib/termsApp'
import { APP_TEXT, PAGE_EDIT_TEXT, VIEW_TEXT } from '../lib/termsApp'
import type { ViewEvidence, ViewModel, ViewNode } from '../typesApp'
import { ViewCtx, type ViewCtxValue } from './context'
import { RENDERERS } from './components'
@@ -29,9 +33,22 @@ export interface ViewRendererProps {
onNavigate?: (pageId: string) => void
/** 视图刷新、实例发起之后要重新取视图模型 */
onReload?: () => void
/** 应用页上直接改的编辑状态:隐藏的组件画成半透明(不传时隐藏的组件不画) */
editing?: ViewEditMarks
}
export function ViewRenderer({ model, appId, runId, preview = false, onNavigate, onReload }: ViewRendererProps) {
/** 编辑状态的标记:草稿里隐藏了的组件 id */
export interface ViewEditMarks {
hidden: ReadonlySet<string>
}
const EditMarksCtx = createContext<ViewEditMarks | null>(null)
/** 服务端按草稿解析时给隐藏的组件带的标记(发布版里没有这样的组件) */
const isHidden = (node: ViewNode, marks: ViewEditMarks | null) =>
(node as ViewNode & { hidden?: boolean }).hidden === true || !!marks?.hidden.has(node.id)
export function ViewRenderer({ model, appId, runId, preview = false, onNavigate, onReload, editing }: ViewRendererProps) {
const [evidence, setEvidence] = useState<EvidenceTarget | null>(null)
const openEvidence = useCallback((ev: ViewEvidence, label: string, text?: string) => {
setEvidence({ evidence: ev, label, text })
@@ -46,7 +63,7 @@ export function ViewRenderer({ model, appId, runId, preview = false, onNavigate,
return (
<ViewCtx.Provider value={ctx}>
<div className="space-y-3" data-view-renderer={preview ? 'preview' : 'live'}>
<div className="space-y-3" data-view-renderer={preview ? 'preview' : 'live'} data-view-editing={editing ? '' : undefined}>
{problems.length > 0 && (
<div role="alert" className="rounded-lg border px-3 py-2 text-xs leading-relaxed" data-view-problems={problems.length}
style={{ borderColor: 'color-mix(in srgb, var(--warn) 40%, var(--border))', background: 'color-mix(in srgb, var(--warn) 7%, transparent)' }}>
@@ -63,7 +80,7 @@ export function ViewRenderer({ model, appId, runId, preview = false, onNavigate,
</ul>
</div>
)}
{render(model.tree)}
<EditMarksCtx.Provider value={editing ?? null}>{render(model.tree)}</EditMarksCtx.Provider>
</div>
<EvidenceDrawer target={evidence} onClose={() => setEvidence(null)} />
</ViewCtx.Provider>
@@ -73,15 +90,30 @@ export function ViewRenderer({ model, appId, runId, preview = false, onNavigate,
let generation = 0
function Node({ node, gen }: { node: ViewNode; gen: string }) {
const marks = useContext(EditMarksCtx)
const hidden = isHidden(node, marks)
// 隐藏的组件只在编辑状态下画(半透明);别处照使用者看到的样子跳过
if (hidden && !marks) return null
const Renderer = RENDERERS[node.type]
if (!Renderer) return <Unknown node={node} />
return (
const body = (
<ErrorBoundary scope="block" resetKey={gen}>
<div data-node={node.id} className="min-w-0">
{/* 编辑状态下组件可以聚焦:键盘也能选中(编辑层按回车选中) */}
<div data-node={node.id} data-node-hidden={hidden ? '' : undefined} tabIndex={marks ? 0 : undefined}
className={hidden ? 'min-w-0 opacity-45' : 'min-w-0'}>
<Renderer node={{ ...node, props: node.props ?? {} }} />
</div>
</ErrorBoundary>
)
if (!hidden) return body
return (
<div className="relative min-w-0" title={PAGE_EDIT_TEXT.hiddenHint}>
<span className="chip absolute right-1 top-1 z-[1] bg-panel text-2xs" data-hidden-tag="">
<EyeOff size={10} aria-hidden /> {PAGE_EDIT_TEXT.hiddenTag}
</span>
{body}
</div>
)
}
function Unknown({ node }: { node: ViewNode }) {
+4
View File
@@ -8,7 +8,9 @@ import { useEffect, useMemo, useState } from 'react'
import { ArrowDown, ArrowUp, RefreshCw, ShieldCheck } from 'lucide-react'
import clsx from 'clsx'
import { api } from '../../api/client'
import { FileLink } from '../../components/FileInput'
import { Notice, Spinner, StatusPill, useToast } from '../../components/ui'
import { isFileRef } from '../../lib/schemaForm'
import { Markdown } from '../../run/Markdown'
import { EvidenceDoc } from '../../run/EvidenceDoc'
import { useEvidence } from '../../store/evidence'
@@ -353,6 +355,8 @@ export function FieldBlock({ node }: NodeProps) {
<span className="text-faint">{label}</span>
{state ? <BlockState {...state} />
: data.state === 'masked' ? <span className="italic text-faint">{text || VIEW_TEXT.masked}</span>
// 绑定的输入是提交的文件(normal-user-apps N9):写成可下载的链接
: isFileRef(data.value) ? <FileLink file={data.value} />
: !text ? <span className="text-faint">—</span>
: evidence && evidence.kind !== 'report' ? <Num text={text} evidence={evidence} label={label} />
: evidence ? <ReportText text={text} evidence={evidence} label={label} />
+3
View File
@@ -12,6 +12,7 @@ import { FormBlock } from './input'
import {
ActionStatus, EntryButton, InstanceHeader, InstanceList, InstanceTimeline, SignoffsBlock, TaskForm, TaskList,
} from './process'
import { RecordsList } from './records'
export const RENDERERS: Record<string, ComponentType<NodeProps>> = {
// 布局
@@ -42,4 +43,6 @@ export const RENDERERS: Record<string, ComponentType<NodeProps>> = {
task_form: TaskForm,
signoffs: SignoffsBlock,
action_status: ActionStatus,
// 填报登记的逐行查看(normal-user-apps N8):按看的人实时取,使用者只看自己的
records_list: RecordsList,
}
+274
View File
@@ -0,0 +1,274 @@
/**
* 记录列表 records_list(docs/design/normal-user-apps.md N8、§3.7、§4.7):填报登记每次提交是记录表里的一行。
*
* 不走封存:每次打开按看的人实时取,行级可见在服务端做——使用(use)只看自己提交的,查看全部(observe)和管理(manage)
* 看到全部,这里只照服务端说的 mine_only 写标题和说明(「我的记录」「全部记录」),不在浏览器里按人过滤(P4)。第一页用
* 服务端解析页面时已经取好的(node.data,apps/resolve._records_list),不再取一遍;重新读取、下一页、更正历史才调
* GET /api/apps/{id}/records。没写 table 的取这个应用的第一张记录表(同服务端);who 照组件属性带上(只看自己的)。
* 别人提交的行里遮罩的列服务端已经写成「已遮罩」,照原样写。
*
* 列表、筛选(按内容或提交人)、按时间排序(序号就是提交的先后);每行可以展开看全部字段和附件。更正不改原行:更正是
* 一次新的提交,指向被更正的那一行(_supersedes),默认只列当前有效的行;更正过的行标「已更正」,展开能看更正历史
* (带 history 再取一次,顺着指向往前找)。值照服务端交来的原样写,这里不格式化数、不合计(叙述层无算术)。
*/
import { useCallback, useEffect, useMemo, useState } from 'react'
import { ChevronDown, ChevronRight, History, Paperclip, RotateCw, Search } from 'lucide-react'
import { api } from '../../api/client'
import { FileLink } from '../../components/FileInput'
import { ErrorState, Spinner } from '../../components/ui'
import { formatDateTime } from '../../lib/format'
import { isFileRef } from '../../lib/schemaForm'
import { RECORDS_TEXT as T } from '../../lib/termsApp'
import type { RecordRow, RecordsPage } from '../../typesBlueprint'
import { str, useView, type NodeProps } from '../context'
/** 服务端可能给的下一页游标、状态(typesBlueprint.RecordsPage 还没有这两项,契约待补):empty 是这个应用还没有记录表 */
type Page = RecordsPage & { next_cursor?: string | null; state?: string }
/** 服务端解析页面时给的第一页(node.data):形状对得上才用 */
function pageOf(data: unknown): Page | null {
return data && typeof data === 'object' && Array.isArray((data as Page).items) && Array.isArray((data as Page).columns)
? data as Page : null
}
/** 一格的值写给人看:文件是可下载的链接,数组用顿号连,布尔写是或否,其余原样 */
function Value({ v }: { v: unknown }) {
if (v == null || v === '') return <span className="text-faint">—</span>
if (isFileRef(v)) return <FileLink file={v} />
if (Array.isArray(v)) {
return v.some(isFileRef)
? <span className="flex flex-col gap-0.5">{v.map((x, i) => <Value key={i} v={x} />)}</span>
: <span>{v.map((x) => String(x)).join('、')}</span>
}
if (typeof v === 'boolean') return <span>{v ? T.yes : T.no}</span>
if (typeof v === 'object') return <span className="mono text-2xs">{JSON.stringify(v)}</span>
return <span className="whitespace-pre-wrap break-words">{String(v)}</span>
}
/** 筛选用的文字:各列的值和提交人(文件按文件名) */
function haystack(row: RecordRow): string {
const parts = Object.values(row.values ?? {}).map((v) => (isFileRef(v) ? v.name : Array.isArray(v) ? v.join(' ') : v == null ? '' : String(v)))
return [...parts, row._submitted_by ?? ''].join(' ').toLowerCase()
}
export function RecordsList({ node }: NodeProps) {
const { appId } = useView()
const table = str(node.props.table) || undefined
const who = node.props.who === 'mine' || node.props.who === 'all' ? node.props.who : undefined
const initial = pageOf(node.data)
const [page, setPage] = useState<Page | null>(initial)
const [error, setError] = useState<unknown>(null)
const [more, setMore] = useState(false)
const [query, setQuery] = useState('')
const [order, setOrder] = useState<'newest' | 'oldest'>('newest')
const [open, setOpen] = useState<Set<string>>(new Set())
// 更正历史:带 history 取一次(含已被更正的行),按 _id 找
const [history, setHistory] = useState<Map<string, RecordRow> | null>(null)
const [historyError, setHistoryError] = useState<unknown>(null)
const [historyFor, setHistoryFor] = useState<Set<string>>(new Set())
const load = useCallback(() => {
let alive = true
setError(null)
api.personal.records(appId, { table, who }).then((p) => { if (alive) setPage(p) }, (e) => { if (alive) setError(e) })
return () => { alive = false }
}, [appId, table, who])
// 页面重新解析过(node.data 换了)就用新的那一页;服务端没给(老服务端)才自己取
useEffect(() => {
if (initial) { setPage(initial); return }
return load()
}, [initial, load])
const loadMore = async () => {
if (!page?.next_cursor) return
setMore(true)
try {
const next: Page = await api.personal.records(appId, { table, who, cursor: page.next_cursor })
setPage({ ...next, items: [...page.items, ...next.items] })
} catch (e) {
setError(e)
} finally {
setMore(false)
}
}
const showHistory = (id: string) => {
setHistoryFor((s) => { const n = new Set(s); if (n.has(id)) n.delete(id); else n.add(id); return n })
if (history || historyError) return
api.personal.records(appId, { table, who, history: true }).then(
(p) => setHistory(new Map(p.items.map((r) => [r._id, r]))),
setHistoryError,
)
}
const rows = useMemo(() => {
const q = query.trim().toLowerCase()
const list = (page?.items ?? []).filter((r) => !q || haystack(r).includes(q))
return [...list].sort((a, b) => (order === 'newest' ? b._seq - a._seq : a._seq - b._seq))
}, [page, query, order])
const columns = page?.columns ?? []
const mine = !!page?.mine_only
const title = mine ? T.mine : str(node.props.title) || T.all
return (
<div className="rounded-lg border bg-panel" data-component="records_list" data-records-scope={page ? (mine ? 'mine' : 'all') : ''}>
<div className="flex flex-wrap items-center gap-2 border-b px-3 py-2">
<div className="min-w-0 flex-1">
<div className="text-xs font-medium" data-records-title="">{title}</div>
{page && (
<div className="text-2xs text-faint" data-records-hint="">
{mine ? T.mineHint : T.allHint}
{mine && str(node.props.title) ? ` · ${str(node.props.title)}` : ''}
{page.version > 1 ? ` · ${T.version(page.version)}` : ''}
</div>
)}
</div>
{page && page.items.length > 0 && (
<span className="tnum shrink-0 text-2xs text-faint" data-records-count="">{T.count(rows.length, page.items.length)}</span>
)}
<button type="button" className="btn btn-xs btn-ghost shrink-0" onClick={() => { setHistory(null); setHistoryError(null); load() }}
aria-label={T.reload} title={T.reload}>
<RotateCw size={11} aria-hidden />
</button>
</div>
{page?.state === 'empty' && !page.items.length ? <div className="px-3 py-3 text-2xs text-faint">{T.tableMissing}</div>
: error && !page ? <ErrorState compact error={error} onRetry={load} className="m-2" />
: !page ? <div className="flex items-center gap-2 px-3 py-3 text-2xs text-faint"><Spinner size={11} /></div>
: (
<>
{page.items.length > 0 && (
<div className="flex flex-wrap items-center gap-2 border-b px-3 py-1.5">
<label className="relative min-w-0 flex-1">
<span className="sr-only">{T.filter}</span>
<Search size={11} aria-hidden className="pointer-events-none absolute left-2 top-1/2 -translate-y-1/2 text-faint" />
<input className="field h-7 py-0 pl-6 text-xs" value={query} placeholder={T.filterPlaceholder}
onChange={(e) => setQuery(e.target.value)} data-records-filter="" />
</label>
<select className="field h-7 w-32 py-0 text-xs" value={order} aria-label={T.sort}
onChange={(e) => setOrder(e.target.value as 'newest' | 'oldest')} data-records-sort="">
<option value="newest">{T.newest}</option>
<option value="oldest">{T.oldest}</option>
</select>
</div>
)}
{!page.items.length ? <div className="px-3 py-3 text-2xs text-faint">{mine ? T.emptyMine : T.empty}</div>
: !rows.length ? <div className="px-3 py-3 text-2xs text-faint">{T.emptyFiltered}</div>
: (
<ul>
{rows.map((r) => (
<RecordItem key={r._id} row={r} columns={columns} mine={mine} open={open.has(r._id)}
onToggle={() => setOpen((s) => { const n = new Set(s); if (n.has(r._id)) n.delete(r._id); else n.add(r._id); return n })}
historyOpen={historyFor.has(r._id)} onHistory={() => showHistory(r._id)}
history={history} historyError={historyError} />
))}
</ul>
)}
{page.next_cursor && (
<div className="border-t px-3 py-2">
<button type="button" className="btn btn-xs" disabled={more} onClick={() => void loadMore()} data-records-more="">
{more && <Spinner size={10} />} {T.more}
</button>
</div>
)}
</>
)}
</div>
)
}
function RecordItem({ row, columns, mine, open, onToggle, historyOpen, onHistory, history, historyError }: {
row: RecordRow; columns: RecordsPage['columns']; mine: boolean; open: boolean; onToggle: () => void
historyOpen: boolean; onHistory: () => void; history: Map<string, RecordRow> | null; historyError: unknown
}) {
// 收起时写前两列,够认出是哪一条;全部字段展开看
const brief = columns.slice(0, 2)
const corrected = !!row._supersedes
const panelId = `record-${row._id}`
return (
<li className="border-b last:border-0" data-record={row._id} data-record-corrected={corrected ? '' : undefined}
data-record-superseded={row.superseded ? '' : undefined}>
<button type="button" className="flex w-full items-center gap-2 px-3 py-2 text-left text-xs hover:bg-hover"
aria-expanded={open} aria-controls={panelId} title={open ? T.collapse : T.expand} onClick={onToggle}>
{open ? <ChevronDown size={12} aria-hidden className="shrink-0 text-faint" /> : <ChevronRight size={12} aria-hidden className="shrink-0 text-faint" />}
<span className="min-w-0 flex-1 truncate">
{brief.length
? brief.map((c, i) => (
<span key={c.name}>{i > 0 && <span className="text-faint"> · </span>}<BriefValue v={row.values?.[c.name]} /></span>
))
: T.seq(row._seq)}
</span>
{corrected && <span className="chip shrink-0" style={{ color: 'var(--st-waiting)' }} title={T.correctedHint}>{T.corrected}</span>}
{row.superseded && <span className="chip shrink-0">{T.superseded}</span>}
{!mine && row._submitted_by && <span className="hidden shrink-0 text-2xs text-dim sm:inline">{T.by(row._submitted_by)}</span>}
<span className="shrink-0 text-2xs text-faint">{formatDateTime(row._submitted_at)}</span>
</button>
{open && (
<div id={panelId} className="space-y-2 px-3 pb-3 pl-8 text-xs" data-record-detail="">
<Fields row={row} columns={columns} />
<div className="flex flex-wrap items-center gap-x-2 text-2xs text-faint">
<span>{T.seq(row._seq)}</span>
{row._submitted_by && <span>{T.by(row._submitted_by)}</span>}
<span>{formatDateTime(row._submitted_at)}</span>
</div>
{corrected && (
<div>
<button type="button" className="btn btn-xs" aria-expanded={historyOpen} onClick={onHistory} data-record-history-toggle="">
<History size={10} aria-hidden /> {historyOpen ? T.hideHistory : T.history}
</button>
{historyOpen && <HistoryChain row={row} columns={columns} history={history} error={historyError} />}
</div>
)}
</div>
)}
</li>
)
}
/** 收起时的一格:文件只写文件名,长文字截断交给外层 */
function BriefValue({ v }: { v: unknown }) {
if (v == null || v === '') return <span className="text-faint">—</span>
if (isFileRef(v)) return <span><Paperclip size={10} aria-hidden className="mr-0.5 inline text-faint" />{v.name}</span>
if (Array.isArray(v)) return <span>{v.map((x) => (isFileRef(x) ? x.name : String(x))).join('、')}</span>
if (typeof v === 'boolean') return <span>{v ? T.yes : T.no}</span>
return <span>{typeof v === 'object' ? JSON.stringify(v) : String(v)}</span>
}
function Fields({ row, columns }: { row: RecordRow; columns: RecordsPage['columns'] }) {
return (
<dl className="grid grid-cols-[minmax(6rem,auto)_1fr] gap-x-3 gap-y-1">
{columns.map((c) => (
<div key={c.name} className="contents" data-record-field={c.name}>
<dt className="text-faint">{c.type === 'file' ? <><Paperclip size={10} aria-hidden className="mr-0.5 inline" />{c.label || c.name}</> : c.label || c.name}</dt>
<dd className="min-w-0"><Value v={row.values?.[c.name]} /></dd>
</div>
))}
</dl>
)
}
/** 更正历史:顺着 _supersedes 往前找,最近的一次更正前在最上面 */
function HistoryChain({ row, columns, history, error }: {
row: RecordRow; columns: RecordsPage['columns']; history: Map<string, RecordRow> | null; error: unknown
}) {
if (error) return <ErrorState compact error={error} className="mt-2" />
if (!history) return <div className="mt-2 flex items-center gap-2 text-2xs text-faint"><Spinner size={10} /> {T.historyLoading}</div>
const chain: RecordRow[] = []
const seen = new Set<string>([row._id])
for (let at = row._supersedes; at && !seen.has(at); at = history.get(at)?._supersedes ?? null) {
seen.add(at)
const prev = history.get(at)
if (!prev) break
chain.push(prev)
}
if (!chain.length) return <div className="mt-2 text-2xs text-faint">{T.historyEmpty}</div>
return (
<ol className="mt-2 space-y-2 border-l pl-3" data-record-history={chain.length}>
{chain.map((r) => (
<li key={r._id} className="opacity-80" data-record-history-item={r._id}>
<div className="mb-1 text-2xs text-faint">
{T.historyItem(r._seq, formatDateTime(r._submitted_at))}{r._submitted_by ? ` · ${T.by(r._submitted_by)}` : ''}
</div>
<Fields row={r} columns={columns} />
</li>
))}
</ol>
)
}
+2 -1
View File
@@ -15,7 +15,8 @@
* - table、chart:{state, columns, rows(二维数组,遮罩的格子服务端已换成「已遮罩」), masked, total_rows, truncated,
* evidence(kind 为 query,带查询快照的工件)}
* - report:{state, node, doc_artifact, evidence}
* - field(输入、成果、运行信息):{state, text, value?, evidence?};status:{state, value(运行状态), text}
* - field(输入、成果、运行信息):{state, text, value?, evidence?}(value 是提交的文件引用时画成下载链接);
* status:{state, value(运行状态), text}
* - form:{form}(表单名,表单在 ViewModel.forms 里)。提交即按这些值重新解析本页(按需视图的参数),见 input.tsx
* - entry_button:{entry, label, disabled, reason?}
* - instance_list:{who, entry, items: InstanceRow[]}