package com.xcong.excoin.modules.gateApi;

import java.math.BigDecimal;

/**
 * 单笔挂单的完整参数，封装条件开仓单及止盈单的状态。
 *
 * <h3>定位</h3>
 * 每个 GridElement 内嵌两个 TraderParam（longTraderParam / shortTraderParam），
 * 分别记录该价格层级上多仓和空仓的挂单参数。所有字段通过 getter/setter
 * 在挂单/成交/止盈各阶段逐步填充。
 *
 * <h3>字段分组</h3>
 * <table>
 *   <tr><th>类别</th><th>字段</th><th>生命周期</th></tr>
 *   <tr><td>开仓准备</td><td>direction, entryPrice, quantity</td><td>updateGridElements() 预填充</td></tr>
 *   <tr><td>止盈预定</td><td>takeProfitPrice</td><td>updateGridElements() 预填充（entryPrice ± (step - minTick)）</td></tr>
 *   <tr><td>挂单确认</td><td>entryOrderPlaced, entryOrderId</td><td>条件单挂成功后由 longEntryTraderIdParam 等写入</td></tr>
 *   <tr><td>止盈确认</td><td>takeProfitPlaced, takeProfitOrderId</td><td>止盈单挂成功后由 longTakeProfitTraderIdParam 等写入</td></tr>
 *   <tr><td>定位</td><td>entryGridPosition, takeProfitGridPosition</td><td>当前策略中由 upId/downId 替代</td></tr>
 * </table>
 *
 * <h3>盈利公式（正向合约）</h3>
 * <pre>
 *   多仓止盈盈利 = takeProfitPrice - entryPrice = (entryPrice + step - minTick) - entryPrice = step - minTick
 *   空仓止盈盈利 = entryPrice - takeProfitPrice = entryPrice - (entryPrice - step + minTick) = step - minTick
 * </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);
        }
    }
}