服务端

web/AGENTS.md

@@ -0,0 +1,73 @@
+# AI 开发入口 [!IMPORTANT]
+
+- 本文档为项目级别规范和重要导航,必须严格参考
+- 对我的回复/文档编写 ,必须是 中文为主体语言，技术术语保留英文原文
+- 强制工作流：按下方索引表定位需要的文档 → 读取匹配文档 → 进入源码
+- 禁止跳过文档检查直接写复杂业务；禁止已有对应文档却不读
+- 索引表无匹配时，按本文件通用规则和现有同层代码风格实现
+- 业务流程需要遵循 `主流做法` `工业级正规`
+- 规范型文档是给 AI 的顶层入口文档，不是“解释得更全”就更好，而是要 更短、更硬、更可判定
+- 本文档只允许在已有的结构上CURD,不允许增加其他标题区
+
+
+## 工具使用规则
+
+- **搜索范围限制**：Grep/Glob 严禁全盘搜索，绝对禁止扫描 `.gitignore` 忽略的目录，以避免性能卡顿。
+- **读写**：所有文件读取/写入统一使用 UTF-8（建议无 BOM）
+- **读写**：PowerShell/脚本读取项目文件必须显式指定 `-Encoding utf8`
+
+## 当前项目代码要求
+
+### 通用要求
+
+- 优化代码时必须同时考虑冗余、孤岛代码、代码清晰度、复杂度、边界条件和兼容性，不能只追求功能跑通。
+- 优化代码时不要修改ui/ux 视觉效果,除非明确要求。
+- 先复用再新增
+- 允许抽公共逻辑，但公共逻辑必须放在根级共享目录，并保证边界仍清晰。
+
+### 项目偏好
+- 
+
+## 文档体系
+
+开始写代码前，根据下表判断当前任务涉及哪些文档，有对应文档必须先读。
+- .ai-specs 为规范根目录
+- .ai-specs\coding-specs 
+- .ai-specs\logic-specs
+
+### 目录索引表
+
+| 类型 | 路径 | 用途 | 说明 |
+|:---|:---|:---|:---|
+
+## 项目架构
+
+### 模块说明
+
+
+### 业务流转
+
+#### 1. xxx
+
+- 
+
+## 命名规范
+
+- 
+
+
+### 模块词汇
+
+| 中文 | 英文 | 说明 |
+|:---|:---|:---|
+| 设备 | device | 设备管理模块 |
+
+
+## 可复用组件
+
+- 
+
+## 技术栈专项规范
+
+### xxx
+- 

web/README.md

@@ -1,3 +1,15 @@
+# 安装项目依赖
+npm install
+
+# 或使用 yarn（如果已安装）
+yarn install
+
+# 或使用 pnpm（推荐，速度更快）
+pnpm install
+
+
+
+
 # gin-vue-admin web
 
 ## Project setup