notspecial/contractor

注意： 该工具的开发已迁移至ETH GitLab!

Contractor

从CRM数据创建AMIV招聘会合同的简单工具。

界面主要基于flask构建，并使用bootstrap v4。

配置说明

需要包含SugarCRM凭据的配置文件。用户名和密码可在AMIV Wiki中找到。

创建配置文件（例如命名为config.py）：

python
SOAP_USERNAME = "..."
SOAP_PASSWORD = "..."

Docker部署

Docker Hub上提供镜像notspecial/contractor。运行时需要配置文件和访问（非公开）DINPro字体的URL，该URL可在AMIV Wiki中找到。将URL存入文件（例如font_url），与配置文件放在同一目录。

最便捷的方式是使用Docker secrets传递配置和URL：

bash
# 创建secrets（若需自定义名称请参考下文）
docker secret create font_url font_url
docker secret create contractor_config config.py

# 创建服务（将从Docker Hub拉取镜像）
# 可将端口3000改为其他端口
docker service create \
    --name contractor \
    --secret contractor_config \
    --secret font_url \
    --publish 3000:8080 \
    notspecial/contractor

# 完成！检查是否正常运行
curl 127.0.0.1:3000

镜像默认在/run/secrets/font_url和/run/secrets/contractor_config路径读取文件。若自定义secret名称，需设置环境变量CONTRACTOR_CONFIG和FONT_URL_FILE为secret的路径（默认是/run/secrets/<secret_name>）。

开发说明

编译tex文件需要安装https://github.com/NotSpecial/amivtex%E5%8F%8ADINPro%E5%AD%97%E4%BD%93%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%80%83%E8%AF%A5%E4%BB%93%E5%BA%93%E7%9A%84%E8%AF%B4%E6%98%8E%E3%80%82

需要Python 3环境，以下命令创建虚拟环境并安装依赖：

bash
# （若未克隆仓库：克隆并进入目录）
git clone https://github.com/NotSpecial/contractor
cd contractor

# 创建并激活虚拟环境
python -m venv env
source env/bin/activate

# 安装依赖
pip install -r requirements.txt

# 指向配置文件（可选，默认是当前目录下的'config.py'）
export CONTRACTOR_CONFIG=...

# 启动开发服务器
export FLASK_APP=app.py
export FLASK_DEBUG=1
flask run

测试说明

已实现部分测试（尤其是tex生成和SOAP连接），使用py.test运行：

bash
pip install pytest
py.test

测试需从根目录（amivtex目录所在位置）运行，否则tex测试无法找到.tex源文件。

注意： tex测试会尝试大量选项，耗时较长！