Alliance Auth 的回购计划管理应用程序
项目描述
Alliance Auth 回购
这是Alliance Auth (AA) 的回购计划管理应用程序。
内容
概述
这个应用程序有助于为联盟或公司运行回购计划。
主要特征
它提供以下主要功能:
- 管理公司回购计划
- 计算将发送到回购计划的物品的价值
- 存储有关回购计划使用情况的统计信息
安装
安装软件
从 PyPI 安装到您的 Alliance Auth 虚拟环境中:
pip install aa-buybacks
更新 Eve Online 应用程序
更新用于 AA 安装中身份验证的 Eve Online 应用程序,以包括以下范围:
esi-universe.read_structures.v1
esi-contracts.read_corporation_contracts.v1
esi-assets.read_corporation_assets.v1
配置 AA 设置
配置您的 AA 设置 ( local.py
),如下所示:
-
添加
'eveuniverse'
和'buybacks'
到INSTALLED_APPS
-
将这些行添加到设置文件的底部:
# settings for buybacks CELERYBEAT_SCHEDULE['buybacks_update_all_offices'] = { 'task': 'buybacks.tasks.update_all_offices', 'schedule': crontab(minute=0, hour='*/12'), } CELERYBEAT_SCHEDULE['buybacks_sync_all_contracts'] = { 'task': 'buybacks.tasks.sync_all_contracts', 'schedule': crontab(minute=0, hour='*'), }
完成安装到 AA
运行迁移并复制静态文件
python manage.py migrate
python manage.py collectstatic
为 AA 重新启动您的主管服务
数据导入
从 ESI 加载 EVE Online 类型数据:
python manage.py buybacks_load_types
设置权限
现在您可以访问 Alliance Auth 并为您的用户设置权限。这是此应用程序使用的所有权限的概述:
姓名 | 目的 | 代码 |
---|---|---|
可以访问此应用并查看回购计划 | 为用户启用应用程序。应为允许使用该应用程序的每个人启用此权限(例如会员国) | basic_access |
可以成立公司 | 添加或更新用于同步办公室和合同的角色。这应该仅限于具有管理员/领导权限的用户。 | setup_retriever |
可以管理回购计划 | 拥有此权限的用户可以管理回购计划和通知 | manage_programs |
设立公司
最后,您需要设置一个具有将用于获取公司办公室、合同和相关结构的角色的公司。只需单击Setup Corp并添加请求的令牌。
请注意,只有具有相应权限的用户才能看到和使用此按钮。
请注意,相应的角色需要是公司的董事。
定义程序
假设您的公司有一个 ORE 回购计划,并且您想为此使用此工具。首先,您需要单击“创建程序”并填写程序名称。
请注意,只有具有相应权限的用户才能看到和使用此按钮。
创建后,您应该能够添加所有位置(您的公司有办公室的地方),以表示要为其创建合同的结构或站点。您可能只接受某些公司精炼厂的矿石,而不希望人们将其发送到其他结构。
您还应该能够在价格之上添加所有项目和公司略读的百分比。例如,对于您的 ORE 回购计划,添加斜长石,经纪佣金设置为 20%。
而已。回购计划已完全创建并可以使用。
计算
任何角色都可以通过单击其中一个程序上的使用按钮来使用其中一个回购程序。完成后,他们需要选择位置并可以复制粘贴他们想要发送给公司的物品。当他们点击计算时,应用程序会根据程序中定义的价格计算出确切的金额,并向他们显示总价值。
一旦他们看到总价值,他们将需要发送一份确切金额的游戏内合同,然后单击通知以通知应用程序。
一旦公司接受合同,我们的合同同步功能将自动匹配相应的通知(基于总价、数量项目和合同位置)并将其存储在统计信息中。
更新
要更新您现有的 Buybacks 安装,首先启用您的虚拟环境。
然后从您的 AA 项目目录(包含 的目录manage.py
)运行以下命令。
pip install -U aa-buybacks
python manage.py migrate
python manage.py collectstatic
python manage.py buybacks_load_types
最后重新启动您的 AA 主管服务。
提示与技巧
- 如果您想在一个程序中编辑一个项目的经纪,您只需将项目添加到新的经纪中,它就会更新现有的。
去做
- 使用精炼值计算 OREs
- 设置每个项目的精炼百分比
- 统计过滤