智慧中医系统要解决的不是单一页面展示问题而是如何把中医资讯、知识库、问诊思路、采集任务、数据处理与 Django 服务组织成可持续演进的数字平台。读完本文后可以独立检查项目边界、数据链路、技术组件、版本演进、模块阅读顺序以及今后用 Codex 辅助开发时应如何写需求、拆任务和验收。文章目录项目定位与目标系统架构与数据链路模块地图与阅读顺序Codex项目开发方法总结项目定位与目标智慧中医系统的产品初衷来自作者在 2018 年至 2020 年接触中医相关方向后的项目实践。原稿中的目标并不是做一个单点工具而是希望利用 Python、Django、Scrapy、数据处理、文本分类和前后端交互能力把互联网与书籍中能够整理的中医相关信息进行采集、管理、展示与持续更新形成一个面向后续学习者的综合参考案例。项目定位可以概括为“智慧中医健康数字服务平台”。它既包含 CMS 管理平台的内容组织能力也包含数据采集、数据清洗、API 服务、Web 前端、用户功能、问诊系统、知识库、资讯应用等方向。原稿还提到项目长期维护、版本更替和栏目文章保留因此本篇更适合作为总览文章而不是某一个后端应用或前端页面的实现教程。维度原稿可核对内容总览中的定位产品方向智慧中医、健康数字服务、CMS 管理平台、中医问诊系统面向中医内容管理、学习参考、资讯展示与问诊方向探索的综合平台技术主线Python、Django 3.x、Scrapy、Gerapy、pandas、pymysql、pymongo、Django REST framework以 Python Web 与数据工程为核心的全链路项目数据来源处理采集 CMS 平台需要的内容数据经过处理后整合为 Django API 接口需要的形式从采集到清洗、入库、接口、前端展示的内容数据链路智能化探索基于 CNN 与 RNN 的文本多分类模型用于抓取文章自动多分类等 NLP 场景的算法模块展示与运营站点数据统计、Web 前端、用户功能后台、Articles、Users、General_Data、My_Home支撑内容展示、用户交互和基础数据管理历史版本V1.0、V2.0、V3.0从商业项目雏形到健康数字服务平台再到填坑和扩展阶段原稿还记录了一项中医科研成果《Application research on quantitative prediction of traditional Chinese medicine syndrome differentiation based on Ensemble Learning》中文题名为“基于集成学习的中医问诊辨证预测应用研究”发表于 2020 年卷号 64、期号 1、页码 46-56DOI 为 10.1504/IJCAT.2020.111087。该信息说明项目作者在中医问诊与辨证预测方向有过科研积累但本文不把论文内容扩展为系统已经具备的线上能力。系统架构与数据链路从原稿可核对的信息看系统由数据采集、数据处理、算法分类、数据分析、数据产品、API 服务和 Django Web 系统组成。采集层使用 Scrapy 与 Gerapy处理层使用 pandas、pymysql、pymongo服务层包含 Django 3.x 与 django REST framework展示层包含 Web 前端、管理后台、用户交互和站点统计算法层包含 CNN 与 RNN 文本多分类模型。中医相关内容数据源Scrapy 数据采集Gerapy 爬虫部署与任务管理pandas 数据处理pymysql / pymongo 数据整合Django 后端应用django REST framework APIWeb 前端页面管理后台CNN / RNN 文本多分类用户交互与内容浏览资讯、知识库、用户、通用数据管理站点数据统计moviepy 图文转视频探索模块层级组件或能力原稿描述可检查边界数据采集模块Scrapy 爬虫框架分布式采集 CMS 平台需要的内容数据信息原稿只说明采集方向不包含具体目标站点、字段清单或运行结果数据采集管理Gerapy 爬虫管理框架进行爬虫脚本部署任务的管理可作为任务管理入口理解不应扩展为已上线调度中心数据处理模块pandas、pymysql、pymongo对抓取数据进行处理整合成 Django API 接口需要的形式可确认处理工具链但不能推断具体库表结构算法模型CNN、RNN 文本多分类模型基于深度学习设计文本多分类模型可对应“抓取文章自动多分类算法模型”栏目数据分析模块站点数据统计进行简单访问数据分析原稿未给出指标口径、报表截图或统计 SQL数据产品moviepy结合文本转视频的自媒体内容原稿说明“内容待整理后放出”不能写成成熟功能API 服务django REST framework开发数据 API 接口服务产品逻辑暂未想好可作为接口技术储备不应虚构接口返回系统开发Django 3.x进行前后端分离系统开发V1.0 与 V2.0 文章索引中包含后端、前端和交互内容Scrapy 在总览中承担数据采集入口角色适合将资讯、知识库或其他可采集内容整理为后续 CMS 与 API 可用的数据源。原稿强调“分布式采集 CMS 平台需要的内容数据信息”因此这里保留“采集内容数据”的边界不扩展为医学诊断数据采集。Gerapy 的位置在采集任务管理侧。它用于爬虫脚本部署任务的管理和 Scrapy 共同构成“采集脚本开发、部署、任务管理”的基础闭环。总览文章只确认其管理框架角色不补充旧稿中没有出现的部署路径、服务端口或任务截图说明。数据处理层将抓取数据整理成 Django API 接口所需的形态。原稿同时出现 pandas、pymysql、pymongo说明处理环节可能同时面对结构化整理、关系型数据库写入和 MongoDB 数据处理等任务但本篇不推断具体表名、集合名或字段约束。算法层的重点是文本多分类。原稿明确写到“基于深度学习中卷积神经网络 CNN 和循环神经网络 RNN 设计的文本多分类模型”并在专栏索引中对应“基于深度学习抓取文章自动多分类算法模型”。因此它更适合服务于文章分类、内容归类与资讯管理而不是直接写成诊断结论生成模块。数据分析层目前是基础站点数据统计用于简单访问数据分析。它可以作为运营观察入口但原稿没有给出访问量、用户留存、来源渠道等具体指标定义因此检查时应只确认是否存在统计展示思路而不把它当作完整数据化运营平台。moviepy 相关内容属于数据产品探索原稿描述为“结合文本转视频的自媒体内容”并说明内容待整理后放出。它与主系统的资讯内容生产、内容再加工有关但在总览中应归入扩展能力而不是核心业务闭环。Django 3.x 是系统开发主框架承接后端应用、API、管理后台与前后端分离开发内容。原稿中 V1.0 包含后台 API、Web 前端、中医问诊系统V2.0 包含重写数据后台 API、重写 Web 前端、增加前后端交互 API、增加用户功能后台功能这些构成了项目从采集数据到 Web 服务的主链路。模块地图与阅读顺序本项目不是单篇文章能够完整覆盖的系统。原稿提供了专栏文章索引覆盖项目整体介绍、中医学习笔记、数据管理模块、算法模型应用、V1.0 项目介绍、V2.0 项目介绍、问题汇总以及待更新的 UGC 自媒体和数据化管理运营。阅读时应先理解产品与数据链路再进入 Django 后端、前端 API、具体应用和可视化页面。阅读阶段对应原稿栏目应关注的问题适合检查的成果总览阶段项目整体介绍系统为何存在、面向哪些中医数字服务场景、有哪些技术组件能说清采集、处理、API、前端、后台、问诊和算法之间的关系理论阶段中医学习笔记中医问诊学习与开发原理理论基础能区分中医理论学习内容与系统工程实现内容采集阶段数据管理模块Scrapy 环境、爬虫目标、数据准备、采集模板、Gerapy 管理能定位数据如何进入平台知道采集管理与数据清洗的边界处理阶段数据 NLP 的数据处理抓取数据如何整理为 Django API 可用形式能检查 pandas、pymysql、pymongo 在链路中的职责算法阶段算法模型应用抓取文章自动多分类算法模型能判断 CNN、RNN 文本分类用于内容归类而非虚构诊疗结论V1.0 阶段基于 Python 技术的智慧中医商业项目产品思路、资讯数据、机器学习问诊、Django 前后端、Manage 后台、知识库、用户、主页能理解第一版项目的应用边界和模块拆分V2.0 阶段全民健康智慧中医数字服务平台后端应用、前端应用、HTML 编写规范、API 交互、Articles、Users、General_Data、My_Home能按应用拆分阅读后端、前端和可视化内容问题排查阶段Django 开发遇见问题汇总和解决办法开发中常见问题与处理经验能把问题汇总作为调试参考而不是需求文档版本时间记录原稿更新内容总览解读V1.02020.01.05Gerapy 数据采集管理系统采集管理能力先行为后续 CMS 内容准备数据基础V1.02020.10.05完成数据后台 API数据进入后端服务层具备接口化基础V1.02020.10.12完成 Web 前端从后台数据走向前端展示V1.02020.10.19完成中医问诊系统第一版形成问诊方向的系统模块V2.02021.02.11暂时下架中医问诊系统第二版开始调整产品边界问诊系统不作为当时展示重点V2.02021.02.12重写数据后台 API 接口后端接口进入重构阶段V2.02021.02.14重写 Web 前端前端展示层重构V2.02021.02.16增加前后端交互 API前后端交互从页面展示推进到接口联动V2.02021.02.17增加用户功能后台功能用户管理与后台功能增强V3.0原稿未列具体日期填前面的所有坑以及更新拓展内容进入修补、扩展和长期维护阶段模块名称或文章组原稿中的关键词建议阅读位置项目整体介绍Python 自制 CMS 开源系统、智慧中医健康数字服务平台首先阅读用于建立全局概念中医问诊学习中医问诊学习、开发原理理论基础在进入问诊模块前阅读Scrapy 入门与模板环境搭建、爬虫目标整理、数据准备、通用代码模板、采集模板样例在理解系统数据来源时阅读Gerapy 管理数据采集篇爬虫管理在需要管理爬虫任务时阅读NLP 数据处理数据 NLP 的数据处理在进入 API 数据整理前阅读自动多分类模型深度学习、抓取文章、自动多分类在理解内容分类能力时阅读V1.0 后端Django 后端系统配置、新闻资讯、用户、主页、知识库在回看第一版架构时阅读V1.0 前端Django 前端系统配置、HTML、用户交互、主页数据交互、资讯数据交互在查看第一版页面交互时阅读V1.0 问诊问诊模块系统配置、用户管理、问诊应用、后台管理、前端设计在理解第一版问诊模块时阅读V2.0 后端Articles、Users、General_Data、My_Home在按 Django 应用拆分学习时阅读V2.0 前端前端应用配置、HTML 规范、API 接口功能、Articles、User 功能在检查前后端分离交互时阅读问题汇总Django 开发遇见问题汇总和解决办法在复现或二次开发遇到异常时阅读UGC 自媒体待更新目前只能作为规划项看待数据化管理运营待更新目前只能作为规划项看待Codex项目开发方法Codex 在这里应被用作“将来复用的开发协作方法”而不是把旧项目历史描述为由 Codex 生成。对于这类 Django 数据平台正确做法是先把旧稿中能核对的事实写成 PDD再把 PDD 拆成实施任务最后用验收检查限制生成范围避免模型补全不存在的接口、字段、运行结果或线上状态。PDD 项本项目可写内容禁止扩写内容项目名称智慧中医健康数字服务平台、智慧中医系统、CMS 管理平台方向不写成已经具备完整互联网医疗诊断资质的平台用户角色普通内容浏览用户、后台管理人员、开发维护人员不虚构医生、患者、处方审核员等旧稿未定义角色核心模块数据采集、Gerapy 管理、数据处理、文本分类、Django API、Web 前端、后台管理、用户功能、Articles、General_Data、My_Home、知识库、问诊模块不新增下载中心、课程中心、支付中心等旧稿没有的模块数据链路Scrapy 采集pandas、pymysql、pymongo 处理Django API 输出前端交互展示不编造具体采集站点、数据库表结构、字段枚举或接口 JSON算法能力CNN、RNN 文本多分类用于抓取文章自动多分类方向不写成自动诊断、自动开方或临床决策系统版本边界V1.0 已记录采集管理、后台 API、Web 前端、中医问诊系统V2.0 重写 API 和前端、增加交互 API 与用户后台V3.0 填坑和扩展不补充旧稿未列出的发布日期、提交记录或部署记录待更新内容UGC 自媒体、数据化管理运营不写成已经上线完成验收方式对照文章索引、模块名称、技术栈和页面功能逐项检查不以无法核对的线上访问结果作为验收依据Codex Prompt 场景可直接复用的 Prompt生成总览需求请基于已有旧稿整理智慧中医健康数字服务平台的 PDD。只能使用旧稿中出现的模块、组件、版本记录和文章索引不允许新增接口字段、数据库路径、线上状态或运行结果。输出包含项目定位、数据链路、模块边界、版本演进、后续阅读顺序和验收项。拆分 Django 应用请把智慧中医系统拆分为 Django 后端应用维度只允许使用旧稿出现的 Articles、Users、General_Data、My_Home、新闻资讯、主页、知识库、问诊、用户功能等名称。每个应用只写职责、输入输出和待检查点不生成数据库字段。整理采集链路请根据旧稿描述整理数据采集与处理链路必须包含 Scrapy、Gerapy、pandas、pymysql、pymongo、Django API不要编造目标网站、采集字段、数据库表名、代理配置、调度时间或运行日志。规划算法模块请根据旧稿整理文本多分类模块说明只能描述 CNN、RNN、抓取文章自动多分类和 NLP 数据处理之间的关系不要声称系统已经输出诊断结论或临床建议。编写验收清单请为智慧中医系统二次开发生成验收清单。验收项必须能从旧稿文章索引、模块名称、技术组件和版本记录中核对不允许使用外部链接、截图内容、线上服务可访问性作为必需验收条件。SOP 阶段输入Codex 可做的事人工必须确认的事需求冻结旧稿、文章索引、版本记录抽取项目目标、模块名称、技术栈和边界条件确认哪些内容是事实哪些只是计划或待更新模块拆分PDD 与栏目索引按采集、处理、算法、API、前端、后台、用户、问诊拆分任务确认不新增旧稿没有的模块数据链路设计Scrapy、Gerapy、pandas、pymysql、pymongo、Django API 的描述生成链路图、职责表和接口占位说明确认是否已有实际库表与字段若没有则保持概念层Django 开发后端应用名称与功能边界辅助生成视图、序列化、路由、管理后台或前端交互的代码草案确认代码是否匹配真实项目结构与版本依赖文档整理已完成模块、可核对截图、代码片段生成模块说明、检查清单和问题记录模板确认不写未运行的输出、不写未验证的接口返回验收回归文章目录、功能页面、API 说明、后台功能生成测试场景和人工检查表人工执行页面、接口和后台检查并记录真实结果待验收对象检查方法通过标准项目总览对照本文五个一级标题和原稿内容能覆盖初衷、技术组件、数据链路、模块索引、版本演进和 Codex 方法技术栈说明对照原稿“项目技术应用”Scrapy、Gerapy、pandas、pymysql、pymongo、CNN、RNN、moviepy、django REST framework、Django 3.x 均被正确放置历史演进对照 V1.0、V2.0、V3.0 更新目录日期和更新事项不被改写不新增旧稿没有的历史记录模块索引对照专栏文章索引V1.0、V2.0、数据管理、算法模型、问题汇总、待更新栏目均能找到对应位置Codex 使用对照本文 PDD、Prompt、SOP只作为未来开发辅助方法不声称旧项目由 Codex 历史生成边界控制对照旧稿缺失信息不出现虚构接口返回、文件路径、数据库字段、线上运行状态或截图细节总结智慧中医系统的价值在于把中医内容管理、数据采集、数据处理、Django API、前端展示、用户功能、问诊方向探索和文本分类模型放在同一条工程链路中理解。它不是单纯的爬虫项目也不是单纯的 Django 页面项目而是一个围绕“中医数字服务平台”持续演进的综合案例。从旧稿可以确认项目经历了 V1.0 的采集管理、后台 API、Web 前端与中医问诊系统阶段也经历了 V2.0 的 API 重写、前端重写、前后端交互增强和用户后台功能增加阶段V3.0 则定位为补坑与扩展。阅读后续内容时应优先沿着“总览、理论、采集、处理、算法、后端、前端、应用、问题排查”的顺序推进。将来使用 Codex 辅助开发时最重要的是先限定事实来源再拆解任务和验收标准。对于本项目凡是旧稿没有提供的接口返回、字段结构、数据库路径、线上状态、截图细节和运行结果都不应被写成事实凡是旧稿已经明确的技术组件、模块名称、版本节点和阅读索引则可以整理成可复用的 PDD、Prompt、SOP 与检查清单。