# tianfu

**Repository Path**: stfnddy/tianfu

## Basic Information

- **Project Name**: tianfu
- **Description**: 天府文化项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-10-06
- **Last Updated**: 2026-10-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 天府文化·锦城漫想

一个基于 Vue 3 + Vite 的成都文化展示与 AI 创作平台，集成了高德地图可视化与 AI 生图功能。

## 项目简介

本项目旨在传播和展示成都（古称锦城、天府）的传统文化艺术，包括川剧、昆曲、汉服等非遗文化。通过交互式地图和 AI 创作工具，让用户深入了解成都的文化底蕴，并参与文化创意生成。

## 技术栈

- **前端框架**: Vue 3 (Composition API)
- **构建工具**: Vite
- **状态管理**: Pinia
- **路由**: Vue Router
- **地图服务**: 高德地图 (AMap)
- **AI 生图**: 豆包 (火山方舟)
- **后端服务**: Node.js (Express)
- **测试**: Vitest + Playwright
- **代码规范**: ESLint + Prettier

## 功能特性

- 🗺️ **文化地图**: 高德地图可视化展示成都各区域文化分布
- 🎭 **文化浏览**: 川剧、昆曲、汉服等传统文化分类浏览
- 🎨 **AI 创作**: 基于豆包 AI 的文化主题图片生成
- 👤 **用户系统**: 登录/注册、作品管理
- 📷 **作品画廊**: 展示 AI 生成的创意作品

## 开发环境配置

### 环境要求

- Node.js 18+
- npm 9+

### 安装依赖

```bash
npm install
```

### 开发模式

```bash
npm run dev
```

### 生产构建

```bash
npm run build
```

### 类型检查

```bash
npm run vue-tsc -- --noEmit
```

## 测试

### 单元测试

```bash
npm run test:unit
```

### E2E 测试

```bash
# 首次运行需安装浏览器
npx playwright install

# 构建项目后运行测试
npm run build
npm run test:e2e

# 仅在 Chromium 上运行
npm run test:e2e -- --project=chromium

# 调试模式
npm run test:e2e -- --debug
```

## 代码规范

```bash
npm run lint
```

## 项目结构

```
src/
├── assets/          # 静态资源 (CSS、图片)
├── components/      # 公共组件
│   ├── AuthModal.vue      # 登录/注册弹窗
│   └── CultureCarousel.vue # 文化轮播组件
├── data/            # 静态数据
│   └── tianfuRegions.ts   # 天府文化区域数据
├── router/          # 路由配置
├── stores/          # Pinia 状态管理
│   ├── auth.ts      # 用户认证状态
│   └── works.ts     # 作品管理状态
├── views/           # 页面组件
│   ├── Home.vue           # 首页
│   ├── CultureBrowser.vue # 文化浏览
│   ├── CultureCategoryDetail.vue # 文化分类详情
│   ├── Gallery.vue        # 作品画廊
│   ├── MyWorks.vue        # 我的作品
│   ├── CreateArt.vue      # AI 创作
│   └── AboutBRI.vue       # 关于页面
├── App.vue          # 根组件
└── main.ts          # 入口文件
```

## 推奨开发工具

- [VS Code](https://code.visualstudio.com/) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) 插件
- 浏览器推荐使用 Chromium 内核浏览器 (Chrome, Edge, Brave) 并安装 [Vue.js devtools](https://chromewebstore.google.com/detail/vuejs-devtools/nhdogjmejiglipccpnnnanhbledajbpd)

## 许可证

MIT License