huimv-employment/doc/灵活用工.sql

-- =============================================================================
-- 灵活用工与用工税筹模块 - 数据库表结构设计
-- =============================================================================
-- 依据材料：
--   - wechat-mini-program-flexible-employment-plan.md
--   - flexible-employment-demo.html（前端原型）
--   - 会议摘要 / 灵活用开发工会议.md
-- 技术栈：PostgreSQL（FastAPI + LangGraph 后端）
-- 设计原则：
--   1. 草稿优先：AI 生成草稿 -> 用户确认 -> 后端办理
--   2. 合规状态机：实名/合同/结算/完税/开票全流程可追踪
--   3. 敏感字段加密存储，业务库仅存密文与脱敏值
--   4. MVP 聚焦对话-草稿-成本对比-登记-结算闭环；考勤/正式第三方联调可二期启用
-- =============================================================================
-- 表命名：fe_ = flexible employment（灵活用工）
-- 公共字段约定：
--   create_time / update_time : 记录时间戳，应用层维护 update_time
--   del_flag                  : 0=正常 1=逻辑删除（带此字段的表软删后释放部分唯一索引）
-- 敏感字段约定：
--   *_enc  : 加密密文，应用层加解密，数据库禁止存明文
--   *_mask : 脱敏展示值，供列表、消息、操作日志使用
-- 业务流程主线：
--   对话(fe_conversation) -> 草稿(fe_employment_draft) -> 成本快照(fe_draft_cost_snapshot)
--   -> 用户确认(fe_user_confirmation) -> 订单(fe_employment_order) -> 登记批次(fe_registration_batch)
--   -> 登记(fe_worker_registration) -> 合同(fe_contract) -> 结算(fe_settlement_order) -> 支付(fe_payment_record)

-- 建议启用扩展（UUID 主键、向量检索等）
-- CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
-- CREATE EXTENSION IF NOT EXISTS "pgcrypto";
-- CREATE EXTENSION IF NOT EXISTS "vector";

-- -----------------------------------------------------------------------------
-- 一、身份与企业画像中心
-- 职责：微信小程序登录鉴权、企业主/临时工身份分离、企业认证与扩展画像。
-- 关联 API：POST /api/v1/agent/messages 中的 enterprise_id；企业主登录与企业绑定。
-- 说明：AI 生成草稿时优先从 fe_enterprise.registered_address、fe_enterprise_preference 推断默认值。
-- -----------------------------------------------------------------------------

-- 微信用户（企业主 / 临时工共用，通过 user_type 区分）
CREATE TABLE fe_user (
    id              BIGSERIAL       PRIMARY KEY,
    openid          VARCHAR(64)     NOT NULL,
    unionid         VARCHAR(64),
    user_type       VARCHAR(20)     NOT NULL DEFAULT 'enterprise',  -- enterprise / worker
    nickname        VARCHAR(64),
    avatar_url      VARCHAR(512),
    mobile_enc      TEXT,                                           -- 手机号密文
    mobile_mask     VARCHAR(20),                                    -- 138****1234
    session_key     VARCHAR(128),                                   -- 微信 session，定期刷新
    status          VARCHAR(20)     NOT NULL DEFAULT 'active',      -- active / disabled
    last_login_at   TIMESTAMPTZ,
    create_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    del_flag        SMALLINT        NOT NULL DEFAULT 0              -- 0正常 1删除
);
CREATE UNIQUE INDEX uk_fe_user_openid ON fe_user (openid) WHERE del_flag = 0;
CREATE INDEX idx_fe_user_type ON fe_user (user_type, status);


-- 企业主体
CREATE TABLE fe_enterprise (
    id                  BIGSERIAL       PRIMARY KEY,
    enterprise_code     VARCHAR(32)     NOT NULL,                   -- 业务编码 ent_001
    name                VARCHAR(200)    NOT NULL,
    credit_code         VARCHAR(32),                                 -- 统一社会信用代码
    legal_person        VARCHAR(64),
    registered_address  VARCHAR(500),
    contact_name        VARCHAR(64),
    contact_mobile_mask VARCHAR(20),
    industry            VARCHAR(100),
    scale               VARCHAR(50),                                  -- 企业规模
    auth_status         VARCHAR(20)     NOT NULL DEFAULT 'pending',   -- pending / verified / rejected
    auth_time           TIMESTAMPTZ,
    profile_json        JSONB           DEFAULT '{}',               -- 扩展画像（行业标签、历史偏好摘要等）
    create_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    del_flag            SMALLINT        NOT NULL DEFAULT 0
);
CREATE UNIQUE INDEX uk_fe_enterprise_code ON fe_enterprise (enterprise_code) WHERE del_flag = 0;
CREATE INDEX idx_fe_enterprise_credit ON fe_enterprise (credit_code);


-- 企业-用户绑定（一个企业可有多个管理员）
CREATE TABLE fe_enterprise_user (
    id              BIGSERIAL       PRIMARY KEY,
    enterprise_id   BIGINT          NOT NULL REFERENCES fe_enterprise(id),
    user_id         BIGINT          NOT NULL REFERENCES fe_user(id),
    role            VARCHAR(20)     NOT NULL DEFAULT 'owner',        -- owner / admin / viewer
    is_default      BOOLEAN         NOT NULL DEFAULT FALSE,          -- 默认选中企业
    bind_time       TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    create_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    del_flag        SMALLINT        NOT NULL DEFAULT 0
);
CREATE UNIQUE INDEX uk_fe_enterprise_user ON fe_enterprise_user (enterprise_id, user_id) WHERE del_flag = 0;
CREATE INDEX idx_fe_enterprise_user_uid ON fe_enterprise_user (user_id);


-- 企业财务与开票信息（敏感，小程序端不直接展示明细）
CREATE TABLE fe_enterprise_finance (
    id                  BIGSERIAL       PRIMARY KEY,
    enterprise_id       BIGINT          NOT NULL REFERENCES fe_enterprise(id),
    bank_name           VARCHAR(100),
    bank_account_enc    TEXT,                                       -- 对公账户密文
    bank_account_mask   VARCHAR(32),
    invoice_title       VARCHAR(200),                               -- 开票抬头
    tax_no              VARCHAR(32),                                -- 税号
    payment_channel     VARCHAR(50),                                -- wechat / alipay / bank（仅渠道类型）
    balance_amount      NUMERIC(14,2)   DEFAULT 0,
    create_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    del_flag            SMALLINT        NOT NULL DEFAULT 0
);
CREATE UNIQUE INDEX uk_fe_enterprise_finance ON fe_enterprise_finance (enterprise_id) WHERE del_flag = 0;


-- 企业智能偏好（工种薪资基准、默认保险、发薪周期等）
CREATE TABLE fe_enterprise_preference (
    id              BIGSERIAL       PRIMARY KEY,
    enterprise_id   BIGINT          NOT NULL REFERENCES fe_enterprise(id),
    pref_type       VARCHAR(50)     NOT NULL,                       -- work_type / insurance / payment_cycle
    pref_key        VARCHAR(100),
    pref_value      JSONB           NOT NULL DEFAULT '{}',
    source          VARCHAR(50)     DEFAULT 'user_config',          -- user_config / ai_inferred / default
    raw_text        TEXT,                                           -- 用户自然语言配置原文
    confirmed       BOOLEAN         NOT NULL DEFAULT FALSE,
    create_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    del_flag        SMALLINT        NOT NULL DEFAULT 0
);
CREATE INDEX idx_fe_enterprise_pref ON fe_enterprise_preference (enterprise_id, pref_type);


-- -----------------------------------------------------------------------------
-- 二、对话与智能体编排
-- 职责：存储企业主与主智能体的对话；消息可携带草稿卡、成本卡等结构化卡片。
-- 说明：小程序不直连大模型，所有对话经业务后端写入本模块；fe_agent_action_log 记录子模块调用链。
-- -----------------------------------------------------------------------------

CREATE TABLE fe_conversation (
    id              BIGSERIAL       PRIMARY KEY,
    conversation_no VARCHAR(32)     NOT NULL,                       -- conv_001
    enterprise_id   BIGINT          NOT NULL REFERENCES fe_enterprise(id),
    user_id         BIGINT          NOT NULL REFERENCES fe_user(id),
    title           VARCHAR(200),
    chat_type       VARCHAR(30)     NOT NULL DEFAULT 'employment',  -- employment/knowledge/order/cost/attendance/emergency
    status          VARCHAR(20)     NOT NULL DEFAULT 'active',        -- active / archived
    last_message_at TIMESTAMPTZ,
    create_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    del_flag        SMALLINT        NOT NULL DEFAULT 0
);
CREATE UNIQUE INDEX uk_fe_conversation_no ON fe_conversation (conversation_no);
CREATE INDEX idx_fe_conversation_ent ON fe_conversation (enterprise_id, last_message_at DESC);


CREATE TABLE fe_conversation_message (
    id                  BIGSERIAL       PRIMARY KEY,
    conversation_id     BIGINT          NOT NULL REFERENCES fe_conversation(id),
    role                VARCHAR(20)     NOT NULL,                   -- user / assistant / system
    content             TEXT            NOT NULL,
    content_type        VARCHAR(30)     NOT NULL DEFAULT 'text',    -- text / card_draft / card_cost / card_order
    card_payload        JSONB,                                      -- 卡片结构化数据
    agent_module        VARCHAR(50),                                -- flexible_employment 等
    next_action         VARCHAR(50),                                -- show_employment_draft 等
    related_draft_id    BIGINT,
    token_usage         JSONB,
    create_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW()
);
CREATE INDEX idx_fe_conv_msg ON fe_conversation_message (conversation_id, create_time);


-- 智能体/子模块调用记录（审计、排障）
CREATE TABLE fe_agent_action_log (
    id              BIGSERIAL       PRIMARY KEY,
    conversation_id BIGINT          REFERENCES fe_conversation(id),
    enterprise_id   BIGINT          NOT NULL REFERENCES fe_enterprise(id),
    module_name     VARCHAR(50)     NOT NULL,                       -- main_agent / flexible_employment / cost_engine
    action          VARCHAR(100)    NOT NULL,
    request_json    JSONB,
    response_json   JSONB,
    status          VARCHAR(20)     NOT NULL DEFAULT 'success',
    error_message   TEXT,
    duration_ms     INTEGER,
    create_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW()
);
CREATE INDEX idx_fe_agent_log ON fe_agent_action_log (enterprise_id, create_time DESC);


-- -----------------------------------------------------------------------------
-- 三、方案目录与规则引擎
-- 职责：成本对比三方案配置、费率规则、合规状态机定义、政策法规规则库。
-- 说明：成本测算引擎读取 fe_service_plan + fe_service_plan_fee_rule；test_only 方案仅供 Demo。
-- -----------------------------------------------------------------------------

-- 用工方案目录（成本对比三方案 + 当前方式）
CREATE TABLE fe_service_plan (
    id                  BIGSERIAL       PRIMARY KEY,
    plan_code           VARCHAR(32)     NOT NULL,                   -- current / plan_1 / plan_2 / plan_3
    plan_name           VARCHAR(100)    NOT NULL,
    plan_type           VARCHAR(30)     NOT NULL DEFAULT 'flexible',  -- flexible / traditional / hybrid
    description         TEXT,
    service_fee_rate    NUMERIC(8,4),                               -- 服务费率，如 0.08
    insurance_level     VARCHAR(30),                                -- basic / standard / premium
    tax_mode            VARCHAR(50),                                -- 税费代征模式
    applicable_scenarios JSONB         DEFAULT '[]',                -- 适用场景列表
    compliance_tags     JSONB         DEFAULT '[]',                 -- ["业务真实","资金合规","个税申报"]
    sort_order          INTEGER         NOT NULL DEFAULT 0,
    status              VARCHAR(20)     NOT NULL DEFAULT 'active',  -- active / test_only / disabled
    effective_from      DATE,
    effective_to        DATE,
    create_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    del_flag            SMALLINT        NOT NULL DEFAULT 0
);
CREATE UNIQUE INDEX uk_fe_service_plan_code ON fe_service_plan (plan_code) WHERE del_flag = 0;


-- 方案费用项规则
CREATE TABLE fe_service_plan_fee_rule (
    id              BIGSERIAL       PRIMARY KEY,
    plan_id         BIGINT          NOT NULL REFERENCES fe_service_plan(id),
    fee_code        VARCHAR(50)     NOT NULL,                       -- labor_fee / service_fee / insurance / tax_withhold
    fee_name        VARCHAR(100)    NOT NULL,
    calc_type       VARCHAR(30)     NOT NULL,                       -- fixed / rate / formula
    calc_expression TEXT,                                           -- 计算公式或规则描述
    default_rate    NUMERIC(8,4),
    sort_order      INTEGER         NOT NULL DEFAULT 0,
    create_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW()
);
CREATE INDEX idx_fe_plan_fee ON fe_service_plan_fee_rule (plan_id);


-- 合规流程定义（五流合一状态机）
CREATE TABLE fe_workflow_definition (
    id              BIGSERIAL       PRIMARY KEY,
    workflow_code   VARCHAR(50)     NOT NULL,                       -- employment_compliance
    workflow_name   VARCHAR(100)    NOT NULL,
    description     TEXT,
    version         INTEGER         NOT NULL DEFAULT 1,
    is_active       BOOLEAN         NOT NULL DEFAULT TRUE,
    create_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW()
);
CREATE UNIQUE INDEX uk_fe_workflow_def ON fe_workflow_definition (workflow_code, version);

CREATE TABLE fe_workflow_step (
    id              BIGSERIAL       PRIMARY KEY,
    workflow_id     BIGINT          NOT NULL REFERENCES fe_workflow_definition(id),
    step_code       VARCHAR(50)     NOT NULL,                       -- draft_created / plan_confirmed / registration ...
    step_name       VARCHAR(100)    NOT NULL,
    step_order      INTEGER         NOT NULL,
    required        BOOLEAN         NOT NULL DEFAULT TRUE,
    auto_advance    BOOLEAN         NOT NULL DEFAULT FALSE,
    create_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW()
);
CREATE UNIQUE INDEX uk_fe_workflow_step ON fe_workflow_step (workflow_id, step_code);


-- 政策规则库（供规则引擎 / RAG 引用）
CREATE TABLE fe_policy_rule (
    id              BIGSERIAL       PRIMARY KEY,
    rule_code       VARCHAR(50)     NOT NULL,
    rule_category   VARCHAR(50)     NOT NULL,                       -- tax / labor / insurance / invoice
    title           VARCHAR(200)    NOT NULL,
    content         TEXT            NOT NULL,
    effective_from  DATE,
    effective_to    DATE,
    priority        INTEGER         NOT NULL DEFAULT 0,
    status          VARCHAR(20)     NOT NULL DEFAULT 'active',
    create_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW()
);
CREATE UNIQUE INDEX uk_fe_policy_rule ON fe_policy_rule (rule_code);


-- -----------------------------------------------------------------------------
-- 四、草稿中心
-- 职责：AI 生成用工草稿、字段来源追踪、成本对比快照；体现「草稿优先」核心体验。
-- 关联 API：GET /drafts/{id}、GET /drafts/{id}/cost-comparison、POST /drafts/{id}/confirm
-- -----------------------------------------------------------------------------

CREATE TABLE fe_employment_draft (
    id                  BIGSERIAL       PRIMARY KEY,
    draft_no            VARCHAR(32)     NOT NULL,                   -- draft_001
    enterprise_id       BIGINT          NOT NULL REFERENCES fe_enterprise(id),
    conversation_id     BIGINT          REFERENCES fe_conversation(id),
    scenario            VARCHAR(50)     NOT NULL,                   -- existing_worker_regularization / new_demand
    title               VARCHAR(200),                               -- 浦东仓库搬运
    status              VARCHAR(20)     NOT NULL DEFAULT 'pending',   -- pending / confirmed / cancelled / expired
    worker_count        INTEGER,
    work_days           INTEGER,
    work_type           VARCHAR(100),                                 -- 搬运工
    work_content        TEXT,                                       -- 主要工作内容
    work_location       VARCHAR(500),
    work_location_source VARCHAR(50),                               -- enterprise_registered_address / user_input / ai_inferred
    settlement_mode     VARCHAR(50),                                -- daily / piece / monthly
    daily_wage          NUMERIC(12,2),
    insurance_required  BOOLEAN         NOT NULL DEFAULT TRUE,
    insurance_level     VARCHAR(30),
    check_in_required   BOOLEAN         NOT NULL DEFAULT FALSE,
    qr_valid_days       INTEGER         DEFAULT 7,
    work_start_date     DATE,
    work_end_date       DATE,
    job_requirements    TEXT,                                       -- 岗位要求（年龄、经验等）
    missing_fields      JSONB           DEFAULT '[]',               -- 待补充字段列表
    risk_prompts        JSONB           DEFAULT '[]',               -- 风险提示
    estimated_total     NUMERIC(14,2),                              -- 预估总支出
    estimated_per_capita NUMERIC(12,2),                             -- 预估人均成本
    selected_plan_id    BIGINT          REFERENCES fe_service_plan(id),
    confirmed_at        TIMESTAMPTZ,
    confirmed_by        BIGINT          REFERENCES fe_user(id),
    create_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    del_flag            SMALLINT        NOT NULL DEFAULT 0
);
CREATE UNIQUE INDEX uk_fe_draft_no ON fe_employment_draft (draft_no);
CREATE INDEX idx_fe_draft_ent ON fe_employment_draft (enterprise_id, status, create_time DESC);


-- 草稿字段明细（带来源与可编辑标记，支持「默认生成」展示）
CREATE TABLE fe_draft_field (
    id              BIGSERIAL       PRIMARY KEY,
    draft_id        BIGINT          NOT NULL REFERENCES fe_employment_draft(id),
    field_key       VARCHAR(100)    NOT NULL,
    field_label     VARCHAR(100),
    field_value     TEXT,
    value_json      JSONB,
    source          VARCHAR(50)     NOT NULL DEFAULT 'ai_inferred',   -- enterprise_profile / history_preference / default / user_input / ai_inferred
    editable        BOOLEAN         NOT NULL DEFAULT TRUE,
    is_default      BOOLEAN         NOT NULL DEFAULT FALSE,
    create_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW()
);
CREATE UNIQUE INDEX uk_fe_draft_field ON fe_draft_field (draft_id, field_key);


-- 草稿成本对比快照
CREATE TABLE fe_draft_cost_snapshot (
    id                          BIGSERIAL       PRIMARY KEY,
    draft_id                    BIGINT          NOT NULL REFERENCES fe_employment_draft(id),
    plan_id                     BIGINT          REFERENCES fe_service_plan(id),
    plan_code                   VARCHAR(32)     NOT NULL,
    plan_name                   VARCHAR(100)    NOT NULL,
    employer_total_outflow      NUMERIC(14,2)   NOT NULL,           -- 企业总支出
    employer_avg_cost_per_worker NUMERIC(12,2)  NOT NULL,           -- 平均每人成本
    worker_take_home_per_worker NUMERIC(12,2),                      -- 员工到手
    is_recommended              BOOLEAN         NOT NULL DEFAULT FALSE,
    status_tag                  VARCHAR(30),                        -- test_only
    compliance_tags             JSONB           DEFAULT '[]',
    notice                      TEXT,
    calc_version                VARCHAR(20),
    create_time                 TIMESTAMPTZ     NOT NULL DEFAULT NOW()
);
CREATE INDEX idx_fe_cost_snapshot ON fe_draft_cost_snapshot (draft_id);


-- 成本明细项（劳务费、服务费、保险、税费代征等）
CREATE TABLE fe_draft_cost_detail (
    id              BIGSERIAL       PRIMARY KEY,
    snapshot_id     BIGINT          NOT NULL REFERENCES fe_draft_cost_snapshot(id),
    fee_code        VARCHAR(50)     NOT NULL,
    fee_name        VARCHAR(100)    NOT NULL,
    amount          NUMERIC(14,2)   NOT NULL,
    rate            NUMERIC(8,4),
    sort_order      INTEGER         NOT NULL DEFAULT 0
);
CREATE INDEX idx_fe_cost_detail ON fe_draft_cost_detail (snapshot_id);


-- -----------------------------------------------------------------------------
-- 五、订单与登记中心
-- 职责：草稿确认后生成正式订单与扫码登记批次；驱动合规状态机推进。
-- 说明：fe_registration_batch.qr_token 需校验有效期；进度页统计来自批次计数字段。
-- -----------------------------------------------------------------------------

CREATE TABLE fe_employment_order (
    id                  BIGSERIAL       PRIMARY KEY,
    order_no            VARCHAR(32)     NOT NULL,                   -- 2024-001
    enterprise_id       BIGINT          NOT NULL REFERENCES fe_enterprise(id),
    draft_id            BIGINT          REFERENCES fe_employment_draft(id),
    selected_plan_id    BIGINT          REFERENCES fe_service_plan(id),
    title               VARCHAR(200)    NOT NULL,
    worker_count        INTEGER         NOT NULL,
    work_days           INTEGER,
    work_type           VARCHAR(100),
    work_location       VARCHAR(500),
    work_start_date     DATE,
    work_end_date       DATE,
    order_status        VARCHAR(30)     NOT NULL DEFAULT 'confirmed', -- 见 workflow_step
    current_step_code   VARCHAR(50)     NOT NULL DEFAULT 'plan_confirmed',
    registered_count    INTEGER         NOT NULL DEFAULT 0,
    pending_count       INTEGER         NOT NULL DEFAULT 0,
    abnormal_count      INTEGER         NOT NULL DEFAULT 0,
    total_outflow       NUMERIC(14,2),
    create_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    del_flag            SMALLINT        NOT NULL DEFAULT 0
);
CREATE UNIQUE INDEX uk_fe_order_no ON fe_employment_order (order_no);
CREATE INDEX idx_fe_order_ent ON fe_employment_order (enterprise_id, order_status, create_time DESC);


-- 登记批次（含二维码/链接）
CREATE TABLE fe_registration_batch (
    id                  BIGSERIAL       PRIMARY KEY,
    batch_no            VARCHAR(32)     NOT NULL,                   -- BATCH-001
    order_id            BIGINT          NOT NULL REFERENCES fe_employment_order(id),
    enterprise_id       BIGINT          NOT NULL REFERENCES fe_enterprise(id),
    expected_count      INTEGER         NOT NULL,
    registered_count    INTEGER         NOT NULL DEFAULT 0,
    pending_count       INTEGER         NOT NULL DEFAULT 0,
    in_progress_count   INTEGER         NOT NULL DEFAULT 0,
    completed_count     INTEGER         NOT NULL DEFAULT 0,
    abnormal_count      INTEGER         NOT NULL DEFAULT 0,
    registration_url    VARCHAR(512),
    qr_code_url         VARCHAR(512),
    qr_token            VARCHAR(64),                                -- 扫码登记 token
    valid_from          TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    valid_until         TIMESTAMPTZ     NOT NULL,
    status              VARCHAR(20)     NOT NULL DEFAULT 'active',  -- active / expired / closed
    create_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    del_flag            SMALLINT        NOT NULL DEFAULT 0
);
CREATE UNIQUE INDEX uk_fe_batch_no ON fe_registration_batch (batch_no);
CREATE UNIQUE INDEX uk_fe_batch_token ON fe_registration_batch (qr_token) WHERE qr_token IS NOT NULL;
CREATE INDEX idx_fe_batch_order ON fe_registration_batch (order_id);


-- 订单流程状态变更日志（合规状态机留痕）
CREATE TABLE fe_order_workflow_log (
    id              BIGSERIAL       PRIMARY KEY,
    order_id        BIGINT          NOT NULL REFERENCES fe_employment_order(id),
    from_step       VARCHAR(50),
    to_step         VARCHAR(50)     NOT NULL,
    from_status     VARCHAR(30),
    to_status       VARCHAR(30)     NOT NULL,
    operator_id     BIGINT          REFERENCES fe_user(id),
    operator_type   VARCHAR(20)     NOT NULL DEFAULT 'system',      -- system / enterprise / worker / provider
    remark          TEXT,
    extra_json      JSONB,
    create_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW()
);
CREATE INDEX idx_fe_order_wf_log ON fe_order_workflow_log (order_id, create_time);


-- -----------------------------------------------------------------------------
-- 六、人员管理（临时工）
-- 职责：临时工档案、批次登记、协议授权；支撑扫码登记页与进度页人员列表。
-- 关联 API：POST /worker-registration/{batch_id}/submit
-- 安全：身份证、银行卡、手机号必须加密（*_enc），前端禁止缓存明文。
-- -----------------------------------------------------------------------------

CREATE TABLE fe_worker (
    id                  BIGSERIAL       PRIMARY KEY,
    user_id             BIGINT          REFERENCES fe_user(id),
    worker_no           VARCHAR(32),
    real_name           VARCHAR(64)     NOT NULL,
    id_card_no_enc      TEXT            NOT NULL,                   -- 身份证号密文
    id_card_no_mask     VARCHAR(32),                                  -- 310***********1234
    mobile_enc          TEXT            NOT NULL,
    mobile_mask         VARCHAR(20),
    bank_account_enc    TEXT,
    bank_account_mask   VARCHAR(32),
    bank_name           VARCHAR(100),
    bank_branch         VARCHAR(200),
    verify_status       VARCHAR(20)     NOT NULL DEFAULT 'pending',   -- pending / passed / failed
    verify_message      TEXT,
    create_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    del_flag            SMALLINT        NOT NULL DEFAULT 0
);
CREATE INDEX idx_fe_worker_user ON fe_worker (user_id);
CREATE INDEX idx_fe_worker_mobile ON fe_worker (mobile_mask);


-- 批次登记记录
CREATE TABLE fe_worker_registration (
    id                  BIGSERIAL       PRIMARY KEY,
    batch_id            BIGINT          NOT NULL REFERENCES fe_registration_batch(id),
    order_id            BIGINT          NOT NULL REFERENCES fe_employment_order(id),
    enterprise_id       BIGINT          NOT NULL REFERENCES fe_enterprise(id),
    worker_id           BIGINT          REFERENCES fe_worker(id),
    real_name           VARCHAR(64)     NOT NULL,
    mobile_enc          TEXT,
    mobile_mask         VARCHAR(20),
    id_card_no_enc      TEXT,
    bank_account_enc    TEXT,
    confirmed_work_type VARCHAR(100),                               -- 工种或任务确认
    reg_status          VARCHAR(20)     NOT NULL DEFAULT 'pending', -- pending/registering/completed/verify_failed/under_review
    fail_reason         TEXT,
    submitted_at        TIMESTAMPTZ,
    reviewed_at         TIMESTAMPTZ,
    reviewed_by         BIGINT          REFERENCES fe_user(id),
    remind_count        INTEGER         NOT NULL DEFAULT 0,
    last_remind_at      TIMESTAMPTZ,
    create_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    del_flag            SMALLINT        NOT NULL DEFAULT 0
);
CREATE INDEX idx_fe_worker_reg_batch ON fe_worker_registration (batch_id, reg_status);
CREATE INDEX idx_fe_worker_reg_order ON fe_worker_registration (order_id);


-- 协议/授权确认（电子合同、隐私政策等）
CREATE TABLE fe_worker_consent (
    id              BIGSERIAL       PRIMARY KEY,
    registration_id BIGINT          NOT NULL REFERENCES fe_worker_registration(id),
    worker_id       BIGINT          REFERENCES fe_worker(id),
    consent_type    VARCHAR(50)     NOT NULL,                       -- labor_contract / privacy_policy / authorization
    consent_version VARCHAR(20),
    consent_title   VARCHAR(200),
    agreed          BOOLEAN         NOT NULL DEFAULT FALSE,
    agreed_at       TIMESTAMPTZ,
    client_ip       VARCHAR(64),
    user_agent      VARCHAR(500),
    create_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW()
);
CREATE INDEX idx_fe_worker_consent ON fe_worker_consent (registration_id);


-- -----------------------------------------------------------------------------
-- 七、合同管理（MVP 可 Mock，流程节点需预留）
-- 职责：电子劳动合同签署，合规流程「合同签署」节点；对接电子签平台前可用 mock  provider。
-- -----------------------------------------------------------------------------

CREATE TABLE fe_contract (
    id              BIGSERIAL       PRIMARY KEY,
    contract_no     VARCHAR(32)     NOT NULL,
    order_id        BIGINT          NOT NULL REFERENCES fe_employment_order(id),
    registration_id BIGINT          REFERENCES fe_worker_registration(id),
    worker_id       BIGINT          REFERENCES fe_worker(id),
    enterprise_id   BIGINT          NOT NULL REFERENCES fe_enterprise(id),
    contract_type   VARCHAR(50)     NOT NULL DEFAULT 'labor',
    contract_title  VARCHAR(200),
    sign_status     VARCHAR(20)     NOT NULL DEFAULT 'pending',     -- pending / signing / signed / rejected / expired
    sign_provider   VARCHAR(50),                                    -- mock / esign_partner
    external_contract_id VARCHAR(100),
    sign_url        VARCHAR(512),
    signed_at       TIMESTAMPTZ,
    file_url        VARCHAR(512),
    create_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    del_flag        SMALLINT        NOT NULL DEFAULT 0
);
CREATE UNIQUE INDEX uk_fe_contract_no ON fe_contract (contract_no);
CREATE INDEX idx_fe_contract_order ON fe_contract (order_id, sign_status);


-- -----------------------------------------------------------------------------
-- 八、结算中心
-- 职责：结算确认单、按人明细、费用汇总、支付打款；对应小程序「历史订单/结算确认单」弹窗。
-- 说明：小程序仅展示渠道类型（微信/支付宝），不展示对公账户等敏感金融信息。
-- -----------------------------------------------------------------------------

CREATE TABLE fe_settlement_order (
    id                  BIGSERIAL       PRIMARY KEY,
    settlement_no       VARCHAR(32)     NOT NULL,
    order_id            BIGINT          NOT NULL REFERENCES fe_employment_order(id),
    batch_id            BIGINT          REFERENCES fe_registration_batch(id),
    enterprise_id       BIGINT          NOT NULL REFERENCES fe_enterprise(id),
    worker_count        INTEGER         NOT NULL,
    gross_amount        NUMERIC(14,2)   NOT NULL DEFAULT 0,         -- 应发总额
    deduction_amount    NUMERIC(14,2)   NOT NULL DEFAULT 0,         -- 扣款/个税
    net_amount          NUMERIC(14,2)   NOT NULL DEFAULT 0,         -- 实发总额
    service_fee_amount  NUMERIC(14,2)   NOT NULL DEFAULT 0,         -- 平台服务费
    invoice_amount      NUMERIC(14,2)   NOT NULL DEFAULT 0,         -- 预计开票额
    total_outflow       NUMERIC(14,2)   NOT NULL DEFAULT 0,         -- 企业总支出
    settlement_status   VARCHAR(20)     NOT NULL DEFAULT 'pending', -- pending / confirmed / paying / paid / cancelled
    compliance_tags     JSONB           DEFAULT '[]',
    compliance_remark   TEXT,
    confirmed_at        TIMESTAMPTZ,
    confirmed_by        BIGINT          REFERENCES fe_user(id),
    paid_at             TIMESTAMPTZ,
    create_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    del_flag            SMALLINT        NOT NULL DEFAULT 0
);
CREATE UNIQUE INDEX uk_fe_settlement_no ON fe_settlement_order (settlement_no);
CREATE INDEX idx_fe_settlement_ent ON fe_settlement_order (enterprise_id, settlement_status);


-- 按人结算明细
CREATE TABLE fe_settlement_item (
    id                  BIGSERIAL       PRIMARY KEY,
    settlement_id       BIGINT          NOT NULL REFERENCES fe_settlement_order(id),
    registration_id     BIGINT          REFERENCES fe_worker_registration(id),
    worker_id           BIGINT          REFERENCES fe_worker(id),
    worker_name_mask    VARCHAR(64),
    work_days           NUMERIC(8,2),
    work_hours          NUMERIC(8,2),
    piece_count         NUMERIC(12,2),
    gross_amount        NUMERIC(12,2)   NOT NULL DEFAULT 0,
    tax_amount          NUMERIC(12,2)   NOT NULL DEFAULT 0,
    other_deduction     NUMERIC(12,2)   NOT NULL DEFAULT 0,
    net_amount          NUMERIC(12,2)   NOT NULL DEFAULT 0,
    item_status         VARCHAR(20)     NOT NULL DEFAULT 'pending',
    create_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW()
);
CREATE INDEX idx_fe_settlement_item ON fe_settlement_item (settlement_id);


-- 结算费用汇总项
CREATE TABLE fe_settlement_fee (
    id              BIGSERIAL       PRIMARY KEY,
    settlement_id   BIGINT          NOT NULL REFERENCES fe_settlement_order(id),
    fee_code        VARCHAR(50)     NOT NULL,
    fee_name        VARCHAR(100)    NOT NULL,
    amount          NUMERIC(14,2)   NOT NULL,
    rate            NUMERIC(8,4),
    sort_order      INTEGER         NOT NULL DEFAULT 0
);
CREATE INDEX idx_fe_settlement_fee ON fe_settlement_fee (settlement_id);


-- 支付记录
CREATE TABLE fe_payment_record (
    id                  BIGSERIAL       PRIMARY KEY,
    payment_no          VARCHAR(32)     NOT NULL,
    settlement_id       BIGINT          NOT NULL REFERENCES fe_settlement_order(id),
    enterprise_id       BIGINT          NOT NULL REFERENCES fe_enterprise(id),
    payment_channel     VARCHAR(50)     NOT NULL,                   -- wechat / alipay / bank
    payment_amount      NUMERIC(14,2)   NOT NULL,
    payment_status      VARCHAR(20)     NOT NULL DEFAULT 'pending', -- pending / success / failed / refunded
    external_trade_no   VARCHAR(100),
    payer_user_id       BIGINT          REFERENCES fe_user(id),
    paid_at             TIMESTAMPTZ,
    receipt_url         VARCHAR(512),
    fail_reason         TEXT,
    create_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW()
);
CREATE UNIQUE INDEX uk_fe_payment_no ON fe_payment_record (payment_no);
CREATE INDEX idx_fe_payment_settlement ON fe_payment_record (settlement_id);


-- -----------------------------------------------------------------------------
-- 九、考勤管理（二期功能，表结构先行预留）
-- 职责：按日考勤核对、语音录入考勤；会议明确一期 MVP 暂不开发，表结构供后续扩展。
-- -----------------------------------------------------------------------------

CREATE TABLE fe_attendance_batch (
    id              BIGSERIAL       PRIMARY KEY,
    batch_id        BIGINT          NOT NULL REFERENCES fe_registration_batch(id),
    order_id        BIGINT          NOT NULL REFERENCES fe_employment_order(id),
    attendance_date DATE            NOT NULL,
    total_workers   INTEGER         NOT NULL DEFAULT 0,
    normal_count    INTEGER         NOT NULL DEFAULT 0,
    overtime_count  INTEGER         NOT NULL DEFAULT 0,
    leave_count     INTEGER         NOT NULL DEFAULT 0,
    total_hours     NUMERIC(10,2)   DEFAULT 0,
    total_pieces    NUMERIC(12,2)   DEFAULT 0,
    estimated_cost  NUMERIC(14,2)   DEFAULT 0,
    status          VARCHAR(20)     NOT NULL DEFAULT 'draft',       -- draft / confirmed / archived
    confirmed_by    BIGINT          REFERENCES fe_user(id),
    confirmed_at    TIMESTAMPTZ,
    create_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW()
);
CREATE UNIQUE INDEX uk_fe_attendance_batch ON fe_attendance_batch (batch_id, attendance_date);

CREATE TABLE fe_attendance_record (
    id                  BIGSERIAL       PRIMARY KEY,
    attendance_batch_id BIGINT          NOT NULL REFERENCES fe_attendance_batch(id),
    registration_id     BIGINT          NOT NULL REFERENCES fe_worker_registration(id),
    worker_id           BIGINT          REFERENCES fe_worker(id),
    attendance_type     VARCHAR(20)     NOT NULL DEFAULT 'normal',  -- normal / overtime / leave / piece
    work_hours          NUMERIC(8,2),
    overtime_hours      NUMERIC(8,2),
    piece_count         NUMERIC(12,2),
    remark              TEXT,
    source              VARCHAR(30)     DEFAULT 'manual',             -- manual / voice / import
    create_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW()
);
CREATE INDEX idx_fe_attendance_rec ON fe_attendance_record (attendance_batch_id);


-- -----------------------------------------------------------------------------
-- 十、审计与确认
-- 职责：用户确认留痕、关键字段变更记录；草稿确认、方案选择、结算支付、外部提交必写。
-- 说明：会议一期可裁剪完整审计日志模块，但 fe_user_confirmation 建议 MVP 即实现。
-- -----------------------------------------------------------------------------

CREATE TABLE fe_user_confirmation (
    id              BIGSERIAL       PRIMARY KEY,
    enterprise_id   BIGINT          NOT NULL REFERENCES fe_enterprise(id),
    user_id         BIGINT          NOT NULL REFERENCES fe_user(id),
    biz_type        VARCHAR(50)     NOT NULL,                       -- draft_confirm / plan_select / settlement_pay / external_submit
    biz_id          BIGINT          NOT NULL,
    biz_no          VARCHAR(32),
    action          VARCHAR(50)     NOT NULL,                       -- confirm / modify / authorize
    confirmed_fields JSONB          DEFAULT '{}',
    selected_plan_id BIGINT         REFERENCES fe_service_plan(id),
    client_ip       VARCHAR(64),
    user_agent      VARCHAR(500),
    remark          TEXT,
    create_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW()
);
CREATE INDEX idx_fe_user_confirm ON fe_user_confirmation (enterprise_id, biz_type, create_time DESC);


CREATE TABLE fe_field_change_log (
    id              BIGSERIAL       PRIMARY KEY,
    biz_type        VARCHAR(50)     NOT NULL,                       -- draft / order / registration
    biz_id          BIGINT          NOT NULL,
    field_key       VARCHAR(100)    NOT NULL,
    old_value       TEXT,
    new_value       TEXT,
    change_source   VARCHAR(30)     NOT NULL,                       -- user_edit / nl_edit / ai_regenerate / system
    operator_id     BIGINT          REFERENCES fe_user(id),
    create_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW()
);
CREATE INDEX idx_fe_field_change ON fe_field_change_log (biz_type, biz_id, create_time);


-- -----------------------------------------------------------------------------
-- 十一、第三方连接器
-- 职责：对接合作灵活用工/税筹平台；保存原始请求响应，技术细节不对用户暴露。
-- 说明：一期采用 Mock 打桩，fe_provider_api_log 可先写本地模拟数据。
-- -----------------------------------------------------------------------------

CREATE TABLE fe_provider (
    id              BIGSERIAL       PRIMARY KEY,
    provider_code   VARCHAR(50)     NOT NULL,                       -- partner_platform
    provider_name   VARCHAR(100)    NOT NULL,
    api_base_url    VARCHAR(512),
    auth_config_enc TEXT,                                           -- 鉴权配置密文
    status          VARCHAR(20)     NOT NULL DEFAULT 'active',
    create_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    update_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW()
);
CREATE UNIQUE INDEX uk_fe_provider_code ON fe_provider (provider_code);

CREATE TABLE fe_provider_api_log (
    id                  BIGSERIAL       PRIMARY KEY,
    provider_id         BIGINT          NOT NULL REFERENCES fe_provider(id),
    enterprise_id       BIGINT          REFERENCES fe_enterprise(id),
    order_id            BIGINT          REFERENCES fe_employment_order(id),
    action              VARCHAR(100)    NOT NULL,                   -- create_requirement / query_status / callback
    request_payload     JSONB,
    response_payload    JSONB,
    http_status         INTEGER,
    biz_status          VARCHAR(50),                                -- 转换后的业务状态
    audit_required      BOOLEAN         NOT NULL DEFAULT FALSE,
    error_message       TEXT,
    duration_ms         INTEGER,
    create_time         TIMESTAMPTZ     NOT NULL DEFAULT NOW()
);
CREATE INDEX idx_fe_provider_log ON fe_provider_api_log (provider_id, create_time DESC);
CREATE INDEX idx_fe_provider_log_order ON fe_provider_api_log (order_id);


-- -----------------------------------------------------------------------------
-- 十二、消息与待办
-- 职责：待确认结算、实名失败、登记进度等通知；支撑侧边栏「消息与待办中心」与一键催办。
-- -----------------------------------------------------------------------------

CREATE TABLE fe_notification (
    id              BIGSERIAL       PRIMARY KEY,
    enterprise_id   BIGINT          REFERENCES fe_enterprise(id),
    user_id         BIGINT          REFERENCES fe_user(id),
    notify_type     VARCHAR(30)     NOT NULL,                       -- pending / error / info / success
    category        VARCHAR(50)     NOT NULL,                       -- settlement / registration / verify / workflow
    title           VARCHAR(200)    NOT NULL,
    content         TEXT,
    biz_type        VARCHAR(50),
    biz_id          BIGINT,
    biz_no          VARCHAR(32),
    action_url      VARCHAR(512),                                   -- 小程序跳转路径
    read_flag       BOOLEAN         NOT NULL DEFAULT FALSE,
    handled_flag    BOOLEAN         NOT NULL DEFAULT FALSE,
    create_time     TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    read_time       TIMESTAMPTZ,
    handled_time    TIMESTAMPTZ
);
CREATE INDEX idx_fe_notification_user ON fe_notification (user_id, read_flag, create_time DESC);
CREATE INDEX idx_fe_notification_ent ON fe_notification (enterprise_id, handled_flag, create_time DESC);



-- =============================================================================
-- 表与字段注释（COMMENT ON）
-- 说明：每张表含表级注释；每个字段含业务含义、写入时机、枚举、示例、外键与敏感/可空说明
-- =============================================================================

COMMENT ON TABLE fe_user IS '微信用户主表，企业主与临时工共用账号体系，通过 user_type 区分身份。支撑微信小程序 code2session 登录与 Session 鉴权，是 fe_enterprise_user、fe_conversation、fe_worker 等表的用户外键来源。敏感手机号仅存密文与脱敏值，禁止明文入库。';
COMMENT ON COLUMN fe_user.id IS '表主键，BIGSERIAL 自增。首次微信登录时由数据库自动生成，后续所有关联表通过本字段引用用户。示例：10001。非空，非敏感，只读展示。';
COMMENT ON COLUMN fe_user.openid IS '微信小程序用户唯一标识，调用微信 code2session 接口获得。用户首次授权登录时由认证服务写入，同一小程序内唯一，用于识别回访用户。示例：oX9k2_abc123def456。非空；建立唯一索引 uk_fe_user_openid（del_flag=0 时）；不可对外暴露。';
COMMENT ON COLUMN fe_user.unionid IS '微信开放平台 unionid，用于同一主体下多应用用户关联。用户绑定开放平台账号且小程序已接入时写入，否则保持为空。示例：oUZ6w_union789。可空；跨应用场景使用。';
COMMENT ON COLUMN fe_user.user_type IS '用户身份类型，区分企业主与临时工两类业务角色。注册或首次登录时根据入口（企业端/临时工端）由应用层写入。枚举：enterprise=企业主（发单、确认方案、结算）；worker=临时工（扫码登记、签署协议）。非空，默认 enterprise；影响菜单权限与 API 鉴权。';
COMMENT ON COLUMN fe_user.nickname IS '用户在微信侧展示的昵称。登录成功后从微信用户信息接口同步，用户可在小程序内修改后更新。示例：张经理、小李。可空；用于消息列表与操作日志展示。';
COMMENT ON COLUMN fe_user.avatar_url IS '用户头像图片 URL。登录时从微信同步或用户上传后由应用层更新。示例：https://thirdwx.qlogo.cn/mmopen/...。可空；CDN 地址，需校验域名白名单。';
COMMENT ON COLUMN fe_user.mobile_enc IS '手机号 AES 等算法加密后的密文，用于实名核验与联系。用户授权获取手机号或企业主填写时，由应用层加密后写入。高度敏感；数据库禁止存明文；解密仅限后端授权接口。可空。';
COMMENT ON COLUMN fe_user.mobile_mask IS '手机号脱敏展示值，供列表、通知、日志使用。与 mobile_enc 同时写入，由应用层按规则生成。示例：138****1234。可空；禁止从脱敏值反推明文。';
COMMENT ON COLUMN fe_user.session_key IS '微信会话密钥，用于解密用户敏感数据及维持登录态。每次 code2session 成功后由认证服务覆盖写入，需定期刷新。高度敏感；仅后端持有，禁止返回前端或写入日志。可空。';
COMMENT ON COLUMN fe_user.status IS '账号启用状态，控制是否允许登录与业务操作。管理员禁用违规账号时写入 disabled，解禁时改回 active。枚举：active=正常可用；disabled=禁用（拒绝登录）。非空，默认 active。';
COMMENT ON COLUMN fe_user.last_login_at IS '用户最近一次成功登录的时间戳（含时区）。每次登录鉴权通过时由认证中间件更新。示例：2026-07-07T09:30:00+08:00。可空；用于活跃度统计与异常登录检测。';
COMMENT ON COLUMN fe_user.create_time IS '记录创建时间，用户首次入库时刻。INSERT 时由数据库 DEFAULT NOW() 或应用层写入。非空；审计字段，一般不修改。';
COMMENT ON COLUMN fe_user.update_time IS '记录最后更新时间。任意字段变更时由应用层维护刷新。非空；与 create_time 配合追踪变更。';
COMMENT ON COLUMN fe_user.del_flag IS '逻辑删除标记，软删后释放 openid 唯一索引占用。用户注销或管理员删除时置 1，恢复时置 0。枚举：0=正常；1=已逻辑删除。非空，默认 0；查询默认过滤 del_flag=0。';

COMMENT ON TABLE fe_enterprise IS '企业主体表，灵活用工业务归属主体，承载企业认证信息与扩展画像。与 fe_enterprise_user（多管理员）、fe_employment_draft、fe_employment_order 等为一对多关系。注册地址 registered_address 供 AI 草稿默认推断工作地点。';
COMMENT ON COLUMN fe_enterprise.id IS '表主键，BIGSERIAL 自增。企业入驻或管理员创建企业时生成。示例：2001。非空；被草稿、订单、会话等多表外键引用。';
COMMENT ON COLUMN fe_enterprise.enterprise_code IS '企业业务编码，系统内唯一标识，便于对外 API 与日志引用。企业创建时由编号生成器写入。示例：ent_001。非空；唯一索引 uk_fe_enterprise_code（del_flag=0）。';
COMMENT ON COLUMN fe_enterprise.name IS '企业全称，工商注册名称。企业入驻表单或 OCR 识别营业执照时写入。示例：上海某某物流有限公司。非空；用于合同抬头与结算展示。';
COMMENT ON COLUMN fe_enterprise.credit_code IS '统一社会信用代码，企业实名认证核心字段。企业提交认证材料时写入，审核通过后不变更。示例：91310000MA1K3XXXXX。可空；认证前可为空；非敏感但需校验格式。';
COMMENT ON COLUMN fe_enterprise.legal_person IS '法定代表人姓名。认证材料解析或人工填写时写入。示例：王某某。可空；用于合同与开票信息核对。';
COMMENT ON COLUMN fe_enterprise.registered_address IS '企业注册地址。认证或企业资料维护时写入；AI 生成草稿时优先作为 work_location 默认值来源。示例：上海市浦东新区张江路 88 号。可空；影响草稿地点推断。';
COMMENT ON COLUMN fe_enterprise.contact_name IS '企业日常联系人姓名。企业主维护企业资料时写入。示例：李主管。可空；用于平台客服联系。';
COMMENT ON COLUMN fe_enterprise.contact_mobile_mask IS '联系人手机号脱敏值。与联系人手机密文（若单独存储）同步生成，供列表展示。示例：139****5678。可空；非敏感。';
COMMENT ON COLUMN fe_enterprise.industry IS '所属行业分类。企业资料维护或 AI 画像推断时写入。示例：仓储物流、制造业。可空；用于方案推荐与风险诊断。';
COMMENT ON COLUMN fe_enterprise.scale IS '企业规模描述。企业资料维护时写入。示例：50-200人、小微企业。可空；辅助成本测算与合规判断。';
COMMENT ON COLUMN fe_enterprise.auth_status IS '企业实名认证状态。提交认证置 pending，审核通过置 verified，驳回置 rejected。枚举：pending=待审核；verified=已认证；rejected=已驳回。非空，默认 pending；未认证企业功能受限。';
COMMENT ON COLUMN fe_enterprise.auth_time IS '认证审核通过时间戳。运营或系统自动审核通过时写入。可空；仅 auth_status=verified 时有值。';
COMMENT ON COLUMN fe_enterprise.profile_json IS '企业扩展画像 JSON，承载行业标签、历史偏好摘要、风险标签等。AI 画像服务或运营标注时增量更新。示例：{"tags":["仓储","旺季用工"]}。可空，默认 {}；非敏感；结构由应用层约定。';
COMMENT ON COLUMN fe_enterprise.create_time IS '企业记录创建时间。INSERT 时默认 NOW()。非空；审计字段。';
COMMENT ON COLUMN fe_enterprise.update_time IS '企业资料最后更新时间。任意字段变更时由应用层刷新。非空。';
COMMENT ON COLUMN fe_enterprise.del_flag IS '逻辑删除标记。企业注销或管理员删除时置 1。枚举：0=正常；1=已删除。非空，默认 0；软删后释放 enterprise_code 唯一索引。';

COMMENT ON TABLE fe_enterprise_user IS '企业与微信用户的多对多绑定关系表，支持一企业多管理员、一用户管多企业。通过 is_default 标识用户登录后默认选中的企业上下文，关联 fe_enterprise 与 fe_user。';
COMMENT ON COLUMN fe_enterprise_user.id IS '表主键，自增。绑定关系创建时生成。非空。';
COMMENT ON COLUMN fe_enterprise_user.enterprise_id IS '关联企业主键，外键 REFERENCES fe_enterprise(id)。管理员邀请绑定或企业创建时写入。非空；级联查询企业下所有管理员。';
COMMENT ON COLUMN fe_enterprise_user.user_id IS '关联微信用户主键，外键 REFERENCES fe_user(id)。被邀请用户接受绑定或企业创建者自动绑定时写入。非空；建立索引 idx_fe_enterprise_user_uid。';
COMMENT ON COLUMN fe_enterprise_user.role IS '用户在该企业下的权限角色。绑定或角色调整时由企业主/管理员写入。枚举：owner=主账号（最高权限）；admin=管理员；viewer=只读。非空，默认 owner。';
COMMENT ON COLUMN fe_enterprise_user.is_default IS '是否为用户登录后的默认选中企业。用户切换默认企业或首次绑定时由应用层更新，同一 user_id 仅一条为 true。非空，默认 FALSE；影响 API 请求默认 enterprise_id。';
COMMENT ON COLUMN fe_enterprise_user.bind_time IS '绑定关系建立时间。绑定成功时写入，默认 NOW()。非空；用于审计。';
COMMENT ON COLUMN fe_enterprise_user.create_time IS '记录创建时间。INSERT 时写入。非空。';
COMMENT ON COLUMN fe_enterprise_user.update_time IS '记录更新时间。角色或默认企业变更时刷新。非空。';
COMMENT ON COLUMN fe_enterprise_user.del_flag IS '逻辑删除标记。解除绑定关系时置 1，非物理删除。枚举：0=正常；1=已解除。非空，默认 0；唯一索引 uk_fe_enterprise_user(enterprise_id,user_id) 在 del_flag=0 时生效。';

COMMENT ON TABLE fe_enterprise_finance IS '企业财务与开票信息表，与企业主体一对一（enterprise_id 唯一）。存储对公账户密文、开票抬头、打款渠道等；小程序端仅展示渠道类型，不展示账户明细等敏感金融信息。';
COMMENT ON COLUMN fe_enterprise_finance.id IS '表主键，自增。企业首次维护财务信息时生成。非空。';
COMMENT ON COLUMN fe_enterprise_finance.enterprise_id IS '关联企业主键，外键 REFERENCES fe_enterprise(id)。财务信息首次录入时写入。非空；一对一，唯一索引 uk_fe_enterprise_finance。';
COMMENT ON COLUMN fe_enterprise_finance.bank_name IS '对公账户开户银行名称。企业主在财务设置页填写时写入。示例：中国工商银行上海张江支行。可空。';
COMMENT ON COLUMN fe_enterprise_finance.bank_account_enc IS '对公银行账号加密密文。企业提交账户信息时由应用层加密写入。高度敏感；禁止明文入库与前端回显；可空。';
COMMENT ON COLUMN fe_enterprise_finance.bank_account_mask IS '对公账号脱敏展示值。与 bank_account_enc 同时生成。示例：6222****1234。可空；供运营后台列表展示。';
COMMENT ON COLUMN fe_enterprise_finance.invoice_title IS '增值税发票开票抬头，通常与企业全称一致。财务设置时写入。示例：上海某某物流有限公司。可空；结算开票使用。';
COMMENT ON COLUMN fe_enterprise_finance.tax_no IS '纳税人识别号，用于开票与税务合规。财务设置或认证同步时写入。示例：91310000MA1K3XXXXX。可空；需与统一社会信用代码核对。';
COMMENT ON COLUMN fe_enterprise_finance.payment_channel IS '企业偏好打款渠道类型，小程序仅展示此枚举不展示账户号。财务设置时写入。枚举：wechat=微信支付；alipay=支付宝；bank=银行转账。可空。';
COMMENT ON COLUMN fe_enterprise_finance.balance_amount IS '企业在平台虚拟账户余额（元），NUMERIC(14,2)。充值、结算扣款时由账务服务更新。示例：50000.00。可空，默认 0；非敏感。';
COMMENT ON COLUMN fe_enterprise_finance.create_time IS '记录创建时间。非空。';
COMMENT ON COLUMN fe_enterprise_finance.update_time IS '财务信息变更时更新。非空。';
COMMENT ON COLUMN fe_enterprise_finance.del_flag IS '逻辑删除标记。枚举：0=正常；1=已删除。非空，默认 0。';

COMMENT ON TABLE fe_enterprise_preference IS '企业智能偏好配置表，存储工种薪资基准、默认保险档次、发薪结算周期等结构化偏好。支持用户自然语言配置后由 AI 解析入库，供草稿生成引擎复用，关联 fe_enterprise。';
COMMENT ON COLUMN fe_enterprise_preference.id IS '表主键，自增。偏好项创建时生成。非空。';
COMMENT ON COLUMN fe_enterprise_preference.enterprise_id IS '关联企业主键，外键 REFERENCES fe_enterprise(id)。偏好配置时写入。非空；索引 idx_fe_enterprise_pref(enterprise_id,pref_type)。';
COMMENT ON COLUMN fe_enterprise_preference.pref_type IS '偏好大类。用户或 AI 配置时写入。枚举：work_type=工种薪资基准；insurance=默认保险配置；payment_cycle=发薪/结算周期偏好。非空。';
COMMENT ON COLUMN fe_enterprise_preference.pref_key IS '偏好子键，细分到具体工种或场景。示例：搬运工、仓库分拣。可空；同一 pref_type 下可有多条记录。';
COMMENT ON COLUMN fe_enterprise_preference.pref_value IS '结构化偏好值 JSON，承载薪资区间、保险方案参数等。AI 解析或用户表单提交时写入。示例：{"daily_wage":280,"currency":"CNY"}。非空，默认 {}。';
COMMENT ON COLUMN fe_enterprise_preference.source IS '偏好数据来源，用于前端展示可信度标签。写入时由应用层标记。枚举：user_config=用户主动配置；ai_inferred=AI 从历史订单推断；default=系统默认。可空，默认 user_config。';
COMMENT ON COLUMN fe_enterprise_preference.raw_text IS '用户自然语言配置原文，便于审计与重新解析。用户在对话或设置页输入时保存。示例：「搬运工日薪 280，要标准意外险」。可空。';
COMMENT ON COLUMN fe_enterprise_preference.confirmed IS '用户是否已明确确认该偏好项。用户点击确认后置 TRUE，未确认前草稿生成可提示复核。非空，默认 FALSE。';
COMMENT ON COLUMN fe_enterprise_preference.create_time IS '记录创建时间。非空。';
COMMENT ON COLUMN fe_enterprise_preference.update_time IS '偏好值变更时更新。非空。';
COMMENT ON COLUMN fe_enterprise_preference.del_flag IS '逻辑删除标记。枚举：0=正常；1=已删除。非空，默认 0。';

COMMENT ON TABLE fe_conversation IS 'AI 对话会话主表，企业主与智能体交互的容器。通过 chat_type 区分用工、知识库、订单、成本等专题对话；一对多关联 fe_conversation_message。enterprise_id 与 user_id 共同界定会话归属与权限。';
COMMENT ON COLUMN fe_conversation.id IS '表主键，自增。用户发起新对话时生成。非空；被消息表、草稿表外键引用。';
COMMENT ON COLUMN fe_conversation.conversation_no IS '会话对外业务编号，API 路径与日志中使用。创建会话时由编号生成器写入。示例：conv_001。非空；唯一索引 uk_fe_conversation_no。';
COMMENT ON COLUMN fe_conversation.enterprise_id IS '所属企业，外键 REFERENCES fe_enterprise(id)。创建会话时从当前登录上下文写入。非空；索引 idx_fe_conversation_ent 用于侧边栏按企业筛选。';
COMMENT ON COLUMN fe_conversation.user_id IS '发起对话的企业主用户，外键 REFERENCES fe_user(id)。创建会话时写入。非空；须为 enterprise 类型用户。';
COMMENT ON COLUMN fe_conversation.title IS '会话标题，侧边栏展示用。可由首条用户消息摘要或 AI 自动生成，用户可重命名。示例：浦东仓库暑期用工。可空。';
COMMENT ON COLUMN fe_conversation.chat_type IS '对话专题类型，决定加载的子智能体与卡片模板。创建时根据入口或首条意图写入。枚举：employment=用工办理；knowledge=政策知识库；order=订单查询；cost=成本测算；attendance=考勤；emergency=应急咨询。非空，默认 employment。';
COMMENT ON COLUMN fe_conversation.status IS '会话生命周期状态。用户归档或长期无消息时更新。枚举：active=进行中；archived=已归档（只读）。非空，默认 active。';
COMMENT ON COLUMN fe_conversation.last_message_at IS '最后一条消息时间，用于侧边栏按时间排序。每次 INSERT fe_conversation_message 后由应用层刷新。可空；索引排序字段。';
COMMENT ON COLUMN fe_conversation.create_time IS '会话创建时间。非空。';
COMMENT ON COLUMN fe_conversation.update_time IS '会话元数据变更时更新。非空。';
COMMENT ON COLUMN fe_conversation.del_flag IS '逻辑删除标记。枚举：0=正常；1=已删除。非空，默认 0。';

COMMENT ON TABLE fe_conversation_message IS '对话消息明细表，存储用户与助手往返的文本及结构化卡片（草稿卡、成本卡、订单卡）。通过 next_action 驱动小程序路由跳转；关联 fe_conversation，可软链 fe_employment_draft。';
COMMENT ON COLUMN fe_conversation_message.id IS '表主键，自增。每条消息入库时生成。非空。';
COMMENT ON COLUMN fe_conversation_message.conversation_id IS '所属会话，外键 REFERENCES fe_conversation(id)。发送消息时写入。非空；索引 idx_fe_conv_msg(conversation_id,create_time)。';
COMMENT ON COLUMN fe_conversation_message.role IS '消息发送方角色。写入时由网关标记。枚举：user=企业主用户；assistant=AI 助手；system=系统提示（如流程引导）。非空。';
COMMENT ON COLUMN fe_conversation_message.content IS '消息正文文本或卡片摘要说明，供聊天气泡展示。用户输入或 AI 生成时写入。非空；长文本需注意截断策略。';
COMMENT ON COLUMN fe_conversation_message.content_type IS '消息内容形态，决定前端渲染组件。写入时标记。枚举：text=纯文本；card_draft=用工草稿卡；card_cost=成本对比卡；card_order=订单进度卡。非空，默认 text。';
COMMENT ON COLUMN fe_conversation_message.card_payload IS '卡片结构化数据 JSON，如草稿字段列表、成本行、订单摘要。AI 子模块返回卡片时写入。示例：{"draft_id":101,"fields":[...]}。可空；仅 content_type 为卡片类型时有值。';
COMMENT ON COLUMN fe_conversation_message.agent_module IS '处理该消息的子智能体模块名，用于排障与统计。路由层写入。示例：flexible_employment、cost_engine。可空。';
COMMENT ON COLUMN fe_conversation_message.next_action IS '建议前端执行的下一步动作编码，用于自动跳转或弹窗。助手回复卡片时写入。示例：show_employment_draft、open_cost_comparison。可空。';
COMMENT ON COLUMN fe_conversation_message.related_draft_id IS '关联的用工草稿 ID，软引用 fe_employment_draft(id)。生成或引用草稿卡时写入。可空；无外键约束，由应用层保证一致性。';
COMMENT ON COLUMN fe_conversation_message.token_usage IS '大模型 token 消耗统计 JSON，含 prompt/completion 分项。AI 调用完成后写入，供成本核算。示例：{"prompt":1200,"completion":800}。可空；不展示给用户。';
COMMENT ON COLUMN fe_conversation_message.create_time IS '消息发送/入库时间，聊天气泡排序依据。非空，默认 NOW()。';

COMMENT ON TABLE fe_agent_action_log IS '智能体与子模块调用审计日志表，记录主智能体、灵活用工模块、成本引擎等的入参出参与耗时。用于技术排障与合规审计，不对小程序用户直接展示；可关联 fe_conversation。';
COMMENT ON COLUMN fe_agent_action_log.id IS '表主键，自增。每次子模块调用时生成。非空。';
COMMENT ON COLUMN fe_agent_action_log.conversation_id IS '关联会话，外键 REFERENCES fe_conversation(id)。对话内调用时写入；后台定时任务触发时可为空。可空。';
COMMENT ON COLUMN fe_agent_action_log.enterprise_id IS '所属企业，外键 REFERENCES fe_enterprise(id)。调用上下文中的企业 ID，必填以便按企业排障。非空；索引 idx_fe_agent_log。';
COMMENT ON COLUMN fe_agent_action_log.module_name IS '被调用的模块名称。调用发起时写入。枚举示例：main_agent=主路由；flexible_employment=用工子模块；cost_engine=成本测算引擎。非空。';
COMMENT ON COLUMN fe_agent_action_log.action IS '模块内具体动作编码。示例：generate_draft、calc_cost、parse_nl_preference。非空；与 module_name 组合定位代码路径。';
COMMENT ON COLUMN fe_agent_action_log.request_json IS '请求体 JSON 快照，含用户输入与上下文参数。调用前由中间件序列化写入。可空；可能含业务敏感字段，访问需授权。';
COMMENT ON COLUMN fe_agent_action_log.response_json IS '响应体 JSON 快照，含 AI 结构化输出。调用成功后写入。可空；失败时可能为空或部分写入。';
COMMENT ON COLUMN fe_agent_action_log.status IS '调用结果状态。调用结束时写入。枚举：success=成功；failed=失败。非空，默认 success。';
COMMENT ON COLUMN fe_agent_action_log.error_message IS '失败时的错误堆栈或业务错误码说明。仅 status=failed 时写入。可空；供研发排障。';
COMMENT ON COLUMN fe_agent_action_log.duration_ms IS '调用耗时（毫秒）。调用结束时计算写入。示例：2350。可空；用于性能监控。';
COMMENT ON COLUMN fe_agent_action_log.create_time IS '调用发生时间。非空；按时间倒序查最近异常。';

COMMENT ON TABLE fe_service_plan IS '用工方案目录表，成本对比页「当前方式 + 方案一二三」的配置数据源。正式环境费率以此表为准；test_only 状态方案仅供 Demo。一对多关联 fe_service_plan_fee_rule，被草稿与订单 selected_plan_id 引用。';
COMMENT ON COLUMN fe_service_plan.id IS '表主键，自增。运营配置或初始化脚本插入时生成。非空。';
COMMENT ON COLUMN fe_service_plan.plan_code IS '方案业务编码，全局唯一（软删条件下）。初始化或运营录入时写入。枚举：current=企业现有处理方式；plan_1/plan_2/plan_3=对比方案。示例：plan_1。非空；唯一索引 uk_fe_service_plan_code。';
COMMENT ON COLUMN fe_service_plan.plan_name IS '前端展示名称。运营配置时写入。示例：合规优先 (A)、传统用工 (B)。非空。';
COMMENT ON COLUMN fe_service_plan.plan_type IS '方案用工模式大类。配置时写入。枚举：flexible=灵活用工；traditional=传统用工；hybrid=混合模式。非空，默认 flexible。';
COMMENT ON COLUMN fe_service_plan.description IS '方案详细说明文案，成本对比页展开区展示。运营维护时写入。可空。';
COMMENT ON COLUMN fe_service_plan.service_fee_rate IS '平台服务费率，NUMERIC(8,4)。示例：0.08 表示 8%。运营配置或费率调整时写入。可空；current 方案可为 NULL 表示按企业现状估算。';
COMMENT ON COLUMN fe_service_plan.insurance_level IS '方案默认保险档次。枚举：basic=基础；standard=标准；premium=高级。可空；影响保险费用项测算。';
COMMENT ON COLUMN fe_service_plan.tax_mode IS '税费代征模式编码，与地方税筹政策对应。运营配置时写入。示例：withhold_standard。可空。';
COMMENT ON COLUMN fe_service_plan.applicable_scenarios IS '适用场景 JSON 数组，供 AI 推荐方案时匹配。示例：["旺季临时工","仓储搬运"]。可空，默认 []。';
COMMENT ON COLUMN fe_service_plan.compliance_tags IS '合规能力标签 JSON 数组，前端展示勾选图标。示例：["业务真实","资金合规","个税申报"]。可空，默认 []。';
COMMENT ON COLUMN fe_service_plan.sort_order IS '前端展示排序权重，越小越靠前。运营配置时写入。非空，默认 0。';
COMMENT ON COLUMN fe_service_plan.status IS '方案生效状态。枚举：active=正式可用；test_only=测试演示默认；disabled=停用。非空，默认 active；生产环境应仅 active 参与正式测算。';
COMMENT ON COLUMN fe_service_plan.effective_from IS '方案生效开始日期。费率版本管理时写入。可空。';
COMMENT ON COLUMN fe_service_plan.effective_to IS '方案生效结束日期，到期后自动不参与测算。可空。';
COMMENT ON COLUMN fe_service_plan.create_time IS '记录创建时间。非空。';
COMMENT ON COLUMN fe_service_plan.update_time IS '方案配置变更时更新。非空。';
COMMENT ON COLUMN fe_service_plan.del_flag IS '逻辑删除标记。枚举：0=正常；1=已删除。非空，默认 0。';

COMMENT ON TABLE fe_service_plan_fee_rule IS '方案费用项计算规则表，定义劳务费、服务费、保险、税费代征等分项的计算方式（固定额/比例/公式）。成本测算引擎读取本表与 fe_service_plan 联合计算；一对多归属 plan_id。';
COMMENT ON COLUMN fe_service_plan_fee_rule.id IS '表主键，自增。运营为方案配置费用项时生成。非空。';
COMMENT ON COLUMN fe_service_plan_fee_rule.plan_id IS '关联方案，外键 REFERENCES fe_service_plan(id)。配置费用规则时写入。非空；索引 idx_fe_plan_fee。';
COMMENT ON COLUMN fe_service_plan_fee_rule.fee_code IS '费用项编码。枚举：labor_fee=劳务费；service_fee=平台服务费；insurance=保险费；tax_withhold=税费代征。非空。';
COMMENT ON COLUMN fe_service_plan_fee_rule.fee_name IS '费用项中文展示名。示例：劳务费、服务费。非空。';
COMMENT ON COLUMN fe_service_plan_fee_rule.calc_type IS '计算方式类型。枚举：fixed=固定金额；rate=按基数比例；formula=自定义公式（由 calc_expression 描述）。非空。';
COMMENT ON COLUMN fe_service_plan_fee_rule.calc_expression IS '计算公式或规则描述文本，供引擎解析或人工审计。运营配置时写入。示例：gross * service_fee_rate。可空；calc_type=formula 时建议必填。';
COMMENT ON COLUMN fe_service_plan_fee_rule.default_rate IS '默认费率或系数，NUMERIC(8,4)。rate 类型费用项使用。示例：0.08。可空。';
COMMENT ON COLUMN fe_service_plan_fee_rule.sort_order IS '成本明细展示顺序。非空，默认 0。';
COMMENT ON COLUMN fe_service_plan_fee_rule.create_time IS '记录创建时间。非空。';
COMMENT ON COLUMN fe_service_plan_fee_rule.update_time IS '规则变更时更新。非空。';

COMMENT ON TABLE fe_workflow_definition IS '合规流程定义表，描述「五流合一」整体状态机的版本化元数据。支持多版本并存，is_active 标识当前启用版本；一对多关联 fe_workflow_step 定义各步骤。';
COMMENT ON COLUMN fe_workflow_definition.id IS '表主键，自增。初始化脚本或运营发布新版本时生成。非空。';
COMMENT ON COLUMN fe_workflow_definition.workflow_code IS '流程业务编码，同一编码可有多个 version。示例：employment_compliance。非空；与 version 组成唯一索引 uk_fe_workflow_def。';
COMMENT ON COLUMN fe_workflow_definition.workflow_name IS '流程中文名称。示例：用工合规办理流程。非空。';
COMMENT ON COLUMN fe_workflow_definition.description IS '流程整体说明，描述五流合一覆盖范围。可空。';
COMMENT ON COLUMN fe_workflow_definition.version IS '流程版本号，递增整数。发布新流程时在上版基础上 +1。非空，默认 1；历史订单可能引用旧版步骤定义。';
COMMENT ON COLUMN fe_workflow_definition.is_active IS '是否当前系统启用的流程版本。发布新版时旧版置 FALSE，新版置 TRUE。非空，默认 TRUE；同时仅应有一个 is_active=TRUE 的同 workflow_code。';
COMMENT ON COLUMN fe_workflow_definition.create_time IS '记录创建时间。非空。';
COMMENT ON COLUMN fe_workflow_definition.update_time IS '流程元数据变更时更新。非空。';

COMMENT ON TABLE fe_workflow_step IS '合规流程步骤定义表，订单 fe_employment_order.current_step_code 对应本表 step_code。强制校验实名、合同、结算、完税、开票等必经节点完整性；归属 fe_workflow_definition。';
COMMENT ON COLUMN fe_workflow_step.id IS '表主键，自增。流程版本初始化时批量插入。非空。';
COMMENT ON COLUMN fe_workflow_step.workflow_id IS '关联流程定义，外键 REFERENCES fe_workflow_definition(id)。步骤归属的流程版本。非空。';
COMMENT ON COLUMN fe_workflow_step.step_code IS '步骤唯一编码，订单 current_step_code 引用此值。枚举（九步）：draft_created=草稿创建；plan_confirmed=方案确认；registration=扫码登记；enterprise_audit=企业审核；contract_signing=合同签署；work_started=开始用工；settlement_pending=待结算；settlement_paid=已支付；completed=已完成。非空；与 workflow_id 组成唯一索引。';
COMMENT ON COLUMN fe_workflow_step.step_name IS '步骤中文展示名。示例：扫码登记、合同签署。非空。';
COMMENT ON COLUMN fe_workflow_step.step_order IS '步骤顺序号，从小到大推进。初始化时写入 1-9。非空。';
COMMENT ON COLUMN fe_workflow_step.required IS '是否必经步骤，FALSE 时可跳过（扩展流程用）。非空，默认 TRUE；MVP 九步均为必经。';
COMMENT ON COLUMN fe_workflow_step.auto_advance IS '满足系统条件后是否自动推进到下一步，无需人工点击。非空，默认 FALSE；如登记人数达标可自动推进。';
COMMENT ON COLUMN fe_workflow_step.create_time IS '步骤定义创建时间。非空。';

COMMENT ON TABLE fe_policy_rule IS '政策法规规则库表，供规则引擎与 RAG 知识库引用，支撑用工风险诊断、合规提示与智能问答。按 rule_category 分类，支持生效期与优先级排序。';
COMMENT ON COLUMN fe_policy_rule.id IS '表主键，自增。运营或法务录入规则时生成。非空。';
COMMENT ON COLUMN fe_policy_rule.rule_code IS '规则唯一业务编码。示例：TAX_WITHHOLD_001。非空；唯一索引 uk_fe_policy_rule。';
COMMENT ON COLUMN fe_policy_rule.rule_category IS '规则分类。枚举：tax=税务；labor=劳动用工；insurance=保险；invoice=发票开票。非空；用于检索过滤。';
COMMENT ON COLUMN fe_policy_rule.title IS '规则标题，知识库与对话引用时展示。非空。';
COMMENT ON COLUMN fe_policy_rule.content IS '规则正文全文，可含法规条文摘要。非空；可能较长，注意全文检索索引。';
COMMENT ON COLUMN fe_policy_rule.effective_from IS '规则生效开始日期。可空；为空表示无开始限制。';
COMMENT ON COLUMN fe_policy_rule.effective_to IS '规则生效结束日期，过期规则不参与实时诊断。可空。';
COMMENT ON COLUMN fe_policy_rule.priority IS '匹配优先级，数值越大越优先。冲突时取高优先级规则。非空，默认 0。';
COMMENT ON COLUMN fe_policy_rule.status IS '规则启用状态。枚举：active=启用；disabled=停用。非空，默认 active。';
COMMENT ON COLUMN fe_policy_rule.create_time IS '记录创建时间。非空。';
COMMENT ON COLUMN fe_policy_rule.update_time IS '规则内容变更时更新。非空。';

COMMENT ON TABLE fe_employment_draft IS '用工草稿主表，体现「草稿优先」产品原则：AI 根据对话生成，用户确认前均为草稿状态。确认并选定方案后生成 fe_employment_order 与 fe_registration_batch；关联 fe_enterprise、fe_conversation、fe_service_plan。';
COMMENT ON COLUMN fe_employment_draft.id IS '表主键，自增。AI 子模块生成草稿时创建。非空；被 fe_draft_field、fe_draft_cost_snapshot 引用。';
COMMENT ON COLUMN fe_employment_draft.draft_no IS '草稿业务编号，对外 API 使用。生成时由编号器写入。示例：draft_001。非空；唯一索引 uk_fe_draft_no。';
COMMENT ON COLUMN fe_employment_draft.enterprise_id IS '所属企业，外键 REFERENCES fe_enterprise(id)。从对话上下文写入。非空；索引 idx_fe_draft_ent。';
COMMENT ON COLUMN fe_employment_draft.conversation_id IS '来源 AI 对话，外键 REFERENCES fe_conversation(id)。对话触发生成时写入；后台批量生成可为空。可空。';
COMMENT ON COLUMN fe_employment_draft.scenario IS '用工业务场景类型。AI 识别用户意图时写入。枚举：existing_worker_regularization=已有非正规临时工规范转正；new_demand=全新用工需求。非空。';
COMMENT ON COLUMN fe_employment_draft.title IS '草稿标题，列表与卡片展示。AI 摘要或用户输入。示例：浦东仓库暑期搬运。可空。';
COMMENT ON COLUMN fe_employment_draft.status IS '草稿生命周期状态。枚举：pending=待用户确认；confirmed=已确认并转订单；cancelled=用户取消；expired=超时未确认自动过期。非空，默认 pending。';
COMMENT ON COLUMN fe_employment_draft.worker_count IS '计划用工人数。AI 提取或用户填写。示例：15。可空；确认前可为空触发 missing_fields 提示。';
COMMENT ON COLUMN fe_employment_draft.work_days IS '计划工作天数。示例：30。可空。';
COMMENT ON COLUMN fe_employment_draft.work_type IS '岗位/工种类型。示例：搬运工、分拣员。可空；影响薪资与保险测算。';
COMMENT ON COLUMN fe_employment_draft.work_content IS '主要工作内容文字描述。AI 从对话归纳或用户补充。可空。';
COMMENT ON COLUMN fe_employment_draft.work_location IS '实际工作地点。可来自企业注册地址或用户指定。示例：上海市浦东新区XX路88号仓库。可空。';
COMMENT ON COLUMN fe_employment_draft.work_location_source IS '工作地点字段来源，前端可展示来源标签。枚举：enterprise_registered_address=取自 fe_enterprise.registered_address；user_input=用户明确输入；ai_inferred=AI 推断。可空。';
COMMENT ON COLUMN fe_employment_draft.settlement_mode IS '薪资结算方式。枚举：daily=日结；piece=计件；monthly=月结。可空；影响成本引擎计费基数。';
COMMENT ON COLUMN fe_employment_draft.daily_wage IS '日薪标准（元），NUMERIC(12,2)。示例：280.00。可空；piece/monthly 模式下可能为空。';
COMMENT ON COLUMN fe_employment_draft.insurance_required IS '是否强制购买商业保险。AI 默认或用户勾选。非空，默认 TRUE。';
COMMENT ON COLUMN fe_employment_draft.insurance_level IS '保险档次。枚举：basic/standard/premium。可空；与 fe_service_plan.insurance_level 对齐。';
COMMENT ON COLUMN fe_employment_draft.check_in_required IS '是否要求打卡考勤（二期功能预留）。非空，默认 FALSE。';
COMMENT ON COLUMN fe_employment_draft.qr_valid_days IS '登记二维码有效天数，确认后生成批次时使用。非空，默认 7。';
COMMENT ON COLUMN fe_employment_draft.work_start_date IS '计划开工日期，DATE 类型。示例：2026-08-01。可空。';
COMMENT ON COLUMN fe_employment_draft.work_end_date IS '计划结束日期。可空；应不早于 work_start_date。';
COMMENT ON COLUMN fe_employment_draft.job_requirements IS '岗位要求（年龄、经验、证件等）自由文本。可空。';
COMMENT ON COLUMN fe_employment_draft.missing_fields IS '待用户补充的字段名 JSON 数组。AI 检测信息不足时写入。示例：["work_location","daily_wage"]。可空，默认 []。';
COMMENT ON COLUMN fe_employment_draft.risk_prompts IS '风险提示 JSON 数组，合规引擎输出。示例：["未签劳动合同存在用工风险"]。可空，默认 []。';
COMMENT ON COLUMN fe_employment_draft.estimated_total IS '预估企业总支出（元）。成本引擎测算后回写。可空。';
COMMENT ON COLUMN fe_employment_draft.estimated_per_capita IS '预估人均成本（元）。成本引擎测算后回写。可空。';
COMMENT ON COLUMN fe_employment_draft.selected_plan_id IS '用户选中的用工方案，外键 REFERENCES fe_service_plan(id)。用户在成本对比页确认方案时写入；确认草稿时必填。可空（待确认阶段）。';
COMMENT ON COLUMN fe_employment_draft.confirmed_at IS '用户点击确认草稿的时间戳。确认接口成功时写入。可空。';
COMMENT ON COLUMN fe_employment_draft.confirmed_by IS '确认操作用户，外键 REFERENCES fe_user(id)。确认接口写入。可空。';
COMMENT ON COLUMN fe_employment_draft.create_time IS '草稿创建时间。非空。';
COMMENT ON COLUMN fe_employment_draft.update_time IS '草稿字段或状态变更时更新。非空。';
COMMENT ON COLUMN fe_employment_draft.del_flag IS '逻辑删除标记。枚举：0=正常；1=已删除。非空，默认 0。';

COMMENT ON TABLE fe_draft_field IS '草稿字段明细细表，逐字段记录值、数据来源与可编辑性，支撑前端「默认生成」角标（is_default=true）与字段级审计。一对多归属 fe_employment_draft。';
COMMENT ON COLUMN fe_draft_field.id IS '表主键，自增。草稿生成或字段补全时插入。非空。';
COMMENT ON COLUMN fe_draft_field.draft_id IS '关联草稿，外键 REFERENCES fe_employment_draft(id)。非空；与 field_key 组成唯一索引 uk_fe_draft_field。';
COMMENT ON COLUMN fe_draft_field.field_key IS '字段键名，与草稿主表列名或扩展字段对应。示例：work_location、daily_wage。非空。';
COMMENT ON COLUMN fe_draft_field.field_label IS '字段中文标签，表单展示用。示例：工作地点、日薪标准。可空。';
COMMENT ON COLUMN fe_draft_field.field_value IS '简单文本类型字段值。用户输入或 AI 填充时写入。可空；复杂结构用 value_json。';
COMMENT ON COLUMN fe_draft_field.value_json IS '复杂类型字段 JSON 值，如多选、地址对象。可空。';
COMMENT ON COLUMN fe_draft_field.source IS '字段值来源，前端展示可信度。枚举：enterprise_profile=企业画像；history_preference=历史偏好；default=系统默认；user_input=用户输入；ai_inferred=AI 推断。非空，默认 ai_inferred。';
COMMENT ON COLUMN fe_draft_field.editable IS '用户是否可在草稿编辑页修改该字段。非空，默认 TRUE；系统锁定字段置 FALSE。';
COMMENT ON COLUMN fe_draft_field.is_default IS '是否 AI/系统默认生成未经用户修改，前端展示「默认」角标。非空，默认 FALSE。';
COMMENT ON COLUMN fe_draft_field.create_time IS '字段记录创建时间。非空。';
COMMENT ON COLUMN fe_draft_field.update_time IS '字段值变更时更新。非空。';

COMMENT ON TABLE fe_draft_cost_snapshot IS '草稿成本对比快照表，一次测算为同一草稿生成多行（current + plan_1/2/3）。核心指标：企业总支出、人均成本、员工到手；一对多关联 fe_draft_cost_detail。';
COMMENT ON COLUMN fe_draft_cost_snapshot.id IS '表主键，自增。成本引擎每次全量测算时批量插入。非空。';
COMMENT ON COLUMN fe_draft_cost_snapshot.draft_id IS '关联草稿，外键 REFERENCES fe_employment_draft(id)。非空；索引 idx_fe_cost_snapshot。';
COMMENT ON COLUMN fe_draft_cost_snapshot.plan_id IS '关联方案目录，外键 REFERENCES fe_service_plan(id)。current 行可能为空（表示非平台方案）。可空。';
COMMENT ON COLUMN fe_draft_cost_snapshot.plan_code IS '方案编码快照，防止方案后续改名影响历史展示。示例：plan_1。非空。';
COMMENT ON COLUMN fe_draft_cost_snapshot.plan_name IS '方案名称快照。示例：合规优先 (A)。非空。';
COMMENT ON COLUMN fe_draft_cost_snapshot.employer_total_outflow IS '企业总支出（元），含劳务+服务费+保险+税费等。成本引擎计算写入。非空。';
COMMENT ON COLUMN fe_draft_cost_snapshot.employer_avg_cost_per_worker IS '企业平均每人成本（元）。非空。';
COMMENT ON COLUMN fe_draft_cost_snapshot.worker_take_home_per_worker IS '员工每人预计到手（元），税后实发估算。可空。';
COMMENT ON COLUMN fe_draft_cost_snapshot.is_recommended IS '是否 AI/规则推荐的优选方案，前端高亮展示。非空，默认 FALSE。';
COMMENT ON COLUMN fe_draft_cost_snapshot.status_tag IS '快照数据性质标签。示例：test_only 表示使用测试费率，需向用户提示。可空。';
COMMENT ON COLUMN fe_draft_cost_snapshot.compliance_tags IS '合规标签 JSON 快照，与方案一致。可空，默认 []。';
COMMENT ON COLUMN fe_draft_cost_snapshot.notice IS '展示给用户的补充说明文案，如费率仅供参考。可空。';
COMMENT ON COLUMN fe_draft_cost_snapshot.calc_version IS '测算引擎版本号，便于回放与排障。示例：v1.2.0。可空。';
COMMENT ON COLUMN fe_draft_cost_snapshot.create_time IS '快照生成时间，同一 draft_id 下多条记录时间相近。非空。';

COMMENT ON TABLE fe_draft_cost_detail IS '成本对比费用明细细表，对应快照下劳务费、服务费、保险、税费代征等分项金额与费率。归属 fe_draft_cost_snapshot，供前端展开明细列表。';
COMMENT ON COLUMN fe_draft_cost_detail.id IS '表主键，自增。生成快照时同步插入各费用项。非空。';
COMMENT ON COLUMN fe_draft_cost_detail.snapshot_id IS '关联成本快照，外键 REFERENCES fe_draft_cost_snapshot(id)。非空；索引 idx_fe_cost_detail。';
COMMENT ON COLUMN fe_draft_cost_detail.fee_code IS '费用项编码，与 fe_service_plan_fee_rule.fee_code 对齐。示例：labor_fee、service_fee。非空。';
COMMENT ON COLUMN fe_draft_cost_detail.fee_name IS '费用项中文名。示例：劳务费、平台服务费。非空。';
COMMENT ON COLUMN fe_draft_cost_detail.amount IS '该费用项金额（元），NUMERIC(14,2)。非空。';
COMMENT ON COLUMN fe_draft_cost_detail.rate IS '适用费率或系数，NUMERIC(8,4)。可空；固定额费用项无费率。';
COMMENT ON COLUMN fe_draft_cost_detail.sort_order IS '明细列表展示顺序。非空，默认 0。';

COMMENT ON TABLE fe_employment_order IS '用工订单主表，草稿确认并选定方案后生成，承载办理全流程业务状态与登记进度冗余统计。current_step_code 驱动合规状态机；关联 fe_enterprise、fe_employment_draft、fe_service_plan，一对多关联登记批次与结算单。';
COMMENT ON COLUMN fe_employment_order.id IS '表主键，自增。草稿确认接口成功时创建。非空。';
COMMENT ON COLUMN fe_employment_order.order_no IS '订单业务编号，企业主可见。示例：2024-001、ORD20260707001。非空；唯一索引 uk_fe_order_no。';
COMMENT ON COLUMN fe_employment_order.enterprise_id IS '所属企业，外键 REFERENCES fe_enterprise(id)。非空；索引 idx_fe_order_ent。';
COMMENT ON COLUMN fe_employment_order.draft_id IS '来源草稿，外键 REFERENCES fe_employment_draft(id)。确认时写入，追溯对话与方案选择。可空（极少数后台直创订单）。';
COMMENT ON COLUMN fe_employment_order.selected_plan_id IS '确认选用的用工方案，外键 REFERENCES fe_service_plan(id)。草稿确认时从 draft.selected_plan_id 复制。可空；应尽早补齐。';
COMMENT ON COLUMN fe_employment_order.title IS '订单标题，通常继承草稿标题。非空。';
COMMENT ON COLUMN fe_employment_order.worker_count IS '计划用工人数。非空；与登记批次 expected_count 对齐。';
COMMENT ON COLUMN fe_employment_order.work_days IS '工作天数。可空。';
COMMENT ON COLUMN fe_employment_order.work_type IS '岗位类型。可空。';
COMMENT ON COLUMN fe_employment_order.work_location IS '工作地点。可空。';
COMMENT ON COLUMN fe_employment_order.work_start_date IS '开工日期。可空。';
COMMENT ON COLUMN fe_employment_order.work_end_date IS '结束日期。可空。';
COMMENT ON COLUMN fe_employment_order.order_status IS '订单业务状态，与合规步骤联动但可更细粒度。示例：confirmed、in_progress、settling、completed。非空，默认 confirmed。';
COMMENT ON COLUMN fe_employment_order.current_step_code IS '当前合规流程步骤编码，对应 fe_workflow_step.step_code。状态机推进时更新。非空，默认 plan_confirmed。';
COMMENT ON COLUMN fe_employment_order.registered_count IS '已登记人数冗余统计，登记完成时由应用层累加。非空，默认 0；与 fe_worker_registration 定期校准。';
COMMENT ON COLUMN fe_employment_order.pending_count IS '待登记人数冗余统计。非空，默认 0。';
COMMENT ON COLUMN fe_employment_order.abnormal_count IS '资料异常/核验失败人数。非空，默认 0。';
COMMENT ON COLUMN fe_employment_order.total_outflow IS '预计或实际企业总支出（元）。结算完成后更新为实际值。可空。';
COMMENT ON COLUMN fe_employment_order.create_time IS '订单创建时间。非空。';
COMMENT ON COLUMN fe_employment_order.update_time IS '订单状态或统计变更时更新。非空。';
COMMENT ON COLUMN fe_employment_order.del_flag IS '逻辑删除标记。枚举：0=正常；1=已删除。非空，默认 0。';

COMMENT ON TABLE fe_registration_batch IS '临时工扫码登记批次表，草稿确认方案后生成，含 H5/小程序登记链接、二维码图片与有效期。企业主在进度页查看登记统计；一对多关联 fe_worker_registration。';
COMMENT ON COLUMN fe_registration_batch.id IS '表主键，自增。订单进入登记步骤时由后端创建。非空。';
COMMENT ON COLUMN fe_registration_batch.batch_no IS '登记批次业务编号。示例：BATCH-001。非空；唯一索引 uk_fe_batch_no。';
COMMENT ON COLUMN fe_registration_batch.order_id IS '关联用工订单，外键 REFERENCES fe_employment_order(id)。非空；索引 idx_fe_batch_order。';
COMMENT ON COLUMN fe_registration_batch.enterprise_id IS '所属企业，外键 REFERENCES fe_enterprise(id)。冗余便于按企业查批次。非空。';
COMMENT ON COLUMN fe_registration_batch.expected_count IS '本批次预期登记人数，通常等于订单 worker_count。非空。';
COMMENT ON COLUMN fe_registration_batch.registered_count IS '已登记总数（含进行中），冗余统计。非空，默认 0。';
COMMENT ON COLUMN fe_registration_batch.pending_count IS '尚未开始登记人数。非空，默认 0。';
COMMENT ON COLUMN fe_registration_batch.in_progress_count IS '登记进行中人数（已打开页面未提交）。非空，默认 0。';
COMMENT ON COLUMN fe_registration_batch.completed_count IS '登记已完成人数。非空，默认 0。';
COMMENT ON COLUMN fe_registration_batch.abnormal_count IS '登记异常人数（核验失败等）。非空，默认 0。';
COMMENT ON COLUMN fe_registration_batch.registration_url IS '临时工登记页链接（H5 或小程序 path）。批次创建时由链接服务生成。可空；需配合 qr_token 校验。';
COMMENT ON COLUMN fe_registration_batch.qr_code_url IS '登记二维码图片 CDN URL。批次创建时生成。可空。';
COMMENT ON COLUMN fe_registration_batch.qr_token IS '扫码登记安全 token，校验链接有效性与防篡改。创建时随机生成。可空；非空时唯一索引 uk_fe_batch_token。';
COMMENT ON COLUMN fe_registration_batch.valid_from IS '二维码/链接生效时间。非空，默认 NOW()。';
COMMENT ON COLUMN fe_registration_batch.valid_until IS '失效时间，过期后拒绝新登记（已登记记录保留）。创建时按 draft.qr_valid_days 计算。非空。';
COMMENT ON COLUMN fe_registration_batch.status IS '批次状态。枚举：active=有效可登记；expired=已过期；closed=企业主手动关闭。非空，默认 active。';
COMMENT ON COLUMN fe_registration_batch.create_time IS '批次创建时间。非空。';
COMMENT ON COLUMN fe_registration_batch.update_time IS '统计或状态变更时更新。非空。';
COMMENT ON COLUMN fe_registration_batch.del_flag IS '逻辑删除标记。枚举：0=正常；1=已删除。非空，默认 0。';

COMMENT ON TABLE fe_order_workflow_log IS '订单合规流程状态变更日志表，记录状态机每一步推进的前后步骤、操作人与备注，构成五流合一合规证据链。关联 fe_employment_order，operator_id 可引用 fe_user。';
COMMENT ON COLUMN fe_order_workflow_log.id IS '表主键，自增。每次步骤推进时追加写入，不可修改。非空。';
COMMENT ON COLUMN fe_order_workflow_log.order_id IS '关联订单，外键 REFERENCES fe_employment_order(id)。非空；索引 idx_fe_order_wf_log。';
COMMENT ON COLUMN fe_order_workflow_log.from_step IS '变更前合规步骤编码。首次创建订单时可为空。可空。';
COMMENT ON COLUMN fe_order_workflow_log.to_step IS '变更后合规步骤编码，对应 fe_workflow_step.step_code。非空。';
COMMENT ON COLUMN fe_order_workflow_log.from_status IS '变更前订单业务状态 order_status。可空。';
COMMENT ON COLUMN fe_order_workflow_log.to_status IS '变更后订单业务状态。非空。';
COMMENT ON COLUMN fe_order_workflow_log.operator_id IS '操作人用户 ID，外键 REFERENCES fe_user(id)。系统自动推进时为 NULL。可空。';
COMMENT ON COLUMN fe_order_workflow_log.operator_type IS '操作方类型。枚举：system=系统自动；enterprise=企业主/管理员；worker=临时工；provider=第三方合作平台。非空，默认 system。';
COMMENT ON COLUMN fe_order_workflow_log.remark IS '变更说明，如「登记人数已达预期，自动推进」。可空。';
COMMENT ON COLUMN fe_order_workflow_log.extra_json IS '扩展上下文 JSON，如触发条件、关联合格人数。可空。';
COMMENT ON COLUMN fe_order_workflow_log.create_time IS '变更发生时间，审计时间轴依据。非空。';

COMMENT ON TABLE fe_worker IS '临时工自然人档案主表，跨登记批次复用，避免重复录入身份证与银行卡。身份证、银行卡、手机号均加密存储（*_enc），列表仅展示脱敏值（*_mask）；可关联 fe_user 实现微信绑定。';
COMMENT ON COLUMN fe_worker.id IS '表主键，自增。首次登记提交且实名核验通过后创建或匹配已有档案。非空。';
COMMENT ON COLUMN fe_worker.user_id IS '关联微信用户，外键 REFERENCES fe_user(id)。临时工首次扫码授权微信后绑定。可空；未授权前仅通过身份证匹配。';
COMMENT ON COLUMN fe_worker.worker_no IS '临时工业务编号，平台内唯一标识。档案创建时生成。示例：WK20260001。可空。';
COMMENT ON COLUMN fe_worker.real_name IS '临时工真实姓名，与身份证一致。登记提交时写入。非空。';
COMMENT ON COLUMN fe_worker.id_card_no_enc IS '身份证号加密密文。登记页提交时应用层加密写入。非空；高度敏感，禁止明文。';
COMMENT ON COLUMN fe_worker.id_card_no_mask IS '身份证号脱敏展示。示例：310***********1234。可空；列表与结算明细使用。';
COMMENT ON COLUMN fe_worker.mobile_enc IS '手机号加密密文。登记时写入。非空；高度敏感。';
COMMENT ON COLUMN fe_worker.mobile_mask IS '手机号脱敏。示例：138****1234。可空。';
COMMENT ON COLUMN fe_worker.bank_account_enc IS '银行卡号加密密文，用于打款。登记时写入。可空；高度敏感。';
COMMENT ON COLUMN fe_worker.bank_account_mask IS '银行卡号脱敏。示例：6222****5678。可空。';
COMMENT ON COLUMN fe_worker.bank_name IS '开户银行名称。示例：中国工商银行。可空。';
COMMENT ON COLUMN fe_worker.bank_branch IS '开户支行名称。可空。';
COMMENT ON COLUMN fe_worker.verify_status IS '实名/人脸核验状态。枚举：pending=待核验；passed=通过；failed=失败。非空，默认 pending；failed 时登记流程阻断。';
COMMENT ON COLUMN fe_worker.verify_message IS '核验失败原因说明，展示给临时工重试。示例：光线不足导致人脸比对失败。可空。';
COMMENT ON COLUMN fe_worker.create_time IS '档案创建时间。非空。';
COMMENT ON COLUMN fe_worker.update_time IS '档案信息或核验状态变更时更新。非空。';
COMMENT ON COLUMN fe_worker.del_flag IS '逻辑删除标记。枚举：0=正常；1=已删除。非空，默认 0。';

COMMENT ON TABLE fe_worker_registration IS '批次登记记录表，记录每个临时工在某一 fe_registration_batch 下的一次登记全过程。reg_status 驱动进度页统计、催办与审核；关联 fe_worker 档案，敏感证件信息加密存储。';
COMMENT ON COLUMN fe_worker_registration.id IS '表主键，自增。临时工打开登记页或提交时创建。非空。';
COMMENT ON COLUMN fe_worker_registration.batch_id IS '所属登记批次，外键 REFERENCES fe_registration_batch(id)。非空；索引 idx_fe_worker_reg_batch。';
COMMENT ON COLUMN fe_worker_registration.order_id IS '关联订单，外键 REFERENCES fe_employment_order(id)。冗余便于按订单查登记列表。非空；索引 idx_fe_worker_reg_order。';
COMMENT ON COLUMN fe_worker_registration.enterprise_id IS '所属企业，外键 REFERENCES fe_enterprise(id)。冗余。非空。';
COMMENT ON COLUMN fe_worker_registration.worker_id IS '关联临时工档案，外键 REFERENCES fe_worker(id)。提交成功且匹配/创建档案后绑定。可空（登记进行中）。';
COMMENT ON COLUMN fe_worker_registration.real_name IS '本次登记填写的姓名。非空；可能与 worker 档案后续同步。';
COMMENT ON COLUMN fe_worker_registration.mobile_enc IS '登记手机号密文。提交时加密写入。可空；高度敏感。';
COMMENT ON COLUMN fe_worker_registration.mobile_mask IS '登记手机号脱敏。可空。';
COMMENT ON COLUMN fe_worker_registration.id_card_no_enc IS '登记身份证密文。可空；高度敏感。';
COMMENT ON COLUMN fe_worker_registration.bank_account_enc IS '登记银行卡密文。可空；高度敏感。';
COMMENT ON COLUMN fe_worker_registration.confirmed_work_type IS '临时工确认的工种或具体任务描述。提交时勾选或填写。可空。';
COMMENT ON COLUMN fe_worker_registration.reg_status IS '登记流程状态。枚举：pending=待登记（占位）；registering=填写中；completed=已完成；verify_failed=实名核验失败；under_review=待企业审核。非空，默认 pending。';
COMMENT ON COLUMN fe_worker_registration.fail_reason IS '失败或企业驳回原因。可空。';
COMMENT ON COLUMN fe_worker_registration.submitted_at IS '临时工点击提交时间。可空。';
COMMENT ON COLUMN fe_worker_registration.reviewed_at IS '企业审核完成时间。可空。';
COMMENT ON COLUMN fe_worker_registration.reviewed_by IS '审核人，外键 REFERENCES fe_user(id)。可空。';
COMMENT ON COLUMN fe_worker_registration.remind_count IS '企业主催办次数，每次催办 +1。非空，默认 0。';
COMMENT ON COLUMN fe_worker_registration.last_remind_at IS '最近一次催办时间。可空。';
COMMENT ON COLUMN fe_worker_registration.create_time IS '登记记录创建时间。非空。';
COMMENT ON COLUMN fe_worker_registration.update_time IS '状态或资料变更时更新。非空。';
COMMENT ON COLUMN fe_worker_registration.del_flag IS '逻辑删除标记。枚举：0=正常；1=已删除。非空，默认 0。';

COMMENT ON TABLE fe_worker_consent IS '临时工协议授权确认表，记录勾选电子劳动合同、隐私政策、信息授权等合规留痕。含同意时间、客户端 IP 与 UA，满足电子证据要求；关联 fe_worker_registration。';
COMMENT ON COLUMN fe_worker_consent.id IS '表主键，自增。临时工勾选协议并提交时插入。非空。';
COMMENT ON COLUMN fe_worker_consent.registration_id IS '关联登记记录，外键 REFERENCES fe_worker_registration(id)。非空；索引 idx_fe_worker_consent。';
COMMENT ON COLUMN fe_worker_consent.worker_id IS '关联临时工档案，外键 REFERENCES fe_worker(id)。档案绑定后写入。可空。';
COMMENT ON COLUMN fe_worker_consent.consent_type IS '协议类型。枚举：labor_contract=电子劳动合同；privacy_policy=隐私政策；authorization=个人信息处理授权。非空。';
COMMENT ON COLUMN fe_worker_consent.consent_version IS '协议版本号，对应法务发布的协议版本。示例：v2.1。可空。';
COMMENT ON COLUMN fe_worker_consent.consent_title IS '协议标题展示文案。示例：《灵活用工电子劳动合同》。可空。';
COMMENT ON COLUMN fe_worker_consent.agreed IS '是否勾选同意。非空，默认 FALSE；提交时须为 TRUE 否则阻断。';
COMMENT ON COLUMN fe_worker_consent.agreed_at IS '用户点击同意的时间戳。可空；提交成功时必填。';
COMMENT ON COLUMN fe_worker_consent.client_ip IS '客户端 IP 地址，合规取证。网关层提取写入。可空。';
COMMENT ON COLUMN fe_worker_consent.user_agent IS '客户端 User-Agent 字符串。可空；最长 500 字符。';
COMMENT ON COLUMN fe_worker_consent.create_time IS '记录入库时间。非空。';

COMMENT ON TABLE fe_contract IS '电子劳动合同表，合规流程「合同签署」节点核心数据。一人一登记一条合同；MVP 阶段 sign_provider 可用 mock，对接电子签平台后替换。关联 fe_employment_order、fe_worker_registration、fe_worker。';
COMMENT ON COLUMN fe_contract.id IS '表主键，自增。登记完成进入合同签署步骤时创建。非空。';
COMMENT ON COLUMN fe_contract.contract_no IS '合同业务编号。示例：CT20260707001。非空；唯一索引 uk_fe_contract_no。';
COMMENT ON COLUMN fe_contract.order_id IS '关联订单，外键 REFERENCES fe_employment_order(id)。非空；索引 idx_fe_contract_order。';
COMMENT ON COLUMN fe_contract.registration_id IS '关联登记记录（一人一合同），外键 REFERENCES fe_worker_registration(id)。可空；建议必填。';
COMMENT ON COLUMN fe_contract.worker_id IS '签约临时工，外键 REFERENCES fe_worker(id)。可空。';
COMMENT ON COLUMN fe_contract.enterprise_id IS '签约企业，外键 REFERENCES fe_enterprise(id)。非空。';
COMMENT ON COLUMN fe_contract.contract_type IS '合同类型编码。非空，默认 labor（劳动合同）。';
COMMENT ON COLUMN fe_contract.contract_title IS '合同标题。示例：劳务派遣协议-张三。可空。';
COMMENT ON COLUMN fe_contract.sign_status IS '签署状态。枚举：pending=待签署；signing=签署中；signed=已签署；rejected=拒签；expired=已过期。非空，默认 pending。';
COMMENT ON COLUMN fe_contract.sign_provider IS '电子签服务商。枚举：mock=MVP 模拟；esign_partner=合作电子签平台。可空。';
COMMENT ON COLUMN fe_contract.external_contract_id IS '第三方电子签平台返回的合同 ID。对接后写入。可空。';
COMMENT ON COLUMN fe_contract.sign_url IS '临时工签署页面链接。创建合同时由签章服务返回。可空。';
COMMENT ON COLUMN fe_contract.signed_at IS '双方签署完成时间。可空。';
COMMENT ON COLUMN fe_contract.file_url IS '已签署合同 PDF 归档地址。签署完成后写入。可空。';
COMMENT ON COLUMN fe_contract.create_time IS '合同记录创建时间。非空。';
COMMENT ON COLUMN fe_contract.update_time IS '签署状态变更时更新。非空。';
COMMENT ON COLUMN fe_contract.del_flag IS '逻辑删除标记。枚举：0=正常；1=已删除。非空，默认 0。';

COMMENT ON TABLE fe_settlement_order IS '结算确认单主表，用工结束后按考勤或约定生成，展示应发/扣款/实发、服务费、开票额与企业总支出。企业确认后进入支付环节；一对多关联 fe_settlement_item、fe_settlement_fee、fe_payment_record。';
COMMENT ON COLUMN fe_settlement_order.id IS '表主键，自增。结算引擎生成结算单时创建。非空。';
COMMENT ON COLUMN fe_settlement_order.settlement_no IS '结算单业务编号。示例：STL20260707001。非空；唯一索引 uk_fe_settlement_no。';
COMMENT ON COLUMN fe_settlement_order.order_id IS '关联用工订单，外键 REFERENCES fe_employment_order(id)。非空。';
COMMENT ON COLUMN fe_settlement_order.batch_id IS '关联登记批次，外键 REFERENCES fe_registration_batch(id)。可空；多批次订单可只关联主批次。';
COMMENT ON COLUMN fe_settlement_order.enterprise_id IS '所属企业，外键 REFERENCES fe_enterprise(id)。非空；索引 idx_fe_settlement_ent。';
COMMENT ON COLUMN fe_settlement_order.worker_count IS '本次结算涵盖人数。非空。';
COMMENT ON COLUMN fe_settlement_order.gross_amount IS '应发总额（元），税前劳务合计。非空，默认 0。';
COMMENT ON COLUMN fe_settlement_order.deduction_amount IS '扣款及个税合计（元）。非空，默认 0。';
COMMENT ON COLUMN fe_settlement_order.net_amount IS '实发总额（元），临时工到手合计。非空，默认 0。';
COMMENT ON COLUMN fe_settlement_order.service_fee_amount IS '平台服务费（元）。非空，默认 0。';
COMMENT ON COLUMN fe_settlement_order.invoice_amount IS '预计开票额（元），供企业财务参考。非空，默认 0。';
COMMENT ON COLUMN fe_settlement_order.total_outflow IS '企业总支出（元）= 实发 + 服务费 + 税费等。非空，默认 0。';
COMMENT ON COLUMN fe_settlement_order.settlement_status IS '结算单状态。枚举：pending=待企业确认；confirmed=已确认待支付；paying=支付中；paid=已支付；cancelled=已取消。非空，默认 pending。';
COMMENT ON COLUMN fe_settlement_order.compliance_tags IS '五流合一合规校验结果标签 JSON。示例：["个税已申报","发票合规"]。可空，默认 []。';
COMMENT ON COLUMN fe_settlement_order.compliance_remark IS '合规说明文案。示例：可全额税前扣除。可空。';
COMMENT ON COLUMN fe_settlement_order.confirmed_at IS '企业主确认结算单时间。可空。';
COMMENT ON COLUMN fe_settlement_order.confirmed_by IS '确认人，外键 REFERENCES fe_user(id)。可空。';
COMMENT ON COLUMN fe_settlement_order.paid_at IS '支付完成时间，全部打款成功后写入。可空。';
COMMENT ON COLUMN fe_settlement_order.create_time IS '结算单生成时间。非空。';
COMMENT ON COLUMN fe_settlement_order.update_time IS '状态或金额变更时更新。非空。';
COMMENT ON COLUMN fe_settlement_order.del_flag IS '逻辑删除标记。枚举：0=正常；1=已删除。非空，默认 0。';

COMMENT ON TABLE fe_settlement_item IS '结算单人明细表，按临时工拆分应发、个税、其他扣款与实发金额。支持按天、按小时、计件多种计量维度；关联 fe_settlement_order、fe_worker_registration、fe_worker。';
COMMENT ON COLUMN fe_settlement_item.id IS '表主键，自增。生成结算单时按登记记录逐人插入。非空。';
COMMENT ON COLUMN fe_settlement_item.settlement_id IS '关联结算单，外键 REFERENCES fe_settlement_order(id)。非空；索引 idx_fe_settlement_item。';
COMMENT ON COLUMN fe_settlement_item.registration_id IS '关联登记记录，外键 REFERENCES fe_worker_registration(id)。可空；建议必填以追溯人员。';
COMMENT ON COLUMN fe_settlement_item.worker_id IS '关联临时工档案，外键 REFERENCES fe_worker(id)。可空。';
COMMENT ON COLUMN fe_settlement_item.worker_name_mask IS '姓名脱敏展示，如张*三。可空；禁止存明文全名。';
COMMENT ON COLUMN fe_settlement_item.work_days IS '结算工作天数，NUMERIC(8,2)。可空。';
COMMENT ON COLUMN fe_settlement_item.work_hours IS '结算工作小时数。可空。';
COMMENT ON COLUMN fe_settlement_item.piece_count IS '计件数量。可空。';
COMMENT ON COLUMN fe_settlement_item.gross_amount IS '该人员应发金额（元）。非空，默认 0。';
COMMENT ON COLUMN fe_settlement_item.tax_amount IS '个税扣款（元）。非空，默认 0。';
COMMENT ON COLUMN fe_settlement_item.other_deduction IS '其他扣款（元），如工装赔偿。非空，默认 0。';
COMMENT ON COLUMN fe_settlement_item.net_amount IS '该人员实发金额（元）。非空，默认 0。';
COMMENT ON COLUMN fe_settlement_item.item_status IS '明细行状态。示例：pending、confirmed、paid。非空，默认 pending。';
COMMENT ON COLUMN fe_settlement_item.create_time IS '明细创建时间。非空。';
COMMENT ON COLUMN fe_settlement_item.update_time IS '明细金额调整时更新。非空。';

COMMENT ON TABLE fe_settlement_fee IS '结算单费用汇总项表，订单级劳务费、服务费、保险、税费等分项金额，对应小程序「资金总览」模块。归属 fe_settlement_order，结构与 fe_draft_cost_detail 类似但为实际结算数据。';
COMMENT ON COLUMN fe_settlement_fee.id IS '表主键，自增。结算单生成时同步写入各费用分项。非空。';
COMMENT ON COLUMN fe_settlement_fee.settlement_id IS '关联结算单，外键 REFERENCES fe_settlement_order(id)。非空；索引 idx_fe_settlement_fee。';
COMMENT ON COLUMN fe_settlement_fee.fee_code IS '费用项编码。示例：labor_fee、service_fee、insurance、tax_withhold。非空。';
COMMENT ON COLUMN fe_settlement_fee.fee_name IS '费用项中文名。非空。';
COMMENT ON COLUMN fe_settlement_fee.amount IS '费用金额（元），NUMERIC(14,2)。非空。';
COMMENT ON COLUMN fe_settlement_fee.rate IS '适用费率，NUMERIC(8,4)。可空。';
COMMENT ON COLUMN fe_settlement_fee.sort_order IS '资金总览展示顺序。非空，默认 0。';

COMMENT ON TABLE fe_payment_record IS '支付/打款记录表，企业确认结算后发起付款，记录渠道、金额、第三方交易流水与凭证。小程序仅展示 payment_channel 渠道类型，不展示对公账户；关联 fe_settlement_order、fe_enterprise。';
COMMENT ON COLUMN fe_payment_record.id IS '表主键，自增。发起支付时创建。非空。';
COMMENT ON COLUMN fe_payment_record.payment_no IS '支付单业务编号。示例：PAY20260707001。非空；唯一索引 uk_fe_payment_no。';
COMMENT ON COLUMN fe_payment_record.settlement_id IS '关联结算单，外键 REFERENCES fe_settlement_order(id)。非空；索引 idx_fe_payment_settlement。';
COMMENT ON COLUMN fe_payment_record.enterprise_id IS '付款企业，外键 REFERENCES fe_enterprise(id)。非空。';
COMMENT ON COLUMN fe_payment_record.payment_channel IS '支付渠道类型，前端仅展示此字段。枚举：wechat=微信支付；alipay=支付宝；bank=银行转账。非空。';
COMMENT ON COLUMN fe_payment_record.payment_amount IS '支付金额（元）。非空。';
COMMENT ON COLUMN fe_payment_record.payment_status IS '支付状态。枚举：pending=处理中；success=成功；failed=失败；refunded=已退款。非空，默认 pending。';
COMMENT ON COLUMN fe_payment_record.external_trade_no IS '微信/支付宝/银行等第三方交易流水号。支付回调成功时写入。可空。';
COMMENT ON COLUMN fe_payment_record.payer_user_id IS '发起付款的企业主用户，外键 REFERENCES fe_user(id)。可空。';
COMMENT ON COLUMN fe_payment_record.paid_at IS '支付成功时间戳。可空。';
COMMENT ON COLUMN fe_payment_record.receipt_url IS '支付凭证或回单下载地址。可空。';
COMMENT ON COLUMN fe_payment_record.fail_reason IS '支付失败原因。可空。';
COMMENT ON COLUMN fe_payment_record.create_time IS '支付单创建时间。非空。';
COMMENT ON COLUMN fe_payment_record.update_time IS '状态变更时更新。非空。';

COMMENT ON TABLE fe_attendance_batch IS '考勤日报批次表（二期功能），按登记批次与日期汇总当日应考勤人数、出勤/加班/请假统计及预估费用。一期 MVP 可不实现业务逻辑，表结构先行预留；关联 fe_registration_batch、fe_employment_order。';
COMMENT ON COLUMN fe_attendance_batch.id IS '表主键，自增。每日定时任务或企业主手动生成日报时创建。非空。';
COMMENT ON COLUMN fe_attendance_batch.batch_id IS '关联登记批次，外键 REFERENCES fe_registration_batch(id)。非空；与 attendance_date 组成唯一索引 uk_fe_attendance_batch。';
COMMENT ON COLUMN fe_attendance_batch.order_id IS '关联订单，外键 REFERENCES fe_employment_order(id)。冗余便于订单维度查考勤。非空。';
COMMENT ON COLUMN fe_attendance_batch.attendance_date IS '考勤统计日期，DATE 类型。示例：2026-08-15。非空。';
COMMENT ON COLUMN fe_attendance_batch.total_workers IS '当日应考勤人数。非空，默认 0。';
COMMENT ON COLUMN fe_attendance_batch.normal_count IS '正常出勤人数。非空，默认 0。';
COMMENT ON COLUMN fe_attendance_batch.overtime_count IS '加班人数。非空，默认 0。';
COMMENT ON COLUMN fe_attendance_batch.leave_count IS '请假人数。非空，默认 0。';
COMMENT ON COLUMN fe_attendance_batch.total_hours IS '当日总工时（小时）。可空，默认 0。';
COMMENT ON COLUMN fe_attendance_batch.total_pieces IS '当日总计件数。可空，默认 0。';
COMMENT ON COLUMN fe_attendance_batch.estimated_cost IS '当日预估劳务费用（元）。可空，默认 0。';
COMMENT ON COLUMN fe_attendance_batch.status IS '日报状态。枚举：draft=草稿可编辑；confirmed=已确认锁定；archived=已归档。非空，默认 draft。';
COMMENT ON COLUMN fe_attendance_batch.confirmed_by IS '确认人，外键 REFERENCES fe_user(id)。企业主确认日报时写入。可空。';
COMMENT ON COLUMN fe_attendance_batch.confirmed_at IS '日报确认时间。可空。';
COMMENT ON COLUMN fe_attendance_batch.create_time IS '日报创建时间。非空。';
COMMENT ON COLUMN fe_attendance_batch.update_time IS '考勤数据变更时更新。非空。';

COMMENT ON TABLE fe_attendance_record IS '考勤明细表（二期），记录单人单日考勤类型（正常/加班/请假/计件）、工时与计件数。支持 manual/voice/import 多种录入来源；关联 fe_attendance_batch、fe_worker_registration、fe_worker。';
COMMENT ON COLUMN fe_attendance_record.id IS '表主键，自增。录入或导入单人考勤时插入。非空。';
COMMENT ON COLUMN fe_attendance_record.attendance_batch_id IS '关联考勤日报，外键 REFERENCES fe_attendance_batch(id)。非空；索引 idx_fe_attendance_rec。';
COMMENT ON COLUMN fe_attendance_record.registration_id IS '关联登记记录，外键 REFERENCES fe_worker_registration(id)。非空；确定考勤对象。';
COMMENT ON COLUMN fe_attendance_record.worker_id IS '关联临时工档案，外键 REFERENCES fe_worker(id)。可空；冗余加速查询。';
COMMENT ON COLUMN fe_attendance_record.attendance_type IS '考勤类型。枚举：normal=正常出勤；overtime=加班；leave=请假；piece=计件产量。非空，默认 normal。';
COMMENT ON COLUMN fe_attendance_record.work_hours IS '正常工作小时数，NUMERIC(8,2)。可空。';
COMMENT ON COLUMN fe_attendance_record.overtime_hours IS '加班小时数。可空。';
COMMENT ON COLUMN fe_attendance_record.piece_count IS '计件数量。可空。';
COMMENT ON COLUMN fe_attendance_record.remark IS '考勤备注，如请假原因。可空。';
COMMENT ON COLUMN fe_attendance_record.source IS '录入来源。枚举：manual=手工录入；voice=语音录入（AI 解析）；import=批量导入。可空，默认 manual。';
COMMENT ON COLUMN fe_attendance_record.create_time IS '记录创建时间。非空。';
COMMENT ON COLUMN fe_attendance_record.update_time IS '考勤数据修改时更新。非空。';

COMMENT ON TABLE fe_user_confirmation IS '用户确认与授权留痕表，草稿确认、方案选择、结算支付、外部平台提交等高风险操作必须写入，满足审计与合规举证。关联 fe_enterprise、fe_user，可引用 fe_service_plan。';
COMMENT ON COLUMN fe_user_confirmation.id IS '表主键，自增。用户执行确认类操作时同步插入，不可篡改。非空。';
COMMENT ON COLUMN fe_user_confirmation.enterprise_id IS '所属企业，外键 REFERENCES fe_enterprise(id)。非空；索引 idx_fe_user_confirm。';
COMMENT ON COLUMN fe_user_confirmation.user_id IS '操作用户，外键 REFERENCES fe_user(id)。非空；须为 enterprise 类型企业主或管理员。';
COMMENT ON COLUMN fe_user_confirmation.biz_type IS '业务场景类型。枚举：draft_confirm=确认用工草稿；plan_select=选定用工方案；settlement_pay=确认并支付结算；external_submit=授权提交第三方平台。非空。';
COMMENT ON COLUMN fe_user_confirmation.biz_id IS '关联业务主键 ID，如 draft_id、settlement_id。非空；与 biz_type 组合解析。';
COMMENT ON COLUMN fe_user_confirmation.biz_no IS '关联业务编号冗余，便于人工审计。示例：draft_001。可空。';
COMMENT ON COLUMN fe_user_confirmation.action IS '用户动作类型。枚举：confirm=确认；modify=修改后确认；authorize=授权。非空。';
COMMENT ON COLUMN fe_user_confirmation.confirmed_fields IS '用户确认时的关键字段快照 JSON，固化确认瞬间数据。示例：{"worker_count":15,"daily_wage":280}。可空，默认 {}。';
COMMENT ON COLUMN fe_user_confirmation.selected_plan_id IS '确认选用的方案，外键 REFERENCES fe_service_plan(id)。biz_type=plan_select 或 draft_confirm 时写入。可空。';
COMMENT ON COLUMN fe_user_confirmation.client_ip IS '客户端 IP，合规取证。网关提取。可空。';
COMMENT ON COLUMN fe_user_confirmation.user_agent IS '客户端 UA 字符串。可空。';
COMMENT ON COLUMN fe_user_confirmation.remark IS '用户填写的备注或系统附注。可空。';
COMMENT ON COLUMN fe_user_confirmation.create_time IS '确认操作发生时间。非空。';

COMMENT ON TABLE fe_field_change_log IS '关键字段变更历史表，记录草稿、订单、登记等业务对象重要字段的修改前后值，区分用户手工编辑、自然语言修改、AI 重新生成与系统自动变更，支撑争议追溯。';
COMMENT ON COLUMN fe_field_change_log.id IS '表主键，自增。字段值发生变更时追加写入。非空。';
COMMENT ON COLUMN fe_field_change_log.biz_type IS '业务对象类型。枚举：draft=用工草稿；order=用工订单；registration=登记记录。非空。';
COMMENT ON COLUMN fe_field_change_log.biz_id IS '业务对象主键 ID。非空；与 biz_type 组合查询；索引 idx_fe_field_change。';
COMMENT ON COLUMN fe_field_change_log.field_key IS '被变更字段键名。示例：work_location、daily_wage。非空。';
COMMENT ON COLUMN fe_field_change_log.old_value IS '变更前的文本值。可空；首次填入时 old_value 为空。';
COMMENT ON COLUMN fe_field_change_log.new_value IS '变更后的文本值。可空。';
COMMENT ON COLUMN fe_field_change_log.change_source IS '变更来源。枚举：user_edit=用户表单编辑；nl_edit=自然语言对话修改；ai_regenerate=AI 重新生成草稿；system=系统自动（如状态联动）。非空。';
COMMENT ON COLUMN fe_field_change_log.operator_id IS '操作人，外键 REFERENCES fe_user(id)。系统自动变更时可为空。可空。';
COMMENT ON COLUMN fe_field_change_log.create_time IS '变更发生时间。非空。';

COMMENT ON TABLE fe_provider IS '第三方灵活用工/税筹合作平台连接器配置表，存储 API 根地址与加密鉴权信息。不对小程序用户暴露；被 fe_provider_api_log 引用，一期可采用 Mock 打桩。';
COMMENT ON COLUMN fe_provider.id IS '表主键，自增。运营接入新合作平台时创建。非空。';
COMMENT ON COLUMN fe_provider.provider_code IS '平台业务编码，全局唯一。示例：partner_platform、tax_partner_a。非空；唯一索引 uk_fe_provider_code。';
COMMENT ON COLUMN fe_provider.provider_name IS '平台展示名称。非空。';
COMMENT ON COLUMN fe_provider.api_base_url IS '第三方 API 根地址。示例：https://api.partner.com/v1。可空。';
COMMENT ON COLUMN fe_provider.auth_config_enc IS 'API Key、Secret 等鉴权配置 JSON 的加密密文。运营配置时加密写入。高度敏感；禁止明文与前端暴露。可空。';
COMMENT ON COLUMN fe_provider.status IS '连接器启用状态。枚举：active=启用；disabled=停用。非空，默认 active。';
COMMENT ON COLUMN fe_provider.create_time IS '配置创建时间。非空。';
COMMENT ON COLUMN fe_provider.update_time IS '配置变更时更新。非空。';

COMMENT ON TABLE fe_provider_api_log IS '合作平台 API 调用日志表，保存原始 HTTP 请求响应、技术状态码与转换后的业务状态 biz_status。技术细节不对用户展示；audit_required 标识是否需用户确认后才能继续推进订单流程。';
COMMENT ON COLUMN fe_provider_api_log.id IS '表主键，自增。每次调用第三方 API 时追加。非空。';
COMMENT ON COLUMN fe_provider_api_log.provider_id IS '合作平台，外键 REFERENCES fe_provider(id)。非空；索引 idx_fe_provider_log。';
COMMENT ON COLUMN fe_provider_api_log.enterprise_id IS '关联企业，外键 REFERENCES fe_enterprise(id)。调用上下文企业。可空。';
COMMENT ON COLUMN fe_provider_api_log.order_id IS '关联订单，外键 REFERENCES fe_employment_order(id)。可空；索引 idx_fe_provider_log_order。';
COMMENT ON COLUMN fe_provider_api_log.action IS 'API 动作编码。示例：create_requirement=创建用工需求；query_status=查询办理状态；callback=异步回调。非空。';
COMMENT ON COLUMN fe_provider_api_log.request_payload IS '请求体 JSON 快照。可空；可能含敏感业务数据，访问受控。';
COMMENT ON COLUMN fe_provider_api_log.response_payload IS '响应体 JSON 快照。可空。';
COMMENT ON COLUMN fe_provider_api_log.http_status IS 'HTTP 响应状态码。示例：200、500。可空。';
COMMENT ON COLUMN fe_provider_api_log.biz_status IS '将技术响应映射后的业务状态，供订单状态机消费。示例：submitted、approved、rejected。可空。';
COMMENT ON COLUMN fe_provider_api_log.audit_required IS '是否需企业主在用户侧确认后才能继续流程。第三方返回待确认时置 TRUE。非空，默认 FALSE。';
COMMENT ON COLUMN fe_provider_api_log.error_message IS '调用失败错误信息。可空。';
COMMENT ON COLUMN fe_provider_api_log.duration_ms IS '请求耗时（毫秒）。可空。';
COMMENT ON COLUMN fe_provider_api_log.create_time IS '调用时间。非空。';

COMMENT ON TABLE fe_notification IS '消息与待办中心表，推送结算待确认、实名失败、登记进度、流程节点变更等通知。支持 action_url 跳转小程序对应页面/弹窗；关联 fe_enterprise、fe_user，通过 read_flag 与 handled_flag 区分已读与已办。';
COMMENT ON COLUMN fe_notification.id IS '表主键，自增。业务事件触发时由通知服务写入。非空。';
COMMENT ON COLUMN fe_notification.enterprise_id IS '所属企业，外键 REFERENCES fe_enterprise(id)。企业维度消息筛选。可空；索引 idx_fe_notification_ent。';
COMMENT ON COLUMN fe_notification.user_id IS '接收用户，外键 REFERENCES fe_user(id)。可空；索引 idx_fe_notification_user；与 enterprise_id 至少其一有值。';
COMMENT ON COLUMN fe_notification.notify_type IS '通知展示样式。枚举：pending=待办（橙色）；error=异常（红色）；info=提示（蓝色）；success=成功（绿色）。非空。';
COMMENT ON COLUMN fe_notification.category IS '业务分类。枚举：settlement=结算；registration=登记；verify=实名核验；workflow=流程进度。非空。';
COMMENT ON COLUMN fe_notification.title IS '通知标题，列表主文案。非空。';
COMMENT ON COLUMN fe_notification.content IS '通知正文详细描述。可空。';
COMMENT ON COLUMN fe_notification.biz_type IS '关联业务对象类型，如 settlement、registration、order。可空。';
COMMENT ON COLUMN fe_notification.biz_id IS '关联业务主键 ID，用于跳转后加载详情。可空。';
COMMENT ON COLUMN fe_notification.biz_no IS '关联业务编号冗余。示例：STL20260707001。可空。';
COMMENT ON COLUMN fe_notification.action_url IS '小程序内跳转路径或 scheme。示例：/pages/settlement/detail?id=123。可空。';
COMMENT ON COLUMN fe_notification.read_flag IS '是否已读。用户打开消息中心或点击后更新。非空，默认 FALSE。';
COMMENT ON COLUMN fe_notification.handled_flag IS '待办是否已处理完成。用户完成对应操作后更新。非空，默认 FALSE。';
COMMENT ON COLUMN fe_notification.create_time IS '通知创建时间。非空。';
COMMENT ON COLUMN fe_notification.read_time IS '标记已读时间。可空。';
COMMENT ON COLUMN fe_notification.handled_time IS '待办完成时间。可空。';

-- -----------------------------------------------------------------------------
-- 十三、初始化数据（测试阶段默认值，正式费率以后端方案目录为准）
-- 说明：
--   1. fe_workflow_definition / fe_workflow_step : 内置合规办理九步流程
--   2. fe_service_plan : 写入 current + plan_1/2/3 四套方案，plan_1~3 标记 test_only
--   3. fe_service_plan_fee_rule : 仅为 plan_1 示例配置费用分项，正式环境需补全全部方案规则
-- -----------------------------------------------------------------------------

INSERT INTO fe_workflow_definition (workflow_code, workflow_name, description, version)
VALUES ('employment_compliance', '用工合规办理流程', '五流合一合规状态机', 1);

INSERT INTO fe_workflow_step (workflow_id, step_code, step_name, step_order, required)
SELECT id, step_code, step_name, step_order, TRUE
FROM fe_workflow_definition wd,
(VALUES
    ('draft_created',     '草稿创建',     1),
    ('plan_confirmed',    '方案确认',     2),
    ('registration',      '扫码登记',     3),
    ('enterprise_audit',  '企业审核',     4),
    ('contract_signing',  '合同签署',     5),
    ('work_started',      '开始用工',     6),
    ('settlement_pending','待结算',       7),
    ('settlement_paid',   '已支付',       8),
    ('completed',         '已完成',       9)
) AS s(step_code, step_name, step_order)
WHERE wd.workflow_code = 'employment_compliance' AND wd.version = 1;

INSERT INTO fe_service_plan (plan_code, plan_name, plan_type, description, service_fee_rate, insurance_level, compliance_tags, sort_order, status)
VALUES
    ('current', '当前处理方式',   'traditional', '企业现有处理方式估算', NULL,  NULL,      '[]', 0, 'active'),
    ('plan_1',  '合规优先 (A)',   'flexible',    '测试方案一：合规优先', 0.08, 'premium', '["业务真实","资金合规","个税申报"]', 1, 'test_only'),
    ('plan_2',  '传统用工 (B)',   'traditional', '测试方案二：传统用工', NULL,  NULL,      '[]', 2, 'test_only'),
    ('plan_3',  '成本优化 (C)',   'flexible',    '测试方案三：成本优化', 0.06, 'basic',   '["业务真实","资金合规"]', 3, 'test_only');

INSERT INTO fe_service_plan_fee_rule (plan_id, fee_code, fee_name, calc_type, default_rate, sort_order)
SELECT p.id, f.fee_code, f.fee_name, f.calc_type, f.default_rate, f.sort_order
FROM fe_service_plan p
JOIN (VALUES
    ('plan_1', 'labor_fee',    '劳务费',   'formula', NULL,  1),
    ('plan_1', 'service_fee',  '服务费',   'rate',    0.08,  2),
    ('plan_1', 'insurance',    '保险',     'fixed',   NULL,  3),
    ('plan_1', 'tax_withhold', '税费代征', 'formula', NULL,  4)
) AS f(plan_code, fee_code, fee_name, calc_type, default_rate, sort_order)
ON p.plan_code = f.plan_code;

-- -----------------------------------------------------------------------------
-- 附录 A：核心实体关系（1 对多）
--   fe_enterprise          1 --- N  fe_employment_draft / fe_employment_order
--   fe_conversation        1 --- N  fe_conversation_message
--   fe_employment_draft    1 --- N  fe_draft_field / fe_draft_cost_snapshot
--   fe_draft_cost_snapshot 1 --- N  fe_draft_cost_detail
--   fe_employment_draft    1 --- 1  fe_employment_order（确认后）
--   fe_employment_order    1 --- N  fe_registration_batch / fe_settlement_order / fe_contract
--   fe_registration_batch  1 --- N  fe_worker_registration
--   fe_worker              1 --- N  fe_worker_registration（跨批次）
--   fe_settlement_order    1 --- N  fe_settlement_item / fe_settlement_fee / fe_payment_record
--
-- 附录 B：合规状态机推进顺序
--   draft_created -> plan_confirmed -> registration -> enterprise_audit
--   -> contract_signing -> work_started -> settlement_pending -> settlement_paid -> completed
--
-- 附录 C：一期 MVP 重点表（必须实现）
--   fe_user, fe_enterprise, fe_enterprise_user, fe_conversation, fe_conversation_message
--   fe_service_plan, fe_employment_draft, fe_draft_cost_snapshot, fe_user_confirmation
--   fe_employment_order, fe_registration_batch, fe_worker_registration, fe_worker
--
-- 附录 D：二期可延后表
--   fe_attendance_batch, fe_attendance_record, fe_contract（可 Mock）, fe_provider_api_log（可 Mock）