Skip to content

ref(core): 统一应用与 Peer 角色命名 - #181

Draft
xiaoland wants to merge 3 commits into
feat/observability-unificationfrom
feat/app-peer-naming
Draft

xiaoland wants to merge 3 commits into
feat/observability-unificationfrom
feat/app-peer-naming

Conversation

@xiaoland

@xiaoland xiaoland commented Nov 4, 2026 •

Copy link
Copy Markdown
Member

将 Python 中代表 InKCre 应用与运行参与者的旧 Client 命名统一为 App / Peer,避免把 Web App 描述成固定的服务端从属角色。

改动与兼容

  • 开发种子的默认 Peer 展示名从 client-web-development 改为 web-development,生产 profile 的展示名从 client-web 改为 web;两处 UUID 保持不变。
  • 当前部署、安全、邮件和观测文档采用 App / Peer;Memos 的 Web 操作入口改为 Peers → Config。Memos、DAV、HTTP、OAuth、IMAP、数据库和第三方 SDK 的真实 client 术语保留。
  • 已发布 migration、完整性 baseline、历史 changelog / task 记录,以及部署脚本清除旧 CLIENT_* 变量的兼容逻辑保持原值,不改认证、协议字段或存量用户命名。
  • 同时修复从 Core/App 拆分继承的发布归属遗漏:inkcre_core/ 变更属于 Core 发布项目,SDK 单独变更也会触发既有 fragment 检查;没有放宽发布规则。

旧开发库可沿正常 db:init --profile development 收敛,或在开发 readiness 检查前执行 pdm run db:seed-dev 更新既有规范种子。无需重置数据库、迁移业务信息或替换 Peer 身份;生产展示名只更新已提交 profile,不自动重命名用户已保存的 Peer。

受影响发布项目为 inkcre-core,已有 Towncrier fragment。Memos 仅更新发布文档,不改 wheel 行为。

验证

  • 删除私有映射测试前的局部集合为 17 passed、1 skipped,未连接数据库或真实外部服务;删除后未重跑该集合,不将该计数归于当前测试树。
  • Pyrefly 0 diagnostics;改动源码的 Ruff lint / format、提交 hooks、git diff --check 通过。
  • 当前提交 4314c2f 对父提交 0867de6 的真实 check:releases 发布意图检查通过,作为 SDK 发布归属修复的证据;当前有效源码、配置和本地文档已扫描角色命名残留。
  • 共享引用通过 canonical pre-bump / pre-commit 检查;源码与共享引用分开提交。
  • 本地未执行数据库场景或端到端验收,未重复全套测试;云端结果以当前 head Checks 为准。

邻近 Kotlin 仓库只读检查的 35 处 client 命中均属于 OkHttp、OSS 等协议或第三方 SDK 语义,没有产品角色迁移需要,因此未改 Kotlin 或创建空 PR。

关联与回滚

直接父 PR:#178(feat/observability-unification);祖先 Core/App 拆分为 #175;已知同仓子 PR:无。

跨仓跟踪:InKCre/docs#55。Hub 命名合同已先推送 d7c4d0c998455d40c30deb25da5b5060eb85aba1,本 PR 用独立提交更新 docs/_shared 引用。

父 PR 合并后须按顺序重排到最新 main。可整体回退本 PR;没有迁移或数据删除。回退默认名后,开发种子也可通过正常 seed 操作收敛。

- Web 默认展示名使用 web,保留 Peer UUID 和历史兼容标识
- 当前部署与扩展文档使用 App 和 Peer 描述产品角色
- 补充独立 SDK 源码的 Core 发布归属及回归验证
- 保留真实 check:releases 作为 SDK 发布归属修复的验证依据

This branch was successfully deployed

1 active deployment
preview — 4314c2f6 Deployed Nov 4, 2026 by xiaoland via impl-py preview #553
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Review / acceptance

Development

Successfully merging this pull request may close these issues.

1 participant