package jnpf.bizcommon.onlyoffice.entity;

import lombok.Data;

import java.util.List;

/**
 * OnlyOffice 保存回调的请求体。
 *
 * <p>字段是 OnlyOffice 定死的一套，**config 里的自定义字段不会回传**——所以业务上下文
 * （bizModule/bizDataId）只能在签发 config 时落库，回调时靠 {@link #key} 反查会话表。
 *
 * <p>同理不要把业务参数拼在 callbackUrl 的 query 上：DS 会存下每个会话的 callbackUrl
 * 并挑其中一份回调（status 2 用最后改动者的），拼在 URL 上的参数会取到不确定的那份。
 */
@Data
public class OnlyOfficeCallbackParam {

    /** 文档版本标识，与 onlyoffice_session.doc_key 对应。必返字段，是唯一可靠的关联锚点 */
    private String key;

    /**
     * 文档状态：
     * 1 编辑中 / 2 准备保存 / 3 保存出错 / 4 无改动关闭 / 6 强制保存 / 7 强制保存出错
     */
    private Integer status;

    /** 编辑后文档的下载地址，status 为 2/3/6/7 时才有 */
    private String url;

    /** 下载文件的扩展名 */
    private String filetype;

    /** 参与编辑的用户 id；status 2/6 时返回的是最后改动者，不是全部参与者 */
    private List<String> users;

    /** 强制保存的触发类型，status 6/7 时才有 */
    private Integer forcesavetype;

    /** 用户动作列表，元素形如 {"type":0|1|2,"userid":"xxx"} */
    private List<Object> actions;

    /** DS 侧签发的 JWT。多数部署经 Authorization 头传递，此处兼容放在 body 的形态 */
    private String token;

    /** 文档状态取值 */
    public static final class Status {
        public static final int EDITING = 1;
        public static final int READY_FOR_SAVING = 2;
        public static final int SAVE_ERROR = 3;
        public static final int CLOSED_NO_CHANGES = 4;
        public static final int FORCE_SAVING = 6;
        public static final int FORCE_SAVE_ERROR = 7;

        private Status() {
        }
    }
}