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

构建"数字闽南文化生态圈"，打造集文化保护、学术研究、公众教育、产业应用于一体的综合性数字平台。通过建立"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/**：关于我们

## 开发与构建

### 开发命令

```bash
# 启动开发服务器
npm run dev
```

### 构建命令

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

### 类型检查

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