zlwu
b220298f89
为减少仓库噪声和重复规则，整理当前开发入口并移除已废弃资料。 - 精简根 AGENTS，补充四个应用规则与 README，统一规范入口 - 归整部署文件、SOP 原稿和参考资源，修正迁移后的脚本路径 - 取消虚拟环境、工具状态、业务导出及备份的跟踪，本机所需原件保留 - 移除停用的 graphify 配置、脚本与产物 - 删除历史业务文档、执行计划、OpenSpec 业务变更和移动 UI 原型 - 清理失效引用，历史细胞产品导入改为必须显式指定 --file 验证：git diff --cached --check、OpenSpec 严格校验、导入参数隔离检查 3/3 通过； 迁移文件完整性和现行链接已核对。未执行部署、业务数据导入或服务启停。
44 lines
2.4 KiB
Markdown
Executable File
44 lines
2.4 KiB
Markdown
Executable File
# 中科兴皖 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 为准）。从本目录执行：
|
||
|
||
```bash
|
||
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](AGENTS.md)，文档见[导航](../docs/README.md)。自动导入、主题、对话框、表格与树路径约束均以本项目规则为准。
|
||
|
||
## 测试与部署
|
||
|
||
单元及回归检查分散在 `src/` 与 `scripts/`，按测试文件所用 Node/tsx 方式运行；当前没有统一 `test` npm 脚本。仅构建成功不能代表业务回归通过。
|
||
|
||
Docker Web 镜像同时包含本应用和 `mobile-oa-h5/`，见 [Dockerfile](../deploy/docker/web-admin/Dockerfile)与[部署说明](../deploy/docker/README.md)。目录重命名、静态资源和代理改动需要同步检查部署引用。
|
||
|
||
## 来源与许可
|
||
|
||
模板来源：Art Design Pro（Daymychen/art-design-pro）。保留 [LICENSE](LICENSE) 的原版权与许可；依赖和第三方静态资源遵循各自许可。本文替代原模板推广页，不删除许可文件。
|