tjt_czjs_ui/README.md

# 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)