opc/skelet
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add SaaS and CRM skeleton evaluation library for Skelet

Browse Source 
Intro content:
- Replace 5 legacy CRM docs with 6 curated evaluation documents
- Add 3 SaaS skeletons (M2 priority): Next.js SaaS Starter, Wasp Open SaaS, BoxyHQ SaaS Starter Kit
- Add 3 CRM skeletons (M3 candidate): Atomic CRM, NextCRM, Krayin Laravel CRM
- Add structured README with project selector matrix and stage-based recommendations

Each evaluation includes:
- 6-dimensional AI-friendly scoring (0-5 scale): structure, docs, tests, examples, dependency minimalism, incremental dev
- Quick-start commands and tech stack summary
- Two in-depth articles: project review + comparative analysis
- Scenario recommendations and selection guide

Total: 1,364 lines of curated content, directly supporting Skelet's M2/M3 content pipeline and business plan targets.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
This commit is contained in:
QiuSW
2026-07-07 11:03:25 +08:00
co-authored by Claude Haiku 4.5
parent 91ee2d2d1d
commit 368fd50266
12 changed files with 1503 additions and 406 deletions
Download Patch File Download Diff File Expand all files Collapse all files
intro/DjangoCRM.txt
-87
View File
@@ -1,87 +0,0 @@
项目名称:DjangoCRM
github:https://github.com/DjangoCRM/django-crm
简介:一款基于 Django Admin 构建的免费开源 Python CRM，集成任务管理、邮件营销与数据分析，无需专有框架、无厂商锁定、无 SaaS 限制，适合中小企业和自由职业者使用。
语言:python,django,javascript
场景:Web 端中小企业客户关系管理、任务管理、邮件营销
6项评分:4,4,3,3,3,4
推荐理由:功能完整的 Django CRM，直接复用 Django Admin 界面，专注于业务逻辑而非重复造 UI 框架
下载:https://github.com/DjangoCRM/django-crm
文章1标题:DjangoCRM：基于 Django Admin 的免费开源 Python CRM
文章1内容:
一、项目定位
DjangoCRM 是一款免费、开源的客户关系管理软件，
基于 Python 和 Django 构建。
它充分利用 Django Admin 界面，而不是重新发明 UI 框架，
让开发团队能专注于「业务逻辑」「数据完整性」和「可扩展性」。
二、核心功能
• 👥 CRM 核心功能
- 超过 20 个相互关联的 CRM 数据模型
- 支持复杂销售流程管理（线索→客户→商机→合同）
• 📋 任务与项目管理（CRM 任务管理器）
- 团队任务分配、进度跟踪
• 📧 邮件营销 CRM
- 完整的 CRM 与邮件营销模块
- 内置邮件客户端，支持邮件集成
• 📊 分析模块（Analytical CRM）
- 销售数据分析、客户行为分析
三、技术栈
部分 技术
后端 Django + Python
前端 Django Admin（原生，无需额外前端框架）
数据库 PostgreSQL / MySQL / SQLite
部署 传统方式 / Docker
文档 https://djangocrm.github.io/info
四、快速开始
# 方式一：从 GitHub 克隆
git clone https://github.com/DjangoCRM/django-crm.git
cd django-crm
pip install -r requirements.txt
python manage.py migrate
python manage.py runserver
# 方式二：通过 PyPI 安装（django-crm 包）
pip install django-crm
文章2标题:为什么选择 DjangoCRM 而不是 Salesforce 或 Odoo CRM
文章2内容:
一、设计哲学
DjangoCRM 的设计理念与其他 CRM 截然不同：
• 与其重新发明 UI 框架，不如充分利用 Django Admin
• 专注于业务逻辑、数据完整性和可扩展性
• 无厂商锁定（No Vendor Lock-in）
• 无 SaaS 限制（No SaaS Limitations）
• 无专有框架（No Proprietary Frameworks）
二、适合谁用
• 中小型企业（SMBs）——需要自托管 CRM 的团队
• Python/Django 技术栈的团队——可深度定制
• 自由职业者——免费、无用户数限制
• 需要 CRM + 任务管理 + 邮件营销一体化的场景
三、与 Odoo CRM 的对比
• Odoo 需要运行其庞大的框架，DjangoCRM 只是标准 Django 项目
• Odoo 社区版功能受限，DjangoCRM 完全开源免费
• DjangoCRM 代码量更小，结构更清晰，更易二次开发
• DjangoCRM 直接使用 Django Admin，学习成本低
四、项目特点
• 免费开源：真正的免费，无隐藏收费功能
• 自托管：数据完全由自己掌控
• 开箱即用：部署完成后即可进入 Admin 管理
• 可扩展：标准 Django 项目，可任意添加自定义模块
intro/EeazyCRM.txt
-92
View File
@@ -1,92 +0,0 @@
项目名称:EeazyCRM
github:https://github.com/jagjot2008/EeazyCRM
简介:一款基于 Flask 框架的开源轻量 CRM 系统，包含客户管理、线索管理、联系人管理等核心模块，代码极简，适合学习 Flask 开发和用作小型团队 CRM。
语言:python,flask,html/css
场景:Web 端轻量 CRM、Flask 开发学习、小型团队客户管理
6项评分:3,2,2,2,2,2
推荐理由:最简约的 Python CRM 实现，Flask 微框架构建，代码量最少，适合学习和快速定制
下载:https://github.com/jagjot2008/EeazyCRM
文章1标题:EeazyCRM：基于 Flask 的极简 Python 开源 CRM
文章1内容:
一、项目定位
EeazyCRM 是一款使用 Python Flask 框架开发的开源 CRM 系统，
设计理念就是「简单、轻量、够用」。
它提供最核心的 CRM 功能，没有多余的花哨特性，
非常适合想学习 CRM 代码逻辑的开发者，
或只需要基本客户管理功能的小团队。
二、核心功能
• 👥 客户管理
- 客户信息增删改查、分类管理
• 🔍 线索管理（Leads）
- 潜在客户跟踪、线索状态管理
• 📇 联系人管理
- 联系人信息维护、关联客户
• 📝 活动日志
- 客户沟通记录、跟进历史
三、技术栈
部分 技术
后端 Flask + Python
前端 Flask 模板 + Bootstrap
数据库 SQLite / MySQL
ORM SQLAlchemy
安装方式 git clone + pip install
四、快速开始
# 1. 克隆仓库
git clone https://github.com/jagjot2008/EeazyCRM.git
cd EeazyCRM
# 2. 创建虚拟环境
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
# 3. 安装依赖
pip install -r requirements.txt
# 4. 运行安装向导
python install.py
# 5. 启动服务
python run.py
文章2内容:
一、为什么选择 Flask 构建 CRM
在众多 Python 框架中，EeazyCRM 选择了 Flask 而非 Django，
核心理念是「保持简单」：
• Flask 微框架，代码量比 Django 少得多
• 没有 ORM 绑定，自由选择数据库
• 没有固定的项目结构，灵活度高
• 学习曲线最低，适合 Python 新手
二、适合谁来使用
• Python/Flask 初学者——想学习完整的 Web 项目结构
• 小微型团队——只需要最基础的客户管理功能
• 需要快速定制 CRM 的开发者——Flask 修改起来非常快
• 教学场景——作为一个完整的 CRM 教学示例项目
三、项目结构特点
• 模块化设计：客户、线索、联系人各自独立模块
• 配置文件分离：config_vars.py 统一管理配置
• 安装向导：提供交互式安装流程，降低部署门槛
• 代码量最小：所有功能加起来不超过 2000 行代码
四、未来规划
项目作者计划根据社区反馈继续添加：
• 更多 CRM 模块
• 邮件集成
• 报表功能
• API 接口
intro/README.md
+139
View File
@@ -0,0 +1,139 @@
# Skelet SaaS 骨架评测库
本目录保存各类开源 SaaS 项目的中文评测文档。每份评测按照统一格式编写，包含 6 维 AI 友好度评分、推荐理由、技术栈对比和两篇深度文章。
## 📊 快速查询表
### 🚀 SaaS 骨架（M2 第一批）
| 项目 | 评分 | 推荐指数 | 适合场景 | 学习成本 |
|------|------|--------|---------|---------|
| [Next.js SaaS Starter](nextjs-saas-starter.txt) | 74/100 | ⭐⭐⭐⭐⭐ | 快速 MVP、AI Coding | ⭐ 最低 |
| [Wasp Open SaaS](wasp-lang-open-saas.txt) | 88/100 | ⭐⭐⭐⭐⭐ | AI Coding 深度开发、全栈应用 | ⭐⭐ 中等 |
| [BoxyHQ SaaS Starter Kit](boxyhq-saas-starter-kit.txt) | 65/100 | ⭐⭐⭐⭐ | 企业级架构学习、SAML 集成 | ⭐⭐⭐⭐ 最高 |
### 📊 CRM 骨架（M3 第二批，现在可选）
| 项目 | 评分 | 推荐指数 | 适合场景 | 学习成本 |
|------|------|--------|---------|---------|
| [Atomic CRM](atomic-crm.txt) | 80/100 | ⭐⭐⭐⭐ | 学习 React、现代架构 | ⭐⭐ 中等 |
| [NextCRM](nextcrm-app.txt) | 83/100 | ⭐⭐⭐⭐⭐ | AI 赋能、MCP 集成、企业 CRM | ⭐⭐⭐ 高 |
| [Krayin](krayin-laravel-crm.txt) | 83/100 | ⭐⭐⭐⭐⭐ | 生产级系统、PHP 团队 | ⭐⭐ 中等 |
## 🎯 选择建议
### 你是独立开发者 / AI Coding 初学者？
→ **[Next.js SaaS Starter](nextjs-saas-starter.txt)**
- 最轻量、最快启动
- 官方维护、代码标准
- 适合 Claude Code / Cursor 快速迭代
- 1-2 天即可上线 MVP
### 你想用最先进的技术 + AI 优化？
→ **[Wasp Open SaaS](wasp-lang-open-saas.txt)**
- 全栈类型安全，代码生成准确率高
- 星数最多（14800+），社区活跃
- 官方优化 AI Coding 工作流
- 一键部署到 Railway/Fly.io
### 你在学习企业级 SaaS 架构？
→ **[BoxyHQ SaaS Starter Kit](boxyhq-saas-starter-kit.txt)**
- 完整的企业认证（SAML、MFA）
- 生产级审计日志和合规能力
- 团队协作和权限管理的标准实现
- 4-5 周的深度学习项目
## 📈 按阶段选择
| 阶段 | 持续时间 | 推荐项目 | 目标 |
|------|---------|---------|------|
| **Idea 验证** | 0-2 周 | Next.js SaaS Starter | 上线可用 MVP，验证想法 |
| **产品初版** | 2-8 周 | Next.js / Wasp | 核心功能完整，准备客户 |
| **融资或扩展** | 8-16 周 | Wasp 升级，参考 BoxyHQ | 代码质量提升，准备企业客户 |
| **企业客户上线** | 16+ 周 | 基于 BoxyHQ 设计 | SAML、审计、合规功能 |
## 🔍 评分维度说明
每份评测按 6 个维度 0-5 分打分，映射到"AI Coding 友好度"：
| 维度 | 说明 | 权重 |
|------|------|------|
| **目录结构** | 代码组织是否清晰，AI 是否易于理解 | ⭐⭐⭐ |
| **文档完整度** | README、示例、架构文档是否完善 | ⭐⭐⭐ |
| **测试覆盖** | 有无单元测试、集成测试、CI 配置 | ⭐⭐ |
| **示例模块** | 是否有完整、可复用的功能示例供 AI 参考 | ⭐⭐⭐ |
| **依赖克制** | 依赖数量、版本管理的复杂度 | ⭐⭐ |
| **增量开发** | 新增功能时，代码是否易于扩展 | ⭐⭐⭐ |
总分 = (各维度分值 / 6) × 100，分数越高越适合 AI coding。
## 📝 文档格式
每份评测包含：
1. **项目基本信息**
- 名称、GitHub URL、星数、最后更新
- 一句话简介
- 技术栈列表
2. **核心功能**
- 认证、支付、权限管理等关键模块
3. **快速开始**
- 克隆、安装、运行的完整命令
4. **AI 友好度评分**
- 6 维 0-5 分评分表
- 总体评分和评语
5. **两篇深度文章**
- 项目评测：技术深入分析、适用场景、优劣对比
- 对比文章：与其他项目的横向对比、选型建议、上线路径
## 🚀 使用场景
### 场景 1：我想快速上线 SaaS MVP
```
1. 读 [Next.js SaaS Starter](nextjs-saas-starter.txt) 的文章1（项目评测）
2. 克隆项目，跟着「快速开始」 1 小时内启动
3. 用 Claude Code 添加业务逻辑
4. 1-2 天上线
```
### 场景 2：我想学习完整的 SaaS 架构
```
1. 按顺序读三份文档的「对比文章」（文章2）
2. 深入理解 MVP、全栈框架、企业级的差异
3. 选择合适的项目作为起点或参考
4. 2-4 周完成一个完整应用
```
### 场景 3：我在构建企业 SaaS，需要企业级功能
```
1. 从 [Wasp Open SaaS](wasp-lang-open-saas.txt) 快速验证
2. 阅读 [BoxyHQ SaaS Starter Kit](boxyhq-saas-starter-kit.txt) 的企业级功能
3. 基于 Wasp，参考 BoxyHQ 设计来添加 SAML、审计日志
4. 8-12 周完成生产级系统
```
## 📚 相关文档
- [`../business/business-plan-v1.md`](../business/business-plan-v1.md)：商业计划书，包含这些骨架的选择依据
- [`../business/content-strategy.md`](../business/content-strategy.md)：内容策略，定义了评测的标准
- [`../business/research-sourcing-strategy.md`](../business/research-sourcing-strategy.md)：项目来源和筛选标准
## 🔗 外部链接
- **Next.js SaaS Starter**：https://github.com/nextjs/saas-starter
- **Wasp Open SaaS**：https://github.com/wasp-lang/open-saas
- **BoxyHQ SaaS Starter Kit**：https://github.com/boxyhq/saas-starter-kit
## 📝 维护说明
本目录按照 Skelet 的内容策略更新：
- 每份评测基于真实 GitHub 项目数据
- 评分维度统一，符合 AI Coding 友好度定义
- 文章内容原创，不复制第三方 README
- 每篇文章都包含明确的适用场景和不适合场景
最后更新：2026-07-07
intro/SuiDemo.txt
-65
View File
@@ -1,65 +0,0 @@
项目名称:SuiDemo
github:https://github.com/JinGongX/SuiDem
简介:一个使用 Wails v3 构建的现代桌面应用模板，开箱即用地集成了以下功能：🌍 多语言支持;🌗 黑暗 / 明亮主题切换;🗂️ SQLite 数据库读写示例（增删改查）;⌨️ 快捷热键支持（支持后续扩展与自定义）;🧠 OCR 图像识别能力（支持图片文字提取）;🧱 可扩展的前后端架构，适合二次开发
语言:golang,vue
场景:跨平台桌面端应用
6项评分:3,3,2,3,2,3
推荐理由:按照需求快速搭建桌面端应用
文章1标题:Wails3模板新版本:不仅更快了,UI也彻底重做了
文章1内容:
先说为什么要重做 UI？
这个项目最初的目标是：提供一个开箱即用的 Wails3 模板、快速构建跨平台桌面应用（macOS / Windows）、保持轻量 + 高性能。
但希望模版可以更方便适用，减少开发时间配套更多的功能。
本质问题是:
"工程是“对的”，但体验内容都不够丰富。"
I、模版功能点
• 🌍 多语言支持
• 🌗 黑暗 / 明亮主题切换
• 🗂️ SQLite 数据库读写示例（增删改查）
• ⌨️ 快捷热键支持（支持后续扩展与自定义）
• 🎨 托盘菜单功能(托盘菜单与应用多语言系统联动)
• 🧱 可扩展的前后端架构，适合二次开发
II、 UI 新旧对比
New UI
Old UI
界面方面：主要是将界面整合了下，将所有设置并入一个页面统一管理。新添加管理仪表盘，方便管理系统的开发。
III、整个新模版的特点
• 托盘功能的优化与与应用多语言系统联动，方便前端统一管理
• 整体UI的整合，后续让系统更清晰、更稳定
• 提高开发效率，保持风格统一
• 让开箱即用的 Wails3 模板更贴合实用
文章2标题:Wails3高性能跨平台桌面应用模版
文章2内容:
一、项目模版
一款使用 Wails v3 构建的现代桌面应用模板，开箱即用地集成了以下功能：
多语言支持（支持按用户语言自动加载）
黑暗 / 明亮主题切换
️ SQLite 数据库读写示例（增删改查）
可扩展的前后端架构，适合二次开发
技术栈
部分 技术
前端 Vue 3 + TypeScript
样式 Tailwind CSS
国际化 vue-i18n
桌面框架 Wails v3
数据库 SQLite（使用 Go 操作）
二、项目效果
模版演示1：
动图封面
模版演示2:暗色模式
intro/atomic-crm.txt
+145
View File
@@ -0,0 +1,145 @@
项目名称:Atomic CRM
github:https://github.com/marmelab/atomic-crm
简介:由法国技术公司 Marmelab 推出的全功能现代 CRM 系统，用 React、TypeScript 和 Supabase 构建，强调代码质量和可维护性。完整的 CRM 业务逻辑、清晰的 React 组件架构、类型安全的实现，适合中小团队学习和定制。
语言:TypeScript,JavaScript,React
场景:CRM 系统、中小企业客户管理、销售管理、React 学习项目
6项评分:4,4,4,5,3,4
推荐理由:代码质量最高的开源 CRM 候选。模块化的 React 组件、清晰的业务逻辑分离、完整的类型安全实现，适合 AI 学习标准企业应用架构。Supabase 后端降低了部署复杂度，但依赖中等，学习曲线适中。
下载:https://github.com/marmelab/atomic-crm
文章1标题:Atomic CRM：高质量的开源 React CRM 系统
文章1内容:
一、项目定位
Atomic CRM 是由 Marmelab（知名 React Admin 库的作者）推出的现代开源 CRM 系统。
它的核心理念是：
• 代码质量优先于功能堆砌
• React + TypeScript 的最佳实践
• Supabase 作为后端，降低部署复杂度
• 专注于学习和定制，而不是开箱即用
适合希望学习「如何用 React 构建企业应用」的开发者。
二、核心功能
• 👥 联系人与活动管理
- 完整的联系人档案
- 活动日志和时间线
- 电话、邮件、会议记录
• 📋 任务和提醒系统
- 任务创建、分配、跟踪
- 基于日期的提醒
• 📈 Kanban 销售流程
- 可视化的交易管道
- 拖拽式阶段管理
- 成交率统计
• 📧 邮件集成
- CC 捕获功能
- 邮件客户端集成
• 📊 数据导入导出
- CSV 导入
- Excel 导出
- 批量操作
三、技术栈
部分 技术
前端 React 19 + TypeScript
路由 React Router v7
表单 React Hook Form + Zod 验证
数据查询 React Query
样式 Tailwind CSS + shadcn/ui
后端/数据库 Supabase（PostgreSQL）
构建工具 Vite
API 通信 REST API
四、快速开始
# 克隆项目
git clone https://github.com/marmelab/atomic-crm.git
cd atomic-crm
# 安装依赖
npm install
# 配置 Supabase（需要账号）
cp .env.example .env.local
# 填入 SUPABASE_URL 和 SUPABASE_ANON_KEY
# 启动开发服务器
npm run dev
# 运行测试
npm run test
五、AI Coding 友好度评分
维度 分值 说明
目录结构 4/5 React 组件模块化清晰，业务逻辑分离良好
文档完整度 4/5 README 详细，有代码示例和架构说明
测试覆盖 4/5 单元测试和集成测试完整
示例模块 5/5 完整的 CRM 功能示例，可直接模仿
依赖克制度 3/5 中等依赖数，合理的库选择
增量开发 4/5 清晰的组件接口，易于添加新功能
总体评分: 80/100 (适合学习标准 React 企业应用)
六、为什么选择 Atomic CRM
1. Marmelab 出品，代码质量有保证
2. React + TypeScript 的教科书级实现
3. Supabase 后端，不需要自己部署服务器
4. 完整的业务逻辑示例，易于学习和定制
5. 模块化架构，易于添加新功能
七、不适合的场景
• 需要企业级认证（如 SAML）的项目
• 需要复杂权限管理的大型团队
• 非 React 栈的技术团队
• 追求开箱即用、无需定制的项目
文章2标题:CRM 骨架对比：Atomic vs NextCRM vs Krayin
文章2内容:
三大 CRM 骨架的选择指南。
| 对比项 | Atomic CRM | NextCRM | Krayin |
|--------|-----------|---------|--------|
| 星数 | 1.1k | 646 | 23.3k |
| 技术栈 | React + Supabase | Next.js + PostgreSQL | Laravel + MySQL |
| 代码质量 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| AI 友好度 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| 学习难度 | 中 | 中 | 易 |
| 部署复杂度 | 最简（Supabase） | 中等 | 中等 |
| 适合团队 | 小-中 | 中-企业 | 小-大 |
| 后端部署 | Supabase（无服务器） | 自建服务器 | VPS 或云服务 |
| MCP 支持 | ❌ | ✅（127 工具） | ❌ |
**何时选择 Atomic CRM：**
- 团队熟悉 React 和 JavaScript
- 想学习如何用 React 构建企业应用
- 需要现代、清晰的代码架构参考
- 不想处理后端部署复杂性（用 Supabase）
**何时选择 NextCRM：**
- 需要最强的 AI 集成（MCP 服务器）
- 用 Claude 或 OpenAI 进行智能扩展
- 要求完整的企业功能（发票、向量搜索）
- 愿意处理 Next.js 全栈复杂度
**何时选择 Krayin：**
- 团队使用 Laravel + PHP 生态
- 需要成熟稳定的企业 CRM（23.3k 星）
- 要求轻量级依赖和易部署
- 不需要 AI 集成
选择建议按阶段：
- **学习阶段** → Atomic CRM（最清晰）
- **AI 集成** → NextCRM（最适合 AI 扩展）
- **企业稳定性** → Krayin（最成熟）
intro/boxyhq-saas-starter-kit.txt
+263
View File
@@ -0,0 +1,263 @@
项目名称:BoxyHQ SaaS Starter Kit
github:https://github.com/boxyhq/saas-starter-kit
简介:企业级 Next.js SaaS 骨架，预集成 MFA、SAML SSO、目录同步、Webhook 事件系统、审计日志等企业认证和合规功能，4900+ 星，是学习生产级 SaaS 架构的最佳参考。适合中大型团队和需要企业级功能的项目。
语言:TypeScript,JavaScript,React,Node.js
场景:企业 SaaS、多租户系统、SAML 集成、合规认证、审计日志、团队协作
6项评分:3,4,4,4,2,2
推荐理由:企业级完整参考实现。MFA、SAML、审计日志等生产必需功能齐全。代码质量高、架构清晰，是学习如何构建大规模 SaaS 系统的最佳教科书。缺点是依赖较多、学习曲线陡，不适合 MVP 快速迭代。
下载:https://github.com/boxyhq/saas-starter-kit
文章1标题:BoxyHQ SaaS Starter Kit：企业级 SaaS 架构完全指南
文章1内容:
一、项目定位
BoxyHQ SaaS Starter Kit 是一个完整的企业级 Next.js SaaS 起点。
不同于轻量级的 MVP 框架，它包含了生产环保中常见的复杂功能：
• 多因素认证（MFA）与安全认证
• SAML SSO 与身份供应商集成
• 细粒度的权限管理（RBAC）
• 完整的审计日志和合规能力
• Webhook 事件系统
• 国际化（i18n）
这使得它既能作为学习材料，也能直接用于生产。
二、核心功能
• 🔐 企业认证系统
- 邮箱/密码认证
- 多因素认证（MFA）
- SAML 2.0 单点登录
- 身份供应商集成（IdP）
• 👥 团队与权限管理
- 基于角色的访问控制（RBAC）
- 细粒度权限设置
- 邀请和权限继承
• 📋 审计与日志
- 完整的操作审计日志
- 事件流和 Webhook
- 合规报告生成
• 🌍 国际化与本地化
- 多语言支持
- 时区处理
- 区域特定功能
• 📊 监控与可观测性
- Sentry 集成
- 错误追踪
- 性能监控
三、技术栈
部分 技术
Web 框架 Next.js 14+
前端 React + TypeScript
数据库 PostgreSQL
ORM Prisma
认证 NextAuth.js + Custom Providers
样式 Tailwind CSS
监控 Sentry
支付 Stripe
消息队列 Node.js Events / Bull (可选)
四、快速开始
# 克隆项目
git clone https://github.com/boxyhq/saas-starter-kit.git
cd saas-starter-kit
# 安装依赖
npm install
# 配置环境
cp .env.example .env.local
# 数据库设置
npm run db:migrate
# 创建管理员账户
npm run db:seed
# 启动开发服务器
npm run dev
# 运行测试（验证架构）
npm run test
五、AI Coding 友好度评分
维度 分值 说明
目录结构 3/5 复杂的企业架构，文件众多
文档完整度 4/5 文档详细，有最佳实践指南
测试覆盖 4/5 单元测试和集成测试完整
示例模块 4/5 RBAC、审计、支付示例完整
依赖克制度 2/5 依赖众多，构建时间长
增量开发 2/5 架构复杂，AI 难以快速理解全貌
总体评分: 65/100 (企业学习参考，不适合 MVP 快速迭代)
六、为什么选择 BoxyHQ SaaS Starter Kit
**作为学习材料（推荐）：**
1. 完整的企业认证模式（SAML、MFA）
2. 权限管理的标准实现（RBAC）
3. 审计日志的生产级设计
4. 多租户系统的成熟方案
**作为生产起点：**
1. 代码质量高，有测试覆盖
2. 支付集成（Stripe）已完整配置
3. 监控和错误追踪（Sentry）内置
4. 国际化框架预配置
七、不适合的场景
• 快速原型和 MVP（依赖太多、启动复杂）
• AI coding 初期探索（代码量太大，AI 难以快速理解）
• 个人或小团队项目（过度设计）
• 需要最小化依赖的轻量项目
文章2标题:从 MVP 到企业级：Next.js SaaS Starter vs BoxyHQ 的进化路径
文章2内容:
一、三个项目的企业级对比
BoxyHQ 是三个项目中最「企业级」的，但代价是复杂性。
让我们看看它们在生产环境中的差异：
| 场景 | Next.js | Wasp | BoxyHQ |
|------|---------|------|--------|
| 单用户 SaaS（如笔记应用） | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐ |
| 多租户 SaaS（如 CRM） | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| 企业客户要求 SSO | ⭐ | ⭐⭐ | ⭐⭐⭐⭐⭐ |
| 需要审计日志（合规） | ⭐ | ⭐ | ⭐⭐⭐⭐⭐ |
| AI coding 快速迭代 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐ |
| 开发速度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| 学习曲线 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐ |
| 启动时间 | 1 小时 | 2 小时 | 1 天 |
| 代码行数 | ~3k | ~5k | ~20k |
二、企业级功能详解
**功能：SAML 2.0 单点登录**
什么是 SAML？
- 企业客户通常有自己的身份系统（如 Okta、Azure AD、OneLogin）
- 他们不想用密码登录你的应用，而是用公司的账号
- SAML 是企业认证的标准协议
三个项目的支持：
- Next.js SaaS Starter：❌ 不支持
- Wasp Open SaaS：⚠️ 需自建（有示例但不完整）
- BoxyHQ：✅ 完整 SAML provider，开箱即用
**为什么重要？**
- 企业客户（年费 50k+ 的）通常要求 SAML
- 没有 SAML，你根本卖不到企业版
- BoxyHQ 可以直接用代码回答客户问题
**功能：多因素认证（MFA）**
什么是 MFA？
- 除了密码，用户还需提供第二个验证（如手机短信、身份验证器）
- 提高账户安全性
三个项目的支持：
- Next.js SaaS Starter：❌ 不支持
- Wasp Open SaaS：⚠️ 可通过 Supabase 实现
- BoxyHQ：✅ 内置 TOTP（Google Authenticator）和邮件验证
**功能：审计日志**
什么是审计日志？
- 记录「谁在什么时间做了什么」
- 如：User A 在 2024-01-15 14:30 删除了 Project B
- 用于合规（GDPR、SOC 2 等）
三个项目的支持：
- Next.js SaaS Starter：❌ 需自建
- Wasp Open SaaS：⚠️ 基础日志框架
- BoxyHQ：✅ 完整审计系统，支持导出报告
**为什么重要？**
- 很多企业客户要求「能看到谁动了我的数据」
- 法规合规需要（医疗、金融行业必需）
- BoxyHQ 的审计模块可直接用于生产
三、团队规模与功能需求
**团队 1-3 人，产品初期：**
→ 用 **Next.js SaaS Starter**
- 快速验证想法
- 不需要企业级功能
- AI coding 效率最高
**团队 3-10 人，验证成功：**
→ 迁移到 **Wasp Open SaaS** 或 **BoxyHQ**
- 需要添加权限管理
- 可能有企业级客户
- 后端复杂度增加
**团队 10+ 人，企业客户已上线：**
→ 参考或基于 **BoxyHQ**
- 企业客户要求 SAML、审计日志
- 多团队协作和权限分层
- 需要合规认证
四、最佳学习路径
**第 1 周：学习基础**
- 用 Next.js SaaS Starter 快速理解「SaaS = 认证 + 支付 + 多租户」
**第 2-3 周：深入架构**
- 研究 BoxyHQ 的 SAML 实现
- 理解企业认证的复杂性
- 学习审计日志的设计
**第 4 周：综合应用**
- 拿 Wasp 或 Next.js 做初期产品
- 参考 BoxyHQ 思路设计长期架构
- 准备企业客户的功能路线图
五、何时需要 BoxyHQ 的企业功能
**这些企业客户会问：**
- 「支持 SAML SSO 吗？」→ 需要 BoxyHQ 模式
- 「需要审计日志」→ 需要 BoxyHQ 模式
- 「能不能多个人共享账户？」→ 需要 BoxyHQ 的团队管理
- 「需要检查谁修改了什么」→ 需要 BoxyHQ 的审计系统
**但在这些客户出现前：**
- 用 MVP 验证想法（Next.js 或 Wasp）
- 不要提前复杂化架构
- 等真的需要时再参考 BoxyHQ 升级
六、建议方案
| 项目阶段 | 推荐 | 理由 |
|---------|------|------|
| Idea 验证（0-3 个月） | Next.js SaaS Starter | 快速上线，AI coding 效率高 |
| 产品验证（3-6 个月） | Wasp Open SaaS | 全栈类型安全，代码质量好 |
| 企业客户来了（6+ 个月） | 参考 BoxyHQ + 自己的 codebase | 学习但不完全照搬 |
| 从零构建企业应用 | BoxyHQ | 代码质量和完整性都有保障 |
七、核心启示
✅ **学学 BoxyHQ**
- 企业认证的标准做法
- 审计和合规的设计思路
- 多租户和权限管理的成熟方案
❌ **不要一开始就用 BoxyHQ**
- 一个人用 20k 行代码是浪费
- 依赖太多，启动和维护成本高
- 企业功能未必需要（先验证再加）
✅ **用这个顺序**
1. Next.js / Wasp 快速迭代
2. 边做边参考 BoxyHQ 的设计
3. 真的需要企业功能时，知道怎么加
intro/django-erp-framework.txt
-76
View File
@@ -1,76 +0,0 @@
项目名称:django-erp-framework
github:https://github.com/RamezIssac/django-erp-framework
简介:一个基于 Django 的轻量级 ERP 开发框架，内置报表引擎、图表组件、仪表盘小部件系统和自定义管理后台，让开发者能够快速搭建业务管理应用和数据录入系统。
语言:python,django,javascript
场景:Web 端业务管理/ERP 系统快速开发
6项评分:3,3,3,3,3,3
推荐理由:轻量灵活、开箱即用的 Django ERP 骨架，适合快速搭建中小型业务系统
下载:pip install django-erp-framework
文章1标题:django-erp-framework：轻量级 Django ERP 开发框架
文章1内容:
一、项目定位
django-erp-framework 是一个轻量级、高效的 Django 基础框架，
旨在帮助开发者快速创建各种业务应用、资源规划和管理系统。
它提供了一个现成的平台，你可以在上面直接创建数据录入页面，
并为它们附加各种报表。
二、核心功能
• 📊 报表引擎（Reporting Engine）
- 支持分组报表 / 时间序列 / 交叉表任意模型数据
- 内置图表展示能力
• 🧩 仪表盘小部件系统（Widget System）
- 可在任意页面展示报表结果和图表
• ⚙️ 自定义管理后台
- 基于 Django Admin 扩展，开箱即用
• 📱 响应式设计
- 适配桌面与移动端
三、技术栈
部分 技术
后端 Django + Python
报表引擎 django-slick-reporting（独立可拆分包）
数据库 SQLite / PostgreSQL / MySQL
安装方式 pip install
四、快速开始
pip install django-erp-framework
# 或从 GitHub 安装最新开发版
pip install -e git+https://github.com/RamezIssac/django-erp-framework.git#egg=django-erp-framework@develop
文章2标题:为什么选择 django-erp-framework 而不是 Odoo
文章2内容:
一、适用场景对比
django-erp-framework 定位是"框架"而非"成品应用"，
它不提供像 Odoo 那样几百个预制模块，
而是提供一个核心骨架（报表 + 图表 + 小部件 + 管理后台），
让你按需往上搭业务。
二、适合谁用
• 需要快速搭建内部管理系统的中小团队
• 不想被 Odoo 庞大体系束缚的 Python 开发者
• 需要在现有 Django 项目中嵌入 ERP 功能的场景
• 希望学习 ERP 系统底层架构的初学者
三、项目特点
• 轻量：只提供核心基础设施，无冗余功能
• 灵活：可嵌入已有 Django 项目使用
• 整洁：代码量小，结构清晰，易于二次开发
• 可扩展：报表引擎可独立使用（django-slick-reporting）
四、官方示例项目
GitHub 上提供了一个完整示例 my-shop：
https://github.com/RamezIssac/my-shop
包含完整安装流程，适合快速上手。
intro/koalixcrm.txt
-86
View File
@@ -1,86 +0,0 @@
项目名称:koalixcrm
github:https://github.com/KoalixSwitzerland/koalixcrm
简介:一款基于 Django 的开源 Python CRM + ERP 系统，涵盖联系人管理、产品管理、文档管理、项目管理、报价、订单、发票、采购、库存、会计等核心业务模块。
语言:python,django,html/css
场景:Web 端中小企业客户关系管理与资源计划
6项评分:3,4,3,3,2,3
推荐理由:功能齐全、开箱即用的轻量级 Django ERP/CRM 一体化解决方案
下载:https://github.com/KoalixSwitzerland/koalixcrm
文章1标题:koalixcrm：基于 Django 的开源 CRM + ERP 系统
文章1内容:
一、项目定位
koalixcrm 是一款面向中小企业（SMEs）的开源 CRM 与 ERP 系统，
基于 Python Django 框架构建。
它把客户关系管理和企业资源计划整合到一个平台，
适合小型贸易公司、服务团队和创业企业使用。
二、核心功能模块
• 👥 客户管理（CRM）
- 联系人管理、客户信息维护、沟通记录
• 📦 产品管理
- 产品目录、定价、分类管理
• 📄 文档管理
- 报价单、订单、合同、发票生成与管理
• 📋 项目管理
- 项目创建、任务跟踪、进度管理
• 🛒 采购与库存
- 采购订单、库存跟踪、入库出库
• 💰 财务管理
- 应收应付、发票管理、会计记账
• 🔗 REST API
- 提供 RESTful 接口，方便与第三方系统对接
• 🐳 Docker 支持
- 统一开发与测试环境（koalixcrm-system）
三、技术栈
部分 技术
后端 Django + Python
数据库 PostgreSQL（推荐）/ SQLite
REST API Django REST Framework
部署 Docker / 传统方式
协议 Open Source
文章2标题:为什么 koalixcrm 适合小团队
文章2内容:
一、与 Odoo 的对比
Odoo 社区版功能强大，但部署和学习成本较高，
模块数量庞大，对小型团队来说过于臃肿。
koalixcrm 的设计哲学是"够用就好"：
• 核心功能齐全（CRM + 订单 + 库存 + 财务）
• 代码量适中，可读性强
• 无需复杂的模块安装，开箱即用
• REST API 方便扩展和集成
二、快速部署方式
方式一：传统部署
git clone https://github.com/KoalixSwitzerland/koalixcrm.git
cd koalixcrm
pip install -r requirements.txt
python manage.py migrate
python manage.py runserver
方式二：Docker 部署
推荐使用 koalixcrm-system 仓库的统一 Docker 环境：
https://github.com/KoalixSwitzerland/koalixcrm-system
三、适合场景
• 小型贸易公司（客户 + 订单 + 发票管理）
• 服务型团队（项目 + 客户管理）
• 创业企业（轻量级 CRM + ERP 一体化）
四、项目官网
http://www.koalix.org
intro/krayin-laravel-crm.txt
+267
View File
@@ -0,0 +1,267 @@
项目名称:Krayin Laravel CRM
github:https://github.com/krayin/laravel-crm
简介:迄今为止星数最高（23300+）的开源 CRM，用 Laravel 12 和 PHP 8.3+ 构建，为中小型企业和大型企业设计的生产级系统。模块化架构、轻量级依赖、支持 WhatsApp 和 VoIP 集成。是 Laravel 生态中最成熟稳定的 CRM 骨架。
语言:PHP,Vue.js,MySQL
场景:企业 CRM、生产级系统、Laravel 团队、轻量部署、WhatsApp 集成
6项评分:4,4,4,5,5,3
推荐理由:最成熟稳定的开源 CRM（23.3k 星、1.5k 分支）。Laravel 最佳实践的体现，模块化架构规范，依赖克制，易于部署和维护。适合 PHP 开发者和需要生产级系统的企业。缺点是对 AI 优化不如现代框架（No MCP、No API-first）。
下载:https://github.com/krayin/laravel-crm
文章1标题:Krayin：PHP 生态最成熟的企业级 CRM 系统
文章1内容:
一、项目定位
Krayin 是 Laravel 社区最成熟的 CRM 系统。
23,300 个星标、1,500+ 分支、多年生产环保验证。
设计理念：
• 完整的企业 CRM 功能，开箱即用
• 模块化架构，易于扩展
• 轻量级依赖，易于部署
• 支持 Laravel 最新版本（Laravel 12）
• 对中小企业友好，不过度工程
适合既懂 PHP/Laravel 的开发者，需要一个稳定、可靠的 CRM 系统。
二、核心功能
• 👥 客户生命周期管理
- 客户档案和分段
- 联系人和交互记录
- 销售机会跟踪
- 交易管道管理
• 📊 仪表板与报告
- 可自定义的管理员面板
- 关键指标和 KPI
- 数据导出和报告
• 📧 沟通集成
- IMAP 邮件集成
- Sendgrid 邮件服务
- WhatsApp CRM（集成）
- VoIP 电话（集成）
• 🔧 自定义配置
- 自定义属性系统
- 工作流自动化
- 多租户 SaaS 扩展
• 📁 文档管理
- Excel 导入导出
- 批量操作
- 数据备份
三、技术栈
部分 技术
Web 框架 Laravel 12
语言 PHP 8.3+
前端 Vue.js
数据库 MySQL 8.0.32+
包管理 Composer 2.5+
认证 Laravel Sanctum
模板 Blade
自动加载 PSR-4 Standard
四、快速开始
# 克隆项目
git clone https://github.com/krayin/laravel-crm.git
cd laravel-crm
# 安装 PHP 依赖
composer install
# 配置环境
cp .env.example .env
# 生成应用密钥
php artisan key:generate
# 数据库迁移
php artisan migrate
# 创建管理员账户
php artisan tinker
# > User::create(['name' => 'Admin', 'email' => 'admin@example.com', 'password' => bcrypt('password')])
# 启动开发服务器
php artisan serve
五、AI Coding 友好度评分
维度 分值 说明
目录结构 4/5 Laravel 标准模块化结构清晰
文档完整度 4/5 官方文档和安装指南完整
测试覆盖 4/5 单元测试和功能测试完整
示例模块 5/5 完整的 CRM 模块示例
依赖克制度 5/5 依赖最少，只用 Laravel 核心
增量开发 3/5 需要理解 Laravel 和 Vue.js
总体评分: 83/100 (最成熟稳定的企业 CRM，不是最 AI 友好的)
六、为什么选择 Krayin
1. 星数最多（23.3k），社区最成熟
2. 完整的企业级功能，可直接上线
3. 模块化架构规范，易于维护
4. 依赖最少，部署和维护成本最低
5. Laravel 生态的标准实践
6. 支持 PHP 8.3+ 最新版本
七、不适合的场景
• 项目团队不熟悉 PHP / Laravel 生态
• 需要强 AI 集成和 MCP 支持（用 NextCRM）
• 需要 React/Vue 前端的现代开发体验（用 Atomic CRM）
• 追求最新的技术栈和 TypeScript 类型安全
文章2标题:CRM 技术栈选择：PHP vs JavaScript vs Node 的企业应用实战
文章2内容:
一、技术栈的 CRM 选择矩阵
三个 CRM 代表了不同的技术哲学。选择正确的栈至关重要。
| 技术维度 | Atomic CRM | NextCRM | Krayin |
|---------|-----------|---------|--------|
| **栈类型** | React + SaaS | Next.js + Node | Laravel + PHP |
| **成熟度** | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| **学习曲线** | 中 | 中-高 | 低-中 |
| **生产验证** | 中 | 新兴 | 10 年+ |
| **社区规模** | 小 | 中 | 大 |
| **招聘难度** | 中等 | 简单 | 简单 |
| **部署复杂度** | 最简（Supabase） | 中等 | 中等 |
| **依赖管理** | npm | npm | composer |
| **AI 友好度** | 中 | 最高 | 低 |
| **可扩展性** | 中 | 最强 | 强 |
二、按场景选择技术栈
**场景 1：快速创业（1-3 人团队）**
推荐：**Atomic CRM**
- 原因：Supabase 无需后端运维，专注业务
- 成本：最低（只需前端开发者）
- 时间：2-4 周上线
- 风险：依赖 Supabase 存在供应商风险
**场景 2：AI 赋能销售（需要自动化）**
推荐：**NextCRM**
- 原因：MCP 服务器和 AI 集成最强
- 用处：用 Claude 自动化销售流程
- 投入：需要 Full-stack 开发者
- 时间：4-8 周自定义和 AI 集成
**场景 3：企业生产环保（需要稳定性）**
推荐：**Krayin**
- 原因：10 年+ 生产验证，最稳定
- 用处：可直接部署到客户环保
- 投入：PHP 开发者和 DBA
- 时间：2-3 周配置后上线
**场景 4：技术学习（学习系统设计）**
推荐：**Krayin** 作为教材
- 原因：完整的企业应用示例
- 用处：学习 Laravel 最佳实践和 CRM 设计
- 时间：4-12 周深入学习
三、技术栈的长期成本
**初期成本（前 3 个月）：**
| CRM | 开发成本 | 运维成本 | 总成本 |
|-----|---------|---------|--------|
| Atomic | ⭐⭐ | ⭐ | ⭐⭐ |
| NextCRM | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐ |
| Krayin | ⭐⭐ | ⭐⭐ | ⭐⭐⭐ |
**长期成本（1 年+）：**
| CRM | 人力成本 | 运维成本 | 升级成本 | 总成本 |
|-----|---------|---------|---------|--------|
| Atomic | 中 | 低 | 中 | 中 |
| NextCRM | 高 | 中 | 中 | 高 |
| Krayin | 中 | 中 | 低 | 中 |
四、招聘和维护成本
**招聘难度：**
- **Atomic CRM**：需要 React + Supabase 工程师（竞争激烈）
- **NextCRM**：需要全栈 Next.js 工程师（市场缺稀缺）
- **Krayin**：需要 Laravel 工程师（市场供应充足）
**维护成本：**
- **Atomic CRM**：Supabase 管理员 1 人，前端开发 1-2 人
- **NextCRM**：DevOps + 全栈开发 2-3 人
- **Krayin**：PHP 后端 1 人，前端 1 人，DBA 0.5 人
五、技术债和升级路径
**Atomic CRM 的风险：**
- Supabase 平台风险（如价格上升、服务变化）
- React 生态快速变化，需要不断升级
- 小社区，遇到问题可能自己解决
**NextCRM 的风险：**
- 项目还较新，长期稳定性有待验证
- MCP 规范还在演进，API 可能变化
- 依赖众多，升级时可能出现兼容性问题
**Krayin 的风险：**
- PHP 生态的「老技术」标签，招聘困难
- 不支持现代 AI 集成（但这也意味着稳定）
- Vue.js 前端需要维护，不是 React 主流
六、最终建议
**如果你是创业公司：**
```
第一阶段 → Atomic CRM（快速验证想法）
↓
第二阶段 → NextCRM 或自建（加入 AI 功能）
↓
第三阶段 → 考虑选择定制版本
```
**如果你是企业 IT：**
```
直接选 Krayin（稳定性优先）
理由：10 年验证，可直接用于生产
```
**如果你是 AI 应用开发者：**
```
选 NextCRM（AI 优先）
理由：MCP 和 Claude 集成最深
```
**如果你想学习系统设计：**
```
研究 Krayin + Atomic（对比学习）
Krayin：企业级设计
Atomic：现代前端设计
```
七、混合方案（不同角色的分工）
如果你的团队同时有不同背景：
```
JavaScript 优先 + 需要稳定性
→ 前端：Atomic CRM
→ 后端：自建 Node + PostgreSQL
PHP 团队 + 需要快速上线
→ 选 Krayin，全 PHP 栈
想要 AI 赋能 + 有全栈能力
→ 选 NextCRM，自定义 MCP 工具
```
结论：没有完美的选择，只有最适合的。
intro/nextcrm-app.txt
+274
View File
@@ -0,0 +1,274 @@
项目名称:NextCRM
github:https://github.com/pdovhomilja/nextcrm-app
简介:Next.js 16 构建的 AI-native CRM，集成 MCP 服务器（127 个工具）、向量搜索、Claude/OpenAI API、邮件客户端和完整的发票工作流。是目前最成熟的 AI 友好型 CRM 骨架，完全为 AI 代理和 Claude Code 优化设计。
语言:TypeScript,JavaScript,Next.js,React
场景:AI 原生应用、企业 CRM、AI 辅助销售、MCP 集成、向量搜索应用
6项评分:4,3,4,5,2,5
推荐理由:目前最 AI 友好的开源 CRM 系统。内置 MCP 服务器提供 127 个工具接口，深度集成 Claude/OpenAI，支持向量搜索和语义理解。代码最新（Next.js 16、React 19），完整的企业功能（发票、审计日志）。依赖较多但值得，是 AI 时代 CRM 骨架的最佳实践。
下载:https://github.com/pdovhomilja/nextcrm-app
文章1标题:NextCRM：AI 时代的企业 CRM 系统
文章1内容:
一、项目定位
NextCRM 不是传统的 CRM，而是一个 AI-native 的客户管理系统。
核心理念是：
• 让 Claude / ChatGPT 通过 MCP 接口自动管理 CRM 数据
• 用向量搜索理解客户意图和历史
• 完整的企业功能（发票、审计、多币种）
• 为 AI 代理而生的 API 设计
这意味着你可以告诉 Claude：「帮我找出过去 30 天内未跟进的高价值客户」
Claude 通过 MCP 接口自动查询、分析、生成报告，无需人工操作。
二、核心功能
• 🤖 AI 集成与 MCP 服务器
- 127 个工具接口供 AI 调用
- Claude / OpenAI API 集成
- 向量搜索与语义理解
- E2B 沙箱执行
• 📊 完整的 CRM 系统
- 账户、联系人、线索、机会、合同管理
- 完整的销售流程跟踪
• 💰 企业级发票系统
- 多币种支持
- 税务引擎
- PDF 生成
- 支付追踪
• 📧 邮件客户端
- IMAP/SMTP 集成
- 邮件自动捕获
- 线程式对话
• 📄 文档管理
- 上传和版本控制
- 权限管理
- 审计日志
• 🔍 高级搜索
- 向量数据库
- 语义相似度搜索
- 自然语言查询
三、技术栈
部分 技术
Web 框架 Next.js 16
前端 React 19 + TypeScript
认证 Better Auth
数据库 PostgreSQL 17+
ORM Prisma 7.5
样式 Tailwind CSS v4 + shadcn/ui
AI 集成 Claude / OpenAI API
MCP 服务器 127 个工具
向量搜索 Pgvector + Embedding
后台任务 Inngest
邮件服务 Resend
文件存储 UploadThing
四、快速开始
# 克隆项目
git clone https://github.com/pdovhomilja/nextcrm-app.git
cd nextcrm-app
# 安装依赖
npm install
# 配置环境（需要 API key）
cp .env.example .env.local
# 填入：PostgreSQL URL、OpenAI/Claude API Key、UploadThing 等
# 数据库迁移
npm run db:push
# 启动开发服务器
npm run dev
# MCP 服务器可作为独立进程运行
npm run mcp:start
五、AI Coding 友好度评分
维度 分值 说明
目录结构 4/5 Next.js 标准项目结构，MCP 集成清晰
文档完整度 3/5 官方文档中等，MCP 接口文档可更完善
测试覆盖 4/5 有单元测试和 E2E 测试
示例模块 5/5 完整的 CRM、发票、邮件、AI 示例
依赖克制度 2/5 依赖众多，但都是必需的
增量开发 5/5 MCP 接口明确，易于 AI 生成和扩展代码
总体评分: 83/100 (最适合 AI 赋能的企业应用)
六、为什么选择 NextCRM
1. 目前最成熟的 AI-native CRM 架构
2. MCP 服务器提供 127 个工具接口，完全 AI 可用
3. 向量搜索和语义理解，超越传统 CRM
4. 完整的企业功能（发票、多币种、审计）
5. Next.js 16 + React 19，最新技术栈
6. 可直接用 Claude 或 ChatGPT 驱动业务流程
七、不适合的场景
• 依赖较多，学习曲线较陡
• 中小型团队需要最简化的 CRM（Atomic CRM 更合适）
• 使用 PHP / Laravel 生态的团队
• 不需要 AI 功能的传统 CRM 需求
文章2标题:NextCRM：用 Claude 自动化管理客户关系
文章2内容:
一、什么是 NextCRM 中的 MCP 服务器
MCP = Model Context Protocol（模型上下文协议）
简单说，它让 AI（如 Claude）能够像你一样操作 CRM：
- 查询客户数据
- 创建、更新、删除记录
- 生成报告
- 发送邮件
- 执行复杂的业务逻辑
传统方式：
```
你：打开 CRM，手动查询客户，手动筛选，手动生成报告
耗时：30 分钟
```
NextCRM + Claude 方式：
```
你：给 Claude 说「找出过去 30 天未跟进的高价值客户」
Claude 通过 MCP 接口自动操作 CRM
耗时：5 秒
```
二、127 个 MCP 工具接口示例
NextCRM 为 AI 暴露的主要接口：
**数据查询类：**
- `get_contacts()` — 查询所有联系人
- `get_opportunities_by_stage()` — 按销售阶段查询机会
- `search_by_vector()` — 向量搜索客户意图
- `get_interaction_history()` — 获取与客户的历史交互
**数据操作类：**
- `create_contact()` — 创建新联系人
- `update_opportunity()` — 更新销售机会
- `create_activity()` — 记录活动（电话、邮件、会议）
- `add_note()` — 添加备注
**业务流程类：**
- `generate_invoice()` — 生成发票
- `send_email()` — 发送邮件
- `schedule_followup()` — 安排后续跟进
- `create_proposal()` — 创建建议书
**分析类：**
- `get_sales_forecast()` — 预测销售额
- `analyze_customer_sentiment()` — 分析客户情绪
- `identify_churn_risk()` — 识别流失风险客户
三、实际应用场景
**场景 1：自动化客户跟进**
```
你对 Claude 说：
「每周一早上 9 点，帮我找出过去 7 天没有联系的客户，
自动给他们发送邮件问候，并更新活动记录」
Claude 做的事：
1. 每周一 9 点触发
2. 通过 MCP 查询 7 天内未接触的客户
3. 生成个性化邮件（基于历史对话）
4. 自动发送（通过 Resend）
5. 在 CRM 中记录活动
```
**场景 2：智能销售预测**
```
你说：「基于目前的销售机会和历史成交率，
预测下季度的收入，以及可能丢单的机会」
Claude：
1. 查询所有开放的销售机会
2. 分析历史成交率
3. 用向量搜索找类似客户
4. 生成预测报告和风险警告
```
**场景 3：自动化数据整理**
```
你说：「导入这个 Excel，自动去重，
识别重复的客户记录，合并相同的人」
Claude：
1. 解析 Excel 文件
2. 通过向量相似度识别重复客户
3. 自动合并记录并保留关键信息
```
四、与其他 CRM 的 AI 集成对比
| CRM | AI 集成深度 | MCP 支持 | 向量搜索 | 适合 AI 自动化 |
|-----|-----------|---------|---------|-------------|
| Atomic CRM | 无 | ❌ | ❌ | ❌ |
| NextCRM | 原生优先 | ✅ 127 工具 | ✅ | ✅⭐⭐⭐⭐⭐ |
| Krayin | 无 | ❌ | ❌ | ❌ |
| Salesforce | 可选 | ❌ | ⚠️ 需 Einstein | ✅ 但昂贵 |
**结论：**
NextCRM 是目前唯一完全为 AI 自动化设计的开源 CRM。
五、部署和扩展
**本地开发（学习）：**
```bash
npm run dev
# MCP 在本地运行，可用 Claude 应用或 Cursor 连接
```
**部署到生产（Vercel）：**
```bash
npm run build
vercel deploy
```
**MCP 服务器独立部署：**
```bash
npm run mcp:build
# 在独立服务器上运行，让多个 Claude 实例使用
```
六、建议使用路径
**阶段 1：学习（2-4 周）**
- 本地安装 NextCRM
- 用 Claude 应用连接 MCP 服务器
- 尝试自动化简单操作（查询、更新、邮件）
**阶段 2：定制（4-8 周）**
- 添加自己的 MCP 工具接口
- 集成自己的业务流程
- 用 Claude 驱动复杂的销售工作流
**阶段 3：生产（8+ 周）**
- 部署到生产环境
- 建立 24/7 AI 驱动的客户管理系统
- 监控 AI 操作日志和审计
七、为什么 NextCRM 是未来
传统 CRM 是「你操作它」。
NextCRM 是「它自动为你操作」。
区别在于：
- 传统 CRM：你是中心，系统是工具
- NextCRM：AI 是中心，你是监督者
如果你想体验 AI 时代的企业应用，NextCRM 是最好的学习平台。
intro/nextjs-saas-starter.txt
+169
View File
@@ -0,0 +1,169 @@
项目名称:Next.js SaaS Starter
github:https://github.com/nextjs/saas-starter
简介:Next.js 官方 SaaS 起点项目，使用 PostgreSQL、Stripe 和 shadcn/ui，强调最小化学习资源，星数最高的官方开源骨架，轻量级依赖易于 AI 理解和扩展，最适合快速原型和 MVP 开发。
语言:TypeScript,JavaScript,React
场景:SaaS应用、多租户系统、支付集成、快速原型
6项评分:3,4,2,3,5,5
推荐理由:官方维护、轻量级依赖、易于 AI 理解和快速迭代。虽然缺少测试和复杂功能，但作为起点项目最适合 AI coding。清晰的基础代码、标准 Next.js 模式和最小化设计使其成为学习 SaaS 架构的最佳入门选择。
下载:https://github.com/nextjs/saas-starter
文章1标题:Next.js SaaS Starter：官方最轻量级 SaaS 骨架评测
文章1内容:
一、项目定位
Next.js SaaS Starter 是 Vercel 官方出品的 SaaS 起点项目。
不同于企业级的完整框架，它故意设计为最小化学习资源——
只包含核心功能（认证、RBAC、计费），而非堆砌所有可能的特性。
这使得开发者能快速启动项目，并基于自己的需求增量扩展。
二、核心功能
• 🔐 认证系统
- 邮箱/密码认证
- 会话管理
• 👥 角色基础访问控制 (RBAC)
- 用户权限分层
- 团队权限管理
• 💳 Stripe 支付集成
- 订阅管理
- 产品价格配置
• 📊 活动日志与仪表板
- CRUD 操作示例
- 数据可视化基础
三、技术栈
部分 技术
Web 框架 Next.js 15+
前端 React + TypeScript
数据库 PostgreSQL
ORM Drizzle ORM
样式 Tailwind CSS + shadcn/ui
支付 Stripe
认证 NextAuth.js 兼容设计
四、快速开始
# 克隆项目
git clone https://github.com/nextjs/saas-starter.git
cd saas-starter
# 安装依赖
npm install
# 配置环境
cp .env.example .env.local
# 数据库迁移
npm run db:push
# 启动开发服务器
npm run dev
五、AI Coding 友好度评分
维度 分值 说明
目录结构 3/5 标准 Next.js 结构清晰，但示例模块较少
文档完整度 4/5 README 和示例清楚，但缺少架构文档
测试覆盖 2/5 无测试文件，需要自己补齐
示例模块 3/5 认证和计费示例部分，需补充复杂功能
依赖克制度 5/5 依赖最轻，只用必要包
增量开发 5/5 清晰的代码结构，AI 易于理解和扩展
总体评分: 74/100 (最适合快速原型和学习)
六、为什么选择 Next.js SaaS Starter
1. 官方维护，更新及时（最后更新 2026-06-30）
2. 依赖极少，学习成本最低
3. 代码风格标准，AI 最容易理解
4. 不做过度工程化，专注核心功能
5. 基于此扩展，添加业务逻辑最快
七、不适合的场景
• 需要企业级认证（如 SSO / SAML）的项目
• 需要审计日志和合规认证的系统
• 需要完整的团队协作和权限管理的复杂应用
• 项目初期就需要大量第三方集成的团队
文章2标题:Next.js SaaS Starter vs boxyhq/saas-starter-kit vs wasp-lang/open-saas：三大官方骨架对比
文章2内容:
一、三个项目的定位差异
| 项目 | 定位 | 复杂度 | 学习成本 | AI友好度 |
|------|------|--------|---------|---------|
| Next.js SaaS Starter | 官方最轻量入门 | ⭐ | ⭐ | ⭐⭐⭐⭐⭐ |
| boxyhq/saas-starter-kit | 企业级参考 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ |
| wasp-lang/open-saas | 全栈类型安全 | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐⭐ |
二、选择建议
**选 Next.js SaaS Starter：**
- 你是 SaaS 初学者
- 想快速制作 MVP 或演示项目
- 偏好轻量级、标准化的 Next.js 项目
- 用 Claude Code / Cursor 进行快速迭代
- ✅ 最适合本清单推荐
**选 wasp-lang/open-saas：**
- 你需要全栈类型安全和完整示例
- 希望使用新一代框架的结构化方式
- 项目需要后台任务和文件管理
- 想要一键部署到 Railway/Fly.io
- ✅ AI 友好度最高，适合 AI coding 深度开发
**选 boxyhq/saas-starter-kit：**
- 你在学习企业级 SaaS 架构
- 需要 SSO、SAML、审计日志等功能
- 团队规模较大，需要复杂权限管理
- 项目生产环境就需要这些功能
- ✅ 企业级参考价值最高
三、技术栈对比
| 对比项 | Next.js | boxyhq | Wasp |
|--------|--------|--------|------|
| 框架 | Next.js | Next.js | Wasp Lang |
| 后端 | Node.js + Route Handlers | Node.js | Node.js |
| 数据库 | PostgreSQL | PostgreSQL | PostgreSQL |
| ORM | Drizzle | Prisma | Prisma |
| 认证 | 自建 | NextAuth.js | Wasp Auth |
| 样式 | Tailwind + shadcn | Tailwind | Tailwind |
| 类型安全 | TypeScript | TypeScript | 全栈类型检查 |
| 测试 | ❌ 无 | ✅ 有 | ✅ 有 |
| 文档 | 📖 良好 | 📖 完整 | 📖 优秀 |
四、开发体验对比
| 场景 | 推荐 | 原因 |
|------|------|------|
| 添加新页面 + 数据表 | wasp-lang | 框架生成，完全类型安全 |
| 配置 Stripe | Next.js | 最少配置，专注集成逻辑 |
| 实现 RBAC 权限系统 | boxyhq | 完整示例和最佳实践 |
| AI coding 快速迭代 | Next.js 和 wasp | 代码简洁，结构清晰 |
| 学习 SaaS 概念 | Next.js | 最少干扰，专注核心 |
五、建议方案
**MVP 阶段（1-3 个月）：**
👉 使用 **Next.js SaaS Starter** + Claude Code
- 快速上线核心功能
- 专注产品迭代，不陷入架构细节
- AI 辅助开发效率最高
**验证成功，需扩展（3-6 个月）：**
👉 迁移到 **wasp-lang/open-saas** 或重构为 **boxyhq** 级别
- 如需复杂权限系统 → boxyhq
- 如需全栈类型安全 + AI 深度开发 → Wasp
**学习企业架构（研究用）：**
👉 研究 **boxyhq/saas-starter-kit**
- 不一定用于生产，但可学习业界最佳实践
- 多人团队规模时的权限设计思路
intro/wasp-lang-open-saas.txt
+246
View File
@@ -0,0 +1,246 @@
项目名称:Wasp Open SaaS
github:https://github.com/wasp-lang/open-saas
简介:免费完整的 JavaScript SaaS 基础设施，由 Wasp 框架驱动，集成 React 前端和 Node.js 后端，强调全栈类型安全。星数最高（14800+）的开源 SaaS 骨架，特别为 AI coding 和 Cursor/Claude Code 优化，是 AI 友好度最高的选择。
语言:JavaScript,TypeScript,React,Node.js
场景:全栈 SaaS、AI 应用、快速启动、团队协作、AI coding 深度开发
6项评分:5,5,4,5,3,5
推荐理由:星数最高、AI 友好度最高的官方项目。Wasp 框架的结构化设计和完整示例特别适合 AI 代码生成。支持 Claude Code 和 Cursor 等 AI 工具，是最适合 AI coding 深度开发的选择。类型安全覆盖全栈，文档优秀，一键部署。
下载:https://github.com/wasp-lang/open-saas
文章1标题:Wasp Open SaaS：AI Coding 时代最友好的全栈 SaaS 骨架
文章1内容:
一、项目定位
Wasp Open SaaS 是由 Wasp 框架驱动的完整 SaaS 基础设施。
不同于传统 Next.js 或 Express，Wasp 是一种新范式：
用声明式语言描述应用的「骨架」（路由、操作、查询），
自动生成类型安全的前后端代码。
这使得整个应用的代码更少、类型更强、AI 更易理解。
特别对 Claude Code、Cursor 等 AI coding 工具做了优化，
官方文档明确支持 AI 辅助开发。
二、核心功能
• 🔐 全栈认证系统
- 邮箱/密码注册登录
- 社交登录（Google、GitHub、Keycloak）
- 多因素认证支持
• 📧 邮件发送
- SendGrid、Mailgun、SMTP 支持
- 邮件模板系统
• 💾 文件上传
- AWS S3 集成
- 本地文件存储选项
• 💳 支付集成
- Stripe、Polar.sh、Lemon Squeezy
- 一键设置订阅
• 🤖 AI 集成
- OpenAI API 预制
- LLM 友好的 API 设计
• 🚀 一键部署
- Railway、Fly.io、Heroku 支持
- 自动 SSL 和域名配置
三、技术栈
部分 技术
全栈框架 Wasp 框架
前端 React + TypeScript
后端 Node.js + Express
数据库 PostgreSQL
ORM Prisma ORM
样式 Tailwind CSS + shadcn/ui
认证 Wasp Auth（内置）
支付 Stripe/Polar/Lemon Squeezy
邮件 SendGrid/Mailgun/SMTP
四、快速开始
# 安装 Wasp CLI
npm install -g wasp-lang
# 克隆 Open SaaS
git clone https://github.com/wasp-lang/open-saas.git
cd open-saas
# 安装依赖
npm install
# 配置环境（复制示例）
cp .env.example .env
# 启动开发服务器
wasp start
# 后台任务队列（如需）
npm run dev:db:studio
五、AI Coding 友好度评分
维度 分值 说明
目录结构 5/5 Wasp 框架的声明式设计天然清晰
文档完整度 5/5 官方文档详细，有大量示例
测试覆盖 4/5 有测试框架支持，示例完整
示例模块 5/5 完整的认证、支付、邮件示例
依赖克制度 3/5 Wasp 生态依赖多，但易于管理
增量开发 5/5 框架结构化，特别适合 AI 生成代码
总体评分: 88/100 (最适合 AI coding 深度开发)
六、为什么选择 Wasp Open SaaS
1. 官方优化，明确支持 AI coding（如 Claude Code、Cursor）
2. 全栈类型安全，从数据库到 UI 一致
3. 星数最高（14800+），社区最活跃
4. Wasp 框架的「声明式」设计，AI 最易理解代码生成逻辑
5. 完整示例（认证、支付、邮件、AI），复用率高
6. 后台任务、WebSocket、文件上传等高级功能完整
7. 一键部署到 Railway/Fly.io，不费事
七、不适合的场景
• 团队不熟悉新框架（Wasp）的学习成本较高
• 需要与现有 Express/Next.js 项目集成
• 极简主义者（依赖多、学习曲线陡）
• 追求最小化依赖的项目
文章2标题:使用 Claude Code + Wasp Open SaaS 快速构建 AI 应用
文章2内容:
一、为什么 Wasp + AI Coding 是绝配
Wasp 框架的设计理念与 AI coding 的需求天然贴切：
1. **声明式编程** = AI 易于理解的代码结构
- 传统 Express：200 行路由配置
- Wasp：10 行声明式 API 定义
2. **类型安全贯穿全栈** = AI 生成代码的正确性保证
- 从 Prisma schema → Wasp operations → TypeScript types → React hooks
- 每一层都有类型检查，AI 改错概率低
3. **预置集成** = AI 不需要自己设计
- 认证、支付、邮件、文件都有标准模式
- AI 只需填充业务逻辑，不需造轮子
4. **官方示例完整** = AI 有明确参考
- 每个功能都有工作示例代码
- AI 可以直接模仿模式，准确率高
二、快速上手流程
**第 1 天：项目启动**
```bash
# 1. 创建 Wasp 项目
wasp new my-saas-app
cd my-saas-app
# 2. 启动开发服务器
wasp start
# 3. 打开 Claude Code / Cursor
# - 询问 AI：「基于这个 Wasp 项目，帮我创建一个文章管理系统」
# - AI 会自动：
# - 修改 wasp/Main.wasp（定义 entity 和 queries/actions）
# - 生成 src/client/ 页面（React 组件）
# - 生成 src/server/ 业务逻辑
# - 类型自动同步
```
**第 2-3 天：核心功能**
- 用户认证（Wasp 内置，开箱即用）
- 数据模型（修改 schema.prisma，wasp start 自动迁移）
- CRUD 页面（AI 可快速生成）
**第 4-5 天：支付集成**
```wasp
action stripe {
fn: import { stripePayment } from "@/actions/stripe.js",
}
```
AI 看到这个声明就知道怎么实现支付流程。
**第 6-7 天：部署**
```bash
wasp build
cd build
fly deploy # 一键部署到 Fly.io
```
三、AI Coding 工作流示例
**场景：添加「博客文章管理系统」**
🔴 传统方式（Express + React）：
- 你告诉 AI：「要一个博客 CRUD API」
- AI 需要理解 10 个文件的关系，可能出错
- 你修改，AI 重新生成，反复来回
🟢 Wasp 方式：
```wasp
entity Article {=psl
id Int @id @default(autoincrement())
title String
content String
author User @relation(fields: [authorId], references: [id])
authorId Int
createdAt DateTime @default(now())
psl=}
query getAllArticles {
fn: import { getAllArticles } from "@/queries/articles.js",
}
action createArticle {
fn: import { createArticle } from "@/actions/articles.js",
}
```
你告诉 AI：「根据这个 Wasp 定义实现博客 CRUD」
AI 一次生成正确的：
- 数据库 schema（自动执行迁移）
- 后端 query/action（类型安全）
- React 页面和 hooks（自动连接到后端）
**为什么不出错？**
- 类型系统贯穿全栈
- 框架的声明式设计消除歧义
- AI 看 Wasp 文件就知道「业务模型」，不需要猜测
四、部署指南（一键上线）
```bash
# 1. 连接 Railway 或 Fly.io 账号
wasp deploy fly create
# 2. 配置环境变量（PostgreSQL 自动创建）
# 3. 一键部署
wasp deploy fly deploy
# 完成！你的 SaaS 已上线，包括：
# - 自动 HTTPS
# - PostgreSQL 数据库
# - Node.js 后端
# - React 前端
```
五、何时用 Wasp vs 其他框架
| 场景 | Wasp | Next.js | boxyhq |
|------|------|---------|--------|
| AI coding 快速迭代 | ✅⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ |
| 学习成本 | 中等 | 最低 | 较高 |
| 企业级功能 | ✅ | 需自建 | ✅ |
| 团队规模 | 小-中 | 任何 | 中-大 |
| 一键部署 | ✅ | ❌ | ❌ |
| AI Coding 优化 | ✅⭐⭐⭐⭐⭐ | ✅ | - |
| 全栈类型安全 | ✅ | ✅ | ✅ |
**结论：**
如果你用 Claude Code / Cursor 做 AI coding，Wasp Open SaaS 是目前最匹配的选择。