feat,refac: 경매장 재설계, 유니크 경매장 구현 (#221)

- 경매장을 모든 입찰 기록이 남는 새로운 경매장 로직으로 변경
  - ng_auction, ng_auction_bid
    - DTO 사용
  - 상회입찰 시 개인메시지로 알림
- 기존의 '배경에서 조용히 이루어지는' 유니크 입찰을 공개된 유니크 경매장으로 변경
  - 종료 기간 명시
    - 종료 기간에 가까워질때 입찰하면 자동 연장
    - 최대 연장기간 있음
  - 유니크 제한인 경우 24턴 연장
  - 중원정세에서 '보물수배'로 알림

Reviewed-on: https://storage.hided.net/gitea/devsam/core/pulls/221

hwe/sammo/API/InheritAction/BuySpecificUnique.php

@@ -1,104 +0,0 @@
-<?php
-
-namespace sammo\API\InheritAction;
-
-use sammo\Session;
-use DateTimeInterface;
-use sammo\DB;
-use sammo\Enums\RankColumn;
-use sammo\GameConst;
-use sammo\General;
-use sammo\KVStorage;
-use sammo\UserLogger;
-use sammo\Validator;
-
-use function sammo\buildItemClass;
-
-class BuySpecificUnique extends \sammo\BaseAPI
-{
-    public function validateArgs(): ?string
-    {
-        $availableItems = [];
-        foreach (GameConst::$allItems as $items) {
-            foreach ($items as $itemKey => $amount) {
-                if ($amount == 0) {
-                    continue;
-                }
-                $availableItems[$itemKey] = $amount;
-            }
-        }
-
-        $v = new Validator($this->args);
-        $v->rule('required', [
-            'item',
-            'amount',
-        ])
-            ->rule('int', 'amount')
-            ->rule('min', 'amount', GameConst::$inheritItemUniqueMinPoint)
-            ->rule('keyExists', 'item', $availableItems);
-
-        if (!$v->validate()) {
-            return $v->errorStr();
-        }
-        return null;
-    }
-
-    public function getRequiredSessionMode(): int
-    {
-        //KVStrorage, General.aux 모두 쓰므로 lock;
-        return static::REQ_GAME_LOGIN;
-    }
-
-    public function launch(Session $session, ?DateTimeInterface $modifiedSince, ?string $reqEtag)
-    {
-        $itemKey = $this->args['item'];
-        $amount = $this->args['amount'];
-
-        $userID = $session->userID;
-        $generalID = $session->generalID;
-
-        $general = General::createGeneralObjFromDB($generalID);
-        if ($userID != $general->getVar('owner')) {
-            return '로그인 상태가 이상합니다. 다시 로그인해 주세요.';
-        }
-
-        $itemTrials = $general->getAuxVar('inheritUniqueTrial') ?? [];
-        if (key_exists($itemKey, $itemTrials)) {
-            return '이미 입찰한 아이템입니다. 다음 턴에 시도해 주세요.';
-        }
-
-        foreach(GameConst::$allItems as $itemType => $items){
-            if(!key_exists($itemKey, $items)){
-                continue;
-            }
-
-            $prevItem = $general->getItem($itemType);
-            if(!$prevItem->isBuyable()){
-                return '이미 같은 자리에 유니크를 보유하고 있습니다.';
-            }
-
-            break;
-        }
-
-        $db = DB::db();
-        $inheritStor = KVStorage::getStorage($db, "inheritance_{$userID}");
-        $trialStor = KVStorage::getStorage($db, "ut_{$itemKey}");
-        $previousPoint = ($inheritStor->getValue('previous') ?? [0, 0])[0];
-        if ($previousPoint < $amount) {
-            return '충분한 유산 포인트를 가지고 있지 않습니다.';
-        }
-
-        $itemObj = buildItemClass($itemKey);
-        $userLogger = new UserLogger($userID);
-        $userLogger->push("{$amount} 포인트로 유니크 {$itemObj->getName()} 구입 시도", "inheritPoint");
-        $userLogger->flush();
-
-        $itemTrials[$itemKey] = $amount;
-        $general->setAuxVar('inheritUniqueTrial', $itemTrials);
-        $inheritStor->setValue('previous', [$previousPoint - $amount, null]);
-        $general->increaseRankVar(RankColumn::inherit_point_spent_dynamic, $amount);
-        $trialStor->setValue("u{$userID}", [$userID, $generalID, $amount]);
-        $general->applyDB($db);
-        return null;
-    }
-}