154 lines
2.9 KiB
Markdown
154 lines
2.9 KiB
Markdown
# tjt_czjs-ui
|
||
|
||
`tjt_czjs-ui` 是特建投设计产值统计平台的管理后台前端工程。当前底座基于 `Lyzsys` 前端后台框架，整体属于芋道源码体系上的二次开发版本。
|
||
|
||
这个项目负责后台页面、路由、权限按钮、统一请求封装、表格与表单交互等前端能力。后续特建投页面 1 到页面 3，建议统一落在独立业务域 `tjt` 下。
|
||
|
||
## 技术栈
|
||
|
||
- Vue 3
|
||
|
||
- TypeScript
|
||
|
||
- Vite
|
||
|
||
- Element Plus
|
||
|
||
- Pinia
|
||
|
||
- Vue Router
|
||
|
||
- Axios
|
||
|
||
- Vue I18n
|
||
|
||
- UnoCSS
|
||
|
||
## 快速开始
|
||
|
||
环境要求：
|
||
|
||
- Node.js `>= 16`
|
||
|
||
- 推荐使用 `npm` 或 `pnpm`
|
||
|
||
安装依赖：
|
||
|
||
```bash
|
||
npm install
|
||
```
|
||
|
||
如果你本地长期使用 `pnpm`，也可以执行：
|
||
|
||
```bash
|
||
pnpm install
|
||
```
|
||
|
||
本地启动：
|
||
|
||
```bash
|
||
npm run dev
|
||
```
|
||
|
||
使用 `dev` 环境变量启动：
|
||
|
||
```bash
|
||
npm run dev-server
|
||
```
|
||
|
||
构建：
|
||
|
||
```bash
|
||
npm run build:dev
|
||
npm run build:test
|
||
npm run build:stage
|
||
npm run build:prod
|
||
```
|
||
|
||
类型检查与代码整理：
|
||
|
||
```bash
|
||
npm run ts:check
|
||
npm run lint:eslint
|
||
npm run lint:format
|
||
npm run lint:style
|
||
```
|
||
|
||
## 配置说明
|
||
|
||
当前请求基地址由 `src/config/axios/config.ts` 中的 `VITE_BASE_URL + VITE_API_URL` 组合而成。
|
||
|
||
本地环境文件位于项目根目录的 `.env*` 文件中。启动前请确认前端请求地址已经指向可用的后端服务。
|
||
|
||
## 关键目录
|
||
|
||
- `src/api`
|
||
业务接口封装目录，建议后续新增 `src/api/tjt/*`
|
||
|
||
- `src/views`
|
||
页面目录，建议后续新增 `src/views/tjt/*`
|
||
|
||
- `src/config`
|
||
全局配置目录，包含请求封装与主题等配置
|
||
|
||
- `src/router`
|
||
路由配置目录
|
||
|
||
- `src/store`
|
||
Pinia 状态管理目录
|
||
|
||
- `src/main.ts`
|
||
应用入口，统一接入 i18n、Pinia、Element Plus、路由与权限控制
|
||
|
||
## 特建投业务建议落位
|
||
|
||
建议按以下方式组织特建投页面：
|
||
|
||
- 页面 1 项目概况 + 合同规划：`src/views/tjt/project`
|
||
|
||
- 页面 2 单项目产值计算：`src/views/tjt/output`
|
||
|
||
- 页面 3 项目盈亏表：`src/views/tjt/profit`
|
||
|
||
与之对应的接口建议放在：
|
||
|
||
- `src/api/tjt/project`
|
||
|
||
- `src/api/tjt/planning`
|
||
|
||
- `src/api/tjt/output`
|
||
|
||
- `src/api/tjt/profit`
|
||
|
||
## 推荐参考代码
|
||
|
||
如果要按现有规范快速开发新页面，建议优先参考：
|
||
|
||
- `src/api/demo/project/index.ts`
|
||
|
||
- `src/views/demo/project/index.vue`
|
||
|
||
- `src/views/demo/project/ProjectForm.vue`
|
||
|
||
- `src/config/axios/service.ts`
|
||
|
||
- `src/main.ts`
|
||
|
||
这套示例已经包含列表分页、搜索筛选、新增编辑删除、批量删除、Excel 导出和权限按钮控制。
|
||
|
||
## 与后端联调
|
||
|
||
后端默认本地 Profile 为 `local`，当前本地端口配置为 `48080`。
|
||
|
||
联调前建议确认接口地址、登录态、租户头和加密配置是否与当前环境一致。
|
||
|
||
## 文档入口
|
||
|
||
特建投业务分析与计划文档：
|
||
|
||
- [`../doc/特建投业务分析与计划.md`](../doc/特建投业务分析与计划.md)
|
||
|
||
主需求文档：
|
||
|
||
- [`../tejiantou_ai_requirements_20260410_v2.md`](../tejiantou_ai_requirements_20260410_v2.md)
|