# Repository Guidelines

## 项目结构与模块组织
- `applications/`：可运行的 Web 应用（如 `drone-command/`、`mobile-web-view/`、`task-work-order/`）。
- `packages/`：共享库（API、组件、常量、hooks、工具等）。
- `uniapps/`：UniApp 相关应用（如 `work-app/`、`work-wx/`）。
- 应用职责说明：
  - `applications/drone-command/`：反制无人机 PC 系统。
  - `applications/task-work-order/`：任务工单 PC 系统。
  - `applications/mobile-web-view/`：`work-app`、`work-wx` 共用的内嵌页面（如地图等）。
  - `uniapps/work-app/`：使用 UniApp 开发的工单 App。
  - `uniapps/work-wx/`：使用 UniApp 开发的微信小程序。
- 资源文件通常放在各应用内，具体入口以各应用的 `README.md` 为准。

## 构建、测试与开发命令
在仓库根目录使用 `pnpm`：
- `pnpm install`：安装工作区依赖。
- `pnpm dev`：并行启动所有工作区的开发服务。
- `pnpm dev:drone-command`：启动单个应用。
- `pnpm dev:mobile-web-view`：启动单个应用。
- `pnpm dev:task-work-order`：启动单个应用。
- `pnpm dev:work-app`：启动 UniApp H5 开发服务。
- `pnpm dev:work-wx`：启动 UniApp H5 开发服务。
- `pnpm build:test:<app>` / `pnpm build:prod:<app>`：构建指定应用，例如 `pnpm build:prod:mobile-web-view`。

## 编码风格与命名规范
- 使用 Prettier 统一格式化（`.prettierrc.json`）。
- 使用 Tab 缩进（`tabWidth: 2`, `useTabs: true`），`semi: false`，`singleQuote: true`。
- SCSS 使用 `tabWidth: 4` 且双引号。
- 文件与目录保持 kebabCase，遵循现有应用与包的命名风格。

## 测试指南
- 无需任何测试

## 提交与合并请求规范
- 提交历史使用简短的约定式主题（如 `feat: ...`）。
- 建议使用 `feat:`、`fix:`、`chore:`、`refactor:` 等前缀并保持简洁描述。
- PR 需要包含：目的、影响的应用/包、UI 改动截图。
- 可关联相关 issue 或工单。

## 环境与配置
- Node.js >= 20，pnpm >= 9。
- 优先使用根目录工作区脚本，除非必要不要在子目录直接运行脚本。

# AI Rules / AI行为规范
- 对低风险修改，AI可自主执行，无需批准。
  AI may proceed autonomously for low-risk changes.
- 仅当修改可能影响架构、核心模块、公共接口、数据结构或安全性时，才需要请求批准。
  Ask for approval only for high-impact changes.
- 若问题不影响系统正确性，应自行做出合理决策，而不是提问。
  DO NOT ask questions that do not affect correctness.
- 优先最小化修改范围。
  Prefer minimal changes.
- 未被明确要求时，禁止大规模重构。
  Avoid large refactors unless requested.
- 修改完不需要走打包编译校验