需在codex中实现教学统计数据可视化与实时联动:确认教案主体、整合教案、教学动画三类统计对象已纳入设计层及接口字段;注册前端菜单;生成带缓存与权限的统计组件并执行数据库迁移;配置excel或简道云实时同步;前端绑定动态api渲染矩阵图表。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要在Codex中快速生成教学统计类数据可视化图表,并让前端看板与数据库真实业务数据联动,不是静态截图也不是手动维护的Excel表格。
确认统计对象与口径是否已纳入Codex设计层
打开Codex项目根目录下的SOP标准文档,核对“教学中心统计”模块是否已明确定义三个统计对象:教案主体(LessonPlanMaster)、整合教案(LessonPlan)、教学动画(TeachingAnimation)。
检查_teaching_center_detail接口返回结构中是否包含这三组detail字段——若缺失任一组,后续前端矩阵树图将无法渲染对应资源覆盖状态。
执行命令codex check --module teaching,验证当前分支是否已注册菜单入口/system/MyWork/TeachingCenterStats。未注册则前端路由404,所有图表组件加载失败。
生成带缓存与权限控制的统计组件
在终端运行:codex generate stats:teaching --with-cache --with-permission。
该命令会自动生成以下内容:教学统计Hero区、教材分类Tab导航、学科结构树图、年级学科数量矩阵表格;同时注入角色可见性逻辑,确保只有teaching_admin和content_editor角色能访问该页面。
【必须执行】生成后立即运行make migrate同步数据库缓存表stats_cache_teaching,否则前端请求SiteStatsViewSet.build_application_section_data("teaching")将返回空数据。
Excel端配置实时数据联动
方法一:使用Excel内置数据连接(推荐中小型部署)
1. 打开Excel → 【数据】→【获取外部数据】→【从SQL Server】→输入Codex部署库地址(如codex-prod.internal:1433)及只读账号。
2. 在查询编辑器中粘贴如下SQL,确保字段名与Codex统计口径完全一致:
SELECT category AS textbook_category, grade, subject, COUNT(*) AS count FROM lessonplanmaster GROUP BY category, grade, subject;
3. 加载至工作表后,选中结果区域 → 【插入】→【透视图】→拖入textbook_category到筛选器、grade和subject到行、count到值;右键透视图→【刷新数据】即可实时拉取最新统计快照。
方法二:用简道云零代码平台桥接(适合无DBA权限场景)
登录简道云 → 新建应用 → 添加「数据源」→选择「MySQL」→填写Codex生产库连接信息 → 启用自动同步(间隔5分钟)→ 拖拽「仪表盘」组件 → 绑定同步过来的lessonplanmaster表 → 插入「矩阵树图」组件,字段映射为category/grade/subject/count。
注意:简道云同步需确保Codex数据库开放外网白名单IP,且用户密码不能含特殊字符@或/,否则连接报错。
前端矩阵图表绑定动态数据源
进入Codex前端src/views/teaching/TeachingCenterStats.vue文件。
定位到setup()函数内const matrixData = ref([])定义处。
将原有mock数据替换为真实API调用:
const { data } = await useAsyncData('teaching-matrix', () => $fetch('/api/v1/stats/teaching/matrix'));
matrixData.value = data.value || [];
确保/api/v1/stats/teaching/matrix接口已在后端SiteStatsViewSet中实现,且返回结构为嵌套二维数组,形如[[{category:"小学语文",grade:"三年级",subject:"阅读",count:12}],...]——格式不匹配会导致前端矩阵树图渲染为空白格子。











