Cursor rule

1---
2description: ll-admin 单体仓库根约定（pnpm、Turbo、脚本）
3alwaysApply: true
4---
5 
6# Monorepo 核心约定
7 
8## 工具链
9 
10- **包管理**：只用 `pnpm`（根目录 `preinstall` 已限制）；不要用 npm/yarn 安装依赖。
11- **编排**：`turbo` 串联 `build`；包依赖构建顺序见 `pnpm-workspace.yaml`（`apps/*`、`packages/*`）。
12- **提交**：Conventional Commits + `commitlint`（见根目录 **`commitlint.config.cjs`**）；可用根脚本 `cz`（cz-git）。
13 
14## 各 App 职责
15 
16| App | 包名 | 说明 |
17|-----|------|------|
18| admin | `@apps/admin` | Vue3 管理后台（Element Plus + VXE Table） |
19| server | `@apps/server` | NestJS API + TypeORM |
20| uni | `@apps/uni` | uni-app 移动端（聚鑫助手） |
21| docs | — | VitePress 开发文档 |
22| common | `@llcz/common` | 跨端纯 TS 工具库 |
23 
24- `@llcz/common` 当前被 **admin / server** 使用，**uni 尚未接入**。
25- uni 依赖 hoist：[`apps/uni/.npmrc`](apps/uni/.npmrc) 需 `shamefully-hoist=true`。
26 
27## 常用脚本（根 `package.json`）
28 
29| 场景 | 命令 |
30|------|------|
31| 后端开发 | `pnpm dev:server` |
32| 管理端 Web | `pnpm dev:admin` |
33| 文档站 | `pnpm dev:docs` |
34| uni-app H5 | `pnpm dev:uni` |
35| uni-app 微信小程序 | `pnpm dev:uni:mp` |
36| 构建 uni H5 / 小程序 | `pnpm build:uni:h5` / `pnpm build:uni:mp` |
37| 全仓检查 | `pnpm check`（lint + typecheck + test） |
38 
39## 全仓检查注意
40 
41- 改 uni 后优先单独验证：`pnpm --filter @apps/uni lint` / `type-check`。
42- `pnpm check` 递归所有包；uni 的 type-check 可能因 wot-ui 依赖类型报错、lint 有既有问题导致全仓失败 — 先定位是哪个 app，再决定是否单独处理 uni。
43 
44## AI 协作原则
45 
46- 改动限制在实际需求涉及的 app 或 package，避免无关重构。
47- 大需求按 app 分包讨论实现（server / admin / docs / uni / common）。
48- 日期处理统一使用 **day.js**：涉及日期解析、日历计算、展示格式化、持久化时间字段时，不使用原生 `Date` 重新实现。
49- 非日历语义场景（性能计时、traceId、cache-bust）可保留 `Date.now()`。
50- 优先复用现有插件/公共工具（如 `@llcz/common`、app 内已有 util）；禁止重复造轮子实现同类能力。
51 
52## Cursor 规则索引
53 
54| App | 规则文件 |
55|-----|----------|
56| 全仓 | `monorepo-core.mdc`、`comment-standards.mdc`（注释规范） |
57| admin | `vue-admin.mdc` |
58| uni | `vue-uni.mdc` |
59| server | `nestjs-server.mdc` |
60| docs | `vitepress-docs.mdc` |
61| common | `shared-common.mdc` |
62