project: askyi
type: project-group
description: 问易社区 - 生活方式类应用平台
subprojects:
- name: askyi-cms-railway
kanban_id:
b986657a-68d8-4600-b2c8-e39466307e
type: backend
tech: Strapi 5 + PostgreSQL + Redis
- name: askyi-h5
kanban_id:
1da5d0cd-8001-4c43-9636-65d07f1c27
type: frontend
tech: Next.js 15 + Capacitor 6
- name: askyilife
kanban_id:
0d65b167-7cff-4496-845a-3b33852230
type: ios-native
tech: Swift 5.9 + SwiftUI
- name: askyi-app
kanban_id:
d7d6096b-8e20-4fb5-a3d3-530d6bf12d
type: capacitor-shell
tech: Capacitor 8 (纯套壳)
- name: prototype-h5
kanban_id:
f435fea5-30f5-449d-8e8f-2d493e9af1
type: prototype
tech: HTML/CSS/JS
- name: askyi-uniapp
kanban_id:
ba7aec6f-114f-49ed-b26b-4e9d234c15
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)
cd askyi-cms-railway
pnpm install
pnpm run dev # 本地开发
pnpm run build # 构建
pnpm run config:export # 导出配置
pnpm run db-backup:dev # 备份数据库
前端 (askyi-h5)
cd askyi-h5
pnpm install
pnpm run dev # 本地开发
pnpm run build # 构建
pnpm run build:ios # 构建 + 同步 iOS
pnpm run build:android # 构建 + 同步 Android
微信小程序 (askyi-uniapp)
cd askyi-uniapp
pnpm install
pnpm run dev:h5 # 本地开发 (H5)
pnpm run dev:mp-weixin # 微信小程序开发
pnpm run build:mp-weixin # 构建微信小程序
iOS 原生 (askyilife)
cd askyilife
make setup # 安装开发工具
make lint # 代码检查
make format # 代码格式化
make build # 构建项目
# 或用 Xcode 打开 askyilife.xcodeproj
套壳应用 (askyi-app)
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 启动说明
# 多项目开发（推荐）
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 |
