非遗文化传播与主题挖掘系统本项目是一个面向“非物质文化遗产ICH数字化展示与传播洞察”的全栈应用围绕“内容展示 互动沉淀 数据分析”三条主线提供从非遗项目内容管理、用户互动点赞/收藏/评论/分享、到基于文本数据的主题挖掘LDA与传播效果分析的完整闭环。项目由Flask 后端与Vue3 前端组成数据存储使用MySQL。前端同时覆盖用户端门户与管理端后台并提供独立的分析台数据集上传、预处理、LDA 训练、报表导出与趋势聚合。项目目标与定位核心目标数字化展示以结构化内容呈现非遗项目分类、地区、级别、图文、媒体、坐标。互动沉淀用户在内容消费过程中产生的互动行为点赞/收藏/分享与评论被持久化为后续分析提供数据基础。主题洞察对传播文本数据集中的内容进行预处理与 LDA 主题挖掘输出主题关键词、主题热度与相关项目入口。运营评估以时间粒度日/周/月聚合传播指标与互动趋势形成可视化报表为运营决策提供依据。典型使用场景面向公众的非遗项目检索与浏览按分类/关键词/地区筛选查看详情与地图分布。内容运营人员在后台维护项目库新增/编辑项目、上传封面、补齐经纬度与媒体素材。数据分析人员在分析台导入传播数据执行预处理、训练 LDA、查看主题结果与传播影响报表。管理人员查看资源与互动概览分类结构完整性、互动趋势与数据质量提示。系统功能概览用户端Portal首页项目检索分类筛选四大类可扩展关键词检索分页浏览与项目卡片展示封面、摘要、地区、级别项目详情页展陈式布局标题、分类/地区/级别信息与互动按钮项目简介summary description媒体展示视频/音频位置展示基于经纬度嵌入在线地图OpenStreetMap支持外链打开评论区发布与列表展示主题展示页读取 LDA 训练结果主题列表、关键词、热度、文本数按非遗分类筛选主题主题到项目展示页的联动入口地图分布页基于经纬度散点图展示项目分布支持按分类与地区筛选点击散点跳转项目详情个人中心基本信息维护用户名/密码/头像收藏列表、评论记录等个人数据沉淀管理端Admin项目管理新增/编辑/删除非遗项目上传封面/视频/音频媒体文件存储在后端 uploads 目录并提供静态访问维护经纬度与结构化字段分类/地区/级别/摘要/描述分类管理分类维护名称、编码、排序用于统一检索、主题归类、地图筛选与内容结构化用户管理查看用户列表与角色支持修改普通用户角色user/admin内置账号保护机制内置账号如admin标记为built_in1后台禁止修改其角色避免误操作导致无法登录管理端概览统计报表KPI用户/项目/分类规模与数据完备度封面/坐标/媒体报表按分类项目数、近 N 天互动趋势点赞/收藏/分享/评论分析台Analysis数据集管理上传 CSV 数据集传播文本数据集预览与导出预处理与训练文本预处理停用词/清洗/分词等运行 LDA 训练输出最佳主题数与主题关键词分析报表传播效果与互动指标的时序聚合支持日/周/月粒度切换生成结构化 JSON 报告用于前端可视化技术架构与工程结构前端Vue3技术栈Vue 3 Vite Vue Router Element Plus ECharts主要模块src/layouts/用户端、管理端、分析台三套布局src/pages/user/用户端页面首页/详情/主题/地图/个人中心src/pages/admin/管理端页面概览/项目/分类/用户src/pages/analysis/分析台页面src/api/client.jsAPI 客户端统一 baseURL/api、统一解包{code,msg,data}src/modules/auth/认证状态管理token、本地存储、me 信息交互特点通过 Vite dev server 代理/api到后端前端只关心/api/...路径图表使用统一封装mountChart支持 resize、动态 setOption后端Flask技术栈Flask SQLAlchemy Engine以 SQL 文本为主 PyMySQL dotenv路由组织API 统一挂载在/apiBlueprintapi_bp统一响应结构{ code, msg, data }数据层特点使用mysql_db.init_db()在启动时保证表存在并执行必要的增量迁移以 SQL 为主的读写方式便于清晰掌控字段与索引项目目录结构文件与职责下面列出仓库关键目录与文件便于快速定位功能与修改点省略非关键构建产物feiyi-cultural-python-vue3/ ├─ flask-app/ # Flask 后端 │ ├─ app.py # 后端入口创建 app、注册 /api │ ├─ .env # 环境变量MySQL 连接、端口等 │ ├─ requirements.txt # Python 依赖 │ ├─ feiyi.csv # 默认示例数据集dataset_iddefault │ ├─ sql/ │ │ └─ schema.sql # 旧版建表 SQL模板/参考用 │ ├─ src/ │ │ ├─ api.py # API 路由Blueprint/api 下所有接口入口 │ │ ├─ services/ │ │ │ ├─ mysql_db.py # MySQL URL、Engine、init_db建表/迁移/种子数据 │ │ │ ├─ ich_service.py # 非遗业务项目/分类/地图点位/互动/评论/统计 │ │ │ ├─ auth_service.py # 认证注册/登录、token、profile 更新 │ │ │ ├─ analysis.py # 分析预处理、LDA、报表聚合 │ │ │ ├─ datasets.py # 数据集管理上传、预览、导出 │ │ │ ├─ media_uploads.py # 媒体上传与保存 │ │ │ └─ config_files.py # 停用词/规则配置读写 │ │ └─ utils/ │ │ └─ responses.py # 统一返回结构 {code,msg,data} │ ├─ uploads/ # 运行时上传目录媒体等 │ └─ outputs/ # 运行时输出目录词云、LDA 结果、报表等 │ ├─ vue3/ # Vue3 前端 │ ├─ vite.config.js # Vite 配置/api 代理到后端 │ ├─ package.json # 前端依赖与脚本 │ ├─ src/ │ │ ├─ main.js # 前端入口 │ │ ├─ style.css # 全局主题色与基础样式 │ │ ├─ api/client.js # axios 实例 unwrap统一解包 │ │ ├─ router/index.js # 路由 权限守卫 │ │ ├─ modules/auth/useAuthStore.js # 认证 storetoken/user全局单例 │ │ ├─ layouts/ # 三套布局 │ │ │ ├─ UserLayout.vue │ │ │ ├─ AdminLayout.vue │ │ │ └─ AnalysisLayout.vue │ │ ├─ pages/ │ │ │ ├─ user/ # 用户端首页/详情/主题/地图/个人中心 │ │ │ ├─ admin/ # 管理端概览/分类/项目/用户 │ │ │ └─ analysis/ # 分析台数据源/主题/影响等 │ │ └─ components/ │ │ ├─ Charts.js # ECharts 挂载封装resize、setOption │ │ └─ LoadingHint.vue # 统一加载提示 │ └─ public/ # 静态资源如有 │ ├─ feiyi_ich.sql # 新版 MySQL 快照结构 演示数据含 DROP TABLE ├─ init-database.bat # Windows 一键导入 feiyi_ich.sql会重建库 ├─ mac/ │ ├─ init_db_from_sql.sh # macOS 一键导入 feiyi_ich.sql自动建库 │ ├─ setup_and_run.sh # macOS安装依赖并启动后端不做 DB 初始化 │ ├─ run.sh # macOS快速启动后端不安装依赖 │ └─ 项目部署手册_macOS.md ├─ windows/ │ └─ 项目部署手册_Windows.md └─ 项目说明.md数据模型与关键字段核心内容ich_categories非遗分类支持排序默认四大类可扩展ich_items非遗项目title/summary/description内容展示核心region/level检索与信息面板cover_url/video_url/audio_url媒体资源longitude/latitude地图展示与分布分析用户与互动usersroleadmin/userbuilt_in是否内置账号内置账号禁止修改角色avatar_url头像ich_actions互动动作like/favorite/share对同一用户与项目的同一动作做唯一约束ich_comments评论记录关联用户与项目数据分析相关datasets上传数据集元信息posts数据集文本明细内容、发布时间、互动指标等训练/报表输出生成于后端outputs/目录供前端读取展示安全与权限策略认证方式基于 tokenBearer访问需要权限的接口权限边界用户端可匿名浏览互动与个人中心需登录管理端与分析台需登录管理端需要admin角色内置账号保护数据库层users.built_in标记内置账号后端层修改角色接口对built_in1强制拒绝前端层管理端用户列表对内置账号禁用角色下拉交付物与可扩展方向已具备的交付能力用户端门户检索、详情、地图、主题展示、个人中心管理端项目/分类/用户管理与统计概览分析台数据集上传、预处理、LDA 训练、报表输出数据闭环内容维护 → 用户互动沉淀 → 统计报表与趋势评估可扩展方向面向后续迭代更精细的地图行政区划底图、聚合、热力、区域统计内容结构增强非遗传承人、时间轴、非遗项目图谱关联推荐与个性化基于收藏/点赞/浏览的召回与排序数据治理数据质量评分坐标/封面/摘要/媒体完备率与后台巡检清单多数据集对比多次训练结果对比与版本管理总结本项目以“非遗项目内容库”为核心以“互动行为与评论”为数据沉淀以“LDA 主题挖掘与传播分析”为洞察能力形成贯穿展示—运营—分析的完整系统。其工程结构清晰、模块边界明确便于持续扩展更多数据分析能力与展陈式内容体验。本项目详情https://www.aiyuanma.vip/posts/feiyi-cultural-python-vue3