Genarrative/server-rs/crates/module-match3d/src/domain.rs

use serde::{Deserialize, Serialize};
#[cfg(feature = "spacetime-types")]
use spacetimedb::SpacetimeType;

pub const MATCH3D_SESSION_ID_PREFIX: &str = "match3d-session-";
pub const MATCH3D_MESSAGE_ID_PREFIX: &str = "match3d-message-";
pub const MATCH3D_PROFILE_ID_PREFIX: &str = "match3d-profile-";
pub const MATCH3D_WORK_ID_PREFIX: &str = "match3d-work-";
pub const MATCH3D_RUN_ID_PREFIX: &str = "match3d-run-";
pub const MATCH3D_TRAY_SLOT_COUNT: u32 = 7;
pub const MATCH3D_ITEMS_PER_CLEAR: u32 = 3;
pub const MATCH3D_MAX_ITEM_TYPE_COUNT: u32 = 20;
pub(crate) const MATCH3D_MAX_ITEM_TYPE_COUNT_USIZE: usize = 20;
pub const MATCH3D_MIN_DIFFICULTY: u32 = 1;
pub const MATCH3D_MAX_DIFFICULTY: u32 = 10;
pub const MATCH3D_DEFAULT_DURATION_LIMIT_MS: u64 = 10 * 60 * 1000;
pub const MATCH3D_BOARD_CENTER: f32 = 0.5;
pub const MATCH3D_BOARD_RADIUS: f32 = 0.5;
pub const MATCH3D_BOARD_SAFE_MARGIN: f32 = 0.035;

// 中文注释：默认资源池对齐抓大鹅 10*10 物品 Sprite 的 20 种物品上限。
pub(crate) const MATCH3D_BLOCK_VISUAL_KEYS: [&str; MATCH3D_MAX_ITEM_TYPE_COUNT_USIZE] = [
    "block-red-2x4",
    "block-blue-1x2",
    "block-yellow-2x2",
    "block-green-1x4",
    "block-orange-1x6",
    "block-white-1x1",
    "block-black-1x8",
    "block-tan-2x3",
    "block-darkred-2x2",
    "block-blue-1x4",
    "block-pink-2x4",
    "block-gray-1x6",
    "block-lavender-tile-2x2",
    "block-teal-tile-1x3",
    "block-orange-tile-2x2-stud",
    "block-purple-slope-1x2",
    "block-green-cylinder",
    "block-clear-ring",
    "block-mint-arch",
    "block-gold-cone",
];

#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
pub enum Match3DCreationStage {
    CollectingConfig,
    DraftReady,
    ReadyToPublish,
    Published,
}

#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
pub enum Match3DPublicationStatus {
    Draft,
    Published,
}

#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
pub enum Match3DRunStatus {
    Running,
    Won,
    Failed,
    Stopped,
}

#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
pub enum Match3DFailureReason {
    TimeUp,
    TrayFull,
}

#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
pub enum Match3DItemState {
    InBoard,
    InTray,
    Cleared,
}

#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
pub enum Match3DClickRejectReason {
    RunNotActive,
    SnapshotVersionMismatch,
    ItemNotFound,
    ItemNotInBoard,
    ItemNotClickable,
    TrayFull,
}

#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
pub struct Match3DCreatorConfig {
    pub theme_text: String,
    pub reference_image_src: Option<String>,
    pub clear_count: u32,
    pub difficulty: u32,
}

#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
pub struct Match3DResultDraft {
    pub game_name: String,
    pub theme_text: String,
    pub summary: String,
    pub tags: Vec<String>,
    pub cover_image_src: Option<String>,
    pub reference_image_src: Option<String>,
    pub clear_count: u32,
    pub difficulty: u32,
    pub publish_ready: bool,
    pub blockers: Vec<String>,
}

#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
pub struct Match3DWorkProfile {
    pub work_id: String,
    pub profile_id: String,
    pub owner_user_id: String,
    pub source_session_id: Option<String>,
    pub game_name: String,
    pub theme_text: String,
    pub summary: String,
    pub tags: Vec<String>,
    pub cover_image_src: Option<String>,
    pub reference_image_src: Option<String>,
    pub clear_count: u32,
    pub difficulty: u32,
    pub publication_status: Match3DPublicationStatus,
    pub play_count: u32,
    pub updated_at_micros: i64,
    pub published_at_micros: Option<i64>,
}

#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
pub struct Match3DItemSnapshot {
    pub item_instance_id: String,
    pub item_type_id: String,
    pub visual_key: String,
    pub x: f32,
    pub y: f32,
    pub radius: f32,
    pub layer: u32,
    pub state: Match3DItemState,
    pub clickable: bool,
    pub tray_slot_index: Option<u32>,
}

#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
pub struct Match3DTraySlot {
    pub slot_index: u32,
    pub item_instance_id: Option<String>,
    pub item_type_id: Option<String>,
    pub visual_key: Option<String>,
}

#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
pub struct Match3DRunSnapshot {
    pub run_id: String,
    pub profile_id: String,
    pub owner_user_id: String,
    pub status: Match3DRunStatus,
    pub started_at_ms: u64,
    pub duration_limit_ms: u64,
    pub remaining_ms: u64,
    pub clear_count: u32,
    pub total_item_count: u32,
    pub cleared_item_count: u32,
    /// 领域内部权威快照版本；HTTP DTO 对外映射为 snapshotVersion。
    pub board_version: u64,
    pub items: Vec<Match3DItemSnapshot>,
    pub tray_slots: Vec<Match3DTraySlot>,
    pub failure_reason: Option<Match3DFailureReason>,
    pub last_confirmed_action_id: Option<String>,
}

#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
pub struct Match3DClickInput {
    pub run_id: String,
    pub owner_user_id: String,
    pub item_instance_id: String,
    pub client_action_id: String,
    pub snapshot_version: u64,
    pub clicked_at_ms: u64,
}

#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
pub struct Match3DClickConfirmation {
    pub accepted: bool,
    pub reject_reason: Option<Match3DClickRejectReason>,
    pub entered_slot_index: Option<u32>,
    pub cleared_item_instance_ids: Vec<String>,
    pub run: Match3DRunSnapshot,
}

impl Match3DCreationStage {
    pub fn as_str(self) -> &'static str {
        match self {
            Self::CollectingConfig => "collecting_config",
            Self::DraftReady => "draft_ready",
            Self::ReadyToPublish => "ready_to_publish",
            Self::Published => "published",
        }
    }
}

impl Match3DPublicationStatus {
    pub fn as_str(self) -> &'static str {
        match self {
            Self::Draft => "draft",
            Self::Published => "published",
        }
    }
}

impl Match3DRunStatus {
    pub fn as_str(self) -> &'static str {
        match self {
            Self::Running => "running",
            Self::Won => "won",
            Self::Failed => "failed",
            Self::Stopped => "stopped",
        }
    }
}

impl Match3DFailureReason {
    pub fn as_str(self) -> &'static str {
        match self {
            Self::TimeUp => "time_up",
            Self::TrayFull => "tray_full",
        }
    }
}

impl Match3DItemState {
    pub fn as_str(self) -> &'static str {
        match self {
            Self::InBoard => "in_board",
            Self::InTray => "in_tray",
            Self::Cleared => "cleared",
        }
    }
}

impl Match3DClickRejectReason {
    pub fn as_str(self) -> &'static str {
        match self {
            Self::RunNotActive => "run_not_active",
            Self::SnapshotVersionMismatch => "snapshot_version_mismatch",
            Self::ItemNotFound => "item_not_found",
            Self::ItemNotInBoard => "item_not_in_board",
            Self::ItemNotClickable => "item_not_clickable",
            Self::TrayFull => "tray_full",
        }
    }
}