PROJECT REPORT // FILE_TOWER_DEFENSE

// IInteractable.cs: 인게임 오브젝트(파일/바이러스) 통합 입력 인터페이스
public interface IInteractable
{
    GameObject targetObj { get; }
    Transform transform { get; }
    Sprite TooltipImg { get; }  // 툴팁은 클래스로 만들까 고민
    string ToolTipDes { get; }  
    
    // 선택 상태 관리
    bool IsSelectable { get; }
    bool IsDraggable { get; }
    bool IsTooltipEnabled { get; }
    
    // 이벤트 메서드
    void OnHoverEnter();     // 마우스가 객체 위로 올라올 때 (ToolTip 타이밍 리셋용)
    void OnHoverExit();      // 마우스가 객체에서 벗어날 때 (ToolTip 숨김)
    void OnClickEnter();     // 마우스 버튼을 누를 때
    void OnClickExit();      // 마우스 버튼을 뗄 때
    void OnBeginDrag();
    void OnDrag(Vector2 mouseDelta); 
    void OnEndDrag();
    void OnClick();          // 클릭 처리
    void OnDoubleClick();    // 더블클릭 처리
    void OnRightClick();     // 우클릭 처리
    void OnSelectSingle();

    // 선택 상태 표시
    void OnSelected(bool isSelected);
}

// FileGridManager.cs: 3x3 국소 탐색 루프
private FileGrid FindClosestGridInRange(Vector2 worldPos, int centerX, int centerY)
{
    float minDistSqr = float.MaxValue;
    FileGrid closestGrid = null;

    for (int dx = -1; dx <= 1; dx++)
    {
        for (int dy = -1; dy <= 1; dy++)
        {
            int x = centerX + dx;
            int y = centerY + dy;

            if (IsValidGridIndex(x, y))
            {
                FileGrid grid = gridArray[x, y];
                SearchClosestBetter(grid, worldPos, ref minDistSqr, ref closestGrid);
            }
        }
    }
    return closestGrid;
}

public FileGrid FindFlagGridWorld(Vector2 worldPos, params SearchGridFlag[] flags)
{
    if (gridArray == null || flags == null || flags.Length == 0)
        return null;

    float bestDistSqr = float.MaxValue;
    FileGrid bestGrid = null;

    foreach (FileGrid grid in gridArray)
    {
        if (grid == null) continue;

        // 플래그 조건 체크
        bool isOccupied = grid.GetFileUnit() != null;
        bool hasObstacle = grid.obstacleObject != null;
        bool isMatch = true;

        foreach (SearchGridFlag flag in flags)
        {
            switch (flag)
            {
                case SearchGridFlag.Occupied:
                    if (!isOccupied) isMatch = false;
                    break;
                case SearchGridFlag.NotOccupied:
                    if (isOccupied) isMatch = false;
                    break;
                case SearchGridFlag.Obstacle:
                    if (!hasObstacle) isMatch = false;
                    break;
                case SearchGridFlag.NotObstacle:
                    if (hasObstacle) isMatch = false;
                    break;
                case SearchGridFlag.None:
                    break;
            }

            if (!isMatch) break;
        }

        if (!isMatch) continue;

        SearchClosestBetter(grid, worldPos, ref bestDistSqr, ref bestGrid);
    }

    return bestGrid;
}

// FileGrid.cs: Observer 패턴 기반 핵심 버프 전파 및 수혜 로직
public class FileGrid : MonoBehaviour
{
    private File_Base fileUnit;

    // 해당 그리드에 영향을 미치는 버프 제공자 목록 (중복 제거 O(1))
    private readonly HashSet<File_Base> _activeBuffSources = new HashSet<File_Base>();

    #region Core Buff Logic
    // 버프 유닛(오라) 배치 시 그리드에 소스 등록 및 기존 유닛 버프 전파
    public void AddBuffSource(File_Base source)
    {
        // ...
    }

    // 버프 유닛 이탈/사망 시 소스 제거 및 버프 원복
    public void RemoveBuffSource(File_Base source)
    {
        // ...
    }

    // 단일 버프 소스로부터 대상 유닛에 버프 스탯 부여 또는 해제
    private void ApplyBuffFromSource(File_Base target, File_Base source, bool apply)
    {
        // ...
    }

    // 신규 유닛 진입/이탈 시 그리드에 축적된 모든 버프 일괄 적용/원복
    private void ApplyGridBuffs(bool apply)
    {
        // ...
    }
    #endregion
}

// Buff_Base.cs: 컴포넌트 기반 버프 추상 클래스
public abstract class Buff_Base : MonoBehaviour
{
    // 버프 핵심 데이터
    public Define.BuffType BuffType { get; private set; }
    public float Amount { get; private set; }
    public float Duration { get; private set; }
    public float WaitTickTime { get; private set; }
    public bool IsRemoving { get; private set; }

    // 내부 타이머 및 대상 유닛 참조
    protected float _durationTimer;
    protected float _tickTimer;
    protected File_Base owner;
    protected GameObject myParticle;

    // 생명주기 및 가상/추상 메서드
    public virtual void Init(BuffStat stat) { }
    protected virtual void OnAdded() { }
    protected virtual void OnTick() { }
    public abstract void Remove();
}

// Buff_Base.cs: 중앙 집중식 틱(Tick) 연산 및 지속시간 관리 루프
protected virtual void Update()
{
    if (IsRemoving) return;

    float deltaTime = Time.deltaTime;

    // 1. 틱(Tick) 주기 연산 (단일 코루틴 남발 방지)
    if (WaitTickTime > 0)
    {
        _tickTimer += deltaTime;
        if (_tickTimer >= WaitTickTime)
        {
            _tickTimer -= WaitTickTime;
            OnTick(); // 상속받은 구체 클래스의 고유 로직(힐링/도트 피해 등) 다형적 실행
        }
    }

    // 2. 버프 지속 시간(Duration) 관리
    if (Duration > 0)
    {
        _durationTimer -= deltaTime;
        if (_durationTimer <= 0)
        {
            Remove();
        }
    }
}

protected virtual void OnTick() { }