devwinsoft/devian/12-mission-storage

12-mission-storage

Status: ACTIVE AppliesTo: v10 Type: Design / SSOT

Purpose

MissionStorage의 저장 구조와 복구 규칙 정본이다.

Schema

public sealed class MissionStorage
{
    public int schemaVersion; // default: 2
    public long dailyMissionStartUtcMs;
    public long weeklyMissionStartUtcMs;
    public int nextMissionUid;
    public Dictionary<int, MissionRuntimeBase> runtimes;
}

핵심:

• MissionStorage는 runtime 상태만 저장한다.
• stat 누적 정본은 45-game-message-system/14-game-message-storage의 message.stats다.
• schemaVersion 기본값은 2를 사용한다.

Runtime Stored Shape

public abstract class MissionRuntimeBase
{
    public string mission_id;
    public string periodKey;
    public int missionUid;
    public int index;
    public CBigInt progressValue;
    public MissionRuntimeState state;  // WAIT, ACTIVE, COMPLETED
}

규칙:

• state는 WAIT, ACTIVE, COMPLETED만 저장한다. CLAIMABLE은 파생 상태이므로 저장하지 않는다.
• condition_msg_id는 저장하지 않는다. mission_id로 테이블(MISSION_DAILY/MISSION_WEEKLY)에서 조회한다.

타입별 저장 규칙:

• MissionRuntimeDaily:
• periodKey, index, state, progressValue 저장
• MissionRuntimeWeekly:
• periodKey, day, state, progressValue 저장

Persistence Rules

• DAILY/period progress는 runtime 로컬 값으로 저장/복원한다.
• stat 누적 값은 mission payload에 저장하지 않는다.
• condition_msg_id는 runtime에 저장하지 않는다. restore 시 테이블에서 조회한다.
• reward_group_id 등 definition 데이터는 runtime에 저장하지 않는다.

Initialize / Recovery

1. storage 로드
2. scheduler rebuild/prune
3. runtime bind 시 저장 progress 복원
4. period runtime은 WAIT 상태를 복원한 뒤 day 규칙으로 재활성화

Hard Rules

• MissionStorage mutation은 MissionManager 경로만 허용
• Mission payload는 stats를 소유하지 않는다.
• message stat 마이그레이션은 SaveData codec에서 처리한다.

Related

• 03-ssot
• 10-mission-manager
• 13-mission-runtime
• 45-game-message-system/14-game-message-storage
• 43-savedata-json-codec