【Codex】用下载中心模块集中管理个人导出文件
管理当前用户可见的下载任务、任务状态、文件名、文件大小和下载地址。 它在“我的工作”中服务个人待办、个人记录和工作反馈,核心价值是让普通用户只看到自己的数据,让管理员能统一处理。

本文基于 server_backend/modules/MyWork/views_app/DownloadCenter.py、server_backend/modules/MyWork/urls.py、dvadmin/system/views/download_center.py 与 server_vue3/src/views/system/MyWork/DownloadCenter/index.vue、api.ts、crud.tsx 的真实代码,说明如何把 下载中心 需求转换成 Codex 可执行的模型、接口、页面、权限和验收任务。
设计与需求
下载中心 不能只按普通 CRUD 理解。当前模块复用了系统能力,但通过 modules/MyWork 路由和 ViewSet 调整了用户数据范围。交给 Codex 的任务需要明确复用来源、字段边界、接口路径、页面交互和权限验收,避免把系统后台页面直接搬到个人工作台而不处理个人范围。
| 需求层描述 | 设计层转换 | Codex 代码生成方向 |
|---|---|---|
| 业务目标 | 管理当前用户可见的下载任务、任务状态、文件名、文件大小和下载地址。 | 生成个人工作模块入口和业务说明 |
| 数据模型 | $model 字段覆盖 task_status、task_name、file_name、size、url、creator、creator_name、create_datetime | 生成序列化、筛选、表单回显和保存校验 |
| 页面结构 | server_vue3/src/views/system/MyWork/DownloadCenter/index.vue、api.ts、crud.tsx | 生成列表、筛选区、表单、详情或自定义按钮 |
| 接口规则 | /api/MyWork/DownloadCenter/ | 保持 api.ts、ViewSet 和路由注册一致 |
| 权限验收 | 普通用户仅看自己,超级管理员可看全部 | 在后端 get_queryset 和前端按钮中约束 |
| 扩展能力 | 数据联动、文件管理 | 只写源码中真实存在的能力 |
可以直接使用下面的Prompt进行模块功能的设计
请 Codex 基于教育管理系统真实源码设计“下载中心”模块。
业务说明:管理当前用户可见的下载任务、任务状态、文件名、文件大小和下载地址。
后端源码:server_backend/modules/MyWork/views_app/DownloadCenter.py、server_backend/modules/MyWork/urls.py、dvadmin/system/views/download_center.py
前端源码:server_vue3/src/views/system/MyWork/DownloadCenter/index.vue、api.ts、crud.tsx
模型对象:DownloadCenter
字段范围:task_status、task_name、file_name、size、url、creator、creator_name、create_datetime
接口范围:/api/MyWork/DownloadCenter/
扩展能力边界:数据联动、文件管理
请输出页面结构、数据模型、接口规则、权限验收、测试用例和代码生成任务。只允许使用源码中存在的字段、接口和页面状态。
后端设计
下载中心 的后端重点不是重新造一套系统功能,而是在 modules/MyWork 下复用系统 ViewSet,并对列表查询的数据范围进行收敛。DownloadCenterViewSet 继承系统下载中心 ViewSet,列表场景下超级管理员查看全部,普通用户只查看 creator=user.id 的下载任务。
| 后端设计项 | 设计重点 | Codex 生成方向 |
|---|---|---|
| 数据模型 | $model 字段覆盖 task_status、task_name、file_name、size、url、creator、creator_name、create_datetime | 生成序列化和基础校验 |
| 复用来源 | 继承系统 ViewSet 或使用系统模型 | 保留原有接口能力 |
| 查询范围 | 普通用户只看自己,超级管理员看全部 | 覆盖 get_queryset 或复用系统范围控制 |
| 接口路由 | /api/MyWork/DownloadCenter/ | 注册到 modules/MyWork/urls.py |
| 权限控制 | 新增、编辑、删除、处理按钮按角色显示 | 前后端同时约束 |
可以直接使用下面的Prompt进行后端代码的设计
请为“我的工作”中的下载中心 模块设计或补齐后端代码。
后端源码范围:server_backend/modules/MyWork/views_app/DownloadCenter.py、server_backend/modules/MyWork/urls.py、dvadmin/system/views/download_center.py
模型对象:DownloadCenter
字段范围:task_status、task_name、file_name、size、url、creator、creator_name、create_datetime
接口范围:/api/MyWork/DownloadCenter/
请复用当前系统模块已有 ViewSet 能力,并在 MyWork 路由下保证普通用户只能查看自己创建或接收的数据,超级管理员可以查看全部。请补齐路由注册、筛选查询、权限控制、异常响应和基础校验。
`DownloadCenterViewSet` 继承系统下载中心 ViewSet,列表场景下超级管理员查看全部,普通用户只查看 `creator=user.id` 的下载任务。
前端设计
下载中心 的前端重点是让用户在个人工作台中高效查看、筛选和处理自己的数据。前端隐藏新增、编辑、删除,只在 task_status === 2 时显示“下载文件”按钮,并通过 getBaseURL(row.url) 打开文件。
| 前端设计项 | 设计重点 | Codex 生成方向 |
|---|---|---|
| 页面结构 | server_vue3/src/views/system/MyWork/DownloadCenter/index.vue、api.ts、crud.tsx | 生成 index.vue、pi.ts、crud.tsx 页面结构 |
| 接口封装 | /api/MyWork/DownloadCenter/ | 统一封装列表、详情、保存、删除和自定义接口 |
| 列表筛选 | 按真实字段提供查询项 | 生成 FastCrud 查询和分页 |
| 表单回显 | 按 task_status、task_name、file_name、size、url、creator、creator_name、create_datetime 保证新增、编辑、详情一致 | 生成组件、校验和保存载荷 |
| 权限按钮 | 根据用户角色控制处理、删除、下载等按钮 | 生成按钮显示逻辑 |
可以直接使用下面的Prompt进行前端代码的设计
请为“我的工作”中的下载中心 模块设计或补齐前端代码。
前端源码范围:server_vue3/src/views/system/MyWork/DownloadCenter/index.vue、api.ts、crud.tsx
接口范围:/api/MyWork/DownloadCenter/
字段范围:task_status、task_name、file_name、size、url、creator、creator_name、create_datetime
扩展能力边界:数据联动、文件管理
请生成页面结构、列表查询、筛选区域、新增编辑表单、详情查看、权限按钮、保存回显和接口调用。字段、接口、按钮显示必须与后端真实代码一致。
前端隐藏新增、编辑、删除,只在 `task_status === 2` 时显示“下载文件”按钮,并通过 `getBaseURL(row.url)` 打开文件。
扩展功能
下载中心 的扩展能力来自当前源码,不按固定结构硬套。它们的共同价值是把个人工作台中的任务、消息、下载或反馈处理成可追踪、可回显、可验收的工作闭环。
| 扩展功能 | 主要用途 | 落地重点 |
|---|---|---|
| 数据联动 | 让任务状态、下载按钮和文件 URL 保持一致 | task_status、url、getBaseURL、列表刷新 |
| 文件管理 | 查看下载中心任务并打开已完成文件 | 文件名、文件大小、下载地址、任务状态 |
数据联动
下载中心 的数据联动 是源码中已经存在的业务能力,主要用于让任务状态、下载按钮和文件 URL 保持一致。实现时需要关注task_status、url、getBaseURL、列表刷新,不能把没有代码支撑的 AI 生成、OCR、统计看板或导入导出写进模块。
交给 Codex 生成时,需要把接口、字段和权限边界写清楚。普通用户与超级管理员的数据范围、按钮显示、保存载荷和回显字段都要能在 PDD 中验收。
可以直接使用下面的Prompt进行数据联动设计
请为教育管理系统的下载中心 模块实现数据联动。
能力用途:让任务状态、下载按钮和文件 URL 保持一致。
落地重点:task_status、url、getBaseURL、列表刷新。
下载按钮只在 task_status 为 2 时显示,点击时用 getBaseURL 处理 url。列表筛选支持任务状态、任务名和文件名。
请读取当前模块后端 ViewSet、复用的系统 ViewSet、前端 api.ts、crud.tsx 和 index.vue,按真实字段和真实接口补齐实现。不要新增源码不存在的功能。
文件管理
下载中心 的文件管理 是源码中已经存在的业务能力,主要用于查看下载中心任务并打开已完成文件。实现时需要关注文件名、文件大小、下载地址、任务状态,不能把没有代码支撑的 AI 生成、OCR、统计看板或导入导出写进模块。
交给 Codex 生成时,需要把接口、字段和权限边界写清楚。普通用户与超级管理员的数据范围、按钮显示、保存载荷和回显字段都要能在 PDD 中验收。
可以直接使用下面的Prompt进行文件管理功能设计
请为教育管理系统的下载中心 模块实现文件管理。
能力用途:查看下载中心任务并打开已完成文件。
落地重点:文件名、文件大小、下载地址、任务状态。
请实现下载中心列表、任务状态展示、已完成任务下载按钮和普通用户数据范围。
请读取当前模块后端 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/
│ └── DownloadCenter.py
├── server_vue3/
│ └── src/
│ └── views/
│ └── system/
│ └── MyWork/
│ └── DownloadCenter/
│ ├── index.vue
│ ├── api.ts
│ └── crud.tsx
└── docs/
└── modules/
└── mywork-DownloadCenter/
├── 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/DownloadCenter/,文档在 docs/modules/mywork-DownloadCenter/。
请先生成 pdd.md、api.md、test-cases.md 和 codex-sop.md,再根据文档生成项目代码。实现过程中只允许使用源码中真实存在的能力:数据联动、文件管理。
PDD 标准
PDD 是 下载中心 的设计与验收文档,用来约束 Codex 输出是否符合个人工作台的真实业务。
| 验收维度 | 验收标准 | 不通过表现 |
|---|---|---|
| 业务目标 | 管理当前用户可见的下载任务、任务状态、文件名、文件大小和下载地址。 | 只生成系统后台 CRUD,缺少个人范围 |
| 页面结构 | 页面包含列表、筛选、详情、表单和必要操作 | 页面路径或按钮与源码不一致 |
| 数据模型 | $model 字段覆盖 task_status、task_name、file_name、size、url、creator、creator_name、create_datetime | 保存或回显字段缺失 |
| 接口规则 | /api/MyWork/DownloadCenter/ 可被前端正确调用 | 前端封装与后端路由不一致 |
| 权限控制 | 普通用户仅看自己,超级管理员可看全部 | 普通用户可看到他人数据 |
| 测试用例 | 覆盖查询、新增、编辑、删除、详情和异常处理 | 只有描述,没有验收路径 |
| 数据联动 | 让任务状态、下载按钮和文件 URL 保持一致,并能按真实接口验收 | 页面有入口但字段或接口不一致 |
| 文件管理 | 查看下载中心任务并打开已完成文件,并能按真实接口验收 | 页面有入口但字段或接口不一致 |
可以直接使用下面的Prompt进行PDD 验收
请根据 docs/modules/mywork-DownloadCenter/pdd.md 对“我的工作”中的下载中心 模块进行 PDD 验收。
验收范围包括后端源码 server_backend/modules/MyWork/views_app/DownloadCenter.py、server_backend/modules/MyWork/urls.py、dvadmin/system/views/download_center.py,前端源码 server_vue3/src/views/system/MyWork/DownloadCenter/index.vue、api.ts、crud.tsx。
请检查业务目标、页面结构、数据模型、接口规则、权限控制、测试用例和扩展能力。扩展能力范围限定为:数据联动、文件管理。
请输出验收结果表,标记通过、未通过和需要修复的文件位置。不要只给结论,需要指出具体问题、影响范围和修复建议。
总结
下载中心 模块的开发价值,不在于复制系统后台页面,而在于把个人工作相关的数据、任务和反馈收敛到用户自己的工作台中。普通用户和超级管理员的数据范围清晰,页面操作才符合教育管理系统的日常使用方式。
使用 Codex 开发这类模块时,PDD 定义业务边界和验收标准,SOP 约束目录结构和开发顺序,Prompt 把页面、模型、接口、权限和真实扩展能力交给 Codex 分阶段实现。
葡萄城是专业的软件开发技术和低代码平台提供商,聚焦软件开发技术,以“赋能开发者”为使命,致力于通过表格控件、低代码和BI等各类软件开发工具和服务,一站式满足开发者需求,帮助企业提升开发效率并创新开发模式。
更多推荐



所有评论(0)