管理用户提交的系统问题工单，支持问题类型、状态处理、页面定位、内容描述和管理员回复。 它在“我的工作”中服务个人待办、个人记录和工作反馈，核心价值是让普通用户只看到自己的数据，让管理员能统一处理。

本文基于 server_backend/modules/MyWork/views_app/UserIssue.py、dvadmin/system/views/user_smart_assistant.py、dvadmin/system/models.py 与 server_vue3/src/views/system/MyWork/UserIssue/index.vue、api.ts、crud.tsx 的真实代码，说明如何把 问题反馈 需求转换成 Codex 可执行的模型、接口、页面、权限和验收任务。

设计与需求

问题反馈 不能只按普通 CRUD 理解。当前模块复用了系统能力，但通过 modules/MyWork 路由和 ViewSet 调整了用户数据范围。交给 Codex 的任务需要明确复用来源、字段边界、接口路径、页面交互和权限验收，避免把系统后台页面直接搬到个人工作台而不处理个人范围。

需求层描述	设计层转换	Codex 代码生成方向
业务目标	管理用户提交的系统问题工单，支持问题类型、状态处理、页面定位、内容描述和管理员回复。	生成个人工作模块入口和业务说明
数据模型	$model 字段覆盖 status、title、category、name、router、content、reply、creator、create_datetime、update_datetime	生成序列化、筛选、表单回显和保存校验
页面结构	server_vue3/src/views/system/MyWork/UserIssue/index.vue、api.ts、crud.tsx	生成列表、筛选区、表单、详情或自定义按钮
接口规则	/api/MyWork/UserIssue/	保持 api.ts、ViewSet 和路由注册一致
权限验收	普通用户仅看自己，超级管理员可看全部	在后端 get_queryset 和前端按钮中约束
扩展能力	数据联动、审批流程、文件管理	只写源码中真实存在的能力

可以直接使用下面的Prompt进行模块功能的设计

请 Codex 基于教育管理系统真实源码设计“问题反馈”模块。

业务说明：管理用户提交的系统问题工单，支持问题类型、状态处理、页面定位、内容描述和管理员回复。
后端源码：server_backend/modules/MyWork/views_app/UserIssue.py、dvadmin/system/views/user_smart_assistant.py、dvadmin/system/models.py
前端源码：server_vue3/src/views/system/MyWork/UserIssue/index.vue、api.ts、crud.tsx
模型对象：UserIssue
字段范围：status、title、category、name、router、content、reply、creator、create_datetime、update_datetime
接口范围：/api/MyWork/UserIssue/
扩展能力边界：数据联动、审批流程、文件管理

请输出页面结构、数据模型、接口规则、权限验收、测试用例和代码生成任务。只允许使用源码中存在的字段、接口和页面状态。

后端设计

问题反馈 的后端重点不是重新造一套系统功能，而是在 modules/MyWork 下复用系统 ViewSet，并对列表查询的数据范围进行收敛。MyWork 侧继承系统 UserIssueViewSet，系统 ViewSet 已按超级管理员和普通用户划分查询范围。更新序列化器会调用 notify_user_action 发送工单更新提醒。

后端设计项	设计重点	Codex 生成方向
数据模型	$model 字段覆盖 status、title、category、name、router、content、reply、creator、create_datetime、update_datetime	生成序列化和基础校验
复用来源	继承系统 ViewSet 或使用系统模型	保留原有接口能力
查询范围	普通用户只看自己，超级管理员看全部	覆盖 get_queryset 或复用系统范围控制
接口路由	/api/MyWork/UserIssue/	注册到 modules/MyWork/urls.py
权限控制	新增、编辑、删除、处理按钮按角色显示	前后端同时约束

可以直接使用下面的Prompt进行后端代码的设计

请为“我的工作”中的问题反馈 模块设计或补齐后端代码。

后端源码范围：server_backend/modules/MyWork/views_app/UserIssue.py、dvadmin/system/views/user_smart_assistant.py、dvadmin/system/models.py
模型对象：UserIssue
字段范围：status、title、category、name、router、content、reply、creator、create_datetime、update_datetime
接口范围：/api/MyWork/UserIssue/

请复用当前系统模块已有 ViewSet 能力，并在 MyWork 路由下保证普通用户只能查看自己创建或接收的数据，超级管理员可以查看全部。请补齐路由注册、筛选查询、权限控制、异常响应和基础校验。

MyWork 侧继承系统 `UserIssueViewSet`，系统 ViewSet 已按超级管理员和普通用户划分查询范围。更新序列化器会调用 `notify_user_action` 发送工单更新提醒。

前端设计

问题反馈 的前端重点是让用户在个人工作台中高效查看、筛选和处理自己的数据。前端支持按状态、类型、页面和标题筛选。普通用户可新增问题，超级管理员显示“处理”按钮，表单中内容与回复使用富文本编辑器。

前端设计项	设计重点	Codex 生成方向
页面结构	server_vue3/src/views/system/MyWork/UserIssue/index.vue、api.ts、crud.tsx	生成 index.vue、pi.ts、crud.tsx 页面结构
接口封装	/api/MyWork/UserIssue/	统一封装列表、详情、保存、删除和自定义接口
列表筛选	按真实字段提供查询项	生成 FastCrud 查询和分页
表单回显	按 status、title、category、name、router、content、reply、creator、create_datetime、update_datetime 保证新增、编辑、详情一致	生成组件、校验和保存载荷
权限按钮	根据用户角色控制处理、删除、下载等按钮	生成按钮显示逻辑

可以直接使用下面的Prompt进行前端代码的设计

请为“我的工作”中的问题反馈 模块设计或补齐前端代码。

前端源码范围：server_vue3/src/views/system/MyWork/UserIssue/index.vue、api.ts、crud.tsx
接口范围：/api/MyWork/UserIssue/
字段范围：status、title、category、name、router、content、reply、creator、create_datetime、update_datetime
扩展能力边界：数据联动、审批流程、文件管理

请生成页面结构、列表查询、筛选区域、新增编辑表单、详情查看、权限按钮、保存回显和接口调用。字段、接口、按钮显示必须与后端真实代码一致。

前端支持按状态、类型、页面和标题筛选。普通用户可新增问题，超级管理员显示“处理”按钮，表单中内容与回复使用富文本编辑器。

扩展功能

问题反馈 的扩展能力来自当前源码，不按固定结构硬套。它们的共同价值是把个人工作台中的任务、消息、下载或反馈处理成可追踪、可回显、可验收的工作闭环。

扩展功能	主要用途	落地重点
数据联动	让问题类型、状态、页面路由、内容和回复回显一致	category、status、router、content、reply、角色按钮
审批流程	让问题反馈从新建、处理中、已完成形成可追踪处理流程	状态字典、回复内容、管理员处理、notify_user_action
文件管理	在问题内容和回复内容中支持富文本上传资源	editor-wang5 uploader、content、reply

数据联动

问题反馈 的数据联动 是源码中已经存在的业务能力，主要用于让问题类型、状态、页面路由、内容和回复回显一致。实现时需要关注category、status、router、content、reply、角色按钮，不能把没有代码支撑的 AI 生成、OCR、统计看板或导入导出写进模块。

交给 Codex 生成时，需要把接口、字段和权限边界写清楚。普通用户与超级管理员的数据范围、按钮显示、保存载荷和回显字段都要能在 PDD 中验收。

可以直接使用下面的Prompt进行数据联动设计

请为教育管理系统的问题反馈 模块实现数据联动。

能力用途：让问题类型、状态、页面路由、内容和回复回显一致。
落地重点：category、status、router、content、reply、角色按钮。

请实现状态筛选、类型筛选、页面跳转、管理员处理和保存后刷新。

请读取当前模块后端 ViewSet、复用的系统 ViewSet、前端 api.ts、crud.tsx 和 index.vue，按真实字段和真实接口补齐实现。不要新增源码不存在的功能。

审批流程

问题反馈 的审批流程 是源码中已经存在的业务能力，主要用于让问题反馈从新建、处理中、已完成形成可追踪处理流程。实现时需要关注状态字典、回复内容、管理员处理、notify_user_action，不能把没有代码支撑的 AI 生成、OCR、统计看板或导入导出写进模块。

交给 Codex 生成时，需要把接口、字段和权限边界写清楚。普通用户与超级管理员的数据范围、按钮显示、保存载荷和回显字段都要能在 PDD 中验收。

可以直接使用下面的Prompt进行审批流程设计

请为教育管理系统的问题反馈 模块实现审批流程。

能力用途：让问题反馈从新建、处理中、已完成形成可追踪处理流程。
落地重点：状态字典、回复内容、管理员处理、notify_user_action。

请按现有状态字典实现问题处理流程，更新后通知创建人。

请读取当前模块后端 ViewSet、复用的系统 ViewSet、前端 api.ts、crud.tsx 和 index.vue，按真实字段和真实接口补齐实现。不要新增源码不存在的功能。

文件管理

问题反馈 的文件管理 是源码中已经存在的业务能力，主要用于在问题内容和回复内容中支持富文本上传资源。实现时需要关注editor-wang5 uploader、content、reply，不能把没有代码支撑的 AI 生成、OCR、统计看板或导入导出写进模块。

交给 Codex 生成时，需要把接口、字段和权限边界写清楚。普通用户与超级管理员的数据范围、按钮显示、保存载荷和回显字段都要能在 PDD 中验收。

可以直接使用下面的Prompt进行文件管理功能设计

请为教育管理系统的问题反馈 模块实现文件管理。

能力用途：在问题内容和回复内容中支持富文本上传资源。
落地重点：editor-wang5 uploader、content、reply。

请按富文本编辑器上传逻辑处理内容附件，详情回显时保持资源 URL。

请读取当前模块后端 ViewSet、复用的系统 ViewSet、前端 api.ts、crud.tsx 和 index.vue，按真实字段和真实接口补齐实现。不要新增源码不存在的功能。

Codex开发标准

使用 Codex 开发 问题反馈 时，不能直接让它随意写代码，而要用需求边界、PDD、SOP、接口权限规则和验收标准约束开发过程。

SOP 标准

SOP 用于约束代码目录、文件职责和开发顺序。问题反馈 需要沿用 modules/MyWork 和 server_vue3/src/views/system/MyWork 目录。

ManageBak-ExamEdu/
├── server_backend/
│   └── modules/
│       └── MyWork/
│           ├── urls.py
│           └── views_app/
│               └── UserIssue.py
├── server_vue3/
│   └── src/
│       └── views/
│           └── system/
│               └── MyWork/
│                   └── UserIssue/
│                       ├── index.vue
│                       ├── api.ts
│                       └── crud.tsx
└── docs/
    └── modules/
        └── mywork-UserIssue/
            ├── pdd.md
            ├── api.md
            ├── test-cases.md
            └── codex-sop.md

开发阶段	Codex 执行目标	输出结果
模块设计	明确 问题反馈 的业务目标、字段、接口和权限范围	pdd.md
目录规划	按 MyWork 后端和前端目录规划文件职责	codex-sop.md
后端实现	补齐 ViewSet 复用、查询范围、路由和权限	后端模块代码
前端实现	补齐页面、接口封装、表格配置和表单	前端页面代码
数据联动	打通筛选、保存、详情和刷新	联动逻辑代码
扩展功能	补齐数据联动、审批流程、文件管理	扩展能力代码与验收记录
验收修复	按 PDD 检查功能、接口、权限和数据回显	验收记录与修复提交

可以直接使用下面的Prompt进行SOP撰写

请按照教育管理系统模块开发 SOP，从零实现或补齐“我的工作”中的问题反馈 模块。

开发前先输出目录结构，不要直接写代码。目录需要贴合当前项目：后端在 server_backend/modules/MyWork/，前端在 server_vue3/src/views/system/MyWork/UserIssue/，文档在 docs/modules/mywork-UserIssue/。

请先生成 pdd.md、api.md、test-cases.md 和 codex-sop.md，再根据文档生成项目代码。实现过程中只允许使用源码中真实存在的能力：数据联动、审批流程、文件管理。

PDD 标准

PDD 是 问题反馈 的设计与验收文档，用来约束 Codex 输出是否符合个人工作台的真实业务。

验收维度	验收标准	不通过表现
业务目标	管理用户提交的系统问题工单，支持问题类型、状态处理、页面定位、内容描述和管理员回复。	只生成系统后台 CRUD，缺少个人范围
页面结构	页面包含列表、筛选、详情、表单和必要操作	页面路径或按钮与源码不一致
数据模型	$model 字段覆盖 status、title、category、name、router、content、reply、creator、create_datetime、update_datetime	保存或回显字段缺失
接口规则	/api/MyWork/UserIssue/ 可被前端正确调用	前端封装与后端路由不一致
权限控制	普通用户仅看自己，超级管理员可看全部	普通用户可看到他人数据
测试用例	覆盖查询、新增、编辑、删除、详情和异常处理	只有描述，没有验收路径
数据联动	让问题类型、状态、页面路由、内容和回复回显一致，并能按真实接口验收	页面有入口但字段或接口不一致
审批流程	让问题反馈从新建、处理中、已完成形成可追踪处理流程，并能按真实接口验收	页面有入口但字段或接口不一致
文件管理	在问题内容和回复内容中支持富文本上传资源，并能按真实接口验收	页面有入口但字段或接口不一致

可以直接使用下面的Prompt进行PDD 验收

请根据 docs/modules/mywork-UserIssue/pdd.md 对“我的工作”中的问题反馈 模块进行 PDD 验收。

验收范围包括后端源码 server_backend/modules/MyWork/views_app/UserIssue.py、dvadmin/system/views/user_smart_assistant.py、dvadmin/system/models.py，前端源码 server_vue3/src/views/system/MyWork/UserIssue/index.vue、api.ts、crud.tsx。

请检查业务目标、页面结构、数据模型、接口规则、权限控制、测试用例和扩展能力。扩展能力范围限定为：数据联动、审批流程、文件管理。

请输出验收结果表，标记通过、未通过和需要修复的文件位置。不要只给结论，需要指出具体问题、影响范围和修复建议。

总结

问题反馈 模块的开发价值，不在于复制系统后台页面，而在于把个人工作相关的数据、任务和反馈收敛到用户自己的工作台中。普通用户和超级管理员的数据范围清晰，页面操作才符合教育管理系统的日常使用方式。

使用 Codex 开发这类模块时，PDD 定义业务边界和验收标准，SOP 约束目录结构和开发顺序，Prompt 把页面、模型、接口、权限和真实扩展能力交给 Codex 分阶段实现。