---
project: askyi
type: project-group
description: 问易社区 - 生活方式类应用平台
subprojects:
  - name: askyi-cms-railway
    kanban_id: b986657a-68d8-4600-b2c8-e39466307ef6
    type: backend
    tech: Strapi 5 + PostgreSQL + Redis
  - name: askyi-h5
    kanban_id: 1da5d0cd-8001-4c43-9636-65d07f1c276d
    type: frontend
    tech: Next.js 15 + Capacitor 6
  - name: askyilife
    kanban_id: 0d65b167-7cff-4496-845a-3b3385223014
    type: ios-native
    tech: Swift 5.9 + SwiftUI
  - name: askyi-app
    kanban_id: d7d6096b-8e20-4fb5-a3d3-530d6bf12d37
    type: capacitor-shell
    tech: Capacitor 8 (纯套壳)
  - name: prototype-h5
    kanban_id: f435fea5-30f5-449d-8e8f-2d493e9af168
    type: prototype
    tech: HTML/CSS/JS
  - name: askyi-uniapp
    kanban_id: ba7aec6f-114f-49ed-b26b-4e9d234c15c4
    type: miniprogram
    tech: UniApp + Vue 3 + Pinia
code_root: /Users/jamesw/dev_workspace/askyi/organization
obsidian_root: /Users/jamesw/dev_workspace/vibe-coding-cn/askyi
---

# 问易社区 (AskYi)

> 生活方式类应用平台，包含 CMS 后端、Web 前端、iOS 原生应用等多个子项目

## 系统架构

```
                         ┌─────────────────────┐
                         │  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 设计   │
└────────────┘ └────────────┘ └────────────┘ └────────────┘ └────────────┘
```

## 子项目说明

| 子项目 | 类型 | 技术栈 | 用途 |
|--------|------|--------|------|
| askyi-cms-railway | 后端 | Strapi 5 + PostgreSQL + Redis | Headless CMS，内容管理 |
| askyi-h5 | 前端 | Next.js 15 + Tailwind + Capacitor 6 | 移动端主应用 |
| askyi-uniapp | 小程序 | UniApp + Vue 3 + Pinia | 微信小程序版本 |
| askyilife | iOS 原生 | Swift 5.9 + SwiftUI + MVVM | 纯原生 iOS 应用 |
| askyi-app | 原生壳 | Capacitor 8 | 套壳加载 askyi.life |
| prototype-h5 | 原型 | HTML/CSS/JS | 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        # 构建
pnpm run config:export # 导出配置
pnpm run db-backup:dev # 备份数据库
```

### 前端 (askyi-h5)

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

### 微信小程序 (askyi-uniapp)

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

### iOS 原生 (askyilife)

```bash
cd askyilife
make setup            # 安装开发工具
make lint             # 代码检查
make format           # 代码格式化
make build            # 构建项目
# 或用 Xcode 打开 askyilife.xcodeproj
```

### 套壳应用 (askyi-app)

```bash
cd askyi-app/app
pnpm install
pnpm exec cap sync ios
pnpm exec cap sync android
pnpm exec cap open ios      # 打开 Xcode
pnpm exec cap open android  # 打开 Android Studio
```

## Claude Code 启动说明

```bash
# 多项目开发（推荐）
cd /Users/jamesw/dev_workspace/askyi/organization
claude

# 单项目开发
cd /Users/jamesw/dev_workspace/askyi/organization/askyi-h5
claude
```

## 核心文档

| 文档 | 位置 | 内容 |
|------|------|------|
| 项目配置 | 本文档 | 子项目列表、Kanban ID |
| CMS 文档 | askyi-cms-railway/README.md | Strapi 开发指南 |
| H5 文档 | askyi-h5/README.md | Next.js 开发指南 |
| UniApp 文档 | askyi-uniapp/README.md | 小程序开发指南 |
| iOS 文档 | askyilife/README.md | Swift 开发指南 |
| App 文档 | askyi-app/README.md | Capacitor 配置指南 |
| 原型说明 | prototype-h5/README.md | 页面结构说明 |

## 部署环境

| 子项目 | 开发环境 | 生产环境 |
|--------|----------|----------|
| 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 |