core2026/packages/logic/src/domain/entities.ts

// 도메인 기본 엔티티: 서비스/DB에 의존하지 않는 공통 모델.

export type GeneralId = number;
export type CityId = number;
export type NationId = number;
export type TroopId = number;

export type ColorCode = string;

export interface StatBlock {
    leadership: number;
    strength: number;
    intelligence: number;
}

export type TriggerValuePrimitive = boolean | number | string;

export interface TriggerValueObject {
    [key: string]: TriggerValue;
}

export type TriggerValue = TriggerValuePrimitive | TriggerValueObject | TriggerValue[];

export interface GeneralTriggerState {
    // Trigger 시스템에서 사용하는 확장 슬롯.
    flags: Record<string, boolean>;
    counters: Record<string, number>;
    modifiers: Record<string, number>;
    meta: Record<string, TriggerValue>;
}

export interface GeneralItemSlots {
    horse: string | null;
    weapon: string | null;
    book: string | null;
    item: string | null;
}

export type GeneralItemSlot = keyof GeneralItemSlots;

export interface GeneralItemInstanceState {
    charges?: number;
    values: Record<string, TriggerValue>;
}

export interface GeneralItemInstance {
    id: string;
    itemKey: string;
    state: GeneralItemInstanceState;
}

export interface GeneralItemInventory {
    nextInstanceId: number;
    instances: Record<string, GeneralItemInstance>;
    equipped: Partial<Record<GeneralItemSlot, string>>;
}

export interface GeneralRole {
    // General.php의 raw 컬럼을 그대로 유지하는 역할 데이터.
    personality: string | null;
    specialDomestic: string | null;
    specialWar: string | null;
    items: GeneralItemSlots;
}

export type GeneralMeta = Record<string, TriggerValue> & {
    killturn: number;
};

// 레거시 general.last_turn JSON. 연속 실행 턴의 선행 턴 누적 상태를 보존한다.
export interface GeneralLastTurn {
    command: string;
    arg?: Record<string, unknown>;
    term?: number;
    seq?: number;
}

export interface General<TriggerState extends GeneralTriggerState = GeneralTriggerState> {
    id: GeneralId;
    name: string;
    nationId: NationId;
    cityId: CityId;
    troopId: number;
    stats: StatBlock;
    experience: number;
    dedication: number;
    officerLevel: number;
    role: GeneralRole;
    injury: number;
    gold: number;
    rice: number;
    crew: number;
    crewTypeId: number;
    train: number;
    atmos: number;
    age: number;
    npcState: number;
    triggerState: TriggerState;
    // 아이템의 canonical 소유/상태 모델. role.items는 레거시 DB 컬럼/API용 projection이다.
    itemInventory?: GeneralItemInventory;
    meta: GeneralMeta;
    lastTurn?: GeneralLastTurn;
    turnTime?: Date;
    turnTick?: number;
    recentWarTime?: Date | null;
    recentWarTick?: number | null;
}

export interface City {
    id: CityId;
    name: string;
    nationId: NationId;
    level: number;
    state: number;
    population: number;
    populationMax: number;
    agriculture: number;
    agricultureMax: number;
    commerce: number;
    commerceMax: number;
    security: number;
    securityMax: number;
    supplyState: number;
    frontState: number;
    defence: number;
    defenceMax: number;
    wall: number;
    wallMax: number;
    conflict?: Record<string, TriggerValue>;
    meta: Record<string, TriggerValue>;
}

export interface Nation {
    id: NationId;
    name: string;
    color: ColorCode;
    capitalCityId: CityId | null;
    chiefGeneralId: GeneralId | null;
    gold: number;
    rice: number;
    power: number;
    level: number;
    typeCode: string;
    meta: Record<string, TriggerValue>;
}

export interface Troop {
    id: TroopId;
    nationId: NationId;
    name: string;
}