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

安装依赖：

npm install

如果你本地长期使用 pnpm，也可以执行：

pnpm install

本地启动：

npm run dev

使用 dev 环境变量启动：

npm run dev-server

构建：

npm run build:dev
npm run build:test
npm run build:stage
npm run build:prod

类型检查与代码整理：

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

主需求文档：

• ../tejiantou_ai_requirements_20260410_v2.md