package com.battery.device.api;

/** 将已保存的实际工步类型解释为充电、放电、静置或未知，不依据测量值猜测。 */
public interface StepDirectionResolver
{
    enum Direction
    {
        CHARGE("充电"), DISCHARGE("放电"), REST("搁置"), UNKNOWN(null);

        private final String displayName;

        Direction(String displayName) { this.displayName = displayName; }

        /**
         * 界面上显示的方向名称，用甲方「实时」页那一列的同一个词；工步名称填的就是它（ADR-0067 §4b）。
         * 方向未确认时为空：调用方不得用默认名把未知说成已知。
         */
        public String displayName() { return displayName; }
    }

    /** 返回有明确协议依据的方向；未定义或混合类型保持未知。 */
    Direction resolve(String stepType);
}