Seltzer CRM 技术文档

1. 概述

Seltzer CRM 是一个开源的客户关系管理工具，专门为黑客空间和类似的会员组织设计，用于管理会员数据。它的设计目标是让典型的黑客空间管理员无需任何培训即可使用，并且通过模块化而不是修改或配置来满足特定空间的需求。

当前功能包括：

• 跟踪会员的联系信息和紧急联系信息
• 跟踪会员级别和日期
• 自动计费
• Amazon Payments 集成（已弃用）
• PayPal 集成
• 跟踪 RFID 钥匙分配
• 跟踪会员的导师
• 可定制的权限和角色

2. 安装指南

2.1 创建 MySQL 数据库

首先，在你的 Web 服务器上创建一个空的 MySQL 数据库。可以使用 PHPMyAdmin 或 MySQL 命令行来完成。以下是使用 MySQL 命令行创建数据库的示例：

mysql -u <username> -p
CREATE DATABASE seltzer-dev CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'seltzer-dev'@'localhost' IDENTIFIED BY '<password>';
GRANT ALL PRIVILEGES ON seltzer-dev.* TO 'seltzer-dev'@'localhost';
FLUSH PRIVILEGES;
quit

2.2 下载并解压项目

你可以通过以下两种方式下载项目：

1. 访问 GitHub 项目页面 并点击 "ZIP" 按钮下载压缩包。
2. 使用命令行下载：

wget https://github.com/elplatt/seltzer/archive/"branch".zip

其中 "branch" 是你想要下载的分支名称。

或者，你可以使用 Git 克隆项目：

git clone --branch "branch" https://github.com/elplatt/seltzer.git

解压下载的压缩包（如果需要）。

2.3 配置文件

在 seltzer/crm 目录下，将 config.sample.inc.php 复制为 config.inc.php，并根据你的数据库和组织设置进行修改：

cp seltzer/crm/config.sample.inc.php seltzer/crm/config.inc.php
nano seltzer/crm/config.inc.php

2.4 上传到服务器

将 seltzer/crm 目录上传到 Web 服务器的文档根目录。例如：/var/www/html/crm。如果你使用其他目录，请更新 config.inc.php 中的 $config_base_path。

2.5 安装

确保 PHP 的 "magic quotes" 已禁用。然后，在浏览器中导航到 install.php 文件进行安装：

http://yourserver.com/crm/install.php

输入管理员邮箱并选择密码。现在你可以使用 "admin" 作为用户名和安装时选择的密码登录。

2.6 导入会员数据（可选）

你可以选择导入现有的会员数据。具体步骤请参考相关文档。

3. 项目使用说明

3.1 登录与管理

安装完成后，使用管理员账户登录系统。你可以通过管理界面管理会员信息、权限、计费等。

3.2 模块化功能

Seltzer CRM 通过模块化设计，允许你根据需要添加或删除功能。每个模块都有独立的配置和使用文档。

3.3 权限管理

系统支持自定义权限和角色，你可以根据组织的需求为不同用户分配不同的权限。

4. 项目 API 使用文档

Seltzer CRM 提供了一些 API 接口，用于与其他系统集成。具体 API 的使用方法和参数请参考项目的 API 文档。

5. 项目安装方式

Seltzer CRM 的安装方式主要包括手动安装和通过 Git 克隆安装。手动安装需要下载压缩包并解压，而 Git 克隆则可以直接获取最新代码。

5.1 手动安装

1. 下载压缩包。
2. 解压并配置 config.inc.php。
3. 上传到服务器并运行 install.php。

5.2 Git 克隆安装

1. 使用 Git 克隆项目。
2. 配置 config.inc.php。
3. 上传到服务器并运行 install.php。

通过以上步骤，你可以顺利安装并使用 Seltzer CRM 来管理你的会员数据。