diff --git a/.codex-tasks/admin-inquiry-form-usability/PROGRESS.md b/.codex-tasks/admin-inquiry-form-usability/PROGRESS.md new file mode 100644 index 0000000..f75ec29 --- /dev/null +++ b/.codex-tasks/admin-inquiry-form-usability/PROGRESS.md @@ -0,0 +1,7 @@ +# 执行记录 + +- 任务:降低普通品牌管理员创建和编辑咨询表单的理解成本。 +- 形态:single-full +- 进度:3/3 +- 结果:新增表单提供可直接使用的默认字段,编辑器文案和空状态已业务化,保存与发布边界明确。 +- 验证:Admin production build、全量 typecheck、lint、format、`git diff --check` 通过。 diff --git a/.codex-tasks/admin-inquiry-form-usability/SPEC.md b/.codex-tasks/admin-inquiry-form-usability/SPEC.md new file mode 100644 index 0000000..0c0c525 --- /dev/null +++ b/.codex-tasks/admin-inquiry-form-usability/SPEC.md @@ -0,0 +1,12 @@ +# 咨询表单编辑体验 + +## 目标 + +让普通品牌管理员能够从可用默认项开始创建咨询表单,并理解表单用途、关联业务和客户填写项的含义。 + +## 范围 + +- 新建表单预填合作咨询名称、称呼、联系电话和需求说明。 +- 表单用途、关联业务、字段列表使用清楚的业务文案和辅助说明。 +- 空列表提示如何开始;编辑已有表单前清理旧表单状态。 +- 明确保存草稿后仍需在发布页发布才会对小程序生效。 diff --git a/.codex-tasks/admin-inquiry-form-usability/TODO.csv b/.codex-tasks/admin-inquiry-form-usability/TODO.csv new file mode 100644 index 0000000..1d5aa6c --- /dev/null +++ b/.codex-tasks/admin-inquiry-form-usability/TODO.csv @@ -0,0 +1,4 @@ +id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes +1,提供开箱可用的默认咨询表单,DONE,新建时预填称呼联系电话和需求说明字段,pnpm --filter @personal-brand/admin build,2026-09-27,0, +2,完善表单业务语义和状态提示,DONE,用途、业务关联、字段及草稿发布边界有清晰说明,pnpm --filter @personal-brand/admin build,2026-09-27,0, +3,完成质量门禁,DONE,Admin build、typecheck、lint、format 和 diff 检查通过,pnpm format:check,2026-09-27,0, diff --git a/apps/admin/src/features/workspace/WorkspacePage.tsx b/apps/admin/src/features/workspace/WorkspacePage.tsx index 219d7d5..48129b9 100644 --- a/apps/admin/src/features/workspace/WorkspacePage.tsx +++ b/apps/admin/src/features/workspace/WorkspacePage.tsx @@ -85,6 +85,19 @@ export function WorkspacePage() { const [previewVisual, setPreviewVisual] = useState("linjing-editorial"); const [form] = Form.useForm>(); const [inquiryForm] = Form.useForm>(); + const openNewInquiryForm = () => { + setEditingForm(null); + inquiryForm.setFieldsValue({ + name: "合作咨询", + purpose: "inquiry", + fieldsSnapshot: [ + { key: "name", label: "您的称呼", type: "text", required: true }, + { key: "phone", label: "联系电话", type: "phone", required: true }, + { key: "remark", label: "想咨询什么", type: "textarea", required: false }, + ], + }); + setFormOpen(true); + }; const query = useQuery({ queryKey: ["admin-workspace"], queryFn: () => client.getAdminWorkspace(), @@ -496,14 +509,7 @@ export function WorkspacePage() { { - setEditingForm(null); - inquiryForm.resetFields(); - setFormOpen(true); - }} - > + } @@ -512,6 +518,7 @@ export function WorkspacePage() { rowKey="id" loading={forms.isLoading} dataSource={forms.data ?? []} + locale={{ emptyText: "还没有咨询入口,点击右上角即可从默认表单开始。" }} columns={[ { title: "名称", dataIndex: "name" }, { title: "版本", dataIndex: "version", render: (value) => v{value} }, @@ -529,6 +536,7 @@ export function WorkspacePage() { size="small" onClick={() => { setEditingForm(item); + inquiryForm.resetFields(); inquiryForm.setFieldsValue({ name: item.name, purpose: item.purpose, @@ -684,7 +692,11 @@ export function WorkspacePage() { }} onOk={() => inquiryForm.submit()} confirmLoading={createForm.isPending || updateForm.isPending} + width={760} > + + 先确定客户要提交的事情,再设置你希望客户填写的问题。保存后还需要在“配置与发布”中检查并发布,才会在小程序生效。 +
- - + + - + {(fields, { add, remove }) => ( <> - +