Frappe CRM

功能完整的开源客户关系管理系统

欢迎使用 Frappe CRM

Frappe CRM 是一个功能完整的开源客户关系管理系统，基于强大的 Frappe Framework 构建。本应用已针对 Lazycat 平台进行优化，支持一键部署和使用。

已部署成功！您可以立即开始使用 Frappe CRM。访问地址：https://frappe-crm.您的域名
默认登录信息：
用户名: Administrator
密码: admin
首次登录后请立即修改密码

核心功能

📋 客户管理

完整的客户信息管理和跟踪系统，支持自定义字段

💼 销售管理

销售机会、线索管理，全流程跟踪

✅ 任务管理

任务分配、进度跟踪、活动安排

📄 报价订单

报价单生成、订单管理、合同跟踪

📧 邮件集成

集成邮件系统，自动记录通信历史

🔧 自定义配置

自定义字段、工作流、权限管理

👥 多用户协作

团队协作、权限控制、角色管理

🌍 多语言支持

支持 20+ 种语言，默认中文界面

快速开始

  1. 访问应用

    点击 Lazycat 平台上的 "打开应用" 按钮，或直接访问

  2. 首次登录

    使用默认账号登录：用户名 Administrator，密码 admin

  3. 修改密码

    登录后，点击右上角头像 → Settings → Change Password 修改默认密码

  4. 配置语言

    如果界面显示英文，请清除浏览器 Cookie 后重新登录，系统会自动使用中文界面

  5. 开始使用

    创建客户、添加销售机会、管理任务，开始使用完整的 CRM 功能

配置说明

数据持久化

应用数据存储在以下位置：

  • 容器路径：/home/frappe/frappe-bench - Frappe 工作目录
  • 宿主机路径：/data/appvar/cloud.lazycat.app.xiao.frappe-crm/frappe-bench - 数据持久化目录
  • 数据库路径：/data/appvar/cloud.lazycat.app.xiao.frappe-crm/mysql - MariaDB 数据目录
重要提示：卸载应用前，如需保留数据，请备份上述目录中的文件。

修改管理员密码

登录后通过以下步骤修改密码：

  1. 点击右上角用户头像
  2. 选择 "Settings"（设置）
  3. 点击 "Change Password"（修改密码）
  4. 输入当前密码和新密码
  5. 点击 "Update"（更新）保存

添加新用户

1. 导航至 Setup → Users
2. 点击 "New User"
3. 填写用户信息（姓名、邮箱等）
4. 设置角色和权限
5. 保存并发送邀请邮件

自定义字段

您可以为各个模块添加自定义字段：

  1. 导航至 Setup → Customize Form
  2. 选择要自定义的文档类型（如 Customer、Lead 等）
  3. 添加自定义字段，设置字段类型和属性
  4. 保存并应用更改

常见问题

Q: 首次登录后界面显示英文怎么办？

A: 这是因为浏览器 Cookie 缓存的问题。请按以下步骤操作：

  1. 清除浏览器 Cookie（快捷键：Ctrl+Shift+Delete 或 Cmd+Shift+Delete）
  2. 重新访问应用并登录
  3. 系统会自动使用中文界面

Q: 如何备份数据？

A: Frappe CRM 提供了内置的备份功能：

  • 自动备份：在 Setup → System Settings 中配置自动备份计划
  • 手动备份：导航至 Tools → Download Backups 下载备份文件
  • 系统备份：直接备份宿主机上的数据目录

Q: 如何恢复数据？

A: 使用 Frappe 的备份恢复命令：

bench --site [site-name] restore [backup-file]

Q: 忘记管理员密码怎么办？

A: 可以通过以下方式重置密码：

  1. 进入容器：通过 Lazycat 平台的终端功能
  2. 执行重置命令：bench set-admin-password admin
  3. 输入新密码并确认

Q: 应用启动需要多长时间？

A: 首次启动可能需要 2-5 分钟，因为需要初始化数据库和配置。后续启动会更快，通常在 30-60 秒内完成。

Q: 如何配置邮件服务？

A: 在 Setup → Email Domain 中配置 SMTP 服务器：

  • 添加邮件域名
  • 配置 SMTP 服务器地址和端口
  • 输入邮箱账号和密码
  • 测试连接并保存

技术架构

本应用由以下组件构成：

  • Frappe Framework: Python + JavaScript 全栈框架
  • MariaDB 10.8: 关系型数据库，存储业务数据
  • Redis: 缓存服务，用于队列和 Socket.IO
  • 响应式界面: 支持桌面和移动端访问

资源配置

  • MariaDB: 内存限制 1GB
  • Redis: 内存限制 256MB
  • 建议配置: 至少 2GB 内存和 10GB 存储空间

参考资料

Welcome to Frappe CRM

Frappe CRM is a full-featured open source customer relationship management system built on the powerful Frappe Framework. This application has been optimized for the Lazycat platform and supports one-click deployment.

Successfully Deployed! You can start using Frappe CRM now. Access URL: https://frappe-crm.your-domain
Default Login Credentials:
Username: Administrator
Password: admin
Please change the password after first login

Core Features

📋 Customer Management

Complete customer information management and tracking with custom fields

💼 Sales Management

Opportunity and lead management with full lifecycle tracking

✅ Task Management

Task assignment, progress tracking, and activity scheduling

📄 Quotes & Orders

Quote generation, order management, and contract tracking

📧 Email Integration

Integrated email system with automatic communication logging

🔧 Customization

Custom fields, workflows, and permission management

👥 Team Collaboration

Multi-user collaboration, access control, and role management

🌍 Multilingual

Supports 20+ languages, default Chinese interface

Quick Start

  1. Access Application

    Click the "Open App" button on Lazycat platform, or visit directly

  2. First Login

    Login with default credentials: Username Administrator, Password admin

  3. Change Password

    After login, click the avatar in top-right → Settings → Change Password to update default password

  4. Configure Language

    If the interface shows English, clear browser cookies and re-login for automatic Chinese interface

  5. Start Using

    Create customers, add opportunities, manage tasks - start using full CRM features

Configuration Guide

Data Persistence

Application data is stored in the following locations:

  • Container Path:/home/frappe/frappe-bench - Frappe working directory
  • Host Path:/data/appvar/cloud.lazycat.app.xiao.frappe-crm/frappe-bench - Persistent data directory
  • Database Path:/data/appvar/cloud.lazycat.app.xiao.frappe-crm/mysql - MariaDB data directory
Important: Before uninstalling the app, backup the above directories if you want to keep your data.

Change Admin Password

Follow these steps to change password after login:

  1. Click user avatar in top-right corner
  2. Select "Settings"
  3. Click "Change Password"
  4. Enter current password and new password
  5. Click "Update" to save

Add New Users

1. Navigate to Setup → Users
2. Click "New User"
3. Fill in user information (name, email, etc.)
4. Set roles and permissions
5. Save and send invitation email

Custom Fields

You can add custom fields to various modules:

  1. Navigate to Setup → Customize Form
  2. Select the document type to customize (e.g., Customer, Lead)
  3. Add custom fields, set field types and properties
  4. Save and apply changes

Frequently Asked Questions

Q: Interface shows English after first login?

A: This is due to browser cookie caching. Follow these steps:

  1. Clear browser cookies (Shortcut: Ctrl+Shift+Delete or Cmd+Shift+Delete)
  2. Re-visit the application and login
  3. System will automatically use Chinese interface

Q: How to backup data?

A: Frappe CRM provides built-in backup features:

  • Auto Backup: Configure automatic backup schedule in Setup → System Settings
  • Manual Backup: Navigate to Tools → Download Backups to download backup files
  • System Backup: Directly backup the data directory on host machine

Q: How to restore data?

A: Use Frappe's restore command:

bench --site [site-name] restore [backup-file]

Q: Forgot admin password?

A: Reset password with the following method:

  1. Enter container: Use terminal feature on Lazycat platform
  2. Execute reset command: bench set-admin-password admin
  3. Enter and confirm new password

Q: How long does app startup take?

A: First startup may take 2-5 minutes due to database initialization and configuration. Subsequent startups are faster, typically within 30-60 seconds.

Q: How to configure email service?

A: Configure SMTP server in Setup → Email Domain:

  • Add email domain
  • Configure SMTP server address and port
  • Enter email account and password
  • Test connection and save

Technical Architecture

This application consists of the following components:

  • Frappe Framework: Python + JavaScript full-stack framework
  • MariaDB 10.8: Relational database for business data storage
  • Redis: Caching service for queues and Socket.IO
  • Responsive UI: Supports desktop and mobile access

Resource Configuration

  • MariaDB: Memory limit 1GB
  • Redis: Memory limit 256MB
  • Recommended: At least 2GB RAM and 10GB storage

References