《互联网产品的客户端架构·端形态与体验基础》4.3 用测试固化分层
把视图不能直接访问数据层、领域不能反向依赖视图、模块之间不能有循环依赖写成可执行架构规则,给出 TypeScript 检查器、带原因的例外机制与失败样例报告,并用本机 Node 26 真实测试输出证明三条规则都能拦住真实违规,最后说明如何接进本地检查与 CI 门禁。
tag
把视图不能直接访问数据层、领域不能反向依赖视图、模块之间不能有循环依赖写成可执行架构规则,给出 TypeScript 检查器、带原因的例外机制与失败样例报告,并用本机 Node 26 真实测试输出证明三条规则都能拦住真实违规,最后说明如何接进本地检查与 CI 门禁。
从模块图出发把依赖方向写成可判定规则:依赖只能指向内层,反向边必须在构建前失败。给出 TypeScript 实现的模块图模型、反向依赖检查、Tarjan 强连通分量循环检测与依赖优先构建排序,并用本机 Node 26 真实测试输出现场验证,最后讨论包边界、公开入口与类型依赖的落地方式。
第三方支付渠道有自己的状态码、签名与回调重试。本篇在 arch-lab 写一个可运行的防腐层:外部 DTO 到领域事件的翻译、失败码映射、未知状态兜底、回调验签与重放保护,并用表驱动测试覆盖成功、拒付、未知状态、签名错误与重复回调,最后讨论引入 ACL 的代价与不值得引入的判据。
把回声客户端的发现、会话、下单三个页面拆成视图、状态、领域、数据访问四层,逐条说明每层负责什么、明确不负责什么,用一段可运行的分层判定与调用审计代码暴露视图直连数据层、领域反向依赖视图、状态绕过领域三类越层,并给出本机 Node 26 真实测试输出与评审问题清单。
首屏快、功能全、包体小为什么无法同时满足,如何把三者的取舍写成可复核的权重与排序函数,并复盘一次「回声」客户端的真实取舍记录,说明排序结果与评审判断的边界;所有案例数值均标注为假设值,附完整可运行 TypeScript 实现与真实测试输出。
端口与适配器最容易退化成目录表演。本篇在 arch-lab 定义 OrderRepository、InventoryPort、PaymentPort 三个端口,给出内存适配器与可注入延迟/错误的故障适配器,用同一套契约测试验证 ErrNotFound、ErrConflict、ErrUnavailable 语义一致,并用 go list -deps 断言领域包的传递依赖不出现 adapters。
把首包、路由包、图片、字体与运行内存拆成可执行的预算条目,说明预算如何从目标设备与网络反推、如何在 CI 中以非零状态卡住,并给出不依赖文件系统的 TypeScript 体积与内存预算检查器、注入时钟的采样器、真实测试输出与一次预算失守的复盘。
《TypeScript高级编程》全 34 节,写给库作者、框架作者与工具链开发者。从结构化类型与兼容性判定讲起,依次深入类型级编程、类型性能治理、装饰器与元编程、编译器 API 与自定义 transformer、语言服务与编辑器插件、声明文件与双包发布、V8 运行时与性能剖析、模块解析深水区,最后讨论类型安全的运行时边界与生态演进。每节都是可直接阅读的独立文章,本页给出全书分章目录。
《TypeScript编程实战》全 55 节,是一本 TypeScript 工程落地手册:从工程脚手架、严格模式分层与代码门禁讲起,依次覆盖错误处理与日志、测试体系、Node.js 服务端、数据访问层、缓存、消息队列与实时通信,再转入 React / Vue / Next.js 前端类型实践、构建产物治理,最后落在 API 契约、可观测性、安全加固与部署发布上。本页给出全书分章目录。
《TypeScript编程入门》全 61 节,是一套面向零基础的 TypeScript 完整教材:从语言诞生史与设计目标讲起,依次覆盖开发环境与工具链、基本类型系统、函数与泛型、接口与类、联合类型与类型收窄、高级类型与工具类型、模块与声明文件、运行时验证、错误处理与异步、测试与构建配置,最后用一个全栈项目与迁移方案串联全部知识点。本页给出全书分章目录。
从「回声」客户端的采样问题出发,拆解 FP、FCP、LCP、INP、TBT 五个指标各自回答什么、何时采样,用最近秩分位与 p75/p95 双线预算替代平均值判定,并给出可运行的 TypeScript 分位计算器、注入时钟的采样器与真实测试输出。
模块化单体的关键不是目录分层,而是把边界写成可校验的数据:模块清单、公开包、私有包、数据所有权与依赖方向。本篇给出 arch-lab 的模块描述符与 Go 校验器,检查依赖成环、私有包越界与 internal 包无主,并预演库存模块独立部署时需要移动的包、改动的接口与数据库切分步骤。
围绕 arch-lab 订单系统回答聚合该多大:给出 Order、InventoryReservation、Payment 的边界清单,解释库存为何不能塞进订单聚合,拆解总额、状态迁移、重复支付三条不变式,并用 internal/order 聚合、假端口补偿测试与真实 go test -race 输出验证跨聚合一致性的失败路径。
记录一次五小时订单域事件风暴工作坊:五类角色、时间盒、11 条命令、13 个事件、9 条策略与 6 个热点,明确哪些进 ADR、哪些留到卷二;随后把产出编码成 internal/eventstorm 包,用校验器检查命令归属、事件生产者、策略引用与孤立事件,并附真实 go test 输出。
以 arch-lab 订单系统为样本,按变化频率、业务差异化与团队归属划出核心域、支撑域和通用域,给出七条限界上下文的职责、数据、上下游、集成模式与包边界对照表,并把映射表编码成可校验的 internal/contextmap 包,用表驱动测试守住唯一 owner、无环依赖和共享内核引用。
把团队规模、发布节奏、离线要求、性能敏感度与平台覆盖转成硬门槛加加权评分,用 TypeScript 选型函数输出排序、淘汰原因与决策记录,并以「回声」的默认事实演示 Web 胜出、桌面备选的完整推演,说明评分结果何时可信、何时必须重跑,以及组合策略的边界。
《Cocos 游戏开发高级编程》全 34 篇,把 Cocos 引擎本身当研究对象:从引擎分层、启动流程与 cc.d.ts 版图起步,经渲染管线、材质与 Effect 体系、合批机制、Effect 语法与后处理、2D 光照与渲染纹理,到物理与动画子系统内部、内存模型与 GC、纹理与显存预算、性能剖析闭环、原生 JSB 与多线程、引擎源码编译与模块裁剪、升级策略、ECS 与模块化架构,最后收在四引擎横向对照与选型方法。本页给出全书分章目录。
把同构与多端复用拆成领域模型、数据层、视图、导航、生命周期、输入与存储七层,用可运行的 TypeScript 分类器判定复用、适配与分叉,给出分叉率阈值与退出条件,并复盘一次强行统一导航的失败,说明复用为什么是一项需要成本口径与退出机制的经济决策。
以一次明确标注为演练的 arch-lab 卷一评审为线索,记录订单、库存、支付、SRE、安全五类角色的议程、五个决策点的反对意见与结论;给出覆盖一致性、可用性、安全、演进、运维的九条风险台账,并用 Go 工具校验必填字段、等级矩阵、负责人与关闭条件,附真实命令输出。
把 Web、原生、小程序与桌面四种端形态拆成八项可判定能力,用一份 TypeScript 能力矩阵与测试固定「稳定支持、有条件支持、不支持」的边界,再复盘一次把小程序当成全平台方案的误判,说明能力矩阵为什么必须先于框架选型,避免团队用渠道优势掩盖能力缺口。