Skip to content

docs(core): 定义跨实现 Core 与 App 边界 - #51

Draft
xiaoland wants to merge 1 commit into
mainfrom
feat/core-app-separation
Draft

xiaoland wants to merge 1 commit into
mainfrom
feat/core-app-separation

Conversation

@xiaoland

@xiaoland xiaoland commented Nov 4, 2026 •

Copy link
Copy Markdown
Member

各实现此前将可复用领域能力与应用配置、启动和 UI 混在一起,外部程序难以独立消费。本 PR 确立跨语言 Core/App 合同:Core 是可独立消费的 SDK/lib,App 拥有运行环境、装配和交互,Extension 保留具体业务;不预设统一平台适配层或 DI 容器。

范围与下一步

新增 Core/App Product TDD,定义独立消费、依赖方向、显式实例与资源生命周期、兼容演进及可观察的验收条件;更新 topology、合同索引和导航。只含本任务的 4 个文件,不携带原 Hub 工作树其他任务的修改。发布项目:无软件包版本变化。

跨仓跟踪:https://github.com/InKCre/docs/issues/50。对应 Python、TypeScript、Swift 实现由跟踪项关联;未来 Rust/Kotlin 等按同一合同声明自己的能力范围。

下一响应方:维护者。请审阅独立库的责任边界、平台支持与兼容约束。保持 draft;实现的父 PR、共享引用、后续检查与发布次序见跟踪项。

验证

  • 4 份文档代码围栏、41 个本地链接及 git diff --check 通过。
  • 合同与三端实现结果已对照;实现证据由对应 PR 拥有。
  • 未执行端到端验收。合同中的真实数据库跨语言读写和完整应用旅程属于验收条件,不代表本轮已通过。

风险、回滚与交付

风险在于把责任图误读成统一目录/包结构,或把独立消费误读成所有语言能力、平台完全相同;文档明确两者均不要求。回滚可整体撤销本 PR 的 4 文件改动,并协调已采用此合同的消费者。

仅修改共享设计文档;没有数据库迁移、凭据、软件包发布或生产部署操作。既有文档 PR 工作流可自行验证/预览。源提交先推送,Python/TypeScript 再分别提交子模块引用;合并后仍须核对最终引用。

依赖

直接父 PR:无,基于当前 main。
同仓子 PR:无;跨仓消费者见跟踪项。

后续统一可观测性

直接子 PR:https://github.com/InKCre/docs/pull/53(draft,基于本 PR 的 Core/App 边界)。先合并本 PR,再将子 PR 重排到最新 main;跨仓交付由 #52 跟踪。

This branch was successfully deployed

1 active deployment
preview — b3334622 Deployed Nov 4, 2026 by github-actions[bot]
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