IgnitionStack

✨ IgnitionStack：您的 AI SaaS 快速起步模板

直接上线、支持扩展的 AI SaaS 快速起步模板，助您极速将创新理念变为实在产品。

---

💡 产品亮点一览

IgnitionStack 是一套以 AI 为核心的 SaaS 起步模板，旨在帮助开发者更快地将真实产品推向市场。您无需从零开始，我们将为您提供一套生产级的核心功能，让您的产品迅速落地。

• 🚀 开箱即用：包含用户认证、Stripe 订阅支付、邮件推送、SEO 优化等基础功能。
• 🧠 强大 AI 内核：完整的 AI 配置，内置精致聊天界面，支持多提供商 AI（OpenAI, Gemini, Claude, Ollama）。
• 📚 文档检索增强 (RAG)：支持将 PDF 等文档导入并与之对话，实现智能问答与信息检索。
• 🔍 语义向量检索：通过 Supabase pgvector 实现高效的语义向量检索，让内容被更好理解。
• 🌐 清晰架构：采用 Next.js 15 + React 19 和 Supabase 后端，架构清晰、易于扩展，助您将 MVP 顺利升级为创收产品。

---

🛠️ 核心功能与技术栈

为了给您提供最前沿、最稳定的开发体验，IgnitionStack 精心构建了以下核心模块：

• 前端技术：Next.js 15 (App Router)，React 19，Tailwind CSS (70+ 预构建组件)。
• 后端服务：Supabase (PostgreSQL 数据库，Auth，Storage，行级安全)。
• 支付集成：Stripe (订阅、一次性支付、Webhook 处理、客户门户)。
• AI 能力：
  • ✨ 多提供商 AI Chatbot：支持 OpenAI, Gemini, Claude, Ollama。
  • 📚 RAG (检索增强生成)：支持文档上传（如 PDF），通过 pgvector 进行向量存储和相似度搜索，增强 LLM 回复的相关性。
  • 🔐 AI API 密钥管理：用户可自带 API 密钥进行计费，所有用户密钥均采用 AES-256-GCM 加密存储。
  • 💸 成本优化与监控：内置 AI 使用量估算和监控，支持设置用户消费限额。
  • ⚡ 弹性与容错：通过熔断器（Circuit Breaker）机制，在提供商故障时自动切换，确保服务高可用。
• 用户认证：邮件/密码认证、OAuth 登录 (Google, GitHub)、魔术链接登录、基于角色的访问控制、管理员面板。
• 国际化：支持多种语言 (pt, en, es)。
• 日志与测试：结构化日志 (Pino)，涵盖单元测试与 E2E 测试。

---

📐 优雅的架构设计

IgnitionStack 遵循清晰的架构原则，确保您的产品具有高可维护性和可扩展性：

“抽象数据访问，实现领域驱动，标准化服务响应，并利用可重用组件提升开发效率。”

• 仓库模式 (Repository Pattern)：抽象数据访问层。
• 实体映射器 (Entity Mappers)：数据库到领域模型的转换。
• 操作结果 (Action Results)：标准化服务器操作返回。
• 管理员包装器 (Admin Wrappers)：用于认证的装饰器模式。
• 自定义 Hooks (Custom Hooks)：可重用的 React 模式。

---

🚀 快速部署与扩展

我们提供的详细文档包括安装指南、设置指南、数据库集成、架构详情、组件库、API 参考、分析集成以及 Vercel, Docker, Railway 等部署指南，确保您能够轻松上手并快速将产品推向市场。