feat: 통합 세력 장수/암행부 페이지 (#213)

- ag-grid 기반
- 컬럼 사용자 정의 기능 제공
  - 컬럼 재정렬, 고정, 정렬 기능
  - 컬럼 상태 저장, 불러오기
  - 마지막 컬럼 재 사용
- 아이콘, 장수명 클릭 시 특수 기능 제공
  - 기본 세력 장수/암행부에서는 '감찰부'
- 추가 컬럼
  - 최근 전투
  - 전투 수
  - 승리 수
  - 살상률
- API/Nation/GeneralList 추가

Co-authored-by: hide_d <hided62@gmail.com>
Reviewed-on: https://storage.hided.net/gitea/devsam/core/pulls/213

hwe/sammo/API/Global/GeneralList.php

@@ -0,0 +1,165 @@
+<?php
+
+namespace sammo\API\List\Nation;
+
+use sammo\DB;
+use sammo\General;
+use sammo\Json;
+use sammo\KVStorage;
+use sammo\RootDB;
+use sammo\Session;
+use sammo\Util;
+use sammo\Validator;
+
+use function sammo\calcLeadershipBonus;
+use function sammo\checkLimit;
+use function sammo\checkSecretPermission;
+use function sammo\getDed;
+use function sammo\getDedLevelText;
+use function sammo\getExpLevel;
+use function sammo\getGenChar;
+use function sammo\getGeneralSpecialDomesticName;
+use function sammo\getGeneralSpecialWarName;
+use function sammo\getHonor;
+use function sammo\getNationStaticInfo;
+use function sammo\getOfficerLevelText;
+use function sammo\increaseRefresh;
+
+class GeneralList extends \sammo\BaseAPI
+{
+    public function validateArgs(): ?string
+    {
+        $v = new Validator($this->args);
+        $v
+            ->rule('boolean', 'with_token');
+        if (!$v->validate()) {
+            return $v->errorStr();
+        }
+        return null;
+    }
+
+    public function getRequiredSessionMode(): int
+    {
+        return static::REQ_LOGIN;
+    }
+
+    public function launch(Session $session, ?\DateTimeInterface $modifiedSince, ?string $reqEtag)
+    {
+        $db = DB::db();
+        $withToken = $this->args['with_token']??false;
+        $gameStor = KVStorage::getStorage($db, 'game_env');
+
+        $userID = $session->userID;
+        if ($session->isGameLoggedIn()) {
+            increaseRefresh("장수일람", 2);
+            $me = $db->queryFirstRow('SELECT con, turntime FROM general WHERE owner=%i', $userID);
+            $con = checkLimit($me['con']);
+            if ($con >= 2) {
+                return '접속 제한중입니다. 1턴 이내에 너무 많은 갱신을 하셨습니다.';
+            }
+        } else {
+            $availableNextCall = $session->availableNextCallGetGeneralList ?? '2000-01-01 00:00:00';
+            $now = new \DateTimeImmutable();
+
+            if ($now <= new \DateTimeImmutable($availableNextCall) && $session->userGrade < 5) {
+                return "장수 리스트는 10초에 한번 갱신 가능합니다.\n다음 시간 : " . $availableNextCall;
+            }
+
+            $availableNextCall = $now->add(new \DateInterval('PT10S'))->format('Y-m-d H:i:s');
+            $session->availableNextCallGetGeneralList = $availableNextCall;
+        }
+
+        $session->setReadOnly();
+
+
+        $rawGeneralList = $db->queryAllLists('SELECT owner,no,picture,imgsvr,npc,age,nation,special,special2,personal,name,owner_name as ownerName,injury,leadership,strength,intel,experience,dedication,officer_level,killturn,connect from general');
+
+        $ownerNameList = [];
+        if ($gameStor->isunited) {
+            foreach (RootDB::db()->queryAllLists('SELECT no, name FROM member') as [$ownerID, $ownerName]) {
+                $ownerNameList[$ownerID] = $ownerName;
+            }
+        }
+
+        $generalList = [];
+        foreach ($rawGeneralList as $rawGeneral) {
+            [$owner, $no, $picture, $imgsvr, $npc, $age, $nation, $special, $special2, $personal, $name, $ownerName, $injury, $leadership, $strength, $intel, $experience, $dedication, $officerLevel, $killturn, $connectCnt] = $rawGeneral;
+
+            if (key_exists($owner, $ownerNameList)) {
+                $ownerName = $ownerNameList[$owner];
+            }
+
+            $nationArr = getNationStaticInfo($nation);
+            $lbonus = calcLeadershipBonus($officerLevel, $nationArr['level']);
+
+            $generalList[] = [
+                $no,
+                $picture,
+                $imgsvr,
+                $npc,
+                $age,
+                $nationArr['name'],
+                getGeneralSpecialDomesticName($special),
+                getGeneralSpecialWarName($special2),
+                getGenChar($personal),
+                $name,
+                $npc == 1 ? $ownerName : null,
+                $injury,
+                $leadership,
+                $lbonus,
+                $strength,
+                $intel,
+                getExpLevel($experience),
+                getHonor($experience),
+                getDed($dedication),
+                getOfficerLevelText($officerLevel, $nationArr['level']),
+                $killturn,
+                $connectCnt
+            ];
+        }
+
+        $resultColumns = [
+            'no',
+            'picture',
+            'imgsvr',
+            'npc',
+            'age',
+            'nationName',
+            'special',
+            'special2',
+            'personal',
+            'name',
+            'ownerName',
+            'injury',
+            'leadership',
+            'lbonus',
+            'strength',
+            'intel',
+            'explevel',
+            'honorText',
+            'dedLevelText',
+            'officerLevelText',
+        ];
+
+        $result = [
+            'result' => 'true',
+            'column' => $resultColumns,
+            'list' => $generalList,
+        ];
+
+
+        if ($withToken) {
+            $now = (new \DateTimeImmutable())->format('Y-m-d H:i:s');
+            $tokens = [];
+            foreach ($db->query('SELECT * FROM select_npc_token WHERE `valid_until`>=%s', $now) as $token) {
+                $validUntil = $token['valid_until'];
+
+                foreach (Json::decode($token['pick_result']) as $pickResult) {
+                    $tokens[$pickResult['no']] = $pickResult['keepCnt'];
+                }
+            }
+            $result['token'] = $tokens;
+        }
+        return $result;
+    }
+}

hwe/sammo/API/Global/GetConst.php

@@ -20,7 +20,7 @@ use function sammo\prepareDir;
 class GetConst extends \sammo\BaseAPI
 {
     /** 반환하는 StaticValues 타입이 달라지면 +1 */
-    const CONST_API_VERSION = 1;
+    const CONST_API_VERSION = 2;
     const CACHE_KEY = 'JSConst';
 
     private ?string $cacheKey = null;
@@ -109,7 +109,7 @@ class GetConst extends \sammo\BaseAPI
     public function tryCache(): ?APICacheResult
     {
         if (is_subclass_of('\\sammo\\VersionGit', '\\sammo\VersionGitDynamic')) {
-            return new APICacheResult(TimeUtil::secondsToDateTime($this->findLastModified(), true, true));
+            return new APICacheResult(TimeUtil::secondsToDateTime($this->findLastModified()??\time(), true, true));
         }
 
         return new APICacheResult(null, $this->getCacheKey());
@@ -258,6 +258,18 @@ class GetConst extends \sammo\BaseAPI
 
             $iActionInfo[$mappedKey] = $actionInfo;
         }
+
+        $crewtypeMap = [];
+        foreach(GameUnitConst::all() as $crewtypeObj){
+            $crewtypeMap[$crewtypeObj->id] = [
+                'value'=>(string)$crewtypeObj->id,
+                'name'=>$crewtypeObj->name,
+                'info'=>$crewtypeObj->getInfo(),
+            ];
+        }
+        $iActionInfo['crewtype'] = $crewtypeMap;
+
+
         return [
             'gameConst' => get_class_vars('\sammo\GameConst'),
             'gameUnitConst' => GameUnitConst::all(),