package consts

// JWT audience
const (
	AudUser  = "user"
	AudAdmin = "admin"
)

// 请求上下文变量（中间件 SetCtxVar）
const (
	CtxUserId   = "userId"
	CtxLevelKey = "levelKey"
	CtxAdminId  = "adminId"

	// 管理员审计上下文（AdminPerm 中间件写入，WriteAudit 读取）
	CtxAdminRole    = "adminRole"
	CtxAdminAccount = "adminAccount"
	CtxAdminName    = "adminName"
)

// 管理员角色（admin_users.role_value）
const (
	AdminRoleSuper    = "super"    // 超管：全部权限
	AdminRoleOperator = "operator" // 运营：内容读写，不含管理员管理与审计
	AdminRoleReadonly = "readonly" // 只读：仅可查看
)

// 管理员状态（admin_users.status）
const (
	AdminStatusDisabled = 0
	AdminStatusEnabled  = 1
)

// 审计结果（admin_audit_logs.result）
const (
	AuditResultFail    = 0 // 失败
	AuditResultSuccess = 1 // 成功
)

// 业务错误码（响应 code 字段）
const (
	CodeLocked           = 4001 // 模块未授权（等级锁定）
	CodeQuotaExhausted   = 4002 // 额度用尽（免费/会员/付费额度都已耗尽）
	CodeNoteLimit        = 4003 // 笔记数量超上限（免费版最多 50 条）
	CodeNoteNotFound     = 4004 // 笔记不存在/无权
	CodeEventUnavailable = 4005 // 活动不存在或未发布
	CodeSeatRateLimited  = 4006 // 查座频率超限
	CodeSeatCooling      = 4007 // 查座连续失败冷却中
	CodeImportConflict   = 4008 // 导入存在未处理冲突
	CodeLayoutConflict   = 4009 // 布局版本冲突（CAS 失败）
	CodePayFail          = 4101 // 下单/支付参数异常
)

// 默认等级：会员到期后回落的目标等级
const DefaultLevelKey = "v1"

// 表名
const (
	TableUsers         = "users"
	TableModules       = "modules"
	TableLevels        = "levels"
	TableTools         = "tools"
	TableUsageLogs     = "tool_usage_logs"
	TableWorkbench     = "user_workbench"
	TableAdminUsers    = "admin_users"
	TableAdminAuditLog = "admin_audit_logs"
	TableFeedbacks     = "feedbacks"
	TableMemberPlans   = "member_plans"
	TableMemberOrders  = "member_orders"
	TableQuotaPacks    = "quota_packs"
	TableUserToolQuota = "user_tool_quota"
	TableQuotaUsage    = "user_quota_usage"
	TableSettings      = "settings"
	TableNotes         = "notes"

	// 年会域（T08 建前 6 张；T09/T10 分别追加 event_import_logs / event_seat_queries）
	TableEnterprises       = "enterprises"
	TableEmployees         = "employees"
	TableAnnualEvents      = "annual_events"
	TableEventParticipants = "event_participants"
	TableEventTables       = "event_tables"
	TableEventSeats        = "event_seats"
	TableEventImportLogs   = "event_import_logs"
	TableEventSeatQueries  = "event_seat_queries"
)

// 年会活动状态（annual_events.status，字符串枚举；仅 published 可查座）
const (
	EventStatusDraft     = "draft"
	EventStatusPublished = "published"
	EventStatusEnded     = "ended"
)

// 自动排座模式（/event/admin/seat/auto 的 mode）
const (
	SeatModeFill    = "fill"    // 增量补位：保留手工号，只填未分配员工到空位
	SeatModeReorder = "reorder" // 全部重排：覆盖含手工号在内的编号并清空 is_manual
)

// 桌型（event_tables.table_type，N4）
//
// 0 普通桌 / 1 主桌 / 2 签到台 / 3 媒体席 / 4 备用桌 / 9 其他。
// 类型默认联动（前端 N4-10，后端中立存储；老数据缺列回退 0）：
//
//	签到台/媒体席/备用桌 → capacity=0 + exclude_auto=1
//	普通桌             → capacity=10 + exclude_auto=0
//	主桌               → capacity=10 + exclude_auto=1
const (
	TableTypeNormal  = 0 // 普通桌
	TableTypeMain    = 1 // 主桌
	TableTypeCheckin = 2 // 签到台
	TableTypeMedia   = 3 // 媒体席
	TableTypeSpare   = 4 // 备用桌
	TableTypeOther   = 9 // 其他
)

// 员工导入：行分类（预览 type，见 §8.4）
const (
	ImportTypeNew      = "new"      // 新号码 → 新增
	ImportTypeUpdate   = "update"   // 同手机号 → 视为同一人，更新
	ImportTypeConflict = "conflict" // 同名不同号 → 需人工裁决
	ImportTypeError    = "error"    // 缺手机号/格式非法 → 跳过（计入 skipped）
)

// 员工导入：冲突裁决动作（decisions.action，见 §8.4）
const (
	ImportActionMerge  = "merge"  // 视为同一人·更新手机号
	ImportActionCreate = "create" // 视为另一个人新增
	ImportActionIgnore = "ignore" // 忽略
)

// 导入记录状态（event_import_logs.status，见 §8.4）
const (
	ImportStatusDraft     = "draft"     // 预览中
	ImportStatusCommitted = "committed" // 已入库
	ImportStatusCancelled = "cancelled" // 已取消
)

// 导入行数上限（超出给明确提示；可用 settings 覆盖）
const (
	SettingImportRowLimit = "event_import_row_limit" // settings 键
	// DefaultImportRowLimit 单次导入行数上限兜底值
	DefaultImportRowLimit = 2000
)

// 查座限流/冷却阈值（settings 键 + 缺省值；无 Redis，以 event_seat_queries 时间窗为准）
const (
	SettingSeatRateLimitPerMin     = "event.seat.rateLimitPerMin"     // ≥N 次/分钟 → 4006
	SettingSeatRateLimitPerHour    = "event.seat.rateLimitPerHour"    // ≥N 次/小时 → 4006
	SettingSeatFailCooldownMinutes = "event.seat.failCooldownMinutes" // 冷却时长（分钟）
	SettingSeatFailThreshold       = "event.seat.failThreshold"       // 连续失败达到该值触发冷却

	DefaultSeatRateLimitPerMin     = 5  // PRD-02 §4.2.3 建议值
	DefaultSeatRateLimitPerHour    = 20 // 建议值
	DefaultSeatFailCooldownMinutes = 10 // 建议值
	DefaultSeatFailThreshold       = 5  // 建议值
)

// 查座审计结果枚举（event_seat_queries.result，架构 §3.2.9）
const (
	SeatResultFail    = 0  // 失败（未命中/未分配）
	SeatResultSuccess = 1  // 成功（命中并返回本人桌座）
	SeatResultAll     = -1 // 审计列表筛选用：全部结果（仅用于入参，不落库）
)

// 笔记额度与提醒状态
const (
	// NoteFreeLimit 免费用户活跃笔记数上限（总量上限，非每月重置）
	NoteFreeLimit = 50

	// notes.remind_status 状态枚举
	NoteRemindNone    = 0 // 未设置
	NoteRemindPending = 1 // 待提醒
	NoteRemindSent    = 2 // 已提醒
	NoteRemindFailed  = 3 // 发送失败（含未发送·授权不足 / 模板未配置）
	NoteRemindExpired = 4 // 已过期
)

// 笔记提醒过期设置（settings 表）
const (
	SettingNoteRemindExpireHours = "note_remind_expire_hours" // 待提醒超过该小时数仍未发送则置「已过期」
)

// DefaultNoteRemindExpireHours 提醒过期兜底值：settings 未配置时使用。
const DefaultNoteRemindExpireHours = 24

// 订单类型：同一个下单/发货链路承载「会员」与「次数包」两种商品
const (
	OrderTypeMember = 1 // 会员套餐（延长等级有效期）
	OrderTypeQuota  = 2 // 次数包（增加某工具的付费额度余额）
)

// ============================================================================
// 商业化域：优惠码 / 优惠券（迭代-2026-09-20）
// ============================================================================

// 表名（优惠码 / 券模板 / 用户持有券）
const (
	TablePromoCodes  = "promo_codes"
	TableCoupons     = "coupons"
	TableUserCoupons = "user_coupons"
)

// 业务错误码：优惠凭证域
//
// 编号接续 4001–4009 / 4010–4014 段（架构 §4.5 统一裁定，解决两份 PRD 的冲突）。
const (
	CodePromoInvalid         = 4010 // 优惠码无效/过期/达上限/超单人限用/不适用；或同时传 promo_code 与 user_coupon_id
	CodeCouponUnavailable    = 4011 // 券不可用/已用/过期/作废；免单券并发占用失败
	CodeLevelInvalid         = 4012 // 等级不存在或已停用
	CodePromoRateLimited     = 4013 // 同一用户 1 分钟内优惠码错误次数超限
	CodeProductPriceMismatch = 4014 // 服务端自检：settings 道具价格与 goodsPrice 预期不一致
)

// 业务错误码（续 4015–4018 段）
//
// 4015 属 T01（订单两步式）：订单不存在 / 不属于当前用户 / 状态不允许该操作。
// 4016/4017（T02 头像上传）见紧随其后的独立区块；4018 属 T04（座次自动排座前置条件）。
const (
	CodeOrderInvalid    = 4015 // 订单不存在 / 不属于当前用户 / 状态不允许该操作（已支付、已关闭）
	CodeSeatAutoInvalid = 4018 // 自动排座前置条件不满足（无可参与排座的桌）——fail-closed，message 列出被排除的桌
)

// 头像上传错误码（T02 / N3）
//
// 4017 上传失败**必须给可读中文提示**（如「头像上传失败，请重试」）且**原头像不变、不静默失败**（U1）。
const (
	CodeUploadInvalid = 4016 // 上传校验失败：体积超限（>5MB）/ 格式不支持 —— 前端不发起上传
	CodeUploadFailed  = 4017 // 上传存储失败（服务端写盘 / 目录异常）—— 可读中文提示，原头像不变
)

// 券型（coupons.coupon_type / user_coupons.coupon_type）
//
// 1 免单券（走支付）/ 2 展示券（仅展示）。**新建默认 2**（fail-closed）。
const (
	CouponTypeFreebie = 1
	CouponTypeDisplay = 2
)

// 券面语义 kind（coupons.kind / user_coupons.kind）：1 满减 / 2 免单
const (
	CouponKindCut     = 1
	CouponKindFreebie = 2
)

// 用户券状态（user_coupons.status）
const (
	UserCouponStatusUnused  = 0 // 未使用
	UserCouponStatusUsed    = 1 // 已使用（占用或核销）
	UserCouponStatusExpired = 2 // 已过期
	UserCouponStatusVoid    = 3 // 已作废
)

// 用户券来源（user_coupons.source）
const (
	UserCouponSourceAdmin  = 1 // 后台发放
	UserCouponSourceClaim  = 2 // 活动领取
	UserCouponSourceSystem = 3 // 系统赠送
)

// 用户券占用/核销人（user_coupons.used_by）
const (
	UserCouponUsedBySystem = "system" // 订单占用
	UserCouponUsedByAdmin  = "admin"  // 人工核销
)

// 订单使用凭证类型（member_orders.promo_kind）
const (
	PromoKindNone   = 0 // 未使用凭证
	PromoKindCode   = 1 // 优惠码
	PromoKindCoupon = 2 // 免单券
)

// 适用范围（promo_codes.scope / coupons.scope）：0 全部 / 1 指定会员套餐 / 2 指定次数包
const (
	PromoScopeAll  = 0
	PromoScopePlan = 1
	PromoScopePack = 2
)

// 优惠凭证域 settings 键（后台可配，不硬编码进 config.yaml）
const (
	SettingFreebieProductId     = "pay.freebie.product_id"  // 免单道具 ID
	SettingFreebiePriceCents    = "pay.freebie.price_cents" // 免单道具价格（分）
	SettingPromoFailLimitPerMin = "promo.fail.limitPerMin"  // 同一用户 1 分钟错误上限
	SettingCouponLockTtlSeconds = "coupon.lock.ttlSeconds"  // 免单券占用自动释放时长（秒）
)

// 优惠凭证域 settings 兜底值（settings 未配置时使用）
const (
	DefaultFreebieProductId     = "admin_1"
	DefaultFreebiePriceCents    = 1
	DefaultPromoFailLimitPerMin = 6
	DefaultCouponLockTtlSeconds = 900
)

// 额度来源（扣减时实际命中的池）
const (
	QuotaSourceFree   = "free"   // 免费额度
	QuotaSourceMember = "member" // 会员额度
	QuotaSourcePaid   = "paid"   // 付费额度（次数包）
	QuotaSourceNone   = "none"   // 已耗尽
)

// 额度设置键（settings 表）
const (
	SettingQuotaPeriodDays = "quota_period_days" // 全局默认额度重置周期（天）
)

// DefaultQuotaPeriodDays 额度周期兜底值：settings 与 config 都未配置时使用。
// 后台「额度设置」可改，用户维度与会员套餐维度可各自覆盖。
const DefaultQuotaPeriodDays = 7

// 会员订单状态
const (
	OrderStatusPending   = 0 // 待支付
	OrderStatusDelivered = 1 // 已支付并发货（会员权益已生效）
	OrderStatusRefunded  = 2 // 已退款
	OrderStatusClosed    = 3 // 已关闭（超时未支付）
)

// 虚拟支付环境与支付渠道
const (
	XPayEnvProd     = 0                           // env 固定填 0（现网）
	XPayCurrency    = "CNY"                       // 币种固定 CNY
	XPayMode        = "short_series_goods"        // 道具直购
	PayChannelWx    = "wxpay"                     // 微信虚拟支付（Android 等）
	PayChannelIOS   = "apple"                     // Apple IAP
	XPayNotifyEvent = "xpay_goods_deliver_notify" // 发货推送事件名
)