【Codex】用PPT文案额外描述优化课件生成细节

教育管理系统PPT文案额外描述用Codex自动生成项目代码

维护教案生成时可复用的额外要求文本，供 PPT 教案分镜、生成提示词和人工补充说明复用。它在教学中心里承接"额外要求库"的职责，让教师可以把常用风格、结构、讲解侧重点和课堂补充说明沉淀成可选择模板。

本文基于 server_backend/modules/TeachingCenter/models.py、server_backend/modules/TeachingCenter/views_app/LessonPlanAdditional.py、server_backend/modules/TeachingCenter/utils.py 与 server_vue3/src/views/modules/TeachingCenter/LessonPlanAdditional/index.vue、api.ts、crud.tsx 的真实代码，说明如何把PPT文案额外描述需求拆成字段、接口、页面、扩展能力和验收标准，再转换成 Codex 可执行的项目代码生成任务。

文章目录

• 设计与需求
• • 后端设计
  • 前端设计
• 扩展功能
• • 数据联动
• Codex开发标准
• • [SOP 标准](#SOP 标准)
  • [PDD 标准](#PDD 标准)
• 总结

设计与需求

PPT 文案额外描述需要放回教学中心业务场景中设计。源码中的 LessonPlanAdditional 字段很少，只有 title 和 additional，但它会被 LessonPlan 页面和 storyboardAction 组件通过 GetAdditionalList 拉取，作为分镜行里的补充要求候选项。交给 Codex 的任务必须写清楚页面结构、数据模型、接口规则、联动位置和权限验收，避免生成一个与 PPT 教案页面脱节的普通表格。
教学业务需求
PPT文案额外描述设计
页面结构
数据模型
接口规则
权限验收
Codex生成代码
教学模块交付

需求层描述	设计层转换	Codex 代码生成方向
业务目标	维护教案生成时可复用的额外要求文本，供 PPT教案分镜、生成提示词和人工补充说明复用。	生成模块入口、页面结构和业务说明
数据模型	LessonPlanAdditional 字段覆盖 title、additional、creator_name、create_datetime、update_datetime	生成序列化、字段校验、查询筛选和保存回显
页面结构	server_vue3/src/views/modules/TeachingCenter/LessonPlanAdditional/index.vue、api.ts、crud.tsx	生成列表、筛选区、表单、详情或自定义组件
接口规则	/api/TeachingCenter/LessonPlanAdditional/	保持 api.ts、ViewSet 和路由注册一致
权限验收	按教师、管理员和资源处理场景约束按钮与接口	在 PDD 中列出操作范围和异常用例
扩展能力	数据联动	只实现源码中真实存在的扩展入口和服务边界

这里的 creator_name、create_datetime、update_datetime 来自 CoreModel 通用字段，不是 LessonPlanAdditional 自己定义的业务字段。Codex 生成表单时不应让用户手动编辑创建者和时间字段，列表搜索可以保留 creator_name，正文维护只围绕 title 和 additional。

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

请 Codex 基于教育管理系统真实源码设计"PPT文案额外描述"模块。

业务说明：维护教案生成时可复用的额外要求文本，供 PPT教案分镜、生成提示词和人工补充说明复用。
后端源码：server_backend/modules/TeachingCenter/models.py、server_backend/modules/TeachingCenter/views_app/LessonPlanAdditional.py、server_backend/modules/TeachingCenter/utils.py
前端源码：server_vue3/src/views/modules/TeachingCenter/LessonPlanAdditional/index.vue、api.ts、crud.tsx
模型对象：LessonPlanAdditional
字段范围：title、additional、creator_name、create_datetime、update_datetime
接口范围：/api/TeachingCenter/LessonPlanAdditional/
扩展能力边界：数据联动

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

后端设计

PPT 文案额外描述的后端设计重点不是堆 CRUD 接口，而是让教学数据能被 PPT 教案页面稳定复用。后端 LessonPlanAdditionalViewSet 位于 server_backend/modules/TeachingCenter/views_app/LessonPlanAdditional.py，继承 LessonPlanAdditionalViewSetUtilsMixin 和 CustomModelViewSet，http_method_names = ['get', 'post', 'put']，使用 CustomModelRefSerializer(model=LessonPlanAdditional)。筛选字段包括 creator_name、title、additional，接口前缀为 /api/TeachingCenter/LessonPlanAdditional/。

源码里没有单独的 LLM 生成、OCR、导入导出或审批动作。LessonPlanAdditionalViewSetUtilsMixin 只是保留模块扩展混入点，文章和 Prompt 不能把它写成已经存在的复杂服务。

后端设计项	设计重点	Codex 生成方向
数据模型	LessonPlanAdditional 字段覆盖 title、additional、creator_name、create_datetime、update_datetime	生成序列化、字段映射和保存校验
查询筛选	按后端 filterset_class、SearchFilter 和前端查询项对齐	生成筛选参数和列表接口
自定义接口	/api/TeachingCenter/LessonPlanAdditional/	生成 action、参数校验和返回结构
权限控制	按当前项目权限体系约束新增、编辑、删除和处理动作	生成前后端一致的权限点
异常处理	参数缺失、记录不存在、资源缺失、任务失败要返回明确消息	生成可验收错误响应
方法边界	后端只开放 get/post/put	删除需按项目软删除规则处理，不生成未开放的 DELETE 假设
复用入口	LessonPlan 页面通过 GetAdditionalList 读取	保持列表响应字段与前端选项映射一致

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

请为教育管理系统教学中心的PPT文案额外描述模块设计或补齐后端代码。

后端源码范围：server_backend/modules/TeachingCenter/models.py、server_backend/modules/TeachingCenter/views_app/LessonPlanAdditional.py、server_backend/modules/TeachingCenter/utils.py
模型对象：LessonPlanAdditional
字段范围：title、additional、creator_name、create_datetime、update_datetime
接口范围：/api/TeachingCenter/LessonPlanAdditional/

请按当前项目技术栈生成模型字段、序列化规则、接口视图、路由注册、筛选查询、权限控制和基础校验。自定义 action 只能来自源码或 PDD 明确说明，不能额外增加不存在的业务入口。

后端 `LessonPlanAdditionalViewSet` 是轻量配置模块，筛选字段包括 creator_name、title、additional，提供列表、新增、编辑和软删除。

前端设计

PPT 文案额外描述的前端设计重点不是把字段堆到表格里，而是让教师或管理员维护可复用的补充要求模板。LessonPlanAdditional/crud.tsx 中 renderAdditionalPopover 用于长文本悬浮查看，列表列包含创建者、标题和额外描述，表单要求 title 和 additional 必填，额外描述使用 textarea 且设置多行输入。

复用发生在 LessonPlan/api.ts 和 LessonPlan/components/storyboardAction/index.vue。GetAdditionalList 请求 /api/TeachingCenter/LessonPlanAdditional/，组件把返回值映射成 id、title、content，选择某个额外描述后写入分镜行的 additionalTitle 和 additional。这才是本模块的数据联动边界。

前端设计项	设计重点	Codex 生成方向
页面结构	server_vue3/src/views/modules/TeachingCenter/LessonPlanAdditional/index.vue、api.ts、crud.tsx	生成 index.vue、api.ts、crud.tsx 与必要组件
接口封装	/api/TeachingCenter/LessonPlanAdditional/	统一封装列表、详情、保存、删除和自定义 action
表单结构	按 title、additional、creator_name、create_datetime、update_datetime 组织新增、编辑和回显字段	生成字段组件、校验规则和保存载荷
列表查询	与后端筛选字段对齐	生成查询项、分页、刷新和重置逻辑
资源交互	只接入源码中已有的预览、导出、生成或任务入口	生成按钮、弹窗、轮询和错误提示
长文展示	additional 列使用 popover 展示完整内容	生成省略显示、悬浮查看和换行保留
下游复用	storyboardAction 选择模板后回填分镜行	生成 additionalTitle、additional 字段映射

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

请为教育管理系统教学中心的PPT文案额外描述模块设计或补齐前端代码。

前端源码范围：server_vue3/src/views/modules/TeachingCenter/LessonPlanAdditional/index.vue、api.ts、crud.tsx
接口范围：/api/TeachingCenter/LessonPlanAdditional/
字段范围：title、additional、creator_name、create_datetime、update_datetime
扩展能力边界：数据联动

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

前端需要让用户维护额外描述标题和正文，并在 PPT教案页面通过 `GetAdditionalList` 拉取这些补充要求。

扩展功能

PPT 文案额外描述的扩展能力来自真实的数据联动。它不负责直接生成教案，也不直接调用 LLM；它提供可复用的补充要求选项，供 PPT 教案分镜和生成流程读取。这个能力直接影响教师能否把常用要求复用到多个分镜行。

扩展功能	主要用途	落地重点
数据联动	让额外描述库与 PPT教案生成页面的补充要求选择保持一致	GetAdditionalList、title、additional、保存回显

数据联动

PPT 文案额外描述的数据联动来自当前源码中的真实字段、接口和前端交互。LessonPlanAdditional 独立页面维护 title 和 additional；LessonPlan/api.ts 的 GetAdditionalList 拉取模板；storyboardAction/index.vue 的 loadAdditionalList 把模板映射为 { id, title, content }；选择模板后，handleAdditionalSelect 将 title 写入 additionalTitle，将 content 写入 additional。

交给 Codex 生成时，必须强调模板列表是"读取后回填页面"，不是自动覆盖正式教案内容。教师仍可编辑分镜行中的 additionalTitle 和 additional，保存时这些字段随 LessonPlan 分镜数据提交。
结果阶段
处理阶段
输入阶段
业务参数
页面操作
组装请求
调用接口
转换结果
内容回显
列表刷新

交给 Codex 生成时，要把请求参数、返回结构、状态提示和保存边界写清楚。涉及生成、识别、预览或导出时，结果应先回填页面或进入下载中心，由人工确认后再进入正式数据。

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

请为教育管理系统的PPT文案额外描述模块实现数据联动。

能力用途：让额外描述库与 PPT教案生成页面的补充要求选择保持一致。
落地重点：GetAdditionalList、title、additional、保存回显。

请实现额外描述列表维护，并在 LessonPlan 页面加载可复用 additional 选项。

请读取当前后端 ViewSet、工具类、任务文件、前端 api.ts、crud.tsx、index.vue 和组件目录，按真实字段与接口补齐代码。不要新增源码中不存在的能力。

Codex开发标准

使用 Codex 开发PPT文案额外描述时，需要用需求边界、PDD、SOP、接口权限规则和验收标准约束开发过程。教学中心模块通常会跨模型、任务、下载中心和前端组件，必须先读上下文，再分阶段生成代码。
验收交付
Codex开发
模块设计
输入约束
需求边界
PDD设计
SOP目录规范
接口与权限规则
后端设计
前端设计
能力边界
读取上下文
生成后端代码
生成前端代码
补齐扩展能力
功能自检
PDD验收
问题修复
模块交付

SOP 标准

SOP 用于约束代码目录、文件职责和开发顺序。PPT文案额外描述需要沿用 modules/TeachingCenter 和 server_vue3/src/views/modules/TeachingCenter 目录。

ManageBak-ExamEdu/
├── server_backend/
│   └── modules/
│       └── TeachingCenter/
│           ├── models.py
│           ├── urls.py
│           ├── utils.py
│           ├── tasks.py
│           └── views_app/
│               └── LessonPlanAdditional.py
├── server_vue3/
│   └── src/
│       └── views/
│           └── modules/
│               └── TeachingCenter/
│                   └── LessonPlanAdditional/
│                       ├── index.vue
│                       ├── api.ts
│                       ├── crud.tsx
│                       └── components/
└── docs/
    └── modules/
        └── teaching-LessonPlanAdditional/
            ├── pdd.md
            ├── api.md
            ├── test-cases.md
            └── codex-sop.md

开发阶段	Codex 执行目标	输出结果
模块设计	明确PPT文案额外描述的业务目标、字段、接口和权限范围	pdd.md
目录规划	按 TeachingCenter 后端和前端目录规划文件职责	codex-sop.md
后端实现	补齐 ViewSet、序列化、筛选、自定义 action 和路由	后端模块代码
前端实现	补齐页面、接口封装、表格配置、表单和组件	前端页面代码
数据联动	打通筛选、保存、详情、预览和刷新	联动逻辑代码
扩展功能	补齐数据联动	扩展能力代码与验收记录
验收修复	按 PDD 检查功能、接口、权限和数据回显	验收记录与修复提交

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

请按照教育管理系统模块开发 SOP，从零实现或补齐教学中心的PPT文案额外描述模块。

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

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

PDD 标准

PDD 是PPT文案额外描述的设计与验收文档，用来约束 Codex 输出是否符合真实教学业务。

验收维度	验收标准	不通过表现
业务目标	维护教案生成时可复用的额外要求文本，供 PPT教案分镜、生成提示词和人工补充说明复用。	只生成普通 CRUD，缺少教学业务字段
页面结构	页面包含列表、筛选、表单、详情和必要资源操作	页面路径或按钮与源码不一致
数据模型	LessonPlanAdditional 字段覆盖 title、additional、creator_name、create_datetime、update_datetime	保存或回显字段缺失
接口规则	/api/TeachingCenter/LessonPlanAdditional/ 可被前端正确调用	前端封装与后端路由不一致
权限控制	操作按钮和后端接口遵守当前项目权限体系	只隐藏按钮，接口层无约束
测试用例	覆盖查询、新增、编辑、删除、详情和异常处理	只有描述，没有验收路径
数据联动	让额外描述库与 PPT教案生成页面的补充要求选择保持一致，并能按源码字段和接口验收	页面入口、接口或回显不一致

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

请根据 docs/modules/teaching-LessonPlanAdditional/pdd.md 对教学中心的PPT文案额外描述模块进行 PDD 验收。

验收范围包括后端源码 server_backend/modules/TeachingCenter/models.py、server_backend/modules/TeachingCenter/views_app/LessonPlanAdditional.py、server_backend/modules/TeachingCenter/utils.py，前端源码 server_vue3/src/views/modules/TeachingCenter/LessonPlanAdditional/index.vue、api.ts、crud.tsx。

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

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

总结

PPT文案额外描述模块的开发价值，不在于生成一张能增删改查的后台页面，而在于把教学内容、资源生成、预览检查和交付结果组织成可维护的业务闭环。字段、接口、页面和任务状态保持一致，教学中心后续扩展才不会被数据结构拖住。

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