# 凯迪财务基础系统前端

[English](./README.md)

前端采用 Vue 3、TypeScript、Vite、Pinia 和 TDesign Vue Next。项目保留 TDesign Starter 的应用框架与组件规范，生产路由只包含财务系统合同中声明的页面，接口按业务领域拆分。

## 环境要求

- Node.js 22.12 或更高版本
- 本地 Java 后端已启动

## 常用命令

```bash
npm install
npm run dev:linux
npm test
npm run lint
npm run build
```

后端未运行在 Vite 代理的本地默认地址时，通过 `VITE_BACKEND_TARGET` 指定地址。

正式构建会执行 `scripts/check-production-hygiene.mjs --dist`，同时扫描源码与构建产物，阻止 Starter 演示页面、Mock 样本、全页面动态路由加载和废弃品牌素材进入生产包。

## 机器合同

- 路由：`contracts/routes.json`
- 页面组件：`contracts/components.json`
- API 操作：`contracts/operations.json`
- 后端 OpenAPI：`../openapi.yaml`

业务页面必须使用 TDesign Vue Next 组件，并调用 `src/api` 下对应的分域接口模块。生产源码中不得增加通用资源适配器或演示路由。