服务门户

服务门户为您提供了一个公开且带有品牌标识的受理界面，组织外部的人员——客户、承包商、公众——无需登录即可提交请求。每份提交的请求都会作为带有公开参考编号的可追踪记录进入您的工作流，提交者可通过链接随时查看进度并进行回复。

服务门户包含在所有 Aptli 套餐中——无需额外解锁。任何拥有服务门户管理权限的管理员均可创建门户，并立即开始收集提交请求。

用途

生命周期一览

        ADMIN SETUP                 PUBLIC SUBMISSION              TRIAGE & TRACK
   ┌────────────────────┐      ┌────────────────────────┐   ┌───────────────────────┐
   │ Build a portal      │      │ Visitor opens the link │   │ Operators are notified │
   │  • forms + fields   │      │ (or scans the QR code) │   │ New submission lands   │
   │  • map layers       │ ───► │ Picks a form            │──►│ in the Inbox           │
   │  • branding         │      │ Drops a point/line/area│   │  • set status          │
   │  • sharing (link,   │      │ Fills fields + photos  │   │  • add public/internal │
   │    QR, embed)       │      │ Submits → gets a       │   │    comments            │
   │ Publish             │      │ reference number       │   │  • link a work order,  │
   └────────────────────┘      └───────────┬────────────┘   │    report, or feature  │
                                            │                └───────────┬───────────┘
                                            ▼                            │
                                ┌────────────────────────┐              ▼
                                │ Submitter tracks status │   ┌───────────────────────┐
                                │ at /portal/<slug>/<ref> │◄──│ Status change emails   │
                                │  • sees progress        │   │ the submitter          │
                                │  • reads public replies │   │ (new → in review →     │
                                │  • can reply back       │   │  actioned → closed)    │
                                └────────────────────────┘   └───────────────────────┘

工作原理

1. 您构建一个门户 —— 既可以从零开始，也可以通过简短的设置向导，基于适用于您所在行业的常见请求类型的现成套件来创建。一个门户可托管一个或多个表单（例如 “报告隐患”、“申请定位”），每个表单都有独立的字段（姓名、文本、多行文本、数字、是/否、下拉选项、日期、日期与时间、电子邮件、URL、位置、地址、附件）、地图图钉颜色和图标。
2. 您可分享该门户 —— 每个门户的 “分享” 面板都会提供一个链接、一个可供查看、复制和打印的 二维码，以及一行 嵌入代码片段，用于将门户嵌入现有网站。 您还可以使用自己的域名来托管门户，而非默认地址（参见 分享门户）。
3. 提交者填写表单 —— 匿名提交，支持任何设备。位置信息可从设备自动获取，或直接在地图上以点、线或面的形式标注。公共地图上还会显示附近先前提交的标记形状，以便用户查看已报告的内容。
4. 生成记录 — 记录将与公共参考编号、提交者的语言、几何图形以及任何附件一同存储。如果提交者提供了电子邮件地址，将收到包含该参考编号的确认邮件。
5. 通知操作人员 —— 订阅了该门户的工作人员将收到一封汇总邮件和推送通知，其中包含指向新提交内容的深度链接。在短时间内收到的提交将批量合并为一条通知，而非每条提交单独发送一条通知。
6. 您在收件箱中进行分流处理 — 进行筛选（包括根据地图上的距离进行筛选），打开提交内容查看详细信息和几何数据，设置其状态，添加评论，并将其转换为工作单、报告或地图要素（见下文）。
7. 提交人将持续收到通知 —— 状态发生变化时，他们会收到一封引用其公开编号的更新邮件，并可返回跟踪页面阅读回复并进行回应。

提交：描述问题或选择表单

门户网站打开时会显示一个**“报告问题”编辑器：提交者只需描述问题** （通过输入或使用设备的语音输入功能）并附上照片，Aptli 会为其自动选择合适的表单——或者他们也可以直接从列表中选择一项服务。 当人工智能功能可用时，描述文本和照片会被路由到最匹配的表单，而**“自动填写”**选项会预先填入字段内容，供提交者核对和调整。 这比让公众自行查找正确表单的流程更顺畅；而简单的表单选择器始终作为备用方案存在。

提交内容的流向：将其转化为工作任务

分流不仅仅是状态变更——通过提交操作（分为创建和关联两类），提交内容可以转化为实际工作任务：

每个创建或关联的记录都会在提交中被追踪，并提供 查看 和 解除关联 功能。 当所有关联记录均达到终态时，该提交将变为准备关闭状态，若您已启用该功能，系统将自动关闭该提交。重新打开已关闭的提交需提供理由。

重复报告的去重处理

关于同一处坑洼的十个报修不应被拆分为十个独立工单。 有两种工具可处理此情况：

• 合并到… — 手动将一个提交归入另一个提交之下；被归入的提交会显示其父提交为 “归入”（且可以 取消归入）。
• 捆绑 — 系统会对当前提交的报告进行自动分组，并根据错误类型、 按距离（在您设定的半径范围内）、按提交者或按相似度进行分组。您审核建议的捆绑包，为每个分组选择一个主条目，然后应用——将大量重复报告转化为一个受追踪的项目，其余报告则归入其下。

提交状态流程

每项提交都会经历四个状态。提交者看到的是一个简单的进度条：

   NEW  ───►  IN REVIEW  ───►  ACTIONED  ───►  CLOSED
   just      an operator      turned into      resolved;
   arrived   is looking       real work        no further
                              (linked record)  action

• 状态变更会通知提交者（内部备注不会），且快速连续的变更会合并为一条消息。
• 达到配置的状态后，提交中绘制的几何图形可升级到真实地图图层上，因此经批准的报告将成为地图上的要素。

跟踪与双向回复

每个提交都有一个位于其参考链接（/portal/<slug>/<reference>）处的公开跟踪页面。提交者可以在该页面上：

• 通过进度条查看当前状态。
• 阅读您团队的公开评论——工作人员姓名绝不会被公开；回复显示为来自门户。
• 发布回复，该回复将显示在您的分流讨论线程中。

内部评论仅限工作人员查看，绝不会显示在跟踪页面上。

提交者还可以通过跟踪页面（“添加到提交”）向现有提交添加照片或文件——当事后有更多证据时，此功能非常有用。一旦提交被关闭，回复框将被一条说明替换，表明该提交已解决且不再接受回复。

我的提交

由于没有公开账户，门户系统会将用户的提交记录保存在其设备上。**“我的提交”**列表会重新检索用户通过该浏览器提交的所有参考编号，按时间倒序排列并显示当前状态——因此居民无需登录或手动记录参考编号，即可查看自己报告过的所有事项。（清除浏览器数据会清空该列表； 参考编号始终是追溯单次提交的可靠途径。）

转发至外部系统

“转发以供跟进” 将提交内容移交给外部自动化系统——合作伙伴的工单系统、传统工作管理工具——作为真正、可靠、单向的交接。 这不会推进提交的状态；该提交仍保留在您的分流系统中。一个仅限使用一次且会过期的回调链接随转发的数据包一同传输，以便外部系统能够将结果通过 POST 方法回传一次且仅一次。

该提交将显示移交的状态：已转发 → 等待响应 → 已响应（或 已过期 / 已撤销）。您可以随时撤销回调，如果外部系统返回了链接，则可在该系统中打开该项。

在地图上发布动态内容

门户还可以向访客展示除表单以外的内容——即在公共地图上以图钉和形状形式呈现的已发布项目实时动态，每个项目都附有“阅读更多”的链接。将外部动态源（例如新闻或公告动态源）连接到门户的 内容 选项卡，新项目将作为“待放置”条目被追踪：

• 如果项目已包含位置信息，则会自动放置。
• 如果未包含位置信息，您的团队可通过“内容”选项卡将其放置在地图上，或向知晓其所属位置的人员发送一个 无需登录的放置链接——对方也不需要拥有账户。
• 一旦放置，该条目即会在门户的公共地图上显示，并附带可分享的链接及其专属二维码。您可以随时将该条目标记为已完成，将其从地图上移除。

这是与提交接收功能相独立的可选功能——一个门户可以只使用其中一种，也可以同时使用两种。

分享门户

每个门户都有一个统一的入口来管理公众如何访问它——即其**“分享”**面板，可通过门户卡片或菜单打开：

• 公开链接——直接复制。
• 二维码 — 查看、复制或打印。二维码页面还会以可直接打印的网格形式显示每个门户的二维码，并支持按已发布/草稿状态进行筛选。
• 嵌入代码片段 —— 仅需一行代码即可将门户作为嵌入式框架添加到现有网站中，并附有针对常见网站构建工具的简短操作指南。
• 自定义域名（白标） —— 默认情况下，门户位于 aptli.io 地址下； “共享”面板允许您改用自有域名托管门户——例如 report.yourcity.gov 而非默认地址——从而打造完全符合品牌形象的受理界面。您只需将 CNAME 指向 Aptli（如果是无子域名的根域名/顶层域名，则将 A 记录 指向我们的 IP 地址）， Aptli 会验证 DNS 并自动签发证书，随后门户网站便会在您的主机上响应请求。
• 公共地址覆盖 —— 如果您的网站位于门户网站前方且路径不同，您可以告知 Aptli 用户实际看到的地址，这样链接、二维码和通知才能始终指向真实的位置。

“门户”页面

“门户”页面是您管理所有运行中门户的入口：每个门户对应一张卡片，显示其公共地址、是否通过默认地址或您自己的域名提供服务，以及一目了然的统计数据——本周的新提交量、 包含多少表单、支持多少种语言，以及是否有待发布的源内容时的警告提示。虚线框的“新建门户”卡片将启动设置向导，该向导为常见请求类型提供现成的入门包，并在门户构建完成后将您引导至“分享”页面。 每张卡片菜单涵盖日常操作：设置域名、分享、查看历史记录、打印二维码、发布或取消发布，以及删除。

收件箱

收件箱是团队日常处理提交请求的地方：带有实时计数（新提交、待审核、已处理、已关闭）的状态栏图标、可搜索和筛选的案例列表（按门户、状态、位置等分类），以及用于批量处理多个提交请求的操作功能。 打开一个提交项将展开为完整的案例视图——一侧显示对话和公开回复，另一侧则有一个侧边栏，包含状态控制、关闭并通知、提交人详细信息以及所有关联记录（工作单、报告、地图要素、转发的工单）。 每位用户均可设置自己的通知偏好，选择希望接收哪些门户和事件的通知。

查看门户配置历史记录

对门户自身设置（包括表单、品牌标识、共享设置以及编辑器中的任何内容）的每次更改都会保存在历史记录中，您可以按门户逐个查看，从而了解谁在何时进行了哪些更改，且该记录与门户收集的提交内容相互独立。

实用功能

• 每个门户支持多个表单 —— 将相关提交类型归类到一个统一品牌门户下，每个表单均可拥有独立的字段和地图样式。
• 照片辅助填写 （可选） — 启用后，上传的照片可预填表单字段以加快提交速度。除非您手动开启，否则该功能默认处于关闭状态。
• 品牌标识与翻译 — 公开表单将显示您的徽标和配色方案，并可按提交人的语言进行展示。
• 地图背景与图例 — 显示选定的图层（可选过滤），以便提交者根据现实世界中的地物提交请求。

关键概念

• 公开参考编号 — 每份提交都会获得一个简短且可分享的编号。该编号不包含任何内部标识符，公开使用安全无虞；提交者可通过此编号进行后续跟进。
• 语言识别 — 系统会记录提交者的语言，以便确认信息和后续通知均以该语言发送。
• 速率限制 — 公共端点设有速率限制以防止滥用；垃圾信息绝不会进入您的工作流。
• 附件 — 文件将被存储并与提交关联，在被接受前会进行大小和类型校验。

配置

服务门户设置位于门户编辑器中，仅对拥有 服务门户 管理权限的用户可见。编辑器分为以下选项卡：

• 基本设置 — 门户名称、发布状态和品牌设置（徽标、颜色、页面标题）。
• 表单 — 创建和编辑受理表单，设置必填字段，选择提交后的操作以及已批准提交将转入的层级，并发布/取消发布每个表单。
• 地图数据 — 选择公众可见的地图图层（可选配图层级过滤器和标签），并限定公众表单的功能和显示范围。
• 工程项目 — 仅在相关情况下显示，适用于展示附近正在进行的工程项目的门户。
• 内容 — 关联数据源并管理上述已发布的地图内容。
• 语言 — 提供门户网站支持的每种语言的文本内容。

共享和自定义域名的设置位于 共享 面板中，而非编辑器标签页中 — 请参阅 共享门户网站。

限制与安全措施

• 从公众端来看，提交内容为 仅追加 模式——提交者可以添加附件和回复，但无法编辑原始字段或删除记录。
• 速率限制和必填字段验证在服务器端运行，因此精心构造的请求无法绕过这些机制。
• 每次分流操作、关联/解除关联、状态变更和重新开启都会记录在提交条目的历史标签页中，从而保持清晰的审计轨迹。