package com.xcong.excoin.modules.gateApi;

import java.math.BigDecimal;

/**
 * 网格交易单参数，封装单笔条件开仓单及其止盈单的完整状态。
 *
 * <p>每笔挂单对应的参数独立存储为一个 TraderParam 实例，
 * 用于追踪条件开仓单和止盈条件单的挂单状态、价格位置及订单 ID。
 *
 * <h3>关键字段</h3>
 * <ul>
 *   <li><b>方向</b>：多 / 空，决定挂单和止盈的触发方向</li>
 *   <li><b>价格</b>：挂单价（条件开仓触发价）、止盈价（止盈触发价）</li>
 *   <li><b>挂单状态</b>：挂单价是否挂成功、止盈价是否挂成功</li>
 *   <li><b>网格位置</b>：挂单价网格位置、止盈价网格位置（用于定位在价格队列中的索引）</li>
 *   <li><b>订单ID</b>：挂单订单 ID、止盈订单 ID（用于取消和匹配）</li>
 * </ul>
 *
 * <h3>使用示例</h3>
 * <pre>
 *   TraderParam param = TraderParam.builder()
 *       .direction(Direction.LONG)
 *       .entryPrice(new BigDecimal("2293.7"))
 *       .takeProfitPrice(new BigDecimal("2301.6"))
 *       .quantity("1")
 *       .entryGridPosition(3)
 *       .takeProfitGridPosition(4)
 *       .build();
 *
 *   // 挂单成功后更新
 *   param.setEntryOrderPlaced(true);
 *   param.setEntryOrderId("12345");
 *
 *   // 止盈单挂成功后更新
 *   param.setTakeProfitPlaced(true);
 *   param.setTakeProfitOrderId("12346");
 * </pre>
 *
 * @author Administrator
 */
public class TraderParam {

    /**
     * 交易方向。
     * <ul>
     *   <li>{@link #LONG} — 多头</li>
     *   <li>{@link #SHORT} — 空头</li>
     * </ul>
     */
    public enum Direction {
        /** 多头方向 */
        LONG,
        /** 空头方向 */
        SHORT
    }

    /** 交易方向（多 / 空） */
    private Direction direction;
    /** 下单数量（合约张数） */
    private String quantity;
    /** 挂单价在网格队列中的位置（索引，-1 表示未定位） */
    private int entryGridPosition;
    /** 条件开仓触发价 */
    private BigDecimal entryPrice;
    /** 挂单（条件开仓单）订单 ID */
    private String entryOrderId;
    /** 挂单价（条件开仓单）是否挂成功 */
    private boolean entryOrderPlaced;
    /** 止盈价在网格队列中的位置（索引，-1 表示未定位） */
    private int takeProfitGridPosition;
    /** 止盈触发价 */
    private BigDecimal takeProfitPrice;
    /** 止盈条件单订单 ID */
    private String takeProfitOrderId;
    /** 止盈价是否挂成功 */
    private boolean takeProfitPlaced;

    private TraderParam(Builder builder) {
        this.direction = builder.direction;
        this.entryPrice = builder.entryPrice;
        this.takeProfitPrice = builder.takeProfitPrice;
        this.quantity = builder.quantity;
        this.takeProfitPlaced = builder.takeProfitPlaced;
        this.entryOrderPlaced = builder.entryOrderPlaced;
        this.entryGridPosition = builder.entryGridPosition;
        this.takeProfitGridPosition = builder.takeProfitGridPosition;
        this.takeProfitOrderId = builder.takeProfitOrderId;
        this.entryOrderId = builder.entryOrderId;
    }

    // ==================== 交易方向 ====================

    /** @return 交易方向（多 / 空） */
    public Direction getDirection() { return direction; }
    /** 设置交易方向 */
    public void setDirection(Direction direction) { this.direction = direction; }

    // ==================== 条件开仓触发价 ====================

    /** @return 条件开仓触发价 */
    public BigDecimal getEntryPrice() { return entryPrice; }
    /** 设置条件开仓触发价 */
    public void setEntryPrice(BigDecimal entryPrice) { this.entryPrice = entryPrice; }

    // ==================== 止盈触发价 ====================

    /** @return 止盈触发价 */
    public BigDecimal getTakeProfitPrice() { return takeProfitPrice; }
    /** 设置止盈触发价 */
    public void setTakeProfitPrice(BigDecimal takeProfitPrice) { this.takeProfitPrice = takeProfitPrice; }

    // ==================== 下单数量 ====================

    /** @return 下单数量（合约张数） */
    public String getQuantity() { return quantity; }
    /** 设置下单数量 */
    public void setQuantity(String quantity) { this.quantity = quantity; }

    // ==================== 挂单价网格位置 ====================

    /** @return 挂单价在网格队列中的索引位置，-1 表示未定位 */
    public int getEntryGridPosition() { return entryGridPosition; }
    /** 设置挂单价在网格队列中的索引位置 */
    public void setEntryGridPosition(int entryGridPosition) { this.entryGridPosition = entryGridPosition; }

    // ==================== 止盈价网格位置 ====================

    /** @return 止盈价在网格队列中的索引位置，-1 表示未定位 */
    public int getTakeProfitGridPosition() { return takeProfitGridPosition; }
    /** 设置止盈价在网格队列中的索引位置 */
    public void setTakeProfitGridPosition(int takeProfitGridPosition) { this.takeProfitGridPosition = takeProfitGridPosition; }

    // ==================== 止盈价是否挂成功 ====================

    /** @return 止盈条件单是否已挂成功 */
    public boolean isTakeProfitPlaced() { return takeProfitPlaced; }
    /** 标记止盈条件单已挂成功 */
    public void setTakeProfitPlaced(boolean takeProfitPlaced) { this.takeProfitPlaced = takeProfitPlaced; }

    // ==================== 挂单价是否挂成功 ====================

    /** @return 条件开仓单是否已挂成功 */
    public boolean isEntryOrderPlaced() { return entryOrderPlaced; }
    /** 标记条件开仓单已挂成功 */
    public void setEntryOrderPlaced(boolean entryOrderPlaced) { this.entryOrderPlaced = entryOrderPlaced; }

    // ==================== 止盈订单 ID ====================

    /** @return 止盈条件单订单 ID（挂成功后由交易所返回） */
    public String getTakeProfitOrderId() { return takeProfitOrderId; }
    /** 记录止盈条件单订单 ID */
    public void setTakeProfitOrderId(String takeProfitOrderId) { this.takeProfitOrderId = takeProfitOrderId; }

    // ==================== 挂单订单 ID ====================

    /** @return 挂单（条件开仓单）订单 ID（挂成功后由交易所返回） */
    public String getEntryOrderId() { return entryOrderId; }
    /** 记录条件开仓单订单 ID */
    public void setEntryOrderId(String entryOrderId) { this.entryOrderId = entryOrderId; }

    public static Builder builder() {
        return new Builder();
    }

    /**
     * TraderParam 的流式构造器。
     *
     * <h3>必填项</h3>
     * {@code direction}、{@code entryPrice}、{@code takeProfitPrice} 必须设置。
     *
     * <h3>默认值</h3>
     * quantity=1 / entryGridPosition=-1 / takeProfitGridPosition=-1 / 挂单状态均为 false
     */
    public static class Builder {
        /** 交易方向（必填） */
        private Direction direction;
        /** 条件开仓触发价（必填） */
        private BigDecimal entryPrice;
        /** 止盈触发价（必填） */
        private BigDecimal takeProfitPrice;
        /** 下单数量，默认 "1" */
        private String quantity = "1";
        /** 止盈价是否挂成功，默认 false */
        private boolean takeProfitPlaced = false;
        /** 挂单价是否挂成功，默认 false */
        private boolean entryOrderPlaced = false;
        /** 挂单价网格位置，默认 -1（未定位） */
        private int entryGridPosition = -1;
        /** 止盈价网格位置，默认 -1（未定位） */
        private int takeProfitGridPosition = -1;
        /** 止盈订单 ID */
        private String takeProfitOrderId;
        /** 挂单订单 ID */
        private String entryOrderId;

        /** 设置交易方向（多 / 空） */
        public Builder direction(Direction direction) { this.direction = direction; return this; }
        /** 设置条件开仓触发价 */
        public Builder entryPrice(BigDecimal entryPrice) { this.entryPrice = entryPrice; return this; }
        /** 设置止盈触发价 */
        public Builder takeProfitPrice(BigDecimal takeProfitPrice) { this.takeProfitPrice = takeProfitPrice; return this; }
        /** 设置下单数量（合约张数） */
        public Builder quantity(String quantity) { this.quantity = quantity; return this; }
        /** 设置止盈价是否已挂成功 */
        public Builder takeProfitPlaced(boolean takeProfitPlaced) { this.takeProfitPlaced = takeProfitPlaced; return this; }
        /** 设置挂单价是否已挂成功 */
        public Builder entryOrderPlaced(boolean entryOrderPlaced) { this.entryOrderPlaced = entryOrderPlaced; return this; }
        /** 设置挂单价在网格队列中的索引位置 */
        public Builder entryGridPosition(int entryGridPosition) { this.entryGridPosition = entryGridPosition; return this; }
        /** 设置止盈价在网格队列中的索引位置 */
        public Builder takeProfitGridPosition(int takeProfitGridPosition) { this.takeProfitGridPosition = takeProfitGridPosition; return this; }
        /** 设置止盈条件单订单 ID */
        public Builder takeProfitOrderId(String takeProfitOrderId) { this.takeProfitOrderId = takeProfitOrderId; return this; }
        /** 设置挂单（条件开仓单）订单 ID */
        public Builder entryOrderId(String entryOrderId) { this.entryOrderId = entryOrderId; return this; }

        public TraderParam build() {
            return new TraderParam(this);
        }
    }
}