# 模块 3：不要让 AI 泛泛总结项目

<div class="grid grid-cols-2 gap-6 mt-6 text-sm">
<div class="p-4 rounded-xl bg-red-500/10 border border-red-500/30">

**不要问：**
```
@workspace 帮我看看若依项目
```
</div>
<div class="p-4 rounded-xl bg-emerald-500/10 border border-emerald-500/30">

**要问：** 从前端、后端、认证、路由、API、权限、日志、测试、构建分析项目，并标注依据文件
</div>
</div>

<!--
使用 @workspace 时，最常见的错误是问"帮我看看这个项目"。这样 AI 会给一段泛泛总结。

我们要让它从明确维度分析：前端结构、后端结构、认证流程、路由菜单、API 封装、权限控制、日志记录、测试结构、构建方式。并且要求每个结论标注依据文件。
-->

---

# 若依前后端结构怎么读？

<div class="grid grid-cols-2 gap-6 mt-4 text-sm">
<div>

**前端重点：** src/api · src/router · src/store · src/views · src/directive · src/permission · src/utils/request
</div>
<div>

**后端重点：** ruoyi-admin · ruoyi-framework · ruoyi-system · ruoyi-common · Controller · Service · Mapper
</div>
</div>

<!--
若依是前后端分离项目，所以读结构时要分前端和后端。

前端重点看 api、router、store、views、directive、permission 文件、request 封装。

后端重点看 ruoyi-admin、ruoyi-framework、ruoyi-system、ruoyi-common，以及 Controller、Service、Mapper 分层。

如果使用 RuoYi-Vue3，前端目录和状态管理方式可能不同，但分析方法一样。
-->

---

# 认证链路要看哪些文件？

<div class="mt-6 text-sm">

登录页面 → login API → token 存储 → request 拦截器 → getInfo 用户信息 → getRouters 动态路由 → 权限 store → 路由守卫

</div>

<!--
若依权限主线从登录开始。

我们要看登录页面在哪里、login API 怎么调用、token 存在哪里、request 拦截器如何带 token、请求用户信息的 getInfo 在哪里、请求菜单路由的 getRouters 在哪里、权限 store 如何保存角色和权限、路由守卫如何判断是否已加载菜单。

这条链路是今天最重要的主线。
-->

---

# 动态菜单与路由怎么看？

<div class="mt-6 text-sm">

- 后端菜单表
- 菜单类型：目录 / 菜单 / 按钮
- 路由地址 · 组件路径 · 权限字符
- 前端动态路由转换
- router.addRoute

</div>

<!--
若依的菜单不是单纯前端写死的。

后台菜单管理里配置菜单，菜单可以是目录、页面菜单，也可以是按钮权限。菜单包含路由地址、组件路径、权限字符等信息。

前端获取后端返回的菜单数据后，会转换成前端路由，再动态挂载。所以分析动态菜单，既要看后端菜单接口，也要看前端路由转换逻辑。
-->

---

# 全局结构分析 Prompt

<div class="mt-4 p-4 rounded-xl bg-blue-500/10 border border-blue-500/30 text-sm">

```
@workspace 请分析若依项目全局结构。
维度：1.前端目录 2.后端目录 3.登录认证 4.动态路由 
5.API封装 6.权限控制 7.操作日志 8.代码生成 
9.测试与构建 10.不确定点
每个结论标注依据文件。
```

</div>

<!--
这是若依全局结构分析的标准 Prompt。大家注意，维度非常明确。

我们不是让 AI 自己决定讲什么，而是让它从前端目录、后端目录、登录认证、动态路由、API 封装、权限控制、操作日志、代码生成、测试与构建这些维度分析。

每个结论都要标注依据文件。
-->

---

# 产出：若依项目结构图

<div class="mt-6 text-sm">

项目结构图应包含：前端目录职责 · 后端模块职责 · 认证与权限相关文件 · 菜单与路由相关文件 · API 封装相关文件 · 操作日志相关文件 · 不确定点

</div>

<!--
这一部分最终产出是若依项目结构图。

结构图不只是列目录，而是说明每个目录和权限主线有什么关系。比如前端 views/system/user 是用户管理页面，api/system/user 是用户接口，store/modules/permission 或 permission 文件和动态路由有关，directive/permission 和按钮权限有关。

后端 sys 用户、角色、菜单 Controller、Service、Mapper 共同支撑权限管理。
-->