trade-message-center/.trellis/spec/server/frontend/index.md

服务端前端开发规范

@trade-message-center/server 是纯服务端包，不包含本地 HTML harness、正式前端框架或生产 UI。

当前基线

• apps/server/package.json 只有 Fastify 依赖，没有 React/Vue/Svelte、样式库或独立前端构建工具。
• 手工 Bright 联调页面归 apps/mind-test-harness/ 所有；server 只提供其 HTTP/WS 业务边界。
• TypeScript 仍必须遵循根 tsconfig.base.json 的严格模式和 NodeNext 模块解析。

规范目录

文档	内容	状态
项目级代码架构	所有包共用的文件职责、共享层级、main-last 与注释规则	项目级必读
目录结构	原生联调页与未来正式 UI 边界	已建立
组件规范	组件引入前的最小边界	已建立基线
Hook 规范	Hook 与服务端数据请求边界	已建立基线
状态管理	UI 状态与服务端状态分类	已建立基线
质量规范	原生联调页的质量和验证方式	已建立
类型安全	TypeScript 和运行时边界	已建立基线

开始前检查

1. 先阅读 项目级代码架构，再确认这次工作确实在服务端包内引入了 UI 或服务端渲染，而不是把 API/路由误归入本层。
2. 读取服务端 backend 规范，明确 UI 与 HTTP/业务层的接口边界。
3. 首次引入前端依赖时，同时记录入口、构建脚本、渲染环境和验证命令。
4. 运行根 pnpm typecheck、pnpm build、pnpm test，并区分真实执行与因 --if-present 跳过的脚本。

文档维护

当服务端出现正式前端代码后，用真实组件、入口和测试补充本文件；不要把 mind-test-harness 的手工测试能力重新放回 server。