0006-web-code-language-and-structure.md 1.1 KB
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（那会让全站文件路由失效）。