PHPackages                             akinams053/seat-pap - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. akinams053/seat-pap

ActiveSeat-plugin

akinams053/seat-pap
===================

Calendar and PAP tracking plugin for SeAT 5.x.

1.1.8(5mo ago)021↑2900%GPL-3.0-or-laterPHP

Since Jan 24Pushed 1mo agoCompare

[ Source](https://github.com/akinams053/seat-pap)[ Packagist](https://packagist.org/packages/akinams053/seat-pap)[ RSS](/packages/akinams053-seat-pap/feed)WikiDiscussions localization Synced 1mo ago

READMEChangelogDependencies (10)Versions (24)Used By (0)

seat-pap
========

[](#seat-pap)

[![Core Version](https://camo.githubusercontent.com/fe73415b3ab44d4df90cf3c5ebdbebb25f38472830dc9b96cc3759fa2b49a6c7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f536541542d352e302e782d626c75653f7374796c653d666f722d7468652d6261646765)](https://github.com/eveseat/seat)[![License](https://camo.githubusercontent.com/a017caf4f714e657609408cf2fd3b5a0df4ac9269323b0d7c2eb747fcb2d9898/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f616b696e616d733035332f736561742d7061703f7374796c653d666f722d7468652d6261646765)](https://github.com/akinams053/seat-pap/blob/localization/LICENCE)

面向 **SeAT 5.x** 的 Calendar / PAP 插件。

功能概览
----

[](#功能概览)

### Operation 管理

[](#operation-管理)

- 创建 / 更新 / 取消 / 重新激活 / 关闭 / 删除 operation
- 基于角色（Role）的 operation 可见性控制
- 用户按角色报名 operation（attending / not attending / maybe）
- operation 标签管理（分类、排序、analytics 分轴、quantifier）

### PAP 采集与统计

[](#pap-采集与统计)

- FC 通过 ESI 拉取当前 fleet 成员，一键生成 PAP
- PAP 发放后自动更新舰队 MOTD，通知成员发放结果
- **主角色聚合**：所有 alt 的 PAP 自动归并到 main character
- 角色维度：
    - 当月 / 当年 PAP 汇总卡片
    - 每月参与趋势折线图
    - 周 / 月 / 年排名榜（按主角色聚合）
- 军团维度：
    - 月度参与趋势折线图（可按年份筛选）
    - PAP 类型分布饼图 — 月度（可按年月筛选）
    - PAP 类型分布饼图 — 年度（可按年份筛选）
    - 排名榜（可按年月筛选，支持导出 Excel）

### PAP API

[](#pap-api)

- 提供 REST API 供外部服务（如 PAP 商店）查询主角色聚合后的 PAP 总数
- 支持单角色查询和批量查询（最多 200 个）
- Token 认证，无需用户二次登录或 SSO 授权
- 在 **Calendar → Settings** 页面生成和管理 API Token

### MOTD 自定义

[](#motd-自定义)

- 在设置页面可自定义舰队 MOTD 的各要素颜色
- 固定要素：标题、舰队名称、舰队人数、PAP 值、PAP 类型、发放时间
- 底部签名可自定义内容和颜色
- 设置页面提供实时预览

### 排名显示

[](#排名显示)

- 前三名显示金 / 银 / 铜奖杯图标
- 每行进度条显示相对贡献占比
- 角色页面自动高亮你的主角色排名位置

兼容性
---

[](#兼容性)

项目版本SeAT5.xLaravel10.xPHP8.1 - 8.4目标部署环境：**Ubuntu 22.04**

安装
--

[](#安装)

当前开发分支为 `localization`，需要指定版本安装。

Packagist 页面：

在 **SeAT 根目录**（默认 `/var/www/seat`）执行：

```
cd /var/www/seat

# 安装插件（需要 sudo 以写入 vendor 目录）
sudo composer require akinams053/seat-pap:dev-localization

# 发布静态资源（CSS/JS）
sudo php artisan vendor:publish --force --provider="Seat\Kassie\Calendar\CalendarServiceProvider"

# 执行数据库迁移
php artisan migrate

# 清除缓存
php artisan view:clear
php artisan route:clear
php artisan cache:clear
```

> **注意**：如果 `composer require` 提示权限问题，请使用 `sudo`。SeAT 目录通常属于 `www-data` 用户。

更新
--

[](#更新)

```
cd /var/www/seat

# 拉取最新版本
sudo composer update akinams053/seat-pap

# 重新发布静态资源
sudo php artisan vendor:publish --force --provider="Seat\Kassie\Calendar\CalendarServiceProvider"

# 执行新增迁移（如有）
php artisan migrate

# 清除缓存
php artisan view:clear
php artisan route:clear
php artisan cache:clear
```

使用说明
----

[](#使用说明)

### 权限设置

[](#权限设置)

安装后需要在 SeAT 后台为用户角色分配以下权限：

权限说明`calendar.view`查看 operation 列表`calendar.create`创建新 operation`calendar.setup`管理 tags、MOTD、API Token 等设置`calendar.update_all`编辑他人的 operation`calendar.cancel_all`取消 / 关闭他人的 operation`calendar.delete_all`删除他人的 operation`character.kassie_calendar_paps`查看角色 PAP 页面`corporation.kassie_calendar_paps`查看军团 PAP 页面设置路径：**SeAT 后台 → Access Management → Roles → 选择角色 → Permissions**

### 日常使用流程

[](#日常使用流程)

1. **创建 Operation**：导航到 Calendar → Operations，点击创建，填写标题、时间、FC、集结星系、标签等
2. **报名**：用户在 operation 详情中选择角色和参与状态
3. **PAP 采集**：operation 进行中，FC 点击 PAP 按钮，系统通过 ESI 拉取 fleet 成员列表并记录
4. **查看统计**：
    - 角色 PAP：角色侧栏 → Paps
    - 军团 PAP：军团侧栏 → Paps

### PAP 使用前提

[](#pap-使用前提)

FC 角色必须在 SeAT 中注册并授权以下 ESI scope：

```
esi-fleets.read_fleet.v1
esi-fleets.write_fleet.v1

```

- `read_fleet`：读取舰队成员列表，用于 PAP 采集
- `write_fleet`：PAP 发放后自动更新舰队 MOTD 通知成员

PAP 采集时，FC 必须是 fleet boss。

### 舰队 MOTD 通知

[](#舰队-motd-通知)

PAP 发放成功后，系统会自动更新舰队 MOTD，以彩色格式展示：

- 舰队名称（operation 标题）
- 舰队人数
- PAP 值（取 tag 中最大 quantifier）
- PAP 类型（取 tag 的 analytics 字段）
- 发放时间（EVE 时间）
- 可选的底部签名

如果 PAP 发放过程中出现错误，MOTD 会显示红色错误提示。

MOTD 更新失败不会影响 PAP 的正常发放。

MOTD 的颜色和签名内容可在 **Calendar → Settings** 页面自定义。

### PAP API

[](#pap-api-1)

本插件提供 REST API，允许外部服务（如 PAP 商店）查询主角色聚合后的 PAP 总数。**外部服务只需持有管理员生成的 API Token 即可调用，无需用户二次登录或 SSO 授权。**

#### 配置步骤

[](#配置步骤)

1. 导航到 **Calendar → Settings** 页面
2. 在页面底部找到 **PAP API 设置** 卡片
3. 点击 **生成 Token** 按钮
4. 将生成的 Token 配置到外部服务中

> 需要 `calendar.setup` 权限才能管理 API Token。

#### 单角色查询

[](#单角色查询)

适用于用户手动刷新个人 PAP 余额等场景。

**请求**：

```
GET https://your-seat-domain/api/calendar/paps/{character_id}
Authorization: Bearer

```

**响应**：

```
{
    "status": "success",
    "character_id": 2118151113,
    "user_id": 120,
    "total_pap": 3.0,
    "sync_at": "2026-03-28 08:27:04"
}
```

- `character_id`：主角色 ID（已自动聚合所有 alt）
- `user_id`：SeAT 用户 ID
- `total_pap`：2026 年起的 PAP 总数（主角色 + 所有 alt 合并）
- `sync_at`：查询时间

角色未找到时返回 `404`：

```
{
    "status": "error",
    "message": "Character not found or not linked to a SeAT user."
}
```

#### 批量查询

[](#批量查询)

适用于定时任务批量同步所有成员 PAP 的场景。单次最多 200 个角色。

**请求**：

```
GET https://your-seat-domain/api/calendar/paps?characters=2118151113,2118151114,2118151115
Authorization: Bearer

```

**响应**：

```
{
    "status": "success",
    "data": [
        {"character_id": 2118151113, "user_id": 120, "total_pap": 3.0},
        {"character_id": 2118151114, "user_id": 121, "total_pap": 5.0}
    ],
    "not_found": [2118151115],
    "sync_at": "2026-03-28 02:00:04"
}
```

- `data`：查询成功的角色列表
- `not_found`：未找到或未绑定 SeAT 用户的角色 ID 列表

#### 认证方式

[](#认证方式)

支持两种传递 Token 的方式：

```
# 方式一：HTTP Header（推荐）
curl -H "Authorization: Bearer YOUR_TOKEN" https://your-seat-domain/api/calendar/paps/2118151113

# 方式二：Query 参数
curl "https://your-seat-domain/api/calendar/paps/2118151113?token=YOUR_TOKEN"
```

#### 错误码

[](#错误码)

HTTP 状态码含义200查询成功400请求参数缺失或角色数量超过 200401Token 错误或缺失404角色未找到（仅单角色查询）503未配置 API Token### ESI Scope 配置

[](#esi-scope-配置)

本插件需要 FC 角色授权 `esi-fleets.write_fleet.v1` scope 来更新舰队 MOTD。SeAT 默认的 SSO scope 列表中不包含此项，需要手动添加。

**配置步骤**：

1. 在 SeAT 服务器上执行以下命令，将 `write_fleet` scope 加入 SSO 请求列表：

```
php artisan tinker --execute="\$s = \Seat\Services\Models\GlobalSetting::where('name', 'sso_scopes')->first(); \$v = json_decode(\$s->value, true); \$v[0]['scopes'][] = 'esi-fleets.write_fleet.v1'; \$s->value = json_encode(\$v); \$s->save(); echo 'done';"
```

2. 清除缓存：

```
php artisan cache:clear
```

3. 前往 [EVE 第三方应用管理](https://community.eveonline.com/support/third-party-applications/) 撤销 SeAT 的旧授权
4. 在 SeAT 中重新添加 / 授权 FC 角色，确保 EVE SSO 弹出新的权限确认页面
5. 验证 token 包含 write scope：

```
php artisan tinker --execute="\$t = \Seat\Eveapi\Models\RefreshToken::find(YOUR_CHARACTER_ID); foreach(\$t->scopes as \$s) { if(str_contains(\$s, 'fleet')) echo \$s . PHP_EOL; }"
```

应输出：

```
esi-fleets.read_fleet.v1
esi-fleets.write_fleet.v1

```

> **注意**：如果不配置 write scope，PAP 采集仍可正常工作，仅 MOTD 更新会静默失败。

### 主角色聚合

[](#主角色聚合)

- PAP 统计自动按 SeAT 用户的 **main character** 聚合
- 一个用户的所有 alt 角色产生的 PAP 会合并计入主角色名下
- 角色 PAP 页面的图表展示的是该用户（含所有 alt）的汇总数据
- 军团排名默认展示主角色聚合结果
- API 返回的 `total_pap` 同样是主角色聚合后的结果

### Tag 与 Analytics

[](#tag-与-analytics)

Tag 的两个关键字段影响 PAP 统计：

- **Quantifier**：PAP 数值权重（operation 的 PAP 值取所有 tag 中最大的 quantifier）
- **Analytics**：分类轴名称（如 Strategic、PvP、Mining），用于图表中的类型分布统计

开发说明
----

[](#开发说明)

```
# 在插件仓库目录
composer install
vendor/bin/rector process
```

当前仓库没有自动化测试套件，验证依赖 SeAT 宿主中的集成测试。

### 建议验证项

[](#建议验证项)

- operation 创建 / 更新 / 取消 / 重新激活 / 关闭 / 删除
- attendee 报名
- PAP 拉取
- PAP 发放后舰队 MOTD 是否正确更新
- 角色 PAP 页面（汇总卡片 + 趋势图 + 排名）
- 军团 PAP 页面（趋势图 + 类型分布 + 排名 + Excel 导出）
- 设置页面 MOTD 颜色和签名自定义
- 主角色聚合结果是否正确
- PAP API 单角色查询 / 批量查询 / Token 认证 / 错误码

历史说明
----

[](#历史说明)

本项目 fork 自 [hermesdj/seat-calendar](https://github.com/hermesdj/seat-calendar)，已移除 Discord / Slack / Mail / 外部通知集成功能，重新定位为核心 Calendar / PAP 插件。

License
-------

[](#license)

GPL-3.0-or-later

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance82

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 64.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~30 days

Recently: every ~10 days

Total

23

Last Release

163d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/adf082d523632f648a9838e122112bf92c8ba5b63190534bc0753f6a3227293b?d=identicon)[akinams053](/maintainers/akinams053)

---

Top Contributors

[![warlof](https://avatars.githubusercontent.com/u/648753?v=4)](https://github.com/warlof "warlof (109 commits)")[![akinams053](https://avatars.githubusercontent.com/u/241569063?v=4)](https://github.com/akinams053 "akinams053 (27 commits)")[![hermesdj](https://avatars.githubusercontent.com/u/5843492?v=4)](https://github.com/hermesdj "hermesdj (20 commits)")[![alkari-verende](https://avatars.githubusercontent.com/u/70491080?v=4)](https://github.com/alkari-verende "alkari-verende (6 commits)")[![herpaderpaldent](https://avatars.githubusercontent.com/u/6583519?v=4)](https://github.com/herpaderpaldent "herpaderpaldent (1 commits)")[![KagurazakaNyaa](https://avatars.githubusercontent.com/u/7751303?v=4)](https://github.com/KagurazakaNyaa "KagurazakaNyaa (1 commits)")[![PhaNtomBek](https://avatars.githubusercontent.com/u/97723224?v=4)](https://github.com/PhaNtomBek "PhaNtomBek (1 commits)")[![veteranmina](https://avatars.githubusercontent.com/u/1810464?v=4)](https://github.com/veteranmina "veteranmina (1 commits)")[![akturis](https://avatars.githubusercontent.com/u/16912735?v=4)](https://github.com/akturis "akturis (1 commits)")[![Enolyo](https://avatars.githubusercontent.com/u/48598512?v=4)](https://github.com/Enolyo "Enolyo (1 commits)")

###  Code Quality

Static AnalysisRector

### Embed Badge

![Health badge](/badges/akinams053-seat-pap/health.svg)

```
[![Health](https://phpackages.com/badges/akinams053-seat-pap/health.svg)](https://phpackages.com/packages/akinams053-seat-pap)
```

###  Alternatives

[eveseat/seat

Simple Eve Api Tool

45319.4k](/packages/eveseat-seat)[eveseat/web

SeAT Web Interface

2723.2k135](/packages/eveseat-web)[kassie/calendar

Calendar plugin for SeAT.

1420.6k1](/packages/kassie-calendar)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)