【免费下载链接】TechSpar一个持续进化的面试训练系统。在线体验地址https://techspar.cn项目地址https://gitcode.com/gh_mirrors/te/TechSpar点击查看免费下载TechSpar 是一个持续进化的技术面试训练系统把专项训练、简历面试、JD 备面、实时 Copilot 与录音复盘串成闭环在线体验地址。功能越多代码边界越容易失控今天业务模块偷偷 import 了一个数据库包明天前端就撞上后端悄悄改掉的响应字段。TechSpar 的答案是两道自动化防线——架构边界检查与响应契约测试用可执行的方式把架构约定钉死。问题背景多模块面试系统最容易坏在哪里TechSpar 采用模块化单体 六边形架构apps/apiHono/Bun与桌面端是宿主层packages/core是纯 TypeScript 业务层packages/contracts是前后端共享的协议层SQLite、文件、LLM、ASR 都是可替换的出站适配器。这套分层的完整设计见 docs/typescript-backend-architecture.md。纸面上的分层人人都画难点在于长期守住。依赖只能向内、core 不许碰 Hono/Bun/供应商 SDK、模块之间不能互读对方的表——如果没有机器守卫这些规则只会在第三次临时借一下 import后失效。边界检查一个 20 行脚本守住依赖方向第一道防线是 scripts/check-boundaries.ts。它做一件朴素的事遍历核心包源码用正则扫描违禁 import扫描范围packages/core/src与packages/contracts/src的全部.ts文件违禁模式从techspar/db、techspar/platform、techspar/providers、hono、hono/*、bun:、electron导入或使用Bun.运行时 API一旦发现违规文件打印全部路径并以非零码退出——直接卡住 CI。核心就一行声明示意forbidden from |hono...|bun:|electron) | \bBun\.通过bun run check:boundaries运行脚本定义见 package.json 的scripts字段。这道检查的价值不在拦住了多少次而在于把架构文档变成了可执行断言新人不需要先读 200 行架构说明再动手改错地方时测试会先替他读到规则。配合同一份文档第 12 节自动守卫清单类型检查、repository 契约测试、schema 基线对照等边界约束全部落在 CI 上而不是落在 code review 的记忆力上。契约测试让每个 HTTP 响应都有户口第二道防线解决另一个经典问题后端改了返回字段前端在用户那里才发现。TechSpar 在 tests-ts/contracts/ 下建立了一套完整的契约测试体系思路可以概括为三件事。1. 响应清单接口行为先登记再测试tests-ts/contracts/response-inventory.ts 维护了一张响应户口表每个 HTTP 操作登记路由文件、状态码、Content-Type、传输类型json / binary / sse / websocket、fixture 文件名、是否动态结构、响应 schema 名称。全库 71 个操作全部在册。关键设计是openapi-parity.test.ts见 tests-ts/contracts/openapi-parity.test.ts会把运行时生成的 OpenAPI 与清单逐一比对——新增了一个接口却没登记进清单测试直接失败。接口数量从此无法悄悄膨胀。2. Fixture 基线旧 FastAPI 的每个响应都可回放TechSpar 后端从 Python/FastAPI 迁移到 TypeScript/Hono最大的风险是迁移即破坏兼容。项目的做法是把旧服务的全部 71 个方法路径固化为基线fastapi-openapi.json契约测试逐项断言旧版每个操作在新应用中仍存在且security、requestBody.required、422校验响应语义一致响应体用tests-ts/contracts/fixtures/responses/下的真实形状 JSON 做基线回放测试通过真实的 Honoapp.request()发起 HTTP 请求验证——不是单测内部函数而是打真实边界测试基建见 tests-ts/contracts/test-app.ts其中未显式注入的依赖一律调用即抛错防止测试误触真实适配器。3. 事件契约SSE / WebSocket 帧也要过 schema流式响应更难守因为格式对了一半就能跑。第三阶段为 Copilot WebSocket 的 13 种事件、面试聊天 SSE、索引重建 SSE 分别建立了 Zod 事件联合见 packages/contracts/src/copilot-events.ts 与 docs/response-contracts-phase-three.md每种事件的必填字段被逐一删除验证——缺任何已知字段都必须解析失败未知type没有兜底分支非法值一律拒绝发送前校验在传输层执行服务层吐出的非法帧在离开边界前被拦截成标准错误帧隐私内容不会泄漏到线上测试用例见 tests-ts/contracts/phase-three-sse.test.ts。分阶段推进契约落地不是一次大爆炸这套契约体系分四个阶段渐进落地每阶段范围明确、独立可验证文档全部留档阶段覆盖内容文档一捕获现状响应清单 基线 fixtureresponse-inventory.ts二21 个核心 JSON 接口命名 DTO 运行时校验docs/response-contracts-phase-two.md三Copilot WS / SSE 事件契约docs/response-contracts-phase-three.md四LLM 结构化输出入口校验评分越界、引用缺失等直接拒绝落库docs/response-contracts-phase-four.md值得注意的取舍兼容优先于洁癖。旧字段、历史扩展字段、稀疏评分都按显式兼容规则保留严格校验只作用于新生成的数据。这让 71 个存量接口在迁移中零破坏。一条命令的质量闸门所有防线最终汇入 package.json 中的一条命令bun run checkBun/Node 双重类型检查 → 架构边界检查 → 全部后端/前端测试 → 前端 lint → API/Web/Electron/sidecar 构建一条命令跑完整个质量闸门bun run test:contracts单独回归契约层OpenAPI 一致性、HTTP 边界、SSE/WS 事件。最终验证记录见 docs/response-contracts-phase-four.md429 个后端/跨模块测试、190 个契约测试全部通过OpenAPI 与前端生成类型差异为零。新手可以直接抄走的 5 条清单把架构规则写成扫描脚本一段违禁 import 正则 CI 退出码比 10 页文档更管用参考 scripts/check-boundaries.ts。给接口建户口每个操作登记状态码、Content-Type、fixture新增接口必须先登记。用旧版 OpenAPI 做基线迁移重构时逐操作断言 security、必填 body 与错误语义不变。打真实边界而不是内部函数HTTP 契约测试走app.request()流式响应逐帧解析验证。校验分层传输层守 HTTP/SSE 形状业务入口守 LLM 输出语义错误数据在落库前就死掉。边界检查管住代码长什么样契约测试管住系统说什么话。两者合起来就是 TechSpar 在持续加功能的同时还能让前端放心消费每个接口的底气——而这一切都由一条bun run check在每个提交时自动执行。赞分享【免费下载链接】TechSpar一个持续进化的面试训练系统。在线体验地址https://techspar.cn项目地址https://gitcode.com/gh_mirrors/te/TechSpar点击查看免费下载相关推荐IronClaw 架构契约测试套件ironclaw_architecture_tests完全指南用机械测试守住 Reborn 依赖边界IronClaw 架构契约测试套件ironclaw_architecture_tests完全指南用机械测试守住 Reborn 依赖边界 IronClaw人工智能AI 应用交互助手AI AgentIceCubesApp持续测试架构自动化检查保障代码质量IceCubesApp持续测试架构自动化检查保障代码质量 还在为SwiftUI项目的手动测试烦恼吗IceCubesApp作为一款优秀的Mastodon客户端移动开发社交vLLM-Omni 测试质量评估实战如何审查 PR 测试是否真正保护行为契约vLLM Omni 测试质量评估实战如何审查 PR 测试是否真正保护行为契约 测试质量评估是 vLLM Omni PR 审查链路中一道关键的证据关卡当测人工智能大模型模型推理服务多模态语音音频媒体生成本地部署创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
【免费下载链接】TechSpar一个持续进化的面试训练系统。在线体验地址https://techspar.cn项目地址https://gitcode.com/gh_mirrors/te/TechSpar点击查看免费下载TechSpar 是一个持续进化的技术面试训练系统把专项训练、简历面试、JD 备面、实时 Copilot 与录音复盘串成闭环在线体验地址。功能越多代码边界越容易失控今天业务模块偷偷 import 了一个数据库包明天前端就撞上后端悄悄改掉的响应字段。TechSpar 的答案是两道自动化防线——架构边界检查与响应契约测试用可执行的方式把架构约定钉死。问题背景多模块面试系统最容易坏在哪里TechSpar 采用模块化单体 六边形架构apps/apiHono/Bun与桌面端是宿主层packages/core是纯 TypeScript 业务层packages/contracts是前后端共享的协议层SQLite、文件、LLM、ASR 都是可替换的出站适配器。这套分层的完整设计见 docs/typescript-backend-architecture.md。纸面上的分层人人都画难点在于长期守住。依赖只能向内、core 不许碰 Hono/Bun/供应商 SDK、模块之间不能互读对方的表——如果没有机器守卫这些规则只会在第三次临时借一下 import后失效。边界检查一个 20 行脚本守住依赖方向第一道防线是 scripts/check-boundaries.ts。它做一件朴素的事遍历核心包源码用正则扫描违禁 import扫描范围packages/core/src与packages/contracts/src的全部.ts文件违禁模式从techspar/db、techspar/platform、techspar/providers、hono、hono/*、bun:、electron导入或使用Bun.运行时 API一旦发现违规文件打印全部路径并以非零码退出——直接卡住 CI。核心就一行声明示意forbidden from |hono...|bun:|electron) | \bBun\.通过bun run check:boundaries运行脚本定义见 package.json 的scripts字段。这道检查的价值不在拦住了多少次而在于把架构文档变成了可执行断言新人不需要先读 200 行架构说明再动手改错地方时测试会先替他读到规则。配合同一份文档第 12 节自动守卫清单类型检查、repository 契约测试、schema 基线对照等边界约束全部落在 CI 上而不是落在 code review 的记忆力上。契约测试让每个 HTTP 响应都有户口第二道防线解决另一个经典问题后端改了返回字段前端在用户那里才发现。TechSpar 在 tests-ts/contracts/ 下建立了一套完整的契约测试体系思路可以概括为三件事。1. 响应清单接口行为先登记再测试tests-ts/contracts/response-inventory.ts 维护了一张响应户口表每个 HTTP 操作登记路由文件、状态码、Content-Type、传输类型json / binary / sse / websocket、fixture 文件名、是否动态结构、响应 schema 名称。全库 71 个操作全部在册。关键设计是openapi-parity.test.ts见 tests-ts/contracts/openapi-parity.test.ts会把运行时生成的 OpenAPI 与清单逐一比对——新增了一个接口却没登记进清单测试直接失败。接口数量从此无法悄悄膨胀。2. Fixture 基线旧 FastAPI 的每个响应都可回放TechSpar 后端从 Python/FastAPI 迁移到 TypeScript/Hono最大的风险是迁移即破坏兼容。项目的做法是把旧服务的全部 71 个方法路径固化为基线fastapi-openapi.json契约测试逐项断言旧版每个操作在新应用中仍存在且security、requestBody.required、422校验响应语义一致响应体用tests-ts/contracts/fixtures/responses/下的真实形状 JSON 做基线回放测试通过真实的 Honoapp.request()发起 HTTP 请求验证——不是单测内部函数而是打真实边界测试基建见 tests-ts/contracts/test-app.ts其中未显式注入的依赖一律调用即抛错防止测试误触真实适配器。3. 事件契约SSE / WebSocket 帧也要过 schema流式响应更难守因为格式对了一半就能跑。第三阶段为 Copilot WebSocket 的 13 种事件、面试聊天 SSE、索引重建 SSE 分别建立了 Zod 事件联合见 packages/contracts/src/copilot-events.ts 与 docs/response-contracts-phase-three.md每种事件的必填字段被逐一删除验证——缺任何已知字段都必须解析失败未知type没有兜底分支非法值一律拒绝发送前校验在传输层执行服务层吐出的非法帧在离开边界前被拦截成标准错误帧隐私内容不会泄漏到线上测试用例见 tests-ts/contracts/phase-three-sse.test.ts。分阶段推进契约落地不是一次大爆炸这套契约体系分四个阶段渐进落地每阶段范围明确、独立可验证文档全部留档阶段覆盖内容文档一捕获现状响应清单 基线 fixtureresponse-inventory.ts二21 个核心 JSON 接口命名 DTO 运行时校验docs/response-contracts-phase-two.md三Copilot WS / SSE 事件契约docs/response-contracts-phase-three.md四LLM 结构化输出入口校验评分越界、引用缺失等直接拒绝落库docs/response-contracts-phase-four.md值得注意的取舍兼容优先于洁癖。旧字段、历史扩展字段、稀疏评分都按显式兼容规则保留严格校验只作用于新生成的数据。这让 71 个存量接口在迁移中零破坏。一条命令的质量闸门所有防线最终汇入 package.json 中的一条命令bun run checkBun/Node 双重类型检查 → 架构边界检查 → 全部后端/前端测试 → 前端 lint → API/Web/Electron/sidecar 构建一条命令跑完整个质量闸门bun run test:contracts单独回归契约层OpenAPI 一致性、HTTP 边界、SSE/WS 事件。最终验证记录见 docs/response-contracts-phase-four.md429 个后端/跨模块测试、190 个契约测试全部通过OpenAPI 与前端生成类型差异为零。新手可以直接抄走的 5 条清单把架构规则写成扫描脚本一段违禁 import 正则 CI 退出码比 10 页文档更管用参考 scripts/check-boundaries.ts。给接口建户口每个操作登记状态码、Content-Type、fixture新增接口必须先登记。用旧版 OpenAPI 做基线迁移重构时逐操作断言 security、必填 body 与错误语义不变。打真实边界而不是内部函数HTTP 契约测试走app.request()流式响应逐帧解析验证。校验分层传输层守 HTTP/SSE 形状业务入口守 LLM 输出语义错误数据在落库前就死掉。边界检查管住代码长什么样契约测试管住系统说什么话。两者合起来就是 TechSpar 在持续加功能的同时还能让前端放心消费每个接口的底气——而这一切都由一条bun run check在每个提交时自动执行。赞分享【免费下载链接】TechSpar一个持续进化的面试训练系统。在线体验地址https://techspar.cn项目地址https://gitcode.com/gh_mirrors/te/TechSpar点击查看免费下载相关推荐IronClaw 架构契约测试套件ironclaw_architecture_tests完全指南用机械测试守住 Reborn 依赖边界IronClaw 架构契约测试套件ironclaw_architecture_tests完全指南用机械测试守住 Reborn 依赖边界 IronClaw人工智能AI 应用交互助手AI AgentIceCubesApp持续测试架构自动化检查保障代码质量IceCubesApp持续测试架构自动化检查保障代码质量 还在为SwiftUI项目的手动测试烦恼吗IceCubesApp作为一款优秀的Mastodon客户端移动开发社交vLLM-Omni 测试质量评估实战如何审查 PR 测试是否真正保护行为契约vLLM Omni 测试质量评估实战如何审查 PR 测试是否真正保护行为契约 测试质量评估是 vLLM Omni PR 审查链路中一道关键的证据关卡当测人工智能大模型模型推理服务多模态语音音频媒体生成本地部署创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
