Skip to content

guides/integrations.mdx 把 10 类连接器列为「Built-in」、guides/index.mdx 仍把邮件页描述为 Gmail/Outlook 双向同步——仓库里没有任何连接器元数据 #756

Description

@yinlianghui

发现于 #738 / PR #755(改 guides/email-and-calendar.mdx 时核对连接器断言),这两页不在该 PR 的文件面内,单独记录。

实测

src/ 里没有任何连接器元数据。grep -rni "gmail|outlook|connector" src/ objectstack.config.ts 的全部命中是:

  • src/objects/lead.hook.ts:138 线索评分里的免费邮箱域名正则;
  • src/data/catalog.seed.ts:101 / src/data/sales.seed.ts 里名为 "Integration Connector Pack" 的商品种子;
  • src/flows/contact-welcome.flow.ts:16 / opportunity-approval.flow.ts:15 的注释(前者恰恰说明「发欢迎邮件需要一个邮件连接器 action,而我们没有」)。

平台侧同样没有:@objectstack/plugin-email@17.0.0-rc.2 自述为 "transport-pluggable outbound delivery with sys_email persistence",sys_email.status 只有 queued | sent | failed,未配置 provider 时回落到 LogTransport(日志里明写 "mail will NOT be sent")。没有入站邮件、没有 OAuth 授权面、没有日历同步、没有追踪像素。

两处仍在承诺

1)content/docs/guides/integrations.mdx:11-23(zh-Hans / zh-Hant 同)——「Built-in connectors」表列出 10 行:Slack、Microsoft Teams、DocuSign、Stripe、Twilio Voice、Aircall / RingCentral / Five9、Intercom / Zendesk Chat、Gmail / Outlook、Snowflake / BigQuery / Redshift、Zapier / Make / n8n,每行还给了一个 Setup → Integrations → X 的菜单路径。这些菜单路径在应用里都不存在(src/apps/ 与 src/pages/ 下没有对应导航)。后面「What each connector does」各小节同理(DocuSign 的 Send for Signature、Stripe 同步、来电屏幕弹窗、聊天转工单等)。

2)content/docs/guides/index.mdx:14(zh-Hans / zh-Hant 同)——邮件页的一句话描述仍是「Connect Gmail / Outlook, two-way sync, email tracking」。PR #755 已把该页正文改成「不含 Gmail/Outlook 连接器,相关段落标注 (not shipped yet)」,索引行会与目标页正文直接矛盾,建议随手一并改掉。

建议

参照 PR #755 采用的既有姿势(guides/mobile.mdx:10 的 roadmap callout、whats-new.mdx 的 "Wow #3 — Honest about what's in the box"):要么给整页/整表加未落地标注并链到 roadmap,要么直接删表。哪种取决于维护者想让 integrations 页承担什么角色——它目前整页都是未落地能力,不像邮件页那样有一半真实内容,所以这是一个页面定位问题,不只是措辞问题。三语同改。

注:content/docs 里散文断言与落地行为不符这一类,目前仍无门禁覆盖(test/docs-object-coverage.test.ts 只保证每个 crm_* 对象有一页文档)。#749 提过给内部链接锚点做检查,散文断言这一层还没有对应方案。

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

bugSomething isn't workingdocumentationImprovements or additions to documentationpm:dispatchedDispatched to a dev agent by /pm-dispatchpriority:p2Medium: important, M3

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions