---
status: accepted
---

# Web code language and structure

Web 驾驶舱沿用 TvT.js / Fes.js 已有工程约定，不把 TypeScript 增设为项目新规范。新增代码默认使用 JavaScript 和 Vue SFC；只在复用已有 `.ts` 文件或第三方类型声明不可省略时保留局部类型文件，且不扩散为新的项目级规范。可使用少量 JSDoc 帮助编辑器理解，但不引入新的 TypeScript 构建、lint 或目录规范。

驾驶舱自有页面代码继续放在 `src/pages/cockpit/index.vue` 与 `src/modules/cockpit`；开发期可以参考或复用 `src/plugins` 下的现有能力，但最终验收以自有页面为准，不把驾驶舱作为 TvT 插件交付。

`src/pages/cockpit/index.vue` 保持薄，只挂载外壳组件；`CockpitShell` 与全部面板、地图服务、适配层、mock 都收在 `src/modules/cockpit` 这个唯一领域边界内。`src/modules` 是为此新增的顶层目录。不使用 `src/pages/cockpit.vue`，不使用 `layout.vue`，也不在 `.fes.js` 写 `router.routes`（那会让全站文件路由失效）。