Files
zkxw/web-admin/README.md
zlwu b220298f89 chore: 清理历史资料并规范工程目录与开发规则
为减少仓库噪声和重复规则,整理当前开发入口并移除已废弃资料。

- 精简根 AGENTS,补充四个应用规则与 README,统一规范入口
- 归整部署文件、SOP 原稿和参考资源,修正迁移后的脚本路径
- 取消虚拟环境、工具状态、业务导出及备份的跟踪,本机所需原件保留
- 移除停用的 graphify 配置、脚本与产物
- 删除历史业务文档、执行计划、OpenSpec 业务变更和移动 UI 原型
- 清理失效引用,历史细胞产品导入改为必须显式指定 --file

验证:git diff --cached --check、OpenSpec 严格校验、导入参数隔离检查 3/3 通过;
迁移文件完整性和现行链接已核对。未执行部署、业务数据导入或服务启停。
2026-10-29 23:08:29 +08:00

2.4 KiB
Executable File
Raw Permalink Blame History

中科兴皖 Web 管理端

Vue 3、TypeScript、Vite 7、Element Plus、Tailwind CSS 4、Pinia、SCSS。基于 Art Design Pro 模板持续开发,当前业务入口以本仓库为准。

开发

需要 Node.js >=20.19.0、pnpm >=8.8.0(以 package.json 的 engines 为准)。从本目录执行:

pnpm install --frozen-lockfile
pnpm build

本地开发服务由用户执行 pnpm dev。本地 .env.development 使用团队提供的脱敏配置,按 vite.config.ts 配置代理与端口,不覆盖已有配置。Docker 构建使用 .env.docker;VITE_* 会进入客户端,不能放服务端密钥。

命令 用途
pnpm build 生产构建
pnpm build:test test 模式构建
pnpm build:typecheck vue-tsc 类型检查并构建
pnpm exec eslint <改动文件> 定向 ESLint 检查
pnpm exec prettier --check <改动文件> 定向格式检查

fix、lint:prettier、lint:stylelint 会改写文件,不作为只读检查使用;clean:dev 现已是提示脚本,不会清理业务页或模板资源。

代码入口

  • src/main.ts:应用入口;src/router/:Hash 路由、权限与动态菜单。
  • src/router/modules/sqxp.ts:业务菜单路由;src/views/:市场存储、生产、质检、中试、OA、系统等页面。
  • src/api/:接口;src/store/modules/:状态;src/components/:共享业务组件。
  • public/:运行时静态资源,包括 TinyMCE、SOP 资源,不能按“第三方”或“Demo”批量删除。

UI 使用 Fresh Mint;新增页面先选择 P01–P27 参考模式。规则见 AGENTS,文档见导航。自动导入、主题、对话框、表格与树路径约束均以本项目规则为准。

测试与部署

单元及回归检查分散在 src/ 与 scripts/,按测试文件所用 Node/tsx 方式运行;当前没有统一 test npm 脚本。仅构建成功不能代表业务回归通过。

Docker Web 镜像同时包含本应用和 mobile-oa-h5/,见 Dockerfile与部署说明。目录重命名、静态资源和代理改动需要同步检查部署引用。

来源与许可

模板来源:Art Design Pro(Daymychen/art-design-pro)。保留 LICENSE 的原版权与许可;依赖和第三方静态资源遵循各自许可。本文替代原模板推广页,不删除许可文件。