From a8d6fafb71df1168e1cfd7679079c028a84a4f07 Mon Sep 17 00:00:00 2001
From: pigeon <zs@vifo.net>
Date: Thu, 4 Jun 2026 08:27:19 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E5=89=8D=E7=AB=AF=20?=
 =?UTF-8?q?AI=20=E9=85=8D=E7=BD=AE=EF=BC=8C=E6=94=AF=E6=8C=81=E5=A4=9A?=
 =?UTF-8?q?=E7=A7=8D=E6=8A=80=E6=9C=AF=E6=A0=88?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- admin-ui: Vue3 + Vite
- cashier-mobile: 技术栈待定（uni-app/React Native/Flutter）
- customer-mobile: 技术栈待定
- 添加各框架的 HTTP 调用示例
---
 .idea/inspectionProfiles/Project_Default.xml |  1 +
 .idea/misc.xml                               |  3 ++
 .idea/modules.xml                            |  8 ++++
 .idea/rui-frontend.iml                       |  9 ++++
 .idea/vcs.xml                                |  6 +++
 AGENTS.md                                    | 49 +++++++++++++-------
 6 files changed, 60 insertions(+), 16 deletions(-)
 create mode 100644 .idea/modules.xml
 create mode 100644 .idea/rui-frontend.iml
 create mode 100644 .idea/vcs.xml

diff --git a/.idea/inspectionProfiles/Project_Default.xml b/.idea/inspectionProfiles/Project_Default.xml
index 8d66637..03d9549 100644
--- a/.idea/inspectionProfiles/Project_Default.xml
+++ b/.idea/inspectionProfiles/Project_Default.xml
@@ -1,5 +1,6 @@
 <component name="InspectionProjectProfileManager">
   <profile version="1.0">
     <option name="myName" value="Project Default" />
+    <inspection_tool class="Eslint" enabled="true" level="WARNING" enabled_by_default="true" />
   </profile>
 </component>
\ No newline at end of file
diff --git a/.idea/misc.xml b/.idea/misc.xml
index 4738e18..fa27012 100644
--- a/.idea/misc.xml
+++ b/.idea/misc.xml
@@ -1,5 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
+  <component name="ProjectRootManager" version="2" project-jdk-name="openjdk-26" project-jdk-type="JavaSDK">
+    <output url="file://$PROJECT_DIR$/out" />
+  </component>
   <component name="SshConsoleOptionsProvider">
     <option name="myEncoding" value="UTF-8" />
     <option name="myConnectionType" value="NONE" />
diff --git a/.idea/modules.xml b/.idea/modules.xml
new file mode 100644
index 0000000..742bf62
--- /dev/null
+++ b/.idea/modules.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/rui-frontend.iml" filepath="$PROJECT_DIR$/.idea/rui-frontend.iml" />
+    </modules>
+  </component>
+</project>
\ No newline at end of file
diff --git a/.idea/rui-frontend.iml b/.idea/rui-frontend.iml
new file mode 100644
index 0000000..d6ebd48
--- /dev/null
+++ b/.idea/rui-frontend.iml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="JAVA_MODULE" version="4">
+  <component name="NewModuleRootManager" inherit-compiler-output="true">
+    <exclude-output />
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>
\ No newline at end of file
diff --git a/.idea/vcs.xml b/.idea/vcs.xml
new file mode 100644
index 0000000..35eb1dd
--- /dev/null
+++ b/.idea/vcs.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>
\ No newline at end of file
diff --git a/AGENTS.md b/AGENTS.md
index cf0532c..1c48ead 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -5,9 +5,9 @@
 ## 🎯 本仓库职责
 
 **rui-frontend** 是睿核科技的前端工程集合，包含：
-- `admin-ui` - 管理后台（Vue3 + TypeScript）
-- `cashier-mobile` - 收银移动端
-- `customer-mobile` - 顾客移动端
+- `admin-ui` - 管理后台（Vue3 + TypeScript + Vite）
+- `cashier-mobile` - 收银移动端（技术栈待定，可能是 uni-app、React Native 等）
+- `customer-mobile` - 顾客移动端（技术栈待定，可能是 uni-app、React Native 等）
 
 ## 🚫 绝对禁止
 
@@ -20,12 +20,9 @@
 
 ```
 rui-frontend/
-├── admin-ui/           ✅ 可修改
-│   ├── src/
-│   ├── public/
-│   └── package.json
-├── cashier-mobile/     ✅ 可修改
-├── customer-mobile/    ✅ 可修改
+├── admin-ui/           ✅ 可修改（Vue3 管理后台）
+├── cashier-mobile/     ✅ 可修改（收银移动端）
+├── customer-mobile/    ✅ 可修改（顾客移动端）
 ├── package.json        ✅ 可修改（根配置）
 └── pnpm-workspace.yaml ✅ 可修改
 ```
@@ -33,21 +30,27 @@ rui-frontend/
 ## 🔗 与后端通信规范
 
 ### 1. API 调用方式
-- 使用 **Axios** 或 **Fetch** 发送 HTTP 请求
+- 使用 **Axios**、**Fetch** 或各框架提供的 HTTP 客户端发送请求
 - 禁止直接引用后端 Java 类
 
 ### 2. 接口地址规范
 ```typescript
-// 正确示例
+// 正确示例（axios）
 const API_BASE = '/api';  // 通过网关转发
 const userApi = {
   getList: () => axios.get(`${API_BASE}/user/list`),
   create: (data) => axios.post(`${API_BASE}/user`, data)
 };
+
+// 正确示例（uni-app）
+const userApi = {
+  getList: () => uni.request({ url: `${API_BASE}/user/list` }),
+  create: (data) => uni.request({ url: `${API_BASE}/user`, method: 'POST', data })
+};
 ```
 
 ### 3. 数据类型定义
-- 前端自行定义 TypeScript 接口
+- 前端自行定义 TypeScript 接口或各框架的类型定义
 - 与后端 DTO 保持一致（但不直接引用）
 
 ```typescript
@@ -61,10 +64,24 @@ interface UserDTO {
 
 ## 📝 编码规范
 
-1. **框架**：Vue 3 + TypeScript + Vite
-2. **包管理器**：pnpm（强制使用）
-3. **代码风格**：遵循项目现有 ESLint 配置
-4. **组件规范**：使用组合式 API（setup 语法）
+### admin-ui（管理后台）
+- **框架**：Vue 3 + TypeScript + Vite
+- **包管理器**：pnpm（强制使用）
+- **组件规范**：组合式 API（setup 语法）
+
+### cashier-mobile / customer-mobile（移动端）
+- **框架**：待定（根据需求选择 uni-app、React Native、Flutter 等）
+- **选型原则**：
+  - uni-app：跨平台、快速开发、适合小程序+H5+App
+  - React Native：性能要求高、需要原生能力
+  - Flutter：高性能、自定义 UI
+- **包管理器**：pnpm（推荐）或 npm
+
+### 通用规范
+1. **代码风格**：遵循项目现有 ESLint/Prettier 配置
+2. **HTTP 客户端**：统一封装请求拦截器（处理 Token、错误等）
+3. **路由管理**：各项目自行管理前端路由
+4. **状态管理**：根据框架选择（Pinia、Vuex、Redux、Zustand 等）
 
 ## 🔔 当需要后端支持时