Salmon Stats Records

最近、Power Egg Record が新設されるなどサーモンラン界隈の記錄に関する基準やらまとめ方などがいろいろ代わってきている流れに便乗して Salmon Stats の記錄だけをまとめたものを作ろうと思う。

UI 部分をつくるのは非常にめんどくさいので API キーを使ってアクセスすると JSON を取得できるような仕組みにしようと思う。

::: tip API キーについて

AWS で運営しようとしているので、アホみたいにアクセスされるとそれなりに料金がかかってきてしまうため。

:::

記錄管理について

誰かから申請を受け付けるのも、それを受理するのもめんどくさいので全てプログラミングで行います。

Salmon Stats にアップロードされたリザルトからでしか判断しないので、それ以外のリザルトは全く考慮されません。

まあ普及率から考えてフレンド四人であそんで、誰も Salmon Stats に登録していないっていう状況もあんまりないと考えてこの仕様にしました。

編成・ステージにもよりますが大体シフトごとに 4000 件くらいはリザルトがアップロードされているのでそれなりにまともな指標にはなると思います。

仕様

次の仕様で実装することにしました。

記錄方式

以下の記錄を扱います。

1
シェケナダム
2
  通常編成
3
    総合記錄
4
      昼のみ
5
        赤イクラ
6
        金イクラ
7
      夜あり
8
        赤イクラ
9
        金イクラ
10
    WAVE記錄
11
      干潮
12
        イベントなし
13
          赤イクラ
14
          金イクラ
15
        霧
16
        ハコビヤ襲来
17
        ドスコイ大量発生
18
      通常
19
        イベントなし
20
        ラッシュ
21
        キンシャケ探し
22
        グリル発進
23
        霧
24
        ハコビヤ襲来
25
      満潮
26
        イベントなし
27
        ラッシュ
28
        キンシャケ探し
29
        グリル発進
30
        霧
31
        ハコビヤ襲来
32
  単緑編成
33
  全緑編成
34
  黄金編成

ステージが 5 通り、編成区分が 4 通りあり、更にその中に総合記錄と WAVE 記錄があります。

WAVE 記錄は 16 通りで、それに総合記錄が 2 通りあるので、合計で 18 通りあります。それぞれの記錄には赤イクラと金イクラの記錄があるので、全部で5*4*18*2=720通りの記錄があることになります。

::: tip 記錄について

編成ごとの TOP10 とかつくっても良いかも知れないと思ったが、どのくらいコストがかかるのかわからんので一旦割愛した。

気が向いたら実装します。

:::

これらに対して申請を受けたりしているといくら時間があっても足りないので、自動集計にするのは理にかなっていると言えます。

古い記錄についてどこまで遡るかは微妙なところなのですが、今回は 2019 年 9 月頃まで遡ることにしました。

まあでもこの辺はまだ知識なども十分洗練されていないので上位に載るような記錄は一件もないと思います。

プレイヤーデータを保存しない

誰がその記錄を打ち立てたかというデータは保存しません。

要するに個人を特定できるデータを含まないようにします。

::: warning 内部保存データ

ただし、外部に後悔されないキャッシュにはプレイヤーデータを含むデータとして保存してあります。

:::

仕組み

まず、Salmon Stats から記錄を取得するところから始めます。記錄を取る API はリザルトを取る API より軽いですが、毎回アクセスしているとそれなりに負担がかかるので JSON としてキャッシュを保存します。

古いシフトについては新たにリザルトがアップロードされることはない、と考えて直近一週間のシフトの記錄だけを毎回取得します。

直近一週間となると 4~5 シフトくらいだと思うので、毎回全件（500 件以上）アクセスするよりは遥かに良心的です。このキャッシュを一時間に一回位のペースで更新することを考えます。

つまり、今回考案する API は一時間に一回しか新しい値を返さないことになります。

レスポンス

以下のようなレスポンスを返すと想定します。

1
[
2
  {
3
    "stage_id": 5000,
4
    "shifts": [
5
      {
6
        // 編成区分
7
        "shift_type": "normal",
8
        // 金イクラ記錄
9
        "golden_egg": {
10
          // 総合記錄
11
          "total": {
12
            "power_egg": 9999,
13
            "golden_egg": 999,
14
            "weapon_list": [0, 5000, 5010, 6000],
15
            "start_time": 1630800000
16
          },
17
          // 昼のみ記錄
18
          "no_night_event": {},
19
          // WAVE記錄
20
          "wave": [
21
            {
22
              "power_egg": 9999,
23
              "golden_egg": 999,
24
              "weapon_list": [0, 5000, 5010, 6000],
25
              "start_time": 1630800000,
26
              "event_type": "-",
27
              "water_level": "low"
28
            }
29
          ]
30
        },
31
        // 赤イクラ記錄
32
        // フォーマットは金イクラ記錄と同一
33
        "power_egg": {}
34
      }
35
    ]
36
  }
37
]

と思ったけど、以下のレスポンスのほうがわかりやすかったりするかな。

1
{
2
  "5000": {
3
    // 通常シフト
4
    "normal": {
5
      // 金イクラ記錄
6
      "golden_egg": {
7
        // 総合記錄
8
        "total": {
9
          "power_egg": 9999,
10
          "golden_egg": 999,
11
          "weapon_list": [0, 5000, 5010, 6000],
12
          "start_time": 1630800000
13
        },
14
        // 昼のみ記錄
15
        "no_night_event": {},
16
        // WAVE記錄
17
        "wave": [
18
          {
19
            "power_egg": 9999,
20
            "golden_egg": 999,
21
            "weapon_list": [0, 5000, 5010, 6000],
22
            "start_time": 1630800000,
23
            "event_type": "-",
24
            "water_level": "low"
25
          }
26
        ]
27
      },
28
      // 赤イクラ記錄
29
      // フォーマットは金イクラ記錄と同一
30
      "power_egg": {}
31
    },
32
    // ランダムシフト
33
    "random1": {},
34
    "random4": {},
35
    "grizzco": {}
36
  },
37
  "5001": {},
38
  "5002": {},
39
  "5003": {},
40
  "5004": {}
41
}

というわけで下のレスポンスを採用しました。

UI

表示方法はいろいろあるのですが、以前つくった LanPlay Records の雛形があるのでそれを利用します。

SCSS + Vue をコピペするだけで動くので楽ちんです。LanPlay Records は Vue で動作しているのですが、Salmon Stats Records は Vite を利用しました。

Vite は内部的には Vue3 なのでかなり高速に動作することが期待できます。

ホスティング

いつもどおり Netlify を利用しました。とても便利です。