smart
129 lines
4.2 KiB
Markdown
129 lines
4.2 KiB
Markdown
# 模块 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 共同支撑权限管理。
|
|
-->
|