@cogito.ai/cli 0.4.3 → 0.4.5

package/dist/templates/web-nextjs/apps/docs/content/docs/template/supabase.mdx

@@ -0,0 +1,130 @@
+---
+title: 数据层：Supabase
+description: 如何在开发环境和生产环境中使用 Supabase，包括数据表设计、类型安全和最佳实践。
+---
+
+## 概述
+
+本项目使用 **Supabase** 作为后端数据库和身份验证服务。Supabase 提供了 PostgreSQL 数据库、自动生成的 REST API、实时订阅和身份验证功能。
+
+## 开发环境配置
+
+### 本地 Supabase CLI
+
+1. **安装 Supabase CLI**
+
+```bash
+pnpm add -g supabase
+```
+
+2. **登录 Supabase**
+
+```bash
+supabase login
+```
+
+3. **启动本地 Supabase 实例**
+
+```bash
+supabase start
+```
+
+本地开发时，Supabase 服务运行在：
+- **Studio UI**: http://localhost:54323
+- **API URL**: http://localhost:54321
+- **数据库**: postgresql://postgres:postgres@localhost:54322/postgres
+
+### 环境变量
+
+在 `.env.local` 中配置本地 Supabase：
+
+```
+NEXT_PUBLIC_SUPABASE_URL=http://localhost:54321
+NEXT_PUBLIC_SUPABASE_ANON_KEY=your-local-anon-key
+SUPABASE_SERVICE_ROLE_KEY=your-local-service-role-key
+```
+
+> 运行 `supabase status` 获取本地密钥。
+
+## 生产环境配置
+
+1. 在 [Supabase Dashboard](https://supabase.com/dashboard) 创建新项目
+2. 获取项目 URL 和 API 密钥
+3. 更新生产环境变量
+
+## 数据表设计
+
+项目包含以下核心数据表（通过迁移脚本管理）：
+
+| 表名 | 说明 |
+|------|------|
+| `profiles` | 用户资料扩展 |
+| `subscriptions` | 订阅信息 |
+| `payments` | 支付记录 |
+
+### 运行迁移
+
+```bash
+# 本地
+supabase migration up
+
+# 生产
+supabase migration up --linked
+```
+
+## 类型安全
+
+项目使用 **Supabase 类型生成** 确保数据库查询的类型安全：
+
+```ts
+import { createClient } from '@supabase/supabase-js'
+import type { Database } from './supabase/types'
+
+const supabase = createClient<Database>(url, key)
+```
+
+运行以下命令生成类型：
+
+```bash
+supabase gen types typescript --project-id your-project-id --schema public > src/lib/supabase/types.ts
+```
+
+## 安全最佳实践
+
+### 行级安全策略 (RLS)
+
+所有表默认启用 RLS，确保用户只能访问自己的数据：
+
+```sql
+CREATE POLICY "Users can only access their own data"
+ON profiles FOR ALL
+TO authenticated
+USING (auth.uid() = user_id);
+```
+
+### 服务角色密钥
+
+- **仅在服务器端**使用 `SUPABASE_SERVICE_ROLE_KEY`
+- **绝不在客户端**暴露服务角色密钥
+- 使用 `@supabase/ssr` 包管理会话
+
+## 开发调试
+
+### 查看数据库
+
+通过 Supabase Studio 访问本地数据库：
+
+```bash
+supabase studio
+```
+
+### 日志和监控
+
+- 本地：http://localhost:54323/project/default/logs/explorer
+- 生产：Supabase Dashboard → Logs
+
+## 相关资源
+
+- [Supabase 官方文档](https://supabase.com/docs)
+- [Supabase JavaScript 客户端](https://supabase.com/docs/reference/javascript)
+- [PostgreSQL 文档](https://www.postgresql.org/docs/)

package/dist/templates/web-nextjs/apps/docs/content/docs/template/troubleshooting.mdx

@@ -0,0 +1,87 @@
+---
+title: 故障排查
+description: 常见问题及解决方案。
+---
+
+## 常见问题
+
+### pnpm install 失败
+
+**问题**: 运行 `pnpm install` 时出现 `ERR_PNPM_IGNORED_BUILDS` 错误。
+
+**解决方案**: 
+- 运行 `pnpm approve-builds` 批准构建脚本
+- 或者检查 `pnpm-workspace.yaml` 中的 `onlyBuiltDependencies` 配置
+
+### 类型检查失败
+
+**问题**: `pnpm check-types` 报错。
+
+**解决方案**: 
+- 确保 `.env.local` 文件存在
+- 运行 `pnpm build` 更新 `.source/` 文件
+
+### 文档站点 404
+
+**问题**: 访问 `/docs` 返回 404。
+
+**解决方案**: 
+- 确保 docs 应用已启动（`pnpm --filter @cogito.ai/docs dev`）
+- 检查 `.source/` 文件是否已生成
+
+### 支付回调收不到
+
+**问题**: 支付宝/微信支付回调通知收不到。
+
+**解决方案**: 
+- 确保服务器公网可访问
+- 检查回调地址配置是否正确
+- 确认使用 HTTPS 协议
+- 查看服务器防火墙设置
+
+### 数据库连接失败
+
+**问题**: 无法连接 Supabase 数据库。
+
+**解决方案**: 
+- 检查 `.env.local` 中的 Supabase URL 和密钥
+- 确保本地 Supabase 实例已启动（`supabase start`）
+- 验证网络连接
+
+## 调试技巧
+
+### 查看日志
+
+```bash
+# Web 应用日志
+pnpm --filter @cogito.ai/web dev
+
+# 文档站点日志
+pnpm --filter @cogito.ai/docs dev
+```
+
+### 清理缓存
+
+```bash
+# 删除 node_modules 和 lockfile
+rm -rf node_modules pnpm-lock.yaml
+
+# 重新安装依赖
+pnpm install
+```
+
+### 检查环境变量
+
+```bash
+# 确认 .env.local 存在
+cat .env.local
+
+# 确认变量已加载
+node -e "console.log(process.env.NEXT_PUBLIC_SUPABASE_URL)"
+```
+
+## 获取帮助
+
+- [AgentDock GitHub Issues](https://github.com/your-org/agentdock/issues)
+- [Next.js 文档](https://nextjs.org/docs)
+- [Supabase 文档](https://supabase.com/docs)

package/dist/templates/web-nextjs/apps/docs/content/docs/template/wechat-pay.mdx

@@ -0,0 +1,318 @@
+---
+title: 支付：微信支付
+description: 微信支付集成指南，包括架构、配置、安全和使用方法。
+---
+
+## 概述
+
+本项目集成了 **微信支付**（WeChat Pay），支持 Native 支付（扫码支付）和 JSAPI 支付（公众号/小程序内支付）场景。
+
+## 技术架构
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                        用户浏览器                              │
+│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐  │
+│  │   选择商品    │ -> │  创建订单     │ -> │  扫码/调起支付 │  │
+│  └──────────────┘    └──────────────┘    └──────────────┘  │
+└─────────────────────────────────────────────────────────────┘
+                             │
+                             ▼
+┌─────────────────────────────────────────────────────────────┐
+│                    Next.js 应用 (Server)                    │
+│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐  │
+│  │  /api/pay    │    │  签名/验签   │    │  回调处理     │  │
+│  │  /api/notify │    │              │    │              │  │
+│  └──────────────┘    └──────────────┘    └──────────────┘  │
+└─────────────────────────────────────────────────────────────┘
+                             │
+                             ▼
+                    ┌────────────────┐
+                    │   微信支付网关  │
+                    │  (api.mch.weixin.qq.com) │
+                    └────────────────┘
+```
+
+## 时序图
+
+```
+用户          前端页面         Next.js API      微信支付网关
+ │               │                  │                 │
+ │  1.选择商品   │                  │                 │
+ │─────────────>│                  │                 │
+ │               │  2.POST /create  │                 │
+ │               │─────────────────>│                 │
+ │               │                  │  3.统一下单      │
+ │               │                  │─────────────────>│
+ │               │                  │  4.返回 prepay_id│
+ │               │                  │<─────────────────│
+ │  5.返回支付参数│                  │                 │
+ │<─────────────│                  │                 │
+ │  6.调起微信支付│                  │                 │
+ │─────────────────────────────────────────────────>│
+ │  7.支付成功   │                  │                 │
+ │<─────────────────────────────────────────────────│
+ │               │                  │  8.异步通知      │
+ │               │                  │<─────────────────│
+ │               │                  │  9.验签+更新状态 │
+ │               │                  │                 │
+ │  10.跳转成功页│                  │                 │
+ │<─────────────│                  │                 │
+```
+
+## 前置条件
+
+### 微信支付商户账号
+
+1. 注册 [微信支付商户平台](https://pay.weixin.qq.com/) 账号
+2. 完成商户认证，获取 **商户号 (mch_id)**
+3. 申请 **API 证书** 和 **APIv3 密钥**
+
+### 必要配置
+
+| 配置项 | 说明 | 获取位置 |
+|--------|------|----------|
+| `WECHAT_PAY_MCH_ID` | 商户号 | 微信支付商户平台 → 账户中心 |
+| `WECHAT_PAY_APP_ID` | 应用 APPID | 微信开放平台/公众号平台 |
+| `WECHAT_PAY_API_V3_KEY` | APIv3 密钥 | 微信支付商户平台 → 账户中心 → API安全 |
+| `WECHAT_PAY_CERT_SERIAL_NO` | 证书序列号 | 商户平台 → API安全 → 管理证书 |
+| `WECHAT_PAY_PRIVATE_KEY` | 商户私钥 | 下载的 apiclient_key.pem |
+
+## 开发环境配置
+
+### 1. 配置环境变量
+
+在 `.env.local` 中添加：
+
+```
+WECHAT_PAY_MCH_ID=your-mch-id
+WECHAT_PAY_APP_ID=your-app-id
+WECHAT_PAY_API_V3_KEY=your-api-v3-key
+WECHAT_PAY_CERT_SERIAL_NO=your-cert-serial-no
+WECHAT_PAY_PRIVATE_KEY=-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----
+WECHAT_PAY_NOTIFY_URL=https://your-domain.com/api/payments/wechat/notify
+```
+
+> **注意**: 私钥包含换行符，使用 `\n` 转义。
+
+### 2. 下载 API 证书
+
+1. 登录 [微信支付商户平台](https://pay.weixin.qq.com/)
+2. 进入 **账户中心 → API安全 → 申请API证书**
+3. 下载证书文件（`apiclient_cert.pem` 和 `apiclient_key.pem`）
+
+### 3. 设置 APIv3 密钥
+
+在商户平台 → 账户中心 → API安全 → 设置 APIv3 密钥：
+
+1. 点击"设置密钥"
+2. 使用随机字符串生成器生成 32 位密钥
+3. 保存密钥（只会显示一次）
+
+## 生产环境配置
+
+### 服务器要求
+
+- 公网可访问的 HTTPS 地址
+- 支持接收 POST 请求的回调接口
+- 服务器时间与微信服务器时间误差不超过 5 分钟
+
+### 回调地址配置
+
+在商户平台 → 产品中心 → 开发配置 中配置：
+
+| 配置项 | 值 |
+|--------|-----|
+| 回调通知地址 | `https://your-domain.com/api/payments/wechat/notify` |
+
+## API 路由
+
+### 创建支付订单
+
+```http
+POST /api/payments/wechat/create
+Content-Type: application/json
+
+{
+  "orderId": "ORDER_123456",
+  "amount": 99.99,
+  "description": "商品描述",
+  "openid": "user-openid"  // JSAPI 支付需要
+}
+```
+
+**响应:**
+
+```json
+{
+  "success": true,
+  "data": {
+    "prepayId": "wx20240101120000...",
+    "appId": "wx...",
+    "timeStamp": "1704096000",
+    "nonceStr": "...",
+    "package": "prepay_id=wx...",
+    "signType": "RSA",
+    "paySign": "..."
+  }
+}
+```
+
+### 支付回调通知
+
+```http
+POST /api/payments/wechat/notify
+Content-Type: application/json
+```
+
+微信支付回调请求头包含 `Wechatpay-Serial` 和 `Wechatpay-Signature`：
+
+```ts
+export async function POST(request: Request) {
+  const body = await request.text()
+  const signature = request.headers.get('Wechatpay-Signature')
+  const serial = request.headers.get('Wechatpay-Serial')
+  
+  // 1. 验证签名
+  const isValid = await verifyWechatSignature(body, signature, serial)
+  if (!isValid) {
+    return new Response('Invalid signature', { status: 400 })
+  }
+  
+  // 2. 解密回调数据
+  const data = JSON.parse(body)
+  const decrypted = await decryptWechatPayload(data)
+  
+  // 3. 更新订单状态
+  // ...
+}
+```
+
+### 查询订单状态
+
+```http
+GET /api/payments/wechat/query?outTradeNo=ORDER_123456
+```
+
+## 安全注意事项
+
+### 签名验证
+
+微信支付使用 **RSA 签名** 和 **AES 加密**，必须严格验证：
+
+```ts
+import { verifyWechatSignature, decryptWechatPayload } from '@/lib/wechat-pay'
+
+export async function POST(request: Request) {
+  const body = await request.text()
+  const signature = request.headers.get('Wechatpay-Signature')
+  
+  // 1. 验证签名
+  const isValid = await verifyWechatSignature(body, signature)
+  if (!isValid) {
+    return new Response('Invalid signature', { status: 400 })
+  }
+  
+  // 2. 解密回调数据
+  const data = JSON.parse(body)
+  const decrypted = await decryptWechatPayload(data)
+  
+  // 3. 验证金额（防止篡改）
+  const order = await db.payments.findOne({ outTradeNo: decrypted.out_trade_no })
+  if (order.amount !== decrypted.amount.total) {
+    return new Response('Amount mismatch', { status: 400 })
+  }
+  
+  // 4. 更新订单状态
+  // ...
+}
+```
+
+### 安全最佳实践
+
+| 风险 | 防护措施 |
+|------|----------|
+| 回调伪造 | 严格验证签名和证书序列号 |
+| 金额篡改 | 比对数据库订单金额与回调金额 |
+| 重复通知 | 使用幂等性处理（out_trade_no 去重） |
+| 密钥泄露 | 私钥仅存储在服务器端 |
+| 中间人攻击 | 使用 HTTPS 传输 |
+| 时间戳重放 | 检查时间戳是否在合理范围内（5分钟） |
+
+### 幂等性处理
+
+```ts
+// 使用数据库唯一约束防止重复处理
+await db.payments.updateOne(
+  { outTradeNo: decrypted.out_trade_no, status: { $ne: 'PAID' } },
+  { 
+    $set: { 
+      status: 'PAID', 
+      transactionId: decrypted.transaction_id 
+    } 
+  }
+)
+```
+
+## 开发环境调试
+
+### 沙箱环境
+
+微信支付提供沙箱环境用于开发测试：
+
+1. 登录 [微信支付商户平台](https://pay.weixin.qq.com/)
+2. 进入 **产品中心 → 开发配置 → 沙箱**
+3. 获取沙箱 API 密钥
+4. 修改环境变量为沙箱配置：
+
+```
+WECHAT_PAY_GATEWAY_URL=https://api.mch.weixin.qq.com/sandboxnew
+```
+
+### 调试工具
+
+- [微信支付开发者工具](https://pay.weixin.qq.com/wiki/doc/apiv3/open/pay/Android_JDk.html)
+- [签名调试工具](https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay6_0.shtml)
+
+## 微信支付 FAQs
+
+**Q: 回调通知收不到？**
+
+A: 检查以下几点：
+1. 服务器是否公网可访问
+2. 回调地址是否正确配置在商户平台
+3. 是否使用 HTTPS（微信要求）
+4. 服务器时间是否准确（误差不超过5分钟）
+5. 防火墙是否放行
+
+**Q: 签名验证失败？**
+
+A: 常见原因：
+1. APIv3 密钥错误
+2. 私钥格式错误（应为 PKCS#8 格式）
+3. 时间戳误差超过 5 分钟
+4. 请求体编码错误（应为 UTF-8）
+
+**Q: 如何测试支付流程？**
+
+A: 使用微信支付沙箱环境：
+1. 在商户平台启用沙箱模式
+2. 使用沙箱 API 密钥
+3. 使用 [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html) 模拟支付
+
+**Q: 如何获取用户的 OpenID？**
+
+A: 对于 JSAPI 支付，需要通过 OAuth 授权获取用户 OpenID：
+1. 引导用户访问微信 OAuth 授权链接
+2. 用户授权后，微信会重定向到回调地址并附带 `code`
+3. 使用 `code` 换取 `openid`
+
+## 相关资源
+
+- [微信支付商户平台](https://pay.weixin.qq.com/)
+- [微信支付开发文档](https://pay.weixin.qq.com/wiki/doc/apiv3/index.shtml)
+- [Native 支付文档](https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_4_1.shtml)
+- [JSAPI 支付文档](https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_1.shtml)
+- [微信支付沙箱环境](https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay7_0.shtml)
+- [APIv3 签名指南](https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay4_0.shtml)
+- [回调通知说明](https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay4_1.shtml)

package/dist/templates/web-nextjs/apps/web/.env.example

@@ -24,3 +24,38 @@ NEXT_PUBLIC_APP_URL=http://localhost:3000
 # Default locale used for root redirects and i18n fallback
 # Allowed values: en, zh
 APP_DEFAULT_LOCALE=zh
+
+# ──────────────────────────────────────────────────────────────────────────────
+# Alipay Payment (Optional)
+# Get these from: Alipay Open Platform → App Center → your app
+# Sandbox: https://open.alipay.com/develop/sandbox
+# ──────────────────────────────────────────────────────────────────────────────
+ALIPAY_APP_ID=<your-app-id>
+ALIPAY_PRIVATE_KEY=-----BEGIN RSA PRIVATE KEY-----
+<your-private-key>
+-----END RSA PRIVATE KEY-----
+ALIPAY_PUBLIC_KEY=-----BEGIN PUBLIC KEY-----
+<your-public-key>
+-----END PUBLIC KEY-----
+# Sandbox gateway (uncomment for sandbox testing):
+# ALIPAY_GATEWAY=https://openapi-sandbox.dl.alipaydev.com/gateway.do
+ALIPAY_NOTIFY_URL=https://your-domain.com/api/payments/alipay/notify
+
+# ──────────────────────────────────────────────────────────────────────────────
+# WeChat Pay (Optional)
+# Get these from: WeChat Pay Merchant Platform
+# ──────────────────────────────────────────────────────────────────────────────
+WECHAT_PAY_APP_ID=wx<your-app-id>
+WECHAT_PAY_MCH_ID=<your-mch-id>
+WECHAT_PAY_API_V3_KEY=<your-32-char-apiv3-key>
+WECHAT_PAY_PRIVATE_KEY=-----BEGIN PRIVATE KEY-----
+<your-private-key>
+-----END PRIVATE KEY-----
+WECHAT_PAY_SERIAL_NO=<your-cert-serial-no>
+# Platform public key (download from GET /v3/certificates)
+WECHAT_PAY_PLATFORM_PUBLIC_KEY=-----BEGIN PUBLIC KEY-----
+<platform-public-key>
+-----END PUBLIC KEY-----
+# Domestic: https://api.mch.weixin.qq.com; Overseas: https://apihk.mch.weixin.qq.com
+WECHAT_PAY_BASE_URL=https://api.mch.weixin.qq.com
+WECHAT_PAY_NOTIFY_URL=https://your-domain.com/api/payments/wechat/notify

package/dist/templates/web-nextjs/apps/web/messages/en.json

@@ -124,6 +124,8 @@
     "resetPasswordSuccess": "Password updated. Please log in."
   },
   "settings": {
+    "profileTitle": "Profile",
+    "subscriptionTitle": "Subscription & Billing",
     "profile": {
       "title": "Profile Settings",
       "subtitle": "Manage your account settings and preferences.",
@@ -160,5 +162,73 @@
       "description": "Learn more about AgentDock.",
       "placeholder": "This page is a placeholder. Replace it with your actual about information before shipping."
     }
+  },
+  "pricing": {
+    "title": "Pricing",
+    "description": "Choose the plan that fits your needs",
+    "monthly": "Monthly",
+    "yearly": "Yearly",
+    "free": "Free",
+    "perMonth": "mo",
+    "perYear": "yr",
+    "currentPlan": "Current Plan",
+    "popular": "Popular",
+    "upgrade": "Upgrade",
+    "getStarted": "Get Started"
+  },
+  "payment": {
+    "checkoutTitle": "Checkout",
+    "orderSummary": "Order Summary",
+    "plan": "Plan",
+    "billingCycle": "Billing Cycle",
+    "total": "Total",
+    "paymentMethod": "Payment Method",
+    "alipay": "Alipay",
+    "wechatPay": "WeChat Pay",
+    "coupon": "Coupon",
+    "couponPlaceholder": "Enter coupon code",
+    "invalidCoupon": "Invalid coupon",
+    "paymentError": "Payment failed. Please try again.",
+    "confirmPayment": "Confirm Payment",
+    "processing": "Processing...",
+    "statusTitle": "Payment Status",
+    "paymentStatus": "Payment Status",
+    "paid": "Paid",
+    "pending": "Pending",
+    "failed": "Failed",
+    "paymentSuccess": "Payment successful!",
+    "paymentFailed": "Payment failed",
+    "paymentPending": "Waiting for payment...",
+    "paymentPendingDescription": "Please complete the payment. This page will update automatically.",
+    "goToDashboard": "Go to Dashboard",
+    "tryAgain": "Try Again"
+  },
+  "subscription": {
+    "title": "Subscription & Billing",
+    "description": "Manage your subscription and payment history",
+    "currentPlan": "Current Plan",
+    "status": "Status",
+    "active": "Active",
+    "trial": "Trial",
+    "expired": "Expired",
+    "cancelled": "Cancelled",
+    "pending": "Pending",
+    "billingCycle": "Billing Cycle",
+    "monthly": "Monthly",
+    "yearly": "Yearly",
+    "expiresOn": "Expires on",
+    "cancelRenewal": "Cancel Auto-Renewal",
+    "cancelledAtPeriodEnd": "Set to cancel at end of period",
+    "noActiveSubscription": "No active subscription",
+    "upgradeNow": "Upgrade Now",
+    "paymentHistory": "Payment History",
+    "noPayments": "No payment history",
+    "feature": "Feature",
+    "free": "Free",
+    "pro": "Pro",
+    "featureProjects": "Projects",
+    "featureApiCalls": "API Calls",
+    "featureSupport": "Priority Support",
+    "featureAnalytics": "Advanced Analytics"
   }
 }