minnan-website

闽南文化生态保护区(厦门市) 官网

构建"数字闽南文化生态圈"，打造集文化保护、学术研究、公众教育、产业应用于一体的综合性数字平台。通过建立"1+3+N"服务体系（1个核心数据库、3大应用终端、N个特色场景），形成覆盖全市的文化数字服务网络。

本项目为闽南文化生态保护区(厦门市)的官网项目源代码。

技术栈

前端核心技术

• 框架：Vue 3 + Nuxt 3（服务端渲染）
• 状态管理：Pinia
• UI 库：Ant Design Vue 4.x
• 路由：Vue Router 4.x
• HTTP 客户端：Axios
• 样式：Sass + Bootstrap 5
• 地图：高德地图 (@vuemap/vue-amap)
• 开发语言：TypeScript
• 构建工具：Vite + Webpack

核心依赖

依赖	版本	用途
vue	^3.5.13	核心前端框架
nuxt	^3.17.6	服务端渲染框架
pinia	^3.0.1	状态管理库
ant-design-vue	^4.2.6	UI 组件库
axios	^1.9.0	HTTP 客户端
bootstrap	^5.3.0	响应式布局框架
@vuemap/vue-amap	^2.1.12	高德地图组件
typescript	~5.8.0	类型系统
vite	^6.2.4	现代构建工具

项目结构

目录组织

e:\Work\minnan-website/
├── api/             # API 相关代码（按功能模块分类）
├── assets/          # 静态资源
│   ├── fonts/       # 字体文件
│   ├── images/      # 图片资源
│   └── scss/        # 样式文件
├── common/          # 通用配置和工具
│   └── config/      # 配置文件
├── components/      # Vue 组件
│   ├── content/     # 内容相关组件
│   ├── controls/    # 控制组件
│   ├── display/     # 显示组件
│   ├── dynamicf/    # 动态表单组件
│   ├── error/       # 错误处理组件
│   ├── icons/       # 图标组件
│   └── parts/       # 页面部分组件
├── composeable/     # Vue 3 组合式 API 工具
├── pages/           # 页面组件（按功能模块分类）
├── public/          # 公共静态资源
├── scripts/         # 脚本文件
│   ├── ExportToAi/  # AI 导出相关脚本
│   └── UpdateScript/ # 更新脚本
├── server/          # 服务端相关代码
├── stores/          # Pinia 状态管理
├── App.vue          # 根组件
├── nuxt.config.ts   # Nuxt 配置文件
├── package.json     # 项目依赖配置
└── tsconfig.json    # TypeScript 配置文件

功能模块

• introduction/：闽南文化简介
• inheritor/：非遗相关
• research/文化研究
• news/：新闻资讯
• communicate/：文化交流
• fusion/：文旅融合
• village/：传统村落
• about/：关于我们

开发与构建

开发命令

# 启动开发服务器
npm run dev

构建命令

# 构建项目
npm run build
# 构建项目，并且自动发布更新至线上
npm run updater ---- update post web
# 构建 ICH 相关内容
npm run build:ich

类型检查

# 执行TypeScript类型检查
npx vue-tsc