
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-08 · 当前星标 ★ 1907
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 已安装 Node.js 及 npm(项目为 Next.js 16 + React 19 技术栈)
- 可访问 npm 源的网络环境
- 本地磁盘可克隆 GitHub 仓库 https://github.com/kargulstudio/sales-crm
- 终端可用(bash 或同类 shell)
安装与启动步骤
-
1克隆项目源码
把仓库拉到本地并进入项目根目录,后续命令都在这个目录执行。
git clone https://github.com/kargulstudio/sales-crm.git cd sales-crm -
2安装依赖
在项目根目录执行,安装 package.json 里声明的全部依赖,耗时取决于网速。
npm install -
3启动开发服务
启动开发服务器,默认监听 3000 端口,改动代码会自动热更新,适合本地调试。
npm run dev -
4浏览器访问验证
打开 http://localhost:3000 查看页面是否正常渲染,终端应无报错信息。
-
5生产构建
生成生产环境可用的构建产物,上线前必须先执行,构建失败会直接报错。
npm run build -
6启动生产服务
在已成功 build 的前提下启动生产模式服务,用于正式环境预览或部署。
npm run start -
7代码检查
运行 ESLint 检查代码规范,提交前建议执行,可提前发现常见写法问题。
npm run lint
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
NEXT_PUBLIC_SITE_URL | 否 | 按部署环境覆盖站点 URL,供 SEO 相关文件与页面元数据使用 | https://your-domain.com |
SITE_NAME | 否 | lib/seo.ts 中定义站点名称,robots、sitemap 与页面 metadata 由此派生 | Sales CRM |
SITE_URL | 否 | lib/seo.ts 中定义默认站点地址,环境变量可覆盖 | http://localhost:3000 |
SITE_DESCRIPTION | 否 | lib/seo.ts 中定义站点描述,用于各页面元信息 | 开源自托管销售 CRM 系统 |
SITE_ROUTES | 否 | lib/seo.ts 中声明站点路由集合,影响 sitemap 与 llms.txt 生成 | ['/', '/pipeline'] |
如何确认成功
终端 npm run dev 无报错后,浏览器打开 http://localhost:3000 能正常显示页面,即启动成功。
常见问题
Q:3000 端口被占用怎么办?
A:README 未给出改端口的方法,可先关闭占用 3000 端口的其他进程,再重新执行 npm run dev。
Q:npm install 安装依赖失败怎么办?
A:先确认 Node.js 与 npm 已正确安装且网络可访问 npm 源,必要时更换镜像源后重试。
Q:怎么以生产模式运行?
A:先执行 npm run build 完成构建,再执行 npm run start 启动生产构建产物。
Q:上线前必须改哪些配置?
A:建议先在 lib/seo.ts 里设置 SITE_NAME、SITE_URL、SITE_DESCRIPTION、SITE_ROUTES,并通过环境变量 NEXT_PUBLIC_SITE_URL 覆盖部署地址。
Q:写页面或组件前要注意什么?
A:README 明确要求写任何 component、section、page 之前先阅读 CONVENTIONS.md,它是该仓库的构建规范。
注意事项
- README 节选实际是 Kargul Starter(Next.js 16 + React 19 + Tailwind CSS 4)脚手架说明,未包含 CRM 业务模块的专用安装与配置步骤。
- README 未提供 Docker、docker-compose 或云平台部署说明,本教程仅覆盖 npm 本地运行方式。
- 除 npm install、npm run dev 外的 npm 脚本还有 build、start、lint、to:avif、extract:avif、frame:rive,后三个为图片/动画资源处理工具。
- 项目处于持续成长阶段,功能覆盖度仍在扩展,实际部署前建议先看 GitHub 仓库当前状态。
核心亮点
- 基于 TypeScript 全栈开发,类型安全,便于二次开发和维护
- 提供销售管道可视化,商机阶段推进直观,适合中小团队日常跟进
- 支持自托管部署,数据自主可控,避免商业 CRM 的订阅费用和锁定
不足之处
- 功能深度相比成熟商业 CRM 仍有差距,高级报表和自动化能力有限
- 生态和插件体系尚在早期,第三方集成较少
适用场景
- 中小型销售团队管理客户线索和商机跟进
- 独立销售或顾问自建客户档案与成交记录
- 需要数据私有化、不想用 SaaS CRM 的公司内部部署
替代项目
Twenty、NocoBase
上一篇:sec-gemini
下一篇:aso-tracker
同类项目推荐
awesome-quant-ai
开源
一站式收藏AI量化投资资源,快速上手智能交易
A curated list of awesome resources for quantitative investment and trading strategi···
mLLMCelltype
开源
多模型投票,单细胞注释又快又准
Cell type annotation for single-cell RNA-seq using multi-LLM consensus
Awesome_AI4Finance
开源
金融AI资源一站导航,省去到处翻找
Resources
read-aware
开源
会记事的阅读器,跨书帮你串起读过的知识
An ebook reader with a self-evolving agent: it remembers your reading across books, ···
AiSOC
开源
告警自动研判,每步决策可回放审计
Open-source AI Security Operations Center: alert fusion, LLM-agent triage, MITRE ATT···
SakikoMind
开源
搭企业智能客服,意图准、能查证、可转人工
Enterprise AI customer-service Agent platform featuring hybrid intent recognition, m···
Vista
开源
用视频生成让自动驾驶预判未来,提升泛化与安全
[NeurIPS 2024] A Generalizable World Model for Autonomous Driving
awesome-ai-tools-for-game-dev
开源
找游戏AI工具,看这份精选清单就够了
A curated list of awesome AI tools for game developers
wisp-science
开源
本地优先的 AI 科学计算工作台,让科研分析更高效
Open-source, local-first desktop AI research workbench for scientific computing with···