用途:构建“打开一条记录”的完整页面,采用双栏布局。左栏为头部加可内联编辑的属性面板,始终可见;右栏为标签式工作区(关联记录、动态、评论、文件、任务)。不得把所有内容堆叠在单一滚动列中。\n\n主要能力:@docyrus/ui 提供可组合组件,包括 EditableRecordDetail、EditableRecordDetailField(内联属性编辑)、RecordActivityPanel、FileAttachmentPanel、CommentsPanel、AvatarThumbnail、EmailComposer、DataGrid/useDataGrid、RecordDeleteConfirmDialog、create-record-dialog。页面外壳需自行构建:双栏 RecordDetailLayout(可调整属性栏与溢出标签栏)、RecordKpiCard、RecordTabPlaceholder 及轻量关联记录表。组件通过 docyrus add <name> 安装到 @/components/docyrus/<name>,基础包路径为 @docyrus/ui/components/<name>。\n\n必要用法:提供可复制的起始外壳 assets/record-detail-layout.tsx,导出 RecordDetailLayout、RecordKpiCard、RecordTabPlaceholder 及类型,依赖 shadcn 原语、EditableRecordDetail、cn 和 lucide-react,已正确实现溢出标签测量、可调整分隔条和记录版本重挂载键,建议复用。数据层为主记录用一个 useQuery(collection.get(id, { columns })),每个关联列表/动态/文件/评论各用一个 useQuery,关联列表按反向引用关系字段过滤。属性字段由数据源字段元数据构建 RecordDetailField[]。标签由 useMemo 数据驱动并条件添加,空状态使用 RecordTabPlaceholder。\n\n限制:资料未提供收费、价格或平台信息。需自行确认 appSlug、dataSourceSlug、记录 id 及关联数据源与关系字段 slug;需自行实现页面外壳与轻量表格;每次 Docyrus 请求必须传 columns,并用 expand 展开引用列。需验证内联保存往返、标签计数、关联列表过滤、logo 上传持久化及邮件/通话动作触发。
docyrus-crm-like-detail-page-design
设计与创作
更新于 10-15 21:11