cancan-microstack 0.0.1__py3-none-any.whl

cancan_microstack/assets/ddl/infra/execution_log_tbl.sql

@@ -0,0 +1,46 @@
+-- 执行审计日志表
+-- Stores detailed logs for each attempt of a node instance execution.
+
+BEGIN;
+
+CREATE TABLE IF NOT EXISTS execution_log_tbl (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    node_instance_id UUID NOT NULL REFERENCES node_instance_tbl(id),
+
+    attempt_no INTEGER NOT NULL,
+
+    -- Snapshots
+    request_snapshot JSONB,
+    response_snapshot JSONB,
+
+    status VARCHAR(20), -- SUCCESS, FAILURE, TIMEOUT
+    error_detail TEXT,
+
+    -- Standard fields
+    flag SMALLINT DEFAULT 0,
+    created_time TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
+    update_time TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
+
+    -- Execution-specific timestamps
+    start_time TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP,
+    end_time TIMESTAMPTZ,
+    duration_ms INTEGER
+);
+
+-- Indexes
+CREATE INDEX IF NOT EXISTS idx_exec_log_node_instance ON execution_log_tbl(node_instance_id);
+
+-- 提升按更新时间查询效率
+CREATE INDEX idx_execution_log_tbl_update_time ON execution_log_tbl (update_time);
+
+-- Comments
+COMMENT ON TABLE execution_log_tbl IS '执行审计日志表，记录每个节点实例每次尝试的详细日志';
+COMMENT ON COLUMN execution_log_tbl.attempt_no IS '第几次尝试';
+COMMENT ON COLUMN execution_log_tbl.request_snapshot IS '动作快照 (请求前)';
+COMMENT ON COLUMN execution_log_tbl.response_snapshot IS '结果快照 (响应后)';
+COMMENT ON COLUMN execution_log_tbl.status IS '执行结果状态: SUCCESS, FAILURE, TIMEOUT';
+COMMENT ON COLUMN execution_log_tbl.flag IS '标志位 (0:正常, 1:已删除)';
+COMMENT ON COLUMN execution_log_tbl.created_time IS '记录创建时间';
+COMMENT ON COLUMN execution_log_tbl.update_time IS '记录最后更新时间';
+
+COMMIT;

cancan_microstack/assets/ddl/infra/node_instance_tbl.sql

@@ -0,0 +1,56 @@
+-- 节点运行实例表
+-- Stores each execution instance of a node within a workflow run.
+
+BEGIN;
+
+CREATE TABLE IF NOT EXISTS node_instance_tbl (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    run_id UUID NOT NULL REFERENCES workflow_run_tbl(id),
+
+    -- Corresponds to the key in the JSON graph (e.g. "step_1")
+    node_id VARCHAR(50) NOT NULL,
+
+    -- Loop iteration number (defaults to 1)
+    loop_index INTEGER NOT NULL DEFAULT 1,
+
+    status VARCHAR(20) NOT NULL DEFAULT 'PENDING',
+
+    -- Data flow
+    input_data JSONB DEFAULT '{}',   -- Input parameters for this node
+    final_output JSONB DEFAULT '{}', -- Result produced by this node
+
+    -- Statistics
+    attempt_count INTEGER DEFAULT 0,
+    error_msg TEXT,
+
+    -- Standard fields
+    flag SMALLINT DEFAULT 0,
+    created_time TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
+    update_time TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Indexes
+CREATE UNIQUE INDEX IF NOT EXISTS idx_node_instance_unique ON node_instance_tbl(run_id, node_id, loop_index);
+CREATE INDEX IF NOT EXISTS idx_node_instance_run_id ON node_instance_tbl(run_id);
+CREATE INDEX IF NOT EXISTS idx_node_instance_status ON node_instance_tbl(status);
+
+-- 提升按更新时间查询效率
+CREATE INDEX idx_node_instance_tbl_update_time ON node_instance_tbl (update_time);
+
+-- Auto-update timestamp trigger
+CREATE TRIGGER t_upd_node_instance_tbl
+    BEFORE UPDATE ON node_instance_tbl
+    FOR EACH ROW
+    EXECUTE PROCEDURE upd_timestamp();
+
+-- Comments
+COMMENT ON TABLE node_instance_tbl IS '节点运行实例表，记录工作流中每个节点的执行状态';
+COMMENT ON COLUMN node_instance_tbl.loop_index IS '循环轮次 (默认为 1)';
+COMMENT ON COLUMN node_instance_tbl.input_data IS '进入该节点时的入参';
+COMMENT ON COLUMN node_instance_tbl.final_output IS '该节点产出的结果';
+COMMENT ON COLUMN node_instance_tbl.status IS '节点状态: PENDING, RUNNING, SUCCESS, FAILURE, SKIPPED, SUSPENDED, RETRYING, CANCELLED';
+COMMENT ON COLUMN node_instance_tbl.flag IS '标志位 (0:正常, 1:已删除)';
+COMMENT ON COLUMN node_instance_tbl.created_time IS '记录创建时间';
+COMMENT ON COLUMN node_instance_tbl.update_time IS '记录最后更新时间';
+
+COMMIT;

cancan_microstack/assets/ddl/infra/service_action_log_tbl.sql

@@ -0,0 +1,36 @@
+-- 服务行为日志表（service_action_log_tbl）
+-- 记录服务实例的所有关键行为：上线、下线、重启、扩缩容等
+
+CREATE TABLE IF NOT EXISTS service_action_log_tbl (
+    id SERIAL PRIMARY KEY,
+    service_name VARCHAR(100) NOT NULL,          -- 服务名称
+    instance_id VARCHAR(50),                     -- 实例ID（可为空，如果是服务级别操作）
+    action_type VARCHAR(50) NOT NULL,            -- 行为类型：register, deregister, heartbeat, health_check_fail, restart, scale, rebuild
+    action_status VARCHAR(20) NOT NULL,          -- 行为状态：success, failed, in_progress
+    action_detail JSONB DEFAULT '{}',            -- 行为详情（JSON格式）
+    error_message TEXT,                          -- 错误信息（如果失败）
+    triggered_by VARCHAR(50) DEFAULT 'system',   -- 触发者：system, user, auto
+    action_metadata JSONB DEFAULT '{}',          -- 行为附加元数据
+    flag SMALLINT DEFAULT 0,                     -- 标志位
+    created_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    update_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+-- 创建索引
+CREATE INDEX idx_service_action_log_service_name ON service_action_log_tbl(service_name);
+CREATE INDEX idx_service_action_log_instance_id ON service_action_log_tbl(instance_id);
+CREATE INDEX idx_service_action_log_action_type ON service_action_log_tbl(action_type);
+CREATE INDEX idx_service_action_log_action_status ON service_action_log_tbl(action_status);
+CREATE INDEX idx_service_action_log_created_time ON service_action_log_tbl(created_time DESC);
+
+-- 添加更新时间触发器
+CREATE TRIGGER update_service_action_log_update_time
+    BEFORE UPDATE ON service_action_log_tbl
+    FOR EACH ROW
+    EXECUTE FUNCTION update_modified_column();
+
+-- 添加注释
+COMMENT ON TABLE service_action_log_tbl IS '服务行为日志表，记录服务实例的所有关键行为';
+COMMENT ON COLUMN service_action_log_tbl.action_type IS '行为类型：register(注册), deregister(注销), heartbeat(心跳), health_check_fail(健康检查失败), restart(重启), scale(扩缩容), rebuild(重建)';
+COMMENT ON COLUMN service_action_log_tbl.action_status IS '行为状态：success(成功), failed(失败), in_progress(进行中)';
+COMMENT ON COLUMN service_action_log_tbl.triggered_by IS '触发者：system(系统自动), user(用户手动), auto(自动化策略)';

cancan_microstack/assets/ddl/infra/service_config_tbl.sql

@@ -0,0 +1,26 @@
+BEGIN;
+
+CREATE TABLE service_config_tbl
+(
+    id           BIGSERIAL PRIMARY KEY,
+    service_name VARCHAR NOT NULL,
+    conf_key     VARCHAR NOT NULL,
+    conf_value   TEXT,
+    flag         SMALLINT                 DEFAULT 0,
+    created_time TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
+    update_time  TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE UNIQUE INDEX uk_service_config_tbl_service_name_conf_key ON service_config_tbl (service_name, conf_key);
+
+-- 提升按更新时间查询效率
+CREATE INDEX idx_service_config_tbl_update_time ON service_config_tbl (update_time);
+
+-- 自动更新时间戳触发器
+CREATE TRIGGER t_upd_service_config_tbl
+    BEFORE UPDATE
+    ON service_config_tbl
+    FOR EACH ROW
+EXECUTE PROCEDURE upd_timestamp();
+
+COMMIT;

cancan_microstack/assets/ddl/infra/service_info_tbl.sql

@@ -0,0 +1,45 @@
+BEGIN;
+
+CREATE TABLE service_info_tbl
+(
+    id                BIGSERIAL PRIMARY KEY,
+    service_name      VARCHAR(100)             NOT NULL,
+    description       TEXT,
+    service_type      VARCHAR(50)              DEFAULT 'business',
+    health_check_path VARCHAR(255)             DEFAULT '/internal/health',
+    service_metadata  JSONB                    DEFAULT '{}',
+    expected_status   VARCHAR(20)              DEFAULT 'running',
+    desired_replicas  SMALLINT                 DEFAULT 1,
+    actual_replicas   SMALLINT                 DEFAULT 0,
+    last_scale_at     TIMESTAMP WITH TIME ZONE,
+    scale_policy      JSONB                    DEFAULT '{}',
+    registered_time   TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
+    last_registered_time TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
+    flag              SMALLINT                 DEFAULT 0,
+    created_time      TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
+    update_time       TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
+);
+
+-- 唯一索引
+CREATE UNIQUE INDEX uk_service_info_tbl_service_name ON service_info_tbl (service_name);
+
+-- 提升按更新时间查询效率
+CREATE INDEX idx_service_info_tbl_update_time ON service_info_tbl (update_time);
+
+-- 服务类型索引
+CREATE INDEX idx_service_info_tbl_service_type ON service_info_tbl (service_type);
+
+-- 标志位索引
+CREATE INDEX idx_service_info_tbl_flag ON service_info_tbl (flag);
+
+-- 期望状态索引
+CREATE INDEX idx_service_info_tbl_expected_status ON service_info_tbl (expected_status);
+
+-- 自动更新时间戳触发器
+CREATE TRIGGER t_upd_service_info_tbl
+    BEFORE UPDATE
+    ON service_info_tbl
+    FOR EACH ROW
+EXECUTE PROCEDURE upd_timestamp();
+
+COMMIT;

cancan_microstack/assets/ddl/infra/service_instance_tbl.sql

@@ -0,0 +1,54 @@
+BEGIN;
+
+-- 服务实例表：记录所有服务实例的详细信息和状态
+-- Service Instance Table: Records detailed info and status of all service instances
+CREATE TABLE service_instance_tbl
+(
+    id                    BIGSERIAL PRIMARY KEY,
+    service_name          VARCHAR(100)             NOT NULL,
+    instance_id           VARCHAR(64)              NOT NULL,
+    container_name        VARCHAR(100)             DEFAULT '', -- 允许为空，非容器环境可能没有
+    compose_service_name  VARCHAR(100)             DEFAULT '',
+    host                  VARCHAR(100)             NOT NULL,
+    port                  INTEGER                  NOT NULL,
+    internal_port         INTEGER                  NOT NULL DEFAULT 8080,
+    status                VARCHAR(20)              NOT NULL DEFAULT 'UP', -- UP, DOWN, STARTING, etc.
+    expected_status       VARCHAR(20)              DEFAULT 'UP',          -- 期望状态 / Expected status
+    health_check_url      VARCHAR(255),                                   -- 健康检查 URL (实例级)
+    health_status         VARCHAR(20)              DEFAULT 'unknown',     -- healthy, unhealthy, unknown
+    last_health_check     TIMESTAMP WITH TIME ZONE,
+    last_heartbeat        TIMESTAMP WITH TIME ZONE,                       -- 最后心跳时间
+    consecutive_failures  SMALLINT                 DEFAULT 0,
+    last_health_error     TEXT,
+    started_at            TIMESTAMP WITH TIME ZONE,
+    stopped_at            TIMESTAMP WITH TIME ZONE,
+    restart_count         INT                      DEFAULT 0,
+    cpu_limit             VARCHAR,
+    memory_limit          VARCHAR,
+    instance_metadata     JSONB                    DEFAULT '{}'::JSONB,
+    flag                  SMALLINT                 DEFAULT 0,
+    created_time          TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
+    update_time           TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
+);
+
+-- 唯一索引：实例ID全局唯一
+CREATE UNIQUE INDEX uk_service_instance_tbl_instance_id ON service_instance_tbl (instance_id);
+
+-- 复合索引：服务维度的实例查询
+CREATE INDEX idx_service_instance_tbl_service_instance ON service_instance_tbl (service_name, instance_id);
+
+-- 状态/健康索引，便于统计聚合
+CREATE INDEX idx_service_instance_tbl_status ON service_instance_tbl (service_name, status);
+CREATE INDEX idx_service_instance_tbl_health_status ON service_instance_tbl (service_name, health_status);
+
+-- 心跳索引 (用于清理过期实例)
+CREATE INDEX idx_service_instance_tbl_last_heartbeat ON service_instance_tbl (service_name, last_heartbeat);
+
+-- 自动更新时间戳触发器
+CREATE TRIGGER t_upd_service_instance_tbl
+    BEFORE UPDATE
+    ON service_instance_tbl
+    FOR EACH ROW
+EXECUTE PROCEDURE upd_timestamp();
+
+COMMIT;

cancan_microstack/assets/ddl/infra/service_operation_tbl.sql

@@ -0,0 +1,47 @@
+BEGIN;
+
+CREATE TABLE service_operation_tbl
+(
+    id                BIGSERIAL PRIMARY KEY,
+    operation_id      VARCHAR                  NOT NULL,
+    operation_type    VARCHAR(20)              NOT NULL,
+    service_name      VARCHAR(100)             NOT NULL,
+    operation_params  JSONB                    DEFAULT '{}',
+    status            VARCHAR(20)              NOT NULL,
+    started_at        TIMESTAMP WITH TIME ZONE,
+    completed_at      TIMESTAMP WITH TIME ZONE,
+    result            JSONB                    DEFAULT '{}',
+    error_message     TEXT,
+    retry_count       SMALLINT                 DEFAULT 0,
+    max_retries       SMALLINT                 DEFAULT 3,
+    last_retry_at     TIMESTAMP WITH TIME ZONE,
+    initiated_by      VARCHAR(100),
+    initiated_from    VARCHAR(100),
+    flag              SMALLINT                 DEFAULT 0,
+    created_time      TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
+    update_time       TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
+);
+
+-- 唯一索引
+CREATE UNIQUE INDEX uk_service_operation_tbl_operation_id ON service_operation_tbl (operation_id);
+
+-- 提升按更新时间查询效率
+CREATE INDEX idx_service_operation_tbl_update_time ON service_operation_tbl (update_time);
+
+-- 服务操作查询索引 (用于查询特定服务的操作历史)
+CREATE INDEX idx_service_operation_tbl_service_operation ON service_operation_tbl (service_name, operation_type, status);
+
+-- 状态和时间索引 (用于查询待处理/超时的操作)
+CREATE INDEX idx_service_operation_tbl_status_created ON service_operation_tbl (status, created_time);
+
+-- 时间范围查询索引 (用于清理历史数据)
+CREATE INDEX idx_service_operation_tbl_created_time ON service_operation_tbl (created_time DESC);
+
+-- 自动更新时间戳触发器
+CREATE TRIGGER t_upd_service_operation_tbl
+    BEFORE UPDATE
+    ON service_operation_tbl
+    FOR EACH ROW
+EXECUTE PROCEDURE upd_timestamp();
+
+COMMIT;

cancan_microstack/assets/ddl/infra/workflow_definition_tbl.sql

@@ -0,0 +1,60 @@
+-- 工作流定义表
+-- Stores the definition of a workflow, including its graph structure and node configurations.
+
+BEGIN;
+
+CREATE TABLE IF NOT EXISTS workflow_definition_tbl (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    name VARCHAR(255) NOT NULL,
+    description TEXT,
+
+    -- Cron expression for scheduled runs
+    schedule VARCHAR(100),
+
+    -- UI data from the frontend (node coordinates, connections, etc.)
+    graph_data JSONB DEFAULT '{}',
+
+    global_context JSONB DEFAULT '{}',
+
+    -- Core logic configuration (flattened map of nodes, keyed by node ID)
+    nodes_config JSONB NOT NULL DEFAULT '{}',
+
+    -- Whether the workflow is active (for scanner pickup)
+    is_active BOOLEAN DEFAULT FALSE,
+
+    -- Definition level versioning metadata
+    version INTEGER NOT NULL DEFAULT 1,
+    change_summary VARCHAR(255),
+
+    -- Standard fields
+    flag SMALLINT DEFAULT 0,
+    created_time TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
+    update_time TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Indexes
+CREATE INDEX IF NOT EXISTS idx_workflow_def_active ON workflow_definition_tbl(is_active);
+CREATE INDEX IF NOT EXISTS idx_workflow_def_schedule ON workflow_definition_tbl(schedule);
+
+-- 提升按更新时间查询效率
+CREATE INDEX idx_workflow_definition_tbl_update_time ON workflow_definition_tbl (update_time);
+
+-- Auto-update timestamp trigger
+CREATE TRIGGER t_upd_workflow_definition_tbl
+    BEFORE UPDATE ON workflow_definition_tbl
+    FOR EACH ROW
+    EXECUTE PROCEDURE upd_timestamp();
+
+-- Comments
+COMMENT ON TABLE workflow_definition_tbl IS '工作流定义表，存储工作流的静态结构和配置';
+COMMENT ON COLUMN workflow_definition_tbl.schedule IS '用于定时触发的 Cron 表达式';
+COMMENT ON COLUMN workflow_definition_tbl.graph_data IS '前端 UI 数据 (节点坐标, 连线等)';
+COMMENT ON COLUMN workflow_definition_tbl.nodes_config IS '核心逻辑配置 (扁平化的节点 Map, key为节点ID)。支持的节点类型: START, ACTION, TRANSFORM, LOGIC, FORK (并行分支), JOIN, LOOP, END';
+COMMENT ON COLUMN workflow_definition_tbl.is_active IS '是否启用 (决定调度器是否扫描)';
+COMMENT ON COLUMN workflow_definition_tbl.version IS '工作流定义版本号，配置变更时自增';
+COMMENT ON COLUMN workflow_definition_tbl.change_summary IS '版本变更说明';
+COMMENT ON COLUMN workflow_definition_tbl.flag IS '标志位 (0:正常, 1:已删除)';
+COMMENT ON COLUMN workflow_definition_tbl.created_time IS '记录创建时间';
+COMMENT ON COLUMN workflow_definition_tbl.update_time IS '记录最后更新时间';
+
+COMMIT;

cancan_microstack/assets/ddl/infra/workflow_definition_version_tbl.sql

@@ -0,0 +1,35 @@
+BEGIN;
+
+-- 工作流定义版本快照表 / Workflow definition history table
+CREATE TABLE IF NOT EXISTS workflow_definition_version_tbl (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    workflow_id UUID NOT NULL REFERENCES workflow_definition_tbl(id),
+    version INTEGER NOT NULL,
+    name VARCHAR(255) NOT NULL,
+    description TEXT,
+    schedule VARCHAR(100),
+    graph_data JSONB DEFAULT '{}',
+    nodes_config JSONB NOT NULL DEFAULT '{}',
+    global_context JSONB DEFAULT '{}',
+    is_active BOOLEAN DEFAULT FALSE,
+    change_summary VARCHAR(255),
+
+    -- Standard fields
+    flag SMALLINT DEFAULT 0,
+    created_time TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
+    update_time TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS uk_workflow_definition_version_tbl ON workflow_definition_version_tbl(workflow_id, version);
+
+-- Auto-update timestamp trigger
+CREATE TRIGGER t_upd_workflow_definition_version_tbl
+    BEFORE UPDATE ON workflow_definition_version_tbl
+    FOR EACH ROW
+    EXECUTE PROCEDURE upd_timestamp();
+
+COMMENT ON TABLE workflow_definition_version_tbl IS '工作流版本快照表，记录每次发布或回滚后的定义快照';
+COMMENT ON COLUMN workflow_definition_version_tbl.version IS '对应 workflow_definition_tbl 的版本号';
+COMMENT ON COLUMN workflow_definition_version_tbl.change_summary IS '版本变更说明（回滚/发布原因）';
+
+COMMIT;

cancan_microstack/assets/ddl/infra/workflow_engine_alert_tbl.sql

@@ -0,0 +1,34 @@
+BEGIN;
+
+CREATE TABLE workflow_engine_alert_tbl
+(
+    id               UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    run_id           UUID REFERENCES workflow_run_tbl (id),
+    node_id          VARCHAR(64)                     NOT NULL,
+    loop_index       INTEGER                         NOT NULL DEFAULT 1,
+    severity         VARCHAR(16)                     NOT NULL,
+    category         VARCHAR(32)                     NOT NULL,
+    reason           VARCHAR(255)                    NOT NULL,
+    detail           JSONB,
+    status           VARCHAR(16)                     NOT NULL DEFAULT 'OPEN',
+    acknowledged_by  VARCHAR(64),
+    acknowledged_at  TIMESTAMP WITH TIME ZONE,
+    resolved_by      VARCHAR(64),
+    resolved_at      TIMESTAMP WITH TIME ZONE,
+    note             TEXT,
+    flag             SMALLINT                         DEFAULT 0,
+    created_time     TIMESTAMP WITH TIME ZONE         DEFAULT CURRENT_TIMESTAMP,
+    update_time      TIMESTAMP WITH TIME ZONE         DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX idx_workflow_engine_alert_tbl_status ON workflow_engine_alert_tbl (status);
+CREATE INDEX idx_workflow_engine_alert_tbl_run ON workflow_engine_alert_tbl (run_id);
+CREATE INDEX idx_workflow_engine_alert_tbl_created ON workflow_engine_alert_tbl (created_time DESC);
+
+CREATE TRIGGER t_upd_workflow_engine_alert_tbl
+    BEFORE UPDATE
+    ON workflow_engine_alert_tbl
+    FOR EACH ROW
+EXECUTE PROCEDURE upd_timestamp();
+
+COMMIT;

cancan_microstack/assets/ddl/infra/workflow_run_tbl.sql

@@ -0,0 +1,52 @@
+-- 工作流运行实例表
+-- Stores each execution instance of a workflow.
+
+BEGIN;
+
+CREATE TABLE IF NOT EXISTS workflow_run_tbl (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    workflow_id UUID NOT NULL REFERENCES workflow_definition_tbl(id),
+
+    status VARCHAR(20) NOT NULL DEFAULT 'PENDING',
+
+    -- Trigger source information
+    trigger_type VARCHAR(20) NOT NULL,
+    trigger_context JSONB DEFAULT '{}',
+
+    -- Global context data that flows through the workflow
+    global_context JSONB DEFAULT '{}',
+
+    -- Definition snapshot metadata to guarantee immutable runs
+    definition_version INTEGER,
+    definition_snapshot JSONB,
+
+    started_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP,
+    finished_at TIMESTAMPTZ,
+    duration_ms INTEGER,
+
+    -- Standard fields
+    flag SMALLINT DEFAULT 0,
+    created_time TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
+    update_time TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Indexes
+CREATE INDEX IF NOT EXISTS idx_workflow_run_workflow_id ON workflow_run_tbl(workflow_id);
+CREATE INDEX IF NOT EXISTS idx_workflow_run_status ON workflow_run_tbl(status);
+
+-- 提升按更新时间查询效率
+CREATE INDEX idx_workflow_run_tbl_update_time ON workflow_run_tbl (update_time);
+
+-- Comments
+COMMENT ON TABLE workflow_run_tbl IS '工作流运行实例表';
+COMMENT ON COLUMN workflow_run_tbl.trigger_type IS '触发类型: MANUAL, SCHEDULE, API';
+COMMENT ON COLUMN workflow_run_tbl.trigger_context IS '触发时的元数据';
+COMMENT ON COLUMN workflow_run_tbl.global_context IS '全局上下文数据 (随流程流动)';
+COMMENT ON COLUMN workflow_run_tbl.definition_version IS '触发时绑定的定义版本号 / Definition version captured when triggering';
+COMMENT ON COLUMN workflow_run_tbl.definition_snapshot IS '触发时的完整工作流定义快照 / Serialized workflow definition snapshot captured at trigger time';
+COMMENT ON COLUMN workflow_run_tbl.status IS '运行状态: PENDING, RUNNING, SUCCESS, FAILURE, CANCELLED, PAUSED';
+COMMENT ON COLUMN workflow_run_tbl.flag IS '标志位 (0:正常, 1:已删除)';
+COMMENT ON COLUMN workflow_run_tbl.created_time IS '记录创建时间';
+COMMENT ON COLUMN workflow_run_tbl.update_time IS '记录最后更新时间';
+
+COMMIT;

cancan_microstack/assets/ddl/ops/admin_user_tbl.sql

@@ -0,0 +1,34 @@
+BEGIN;
+
+CREATE TABLE admin_user_tbl
+(
+    id                      BIGSERIAL PRIMARY KEY,
+    username                VARCHAR(50) NOT NULL,
+    password_hash           VARCHAR(255) NOT NULL,
+    totp_secret_encrypted   TEXT,
+    totp_bound              BOOLEAN DEFAULT false,
+    flag                    SMALLINT DEFAULT 0,
+    created_time            TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
+    update_time             TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE UNIQUE INDEX idx_admin_user_tbl_username ON admin_user_tbl (username);
+
+-- 提升按更新时间查询效率
+CREATE INDEX idx_admin_user_tbl_update_time ON admin_user_tbl (update_time);
+
+-- 自动更新时间戳触发器
+CREATE TRIGGER t_admin_user_tbl
+    BEFORE UPDATE
+    ON admin_user_tbl
+    FOR EACH ROW
+EXECUTE PROCEDURE upd_timestamp();
+
+COMMENT ON TABLE admin_user_tbl IS 'OPS Admin 用户表';
+COMMENT ON COLUMN admin_user_tbl.username IS '用户名';
+COMMENT ON COLUMN admin_user_tbl.password_hash IS 'bcrypt 密码哈希';
+COMMENT ON COLUMN admin_user_tbl.totp_secret_encrypted IS 'Fernet 加密后的 TOTP secret';
+COMMENT ON COLUMN admin_user_tbl.totp_bound IS 'TOTP 是否已绑定';
+COMMENT ON COLUMN admin_user_tbl.flag IS '标记位 0=正常';
+
+COMMIT;

cancan_microstack/assets/ddl/ops/caddy_access_log_tbl.sql

@@ -0,0 +1,91 @@
+BEGIN;
+
+CREATE TABLE caddy_access_log_tbl
+(
+    id BIGSERIAL PRIMARY KEY,
+    
+    -- 请求基本信息
+    request_id VARCHAR(50) NOT NULL,
+    timestamp TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    
+    -- 客户端信息
+    client_ip VARCHAR(50) NOT NULL,                        -- 客户端 IP
+    client_port INTEGER,                                   -- 客户端端口
+    user_agent TEXT,                                       -- User-Agent
+    referer TEXT,                                          -- Referer
+    
+    -- IP 地理位置信息（使用 IP 库解析）
+    country VARCHAR(100),                                  -- 国家
+    country_code VARCHAR(10),                              -- 国家代码（如 CN, US）
+    region VARCHAR(100),                                   -- 省份/州
+    city VARCHAR(100),                                     -- 城市
+    latitude DECIMAL(10, 8),                               -- 纬度
+    longitude DECIMAL(11, 8),                              -- 经度
+    timezone VARCHAR(50),                                  -- 时区
+    isp VARCHAR(200),                                      -- ISP 运营商
+    
+    -- 请求信息
+    method VARCHAR(10) NOT NULL,                           -- HTTP 方法（GET/POST 等）
+    protocol VARCHAR(20),                                  -- 协议版本（HTTP/1.1, HTTP/2）
+    host VARCHAR(255),                                     -- 请求的 Host
+    path TEXT NOT NULL,                                    -- 请求路径
+    query_string TEXT,                                     -- 查询字符串
+    
+    -- 路由和服务信息
+    matched_route VARCHAR(100),                            -- 匹配的路由名称
+    upstream_service VARCHAR(100),                         -- 转发到的上游服务
+    upstream_host VARCHAR(100),                            -- 上游服务主机
+    upstream_port INTEGER,                                 -- 上游服务端口
+    
+    -- 响应信息
+    status_code INTEGER NOT NULL,                          -- HTTP 状态码
+    response_size BIGINT,                                  -- 响应大小（字节）
+    response_time INTEGER,                                 -- 响应时间（毫秒）
+    
+    -- WAF 信息
+    waf_action VARCHAR(50),                                -- WAF 动作（allow/block/log）
+    waf_rule_id VARCHAR(100),                              -- 触发的 WAF 规则 ID
+    waf_score INTEGER,                                     -- WAF 威胁评分
+    
+    -- 限流信息
+    rate_limited BOOLEAN DEFAULT false,                    -- 是否被限流
+    rate_limit_rule VARCHAR(100),                          -- 限流规则名称
+    
+    -- TLS 信息
+    tls_version VARCHAR(20),                               -- TLS 版本
+    tls_cipher VARCHAR(100),                               -- TLS 加密套件
+    
+    -- 元数据
+    log_metadata JSONB DEFAULT '{}',
+    
+    -- 标准字段
+    flag SMALLINT DEFAULT 0,
+    created_time TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
+    update_time TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
+);
+
+-- 唯一索引
+CREATE UNIQUE INDEX uk_caddy_access_log_tbl_request_id ON caddy_access_log_tbl (request_id);
+
+-- 提升按更新时间查询效率
+CREATE INDEX idx_caddy_access_log_tbl_update_time ON caddy_access_log_tbl (update_time);
+
+-- 优化查询性能的索引
+CREATE INDEX idx_caddy_access_log_tbl_timestamp ON caddy_access_log_tbl (timestamp DESC);
+CREATE INDEX idx_caddy_access_log_tbl_client_ip ON caddy_access_log_tbl (client_ip);
+CREATE INDEX idx_caddy_access_log_tbl_status_code ON caddy_access_log_tbl (status_code);
+CREATE INDEX idx_caddy_access_log_tbl_upstream_service ON caddy_access_log_tbl (upstream_service);
+CREATE INDEX idx_caddy_access_log_tbl_country ON caddy_access_log_tbl (country);
+
+-- 复合索引（优化常见查询）
+CREATE INDEX idx_caddy_access_log_tbl_service_time ON caddy_access_log_tbl (upstream_service, timestamp DESC);
+CREATE INDEX idx_caddy_access_log_tbl_ip_time ON caddy_access_log_tbl (client_ip, timestamp DESC);
+
+-- 自动更新时间戳触发器
+CREATE TRIGGER t_upd_caddy_access_log_tbl
+    BEFORE UPDATE
+    ON caddy_access_log_tbl
+    FOR EACH ROW
+EXECUTE PROCEDURE upd_timestamp();
+
+COMMIT;