Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fengkaijia/iplacard
The Model United Nations Conference Management System by IMUNC since 2013
https://github.com/fengkaijia/iplacard
model-united-nations mun
Last synced: about 2 months ago
JSON representation
The Model United Nations Conference Management System by IMUNC since 2013
- Host: GitHub
- URL: https://github.com/fengkaijia/iplacard
- Owner: fengkaijia
- License: other
- Created: 2017-07-14T09:42:15.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2019-08-03T10:38:44.000Z (about 5 years ago)
- Last Synced: 2024-04-09T20:03:21.160Z (6 months ago)
- Topics: model-united-nations, mun
- Language: PHP
- Homepage: http://iplacard.com
- Size: 5.89 MB
- Stars: 31
- Watchers: 12
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# iPlacard
iPlacard 是 [Kaijia Feng](http://kaijia.me/) 于 2013 年起为 [IMUNC](http://imunc.com/) 开发的模拟联合国会议管理系统。
iPlacard 的设计目标是适配所有常规类型会议的自动化管理系统，功能包括管理完整的申请流程，包括代表、面试、席位、文件、缴费、委员会、代表团，以及附带的数据导出、API、统计及个人帐户管理功能。同时提供了一个供与会代表访问界面，可显示申请进度、席位、文件、代表团、委员会信息。
iPlacard 同时按照早前会议的需求扩展有与其他系统对接的能力，包括利用 FreeRADIUS 实现会场 WIFI 网络登录（首次于 IMUNC 2013 中使用）；利用 iDocument 系统分发文件（首次于 IMUNC 2015 中使用）；利用 jsConnect 等模式实现 Single Sign-On 等（首次于 IMUNC 2015 中使用）。iPlacard 数据库经扩展亦可作为会期期间利用 NFC 或二维码签到、领餐、打卡等功能的数据后端（首次于 IMUNC 2016 中使用）。
iPlacard [公开](http://imunc.com/2013/04/announcing-iplacard/)于 2013 年 4 月 1 日。iPlacard 1.0 于 IMUNC 2013 中首次使用，随后进行了重写，并于 IMUNC 2014 开始使用 2.0 版本。iPlacard 于 2.3 版本起于 2017 年 8 月 3 日，在有约束条件下公开软件源代码于 [GitHub](https://github.com/fengkaijia/iplacard)。
## 许可证信息
iPlacard 是采用双重许可证授权模式的专有软件。
任何与会人数小于或等于 150 人的非商业且不以营利为目的的会议可以在[第三版 GNU 通用公共许可协议](https://www.gnu.org/licenses/gpl-3.0.en.html)（GNU General Public License v3.0）约束且保留合适署名条件下使用、复制、修改、分发 iPlacard。任何商业或以营利为目的的会议需要联系版权所有人（[[email protected]](mailto:[email protected])）取得商业授权。详细的许可信息请见[版权声明及附加协议](LICENSE.txt)。
## 示例
测试用 Demo 提供于 。
后台（组织团队帐号）登录用户名 `[email protected]`，密码 `iplacardadmin`。
前台（代表报名帐号）登录用户名 `[email protected]`，密码 `iplacarduser`，亦可由简易报名表提交报名登录。
## 安装
使用 iPlacard 需要系统管理员具有一定的网站维护知识，建议使用 phpMyAdmin 等软件方便维护。
### 运行环境
iPlacard 标准实例可以运行在标准的 LAMP 环境中，最低需求如下：
* PHP 7.0（包含 `php-curl`、`php-gd`、`php-mbstring`、`php-memcached`、`php-mysql`、`php-xml`、`php-zip` 扩展）
* MySQL 5.7
* Nginx 1.0 / Apache 2.2（包含 `mod_rewrite`）
* Memcached
* Cron
* CURL
### 获取源代码
可通过两种方法获取源代码。
#### 1、使用 Git 和 Composer
```bash
git clone https://github.com/fengkaijia/iplacard.git
cd iplacard
git checkout release/2.3
wget https://raw.githubusercontent.com/composer/getcomposer.org/master/web/installer -O - -q | php -- --quiet
php composer.phar install
```
#### 2、下载预编译的文件
访问 下载包含所有代码的源文件并解压缩到文件目录。请注意通过此方法下载的代码无法自动升级，如条件允许请使用前种方法。
### 创建配置文件
复制 iPlacard 根目录下的 [`config.example.php`](config.example.php) 文件到 `config.php`。根据提示修改数据库连接等配置信息。
### 导入数据库
将 [`resource/install.sql`](resource/install.sql) 文件导入数据库。导入前需将 `install.sql` 文件中的 `{IP_PREFIX}` 更换为在 `config.php` 中设定的数据库前缀（默认配置将 `{IP_PREFIX}` 替换为 `ip_`）。在 Linux 下可运行：
```bash
sed -e 's/{IP_PREFIX}/ip_/g' resource/install.sql | mysql -u user -p database
```
### 创建管理用户
在数据库中运行 SQL 语句：
```mysql
INSERT INTO `{IP_PREFIX}user` (`name`, `email`, `password`, `phone`, `type`, `pin_password`, `reg_time`) VALUES (
'姓名',
'[email protected]',
'$2a$12$85882f010234860c69b20unGCh76I/fvE.eL5QBdhG7Dfk7BSYah6',
'13800000000',
'admin',
'iPlacard',
UNIX_TIMESTAMP(CURRENT_TIMESTAMP)
);
INSERT INTO `{IP_PREFIX}admin` (`id`, `role_reviewer`, `role_dais`, `role_interviewer`, `role_cashier`, `role_administrator`, `role_bureaucrat`) VALUES (1, 1, 1, 1, 1, 1, 1);
```
其中，替换姓名、邮箱和手机号三项必要信息。将 `{IP_PREFIX}` 更换为在 `config.php` 中设定的数据库前缀。
### 更改系统设置
iPlacard 总共有两百余项设置项，可设置申请流程、账单、席位模式、界面等等行为。这些设置项在数据库的 `option` 表中可被修改。详细的设置项名称及其控制的功能请参见 [`resource/install.sql`](resource/install.sql)。
### 设置 Cron
Cron 脚本用于处理发送短信、面试提醒、删除代表帐户等任务。增加以下 Cron 任务：
```
* * * * * php /path/to/iplacard/index.php cron minutely >> /path/to/iplacard/data/0/log/minutely.log 2>&1
@hourly php /path/to/iplacard/index.php cron hourly >> /path/to/iplacard/data/0/log/hourly.log 2>&1
@daily php /path/to/iplacard/index.php cron daily >> /path/to/iplacard/data/0/log/daily.log 2>&1
@weekly php /path/to/iplacard/index.php cron weekly >> /path/to/iplacard/data/0/log/weekly.log 2>&1
```
替换其中的 `/path/to/iplacard/` 为 iPlacard 的安装目录。
### 开始使用
访问 iPlacard 网页，使用上述创建管理用户步骤中设置的邮箱登录，登录密码为 `iplacardadmin`，登录后请修改密码。
### 可选操作
#### 1、导入示例数据
[`resource/sample.sql`](resource/sample.sql) 文件包含有示例数据，导入示例数据可快速开始使用 iPlacard。导入前需将 `sample.sql` 文件中的 `{IP_PREFIX}` 更换为在 `config.php` 中设定的数据库前缀。在 Linux 下可运行：
```bash
sed -e 's/{IP_PREFIX}/ip_/g' resource/sample.sql | mysql -u user -p database
```
#### 2、配置 Apache
将 [`resource/htaccess`](resource/htaccess) 复制到 iPlacard 根目录下并重命名为 `.htaccess` 可隐藏网址中的 `index.php/` 部分并防止恶意获取文件。
#### 3、配置 Nginx
参照 [`resource/nginx`](resource/nginx) 修改 Nginx 的配置文件可隐藏网址中的 `index.php/` 部分并防止恶意获取文件。
#### 4、删除多余配置项
iPlacard 每次请求均会从数据库的 `option` 表中载入全部配置项，删除采用默认设置的配置项（即导入数据表后未修改过的配置项）可以提高网页打开速度。
## 更新
### 修订更新
修订更新指大版本不变的更新，例如由 2.3.0 更新至 2.3.1。修订更新不包含新功能和数据库变动，仅需通过 Git 更新代码。
```bash
cd iplacard
git pull
php composer.phar update
```