跳转到内容

管理后台

每个已发布的 Proyecta 应用都自带一个管理后台——一个需要登录才能访问的私密后台办公室,让你无需触碰代码即可管理内容和表单提交。

你的应用对外呈现的是独特的品牌形象,而在这之后,每个应用都需要同样平凡却不可或缺的后台:一个用来编辑内容、审查潜在客户、处理日常事务的地方。Proyecta 会从由 schema 驱动、模板内置的组件为你自动构建这一切,确保在每个应用中保持一致且正确——你也无需等待 AI 手动编写 CRUD 页面。

功能模块 说明 状态
内容 在各个集合中创建、编辑、发布和归档条目 已上线
表单提交 审查、标记已读以及归档来自你表单的提交记录 已上线
商店订单 审查并处理来自你商店的订单 已上线
成员 / 用户 管理已登录你应用的用户及其角色 已上线

你会看到哪些模块,取决于你的应用做什么——后台会读取应用的实时结构,只渲染适用的部分。没有商店的应用不会有订单模块。

管理后台受 RBAC 权限控制。访客必须以 admin 账号登录才能看到后台——每一项管理操作都在服务器端强制执行,而不仅仅是在 UI 层面隐藏。

管理员权限会授予你在创建应用时指定的那个邮箱,并与身份提供方已验证的地址进行比对。它不会授予第一个登录的人——在正常的应用中,包括第一位访客在内的其他所有人都以普通用户身份登录。登录方式和角色分配的详细说明请参阅 Users & Auth

管理后台由模板内置组件组合而成。你不需要编写这些组件——它们是每个应用的标配——但了解其中主要组件的作用会有所帮助:

组件 功能说明
CollectionManager 针对单个集合的完整管理页面:包含可搜索、可排序的列表,以及自动生成的创建/编辑表单。每个集合对应一个。
SubmissionsInbox 表单收件箱:包含新建 / 已读 / 已归档标签页、未读提示角标,以及每条提交的详情视图。
AdminShell 整个后台的外壳框架——包含可折叠的侧边栏和顶部导航栏,将各模块串联在一起。

CollectionManager:从 schema 自动生成 CRUD

Section titled “CollectionManager:从 schema 自动生成 CRUD”

CollectionManager 读取集合的 schema,仅需极少量手写代码即可构建完整的编辑体验:

  • 以表格形式列出条目,带有状态角标、搜索功能和 New 按钮。
  • 根据字段类型自动生成表单——文本字段变为输入框,长文本变为文本域,数字变为数字输入框,开关值变为切换开关,选项字段变为下拉菜单,日期变为日期选择器,关联字段变为关联集合的选择器,图片字段则带有上传按钮(含媒体库选择器和粘贴 URL 的备用方式)。
  • 先保存为草稿——发布是一个明确的独立操作,不会意外上线任何内容。你也可以取消发布归档条目(归档是软删除——条目会从应用和后台中消失,但不会被彻底删除)。
  • 同样支持单例内容:单例集合(例如你的企业信息)会直接渲染表单,不显示列表。

编辑真正做到无需代码:你(或任何你授权的管理员)在后台修改文字、价格、图片和营业时间,点击发布,线上应用即刻更新。

注意: 商品目录虽然属于内容,但商店商品通过 Commerce 工具管理,而非通过 CollectionManager。详见 Commerce

你不需要提出要求,AI 也不会手动编写它。这个后台就是一个自动配置的“统一管理后台”:一个固定的 /admin 内置于每个应用的模板中,读取你应用的实时内容 schema 和功能配置并自行渲染——无需任何 AI 接线。之后新增一个集合,它会自动出现,无需重新构建。

除了内容和表单提交之外,你的应用实际具备哪些能力,就会出现哪些模块——订单与退货、预约与排期、成员与角色、媒体库、邮件与推送。适用于你应用的模块你都会拥有,不适用的则不会出现。

因为它由模板内置,所以在每个应用中都保持一致且正确,即使 AI 编辑你的公开页面,它也不会走样或损坏。如果之后你想改动后台本身,尽管开口——那属于一次明确的修改,而不是首次构建自行发挥的结果。

你永远不需要要求管理后台本身——每个应用都自带,新集合也会自动出现在其中。真正值得让 AI 去做的是这些:

  • "给我的服务加一个'推荐'开关,让我可以选择首页展示哪些内容。" — 新字段会自动出现在管理后台。
  • "让我首页的标题和营业时间可以从管理后台编辑。" — 把硬编码的文案移入内容。
  • "帮我做一个后台页面,一眼就能看到本周的预约。" — 用同样的构建模块组合出的定制页面。
  • 内容管理 — 管理后台所编辑的集合与条目。
  • 表单 — 提交收件箱的数据来源。
  • Users & Auth — 登录方式以及管理员角色的授予方式。
  • Commerce — 管理你的商品目录和订单。