deal-with-code-to-fontend-logic

name	deal-with-code-to-fontend-logic
description	这是一个梳理前端具体逻辑的技能。

目标

把代码整理成前端逻辑，用前端语言，中文，放到.docs/代码逻辑梳理

触发使用技能

• 用户提到放到“.docs/代码逻辑梳理”
• 重新梳理
• 代码梳理
• 逻辑梳理

适用边界

• 帮助ai或者人快速了解具体完整的前端逻辑细节

强制要求

必须先读取案例再结合步骤进行执行，只理解步骤，会导致理解会不准确，案例就是代码步骤的最准确意思

原则

如果字段能通过项目上下文得知什么意思，必须列出什么意思，案例：是否开启策略衰减（autoDecaySwitch）

执行流程

1. 读取文件，或者通过中文识别用户输入的业务是哪个文件下，先区分是梳理整块业务还是单个文件，假设用户说的是整理学生管理系统，则用户的意思是整理student_portal的所有文件，那么需要根据一个一个文件来进行梳理，假设用户说的是梳理某个单独的组件，则仅仅只需要梳理当前的组件文件
2. 根据每个文件去整理，忽略css
3. 整理成简要逻辑
4. service文件查看案例，根据这个模版来输出，结合以service的url为纲，根据项目上下文，梳理出出参和入参

文档规范（强制检查输出文档）

参考./template.md

• 不要出现过多代码（代码只能是辅助，重要是用中文梳理逻辑细节，例如禁止条件：status==2）
• 必须包含（页面、逻辑）title
  • 逻辑：必须保留具体逻辑，例如禁止，权限等
• 先整体后细节：先列模块（例如：查询/筛选、列表、详情、弹窗、抽屉等），再进入每个模块内部。
• 如果同一页面存在多种“展示场景/模式”（比如不同 tab、不同业务类型、不同入口），要按“场景”分别列字段顺序（不能合并写“字段A/字段B”）

页面

应该先整体到细节列出页面展示情况，如果某个按钮有简单逻辑逻辑，在这个部分必须列出，如果太复杂则在逻辑列出

筛选

• 每个字段需要展示接口字段+表单类型（input、select等）+枚举，例如：
• 学生ID（id）
• 学生状态（字段：studentStatus）（下拉）
  • 全部
  • 在读（值 1）
  • 休学（2）
  • 退学（3）
  • 毕业（4）

列表

• 如果有列表应该列出所有的字段、如果有表单应该保留表单字段（字段名字一个字不能错，必须按照顺序），列表就是从左到右，表单有可能是从上到下或者从左到右
• 每个字段需要展示接口字段
• 每个列表列，如果有逻辑，则需要展示逻辑明细，例如禁止、因为某个if分支才展示等，但是禁止展示简单的兜底，例如为空时兜底“-”，如果没有特殊逻辑，只有获取接口字段，以及简单兜底，则禁止出现逻辑明细
• 除了字段能用代码，其他禁止出现代码，只能用中文逻辑
• 禁止出现枚举的英文字段引用，只能用中文枚举
• 使用方法才能把逻辑放到“逻辑”模块里面，如果在react-dom里面做判断，这部分逻辑都应该放到“页面”模块

if else应该分别说明

案例： if(noShow){ return '-' } return 重点关注学生 分析： 这里完整逻辑应该是 if(noShow){ return '-' }else{ return 重点关注学生 } 错误输出： 如果无需展示，兜底‘-’；返回重点关注学生 正确输出： 如果无需展示，出现‘-’，否则展示重点关注学生

模版

根据这个模版来输出

• 学生记录ID（id)
• 班委（字段：classOfficerRole）
  • 如果是班长，则颜色是绿色
  • 如果是副班长，则颜色是蓝色
  • 如果是学习委员，则颜色是橙色

操作按钮必须拆两层写（强制）

页面-操作栏：只写“按钮是否展示”的条件 条件写法：中文可读的状态/原因 +（括号里写代码条件） 对于无法推断含义的“权限位/标记位数字”，只写代码条件本身，不要硬翻译

弹窗

必须写 标题 + 核心文案/关键字段（不能只写“有弹窗”） 有动态文案时，必须写清楚 变量取值规则（例如 planName 怎么算）

逻辑

列表-操作

逻辑-操作行为：写“点了按钮发生什么” 必须落到具体动作：跳转到哪（路径 + query/params）、请求哪个接口（method + url）、是否二次确认、成功后如何刷新/回跳/提示 如果按钮只是触发上层回调，必须继续向上追踪到页面/模型/服务层，直到能写出“跳转/接口/弹窗”的真实行为

输出示例

案例1

流程：1. 读取文件，或者通过中文识别用户输入的业务是哪个文件下 输入：学生管理系统 读取：student_portal下

案例2

流程：3. 整理成简要逻辑

学生管理系统或者student_portal

输出

限制

• 允许写代码，但只能“最小代码”
• 文档里不贴大段代码；只允许在括号里放关键判断（例如 status == 1），或列举映射（value→name）。 重点是中文解释“为什么”，不是复述实现细节（例如不要展开 props 列表、不要写分页参数这种细节）。
• 禁止写props、向父组件派发的事件这种技术方面的梳理
• 禁止在文档出现“本文档根据deal-with-code-to-fontend-logic梳理”

检查

• 字段自检：列表字段是否与 title 文案逐字一致？顺序是否从左到右？
• 场景自检：是否把不同场景的字段/规则混写在一起？
• 映射自检：所有 value→name 是否逐条列出？是否遗漏某个值？
• 展示条件是否都在“页面-操作栏”？
• 点击后的跳转/接口/确认/刷新是否都在“逻辑-操作行为”？
• 动态文案自检：弹窗/页面上出现的关键文案是否遗漏？动态变量取值规则是否写清？