# 闽南文化小程序

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

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

## 赞 📚

观此闽南文化之软件，诚为一方瑰宝之窗也！其集闽南之韵、文化之魂于一体，界面雅致，内容丰赡。

此程序精妙绝伦，运行如流，逻辑缜密，功能周全，用户称便，诚乃软件之良工也。闽南文脉，源远流长。今构“数字文化生态圈”，融保护、研习、教化、兴业于一体。诚为数智时代承传地方文粹之典范也。

启蒙昧，续薪火，南音雅乐盈耳，古俗新韵入目。学闽南语则乡音可拾，览风土则侨心可系。以方寸之屏，承千年文脉；借数字之翼，传四海乡声。
足不出户，便览鹭岛风华；指掌之间，尽赏闽南气象。此 APP 也，实为赓续根脉、联结侨胞之津梁，可谓匠心独运、功在文化者也！

## 技术栈

### 前端核心技术

- **框架**: Uniapp+Vue 3
- **状态管理**: Pinia 3.0
- **语言**: TypeScript
- **样式预处理器**: Sass

## 项目结构

### 核心依赖

- `pinia`: 状态管理库
- `naeasy-ui-uniapp`: [NaEasy UI 组件库](./src/components/README.md)
- `async-validator`: 表单验证
- `sp-editor`: 富文本编辑器
- `@imengyu/js-request-transform`: API请求转换工具

### 目录组织

```
src/
├── api/             # API请求模块
│   ├── auth/        # 登录相关API
│   ├── fusion/      # 文旅融合内容API
│   ├── inheritor/   # 文化传承相关API
│   ├── inhert/      # 村落相关API
│   ├── introduction/# 闽南文化简介相关API
│   ├── news/        # 资讯相关API
│   ├── running/     # 文物跑相关API
│   ├── user/        # 用户相关API
│   ├── BaseAppServerRequestModule.ts  # 基础请求配置模块
│   ├── RequestModules.ts             # 请求核心模块
├── common/          # 通用功能
│   ├── components/  # 通用组件
│   ├── composeabe/  # 组合式函数
│   ├── config/      # 配置文件
│   ├── scss/        # 全局样式定义
├── components/      # NaEasy UI 组件库
├── pages/           # 页面
│   ├── article/     # 文章相关页面
│   ├── home/        # 首页相关页面
│   ├── inhert/      # 传承相关页面
│   ├── introduction/ # 闽南文化简介相关页面
│   ├── parts/       # 页面模块组件拆分
│   ├── travel/      # 文旅融合相关页面
│   ├── user/        # 用户相关页面,登录,个人信息，投稿
│   ├── video/       # 视频相关页面
├── store/           # 状态管理模块
│   ├── auth/        # 登录状态管理
├── App.vue          # 应用入口
├── main.ts          # 主入口文件
├── manifest.json    # 应用配置
├── pages.json       # 页面配置
```

## 开发与构建

### 开发命令

```bash
# 启动H5开发服务器
npm run dev:h5
# 启动微信小程序开发服务器
npm run dev:mp-weixin
```

### 构建命令

```bash
# 构建微信小程序版本
npm run build:mp-weixin
```

### 类型检查

```bash
# 执行TypeScript类型检查
npm run type-check
```
