跳到主要内容

AOVIS 项目总览

这个仓库承载的是 AOVIS 的分阶段账户基础和独立站底座。它被刻意拆成多个轮次，这样认证、账户、商业流程和发布链路可以逐步演进，而不会互相破坏。

这个仓库包含什么​

  • 账户基础
  • 独立站电商
  • 支付流程
  • 订单历史和支付确认
  • 后续设备与服务工作流的清晰接入路径

先读哪些项目文档​

当前稳定里程碑​

  • aovis-direct-store-v0.5

VM 部署准备​

这个仓库已经准备好采用传统 Linux VM 的发布路径。

  • 搭建 staging 前先读 VM 部署说明
  • 标准 Next.js 生产流程为：npm run build 然后 npm run start
  • staging 要与旧的预发布站点和未来正式生产域名分开
  • 先用 Stripe test keys 做 staging，再切 live secrets

Cloudflare Workers / OpenNext 这条线已经归档，不再是当前活跃部署路径。

技术栈​

  • Next.js App Router
  • TypeScript
  • Tailwind CSS
  • Auth.js v5 (next-auth) + Prisma Adapter
  • Prisma
  • PostgreSQL

第一轮状态​

已实现并验证：

  • Google 登录在 localhost 上用真实 Gmail 账户验证通过，并确认写库成功
  • /login
  • /account
  • /account/profile
  • /account/devices
  • /account/services
  • /account/** 的服务端保护
  • CustomerProfile 读写
  • PostgreSQL + Prisma schema 和 migration
  • 可重复 seed
  • provider 未配置时的优雅回退

第二轮状态​

本轮新增：

  • Apple provider 接线与优雅回退
  • Email magic link provider 接线与真实 SMTP 支持
  • provider 状态辅助函数
  • 账户中心的 Linked Accounts 展示
  • 更结构化的设备与服务摘要
  • 演示用户、设备归属、订阅和 entitlement 数据
  • 账户关联占位动作与后续扩展代码结构

已验证：

  • Google OAuth 在 localhost 上用真实 Gmail 账户验证通过并确认写库
  • Email Magic Link 通过 SMTP 完整验证

本轮未实现：

  • Stripe
  • Apple IAP
  • Google Play Billing
  • 真实设备绑定流程
  • 真实云存储购买流程
  • 真实流量套餐购买流程
  • 管理后台
  • Redis / 队列 / 微服务基础设施

当前稳定版本细节​

当前稳定版本：

  • AOVIS Direct Store v0.5

已完成：

  • 预览修复
  • 商品页运行时修复
  • 品牌一致性收口
  • Stripe test 验证
  • Shipping / returns / support / contact 页面
  • 首尾导航
  • Checkout 成功 / 取消页收口
  • 账户 / 订单中心收口
  • Stripe 生产配置文档
  • 生产环境变量样例
  • 生产就绪页面、导航、页脚和支付后引导
  • Stripe 生产配置准备
  • Live payment readiness 文档
  • 发布检查清单
  • Live payment 验证清单
  • 文案收口

支付状态：

  • Stripe test 模式 checkout 已在本地端到端验证通过

历史 staging 验证记录​

之前的 staging 发布路径已经端到端验证过：

  • 发布模式：传统 VM 部署
  • App server：专用 VM 跑 Next.js 全栈应用
  • Database server：独立 PostgreSQL VM
  • 历史 staging 域名：store-staging.aovis.app
  • Stripe 模式：test sandbox
  • 进程管理：PM2
  • 反向代理：Caddy

生产就绪范围​

本轮已完成：

  • 公共 shipping、returns、support、contact 页面
  • 面向上线的网站导航结构
  • 支付成功和取消页
  • 账户订单中心收口
  • Stripe 生产准备与配置说明

本轮未新增：

  • 设备绑定
  • entitlement 自动开通
  • App Store Billing
  • 退款工具
  • 优惠券 / 折扣引擎
  • CMS 或库存系统
  • Shopify 或基础设施迁移

Stripe live payment 就绪检查​

独立站已经支持 Stripe Checkout 和 webhook 确认。切 live 前要确认：

  • STRIPE_SECRET_KEY 是 live key
  • NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY 是 live publishable key
  • STRIPE_WEBHOOK_SECRET 是 Stripe dashboard 里的 live webhook secret
  • NEXT_PUBLIC_APP_URL 指向正式域名
  • success / cancel URL 都能在正式域名下访问
  • 生产环境可以访问 Stripe webhook endpoint
  • live 部署配置里没有 localhost 或 test-domain 值

正式域名切换​

从 staging 切到正式公共域时，统一使用 https://aovis.app 作为认证、邮件链接、metadata 和支付回调的单一站点源。