From 2d0f9bf5e0a9ad80ae573b286142c372cb32608a Mon Sep 17 00:00:00 2001
From: chiguyong <chiguyong@beyondsoft.com>
Date: Sun, 22 Mar 2026 01:42:16 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0known-patterns.json?=
 =?UTF-8?q?=20-=20=E5=A2=9E=E5=8A=A0API=E5=B5=8C=E5=A5=97=E7=BB=93?=
 =?UTF-8?q?=E6=9E=84=E9=97=AE=E9=A2=98=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- pat-002: 明确说明所有列表API都有相同的嵌套结构问题
- applications: 5次重复发生
---
 05-ISSUES/known-patterns.json | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/05-ISSUES/known-patterns.json b/05-ISSUES/known-patterns.json
index cad2633..adb1366 100644
--- a/05-ISSUES/known-patterns.json
+++ b/05-ISSUES/known-patterns.json
@@ -18,17 +18,18 @@
     },
     "pat-002": {
       "name": "Axios响应数据嵌套结构",
-      "source": "implementation_review",
+      "source": "user_feedback",
       "confidence": 0.95,
-      "applications": 1,
+      "applications": 5,
       "created": "2026-03-22",
       "category": "frontend",
-      "pattern": "API响应是{code, message, data{...}}嵌套结构，直接访问res.data.token是undefined",
-      "problem": "登录成功后token存储为undefined，导致isLoggedIn返回false",
-      "solution": "使用res.data.data获取实际的登录数据",
+      "pattern": "后端API响应统一格式为{code,message,data{}}，前端直接访问res.data导致数据为undefined",
+      "problem": "登录、用户、角色、权限等页面fetch数据时，res.data是ApiResponse而非实际数据",
+      "solution": "使用res.data.data获取实际的列表/用户数据",
       "quality_rules": [
-        "登录数据在res.data.data中，不是在res.data中",
-        "访问嵌套数据前先console.log打印确认结构"
+        "所有API调用后赋值给ref时使用 res.data.data",
+        "示例: users.value = res.data.data || []",
+        "不仅是登录API，所有列表查询API都有相同的嵌套结构"
       ]
     },
     "pat-003": {
@@ -50,7 +51,7 @@
       "name": "Git提交纪律",
       "source": "user_feedback",
       "confidence": 0.95,
-      "applications": 3,
+      "applications": 5,
       "created": "2026-03-22",
       "category": "workflow",
       "pattern": "代码修改后未提交到Git，npm install或操作导致工作目录恢复到旧状态",