# 问易社区 (AskYi) - Claude Code 配置

## 项目信息

| 属性 | 值 |
|------|-----|
| 项目名称 | askyi |
| 项目类型 | project-group (多项目组) |
| 项目描述 | 生活方式类应用平台 |

## 子项目

| 子项目 | 类型 | 技术栈 | 目录 |
|--------|------|--------|------|
| askyi-cms-railway | 后端 CMS | Strapi 5 + PostgreSQL + Redis | `./askyi-cms-railway/` |
| askyi-h5 | 前端应用 | Next.js 15 + Capacitor 6 | `./askyi-h5/` |
| askyi-uniapp | 小程序 | UniApp + Vue 3 + Pinia | `./askyi-uniapp/` |
| askyilife | iOS 原生 | Swift 5.9 + SwiftUI | `./askyilife/` |
| askyi-app | 原生壳 | Capacitor 8 | `./askyi-app/` |
| prototype-h5 | 原型 | HTML/CSS/JS | `./prototype-h5/` |

## 关联配置

### Obsidian 文档路径
```
文档根目录: /Users/yibu/dev_workspace/vibe-coding-cn
项目文档:   /Users/yibu/dev_workspace/vibe-coding-cn/askyi
```

### Vibe Kanban 项目
| 项目 | Kanban ID |
|------|-----------|
| askyi-cms-railway | `b986657a-68d8-4600-b2c8-e39466307ef6` |
| askyi-h5 | `1da5d0cd-8001-4c43-9636-65d07f1c276d` |
| askyi-uniapp | `ba7aec6f-114f-49ed-b26b-4e9d234c15c4` |
| askyilife | `0d65b167-7cff-4496-845a-3b3385223014` |
| askyi-app | `d7d6096b-8e20-4fb5-a3d3-530d6bf12d37` |
| prototype-h5 | `f435fea5-30f5-449d-8e8f-2d493e9af168` |

## 系统架构

```
                         ┌─────────────────────┐
                         │  askyi-cms-railway  │  ← Headless CMS (Strapi)
                         │  PostgreSQL + Redis │
                         │  Railway 部署        │
                         └──────────┬──────────┘
                                    │ API
    ┌───────────────┬───────────────┼───────────────┬───────────────┐
    ↓               ↓               ↓               ↓               ↓
┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐
│ askyi-h5   │ │askyi-uniapp│ │ askyilife  │ │ askyi-app  │ │prototype-h5│
│ Next.js 15 │ │UniApp+Vue3 │ │Swift/SwiftUI│ │Capacitor壳 │ │静态HTML原型│
│ +Capacitor │ │ 微信小程序  │ │  iOS 原生   │ │askyi.life │ │  UI 设计   │
└────────────┘ └────────────┘ └────────────┘ └────────────┘ └────────────┘
```

## 开发顺序约定

### 功能开发顺序
```
1. prototype-h5    → UI 设计稿（可选）
2. askyi-cms-railway → 后端 API + 数据模型
3. askyi-h5        → 前端页面实现
4. askyi-uniapp    → 微信小程序实现（从 askyi-h5 迁移）
5. askyilife       → iOS 原生实现（如需要）
6. askyi-app       → 同步更新套壳配置（如需要）
```

### 前后端联动
- 先后端：定义数据模型和 API
- 再前端：调用 API 实现页面

## 开发命令

### 后端 (askyi-cms-railway)
```bash
cd askyi-cms-railway
pnpm install
pnpm run dev          # 本地开发
pnpm run build        # 构建
```

### 前端 (askyi-h5)
```bash
cd askyi-h5
pnpm install
pnpm run dev          # 本地开发
pnpm run build:ios    # 构建 + 同步 iOS
```

### 微信小程序 (askyi-uniapp)
```bash
cd askyi-uniapp
pnpm install
pnpm run dev:mp-weixin # 微信小程序开发
pnpm run build:mp-weixin # 构建微信小程序
```

### iOS 原生 (askyilife)
```bash
cd askyilife
make setup            # 安装开发工具
make build            # 构建项目
# 或用 Xcode 打开
```

## 部署环境

| 子项目 | 开发环境 | 生产环境 |
|--------|----------|----------|
| askyi-cms-railway | localhost:1337 | Railway |
| askyi-h5 | localhost:3000 | Railway / askyi.life |
| askyi-uniapp | HBuilderX / 微信开发者工具 | 微信小程序 |
| askyilife | Xcode 模拟器 | App Store |
| askyi-app | Xcode / Android Studio | App Store / Google Play |

## 核心文档

| 文档 | 位置 | 内容 |
|------|------|------|
| 系统架构 | `architecture.canvas` | 整体架构图 |
| H5 架构 | `askyi-h5/architecture.canvas` | 前端架构 |
| UniApp 架构 | `askyi-uniapp/architecture.canvas` | 小程序架构 |