{
  "openapi": "3.0.1",
  "info": {
    "title": "APP",
    "description": "家谱业务 APP/PC 用户侧接口文档，用于 Apifox 导入。\n\n导入方式：Apifox -> 导入 API 数据 -> OpenAPI/Swagger -> 选择本文件。\n\n约定：\n- APP 路径前缀为 `/genealogy/app`\n- PC/H5 路径前缀为 `/genealogy/pc`\n- 后台管理接口不包含在本文件内\n- 登录后接口需要携带 token，且请求 Header 需携带 `clientid`\n",
    "version": "1.0.0"
  },
  "tags": [
    {
      "name": "验证中心"
    },
    {
      "name": "认证登录"
    },
    {
      "name": "文件上传"
    },
    {
      "name": "行政区划"
    },
    {
      "name": "家谱"
    },
    {
      "name": "家谱成员"
    },
    {
      "name": "字辈谱"
    },
    {
      "name": "世系人物"
    },
    {
      "name": "家族圈"
    },
    {
      "name": "内容文章"
    },
    {
      "name": "相册"
    },
    {
      "name": "祭祀"
    },
    {
      "name": "族务记录"
    },
    {
      "name": "消息通知"
    },
    {
      "name": "意见反馈"
    },
    {
      "name": "VIP"
    }
  ],
  "paths": {
    "/captcha/require": {
      "get": {
        "summary": "查询当前场景是否需要验证",
        "deprecated": false,
        "description": "用于登录、注册、换绑手机等场景。按租户、客户端和场景编码匹配后台验证策略。",
        "tags": [
          "验证中心"
        ],
        "parameters": [
          {
            "name": "tenantId",
            "in": "query",
            "description": "租户ID，用于区分不同租户的数据和验证策略",
            "required": false,
            "example": "000000",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "clientId",
            "in": "query",
            "description": "客户端ID，对应后台客户端管理中的APP/PC/小程序等终端",
            "required": false,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sceneCode",
            "in": "query",
            "description": "验证场景编码，例如APP_LOGIN、PC_LOGIN、APP_REGISTER",
            "required": true,
            "example": "APP_LOGIN",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "subject",
            "in": "query",
            "description": "验证主体，通常为手机号、用户ID或登录账号",
            "required": false,
            "example": "13800000000",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID",
            "example": "ced7e5f0498645c6ec642dcf450b036f",
            "schema": {
              "type": "string",
              "default": "ced7e5f0498645c6ec642dcf450b036f"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/VerificationRequireResult",
            "description": "验证需求查询结果"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/captcha/challenge": {
      "post": {
        "summary": "生成验证挑战",
        "deprecated": false,
        "description": "统一生成验证码。策略为天爱时返回行为验证数据；策略为系统图形时返回 uuid 和 img。",
        "tags": [
          "验证中心"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID",
            "example": "ced7e5f0498645c6ec642dcf450b036f",
            "schema": {
              "type": "string",
              "default": "ced7e5f0498645c6ec642dcf450b036f"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VerificationChallengeBody"
              },
              "example": {
                "tenantId": "000000",
                "clientId": "428a8310cd442757ae699df5d894f051",
                "sceneCode": "APP_LOGIN",
                "subject": "13800000000"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/VerificationChallengeResult",
            "description": "验证挑战生成结果"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/captcha/verify": {
      "post": {
        "summary": "校验验证结果并换取 validToken",
        "deprecated": false,
        "description": "验证通过后返回 validToken，登录、注册、发短信等业务接口将 validToken 随请求体一起提交。",
        "tags": [
          "验证中心"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID",
            "example": "ced7e5f0498645c6ec642dcf450b036f",
            "schema": {
              "type": "string",
              "default": "ced7e5f0498645c6ec642dcf450b036f"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VerificationCheckBody"
              },
              "examples": {
                "tianai_behavior": {
                  "value": {
                    "tenantId": "000000",
                    "clientId": "428a8310cd442757ae699df5d894f051",
                    "sceneCode": "APP_LOGIN",
                    "subject": "13800000000",
                    "challengeId": "CAPTCHA_CHALLENGE_ID",
                    "providerCode": "tianai",
                    "captchaType": "SLIDER",
                    "payload": {
                      "id": "tianai-captcha-id",
                      "data": {
                        "bgImageWidth": 340,
                        "bgImageHeight": 180,
                        "startSlidingTime": 1720000000000,
                        "endSlidingTime": 1720000001500,
                        "trackList": []
                      }
                    }
                  },
                  "summary": "天爱滑块/旋转/滑动还原/文字点选验证"
                },
                "system_image": {
                  "value": {
                    "tenantId": "000000",
                    "clientId": "428a8310cd442757ae699df5d894f051",
                    "sceneCode": "APP_LOGIN",
                    "subject": "13800000000",
                    "challengeId": "CAPTCHA_CHALLENGE_ID",
                    "providerCode": "ruoyi_image",
                    "captchaType": "math",
                    "payload": {
                      "uuid": "captcha-uuid",
                      "code": "6"
                    }
                  },
                  "summary": "系统图形验证码"
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/VerificationCheckResult",
            "description": "验证校验结果"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/auth/code": {
      "get": {
        "summary": "兼容旧系统图形验证码",
        "deprecated": false,
        "description": "老版后台登录图形验证码入口。新的 APP/PC 业务优先使用 /captcha/require + /captcha/challenge + /captcha/verify。",
        "tags": [
          "验证中心"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID",
            "example": "ced7e5f0498645c6ec642dcf450b036f",
            "schema": {
              "type": "string",
              "default": "ced7e5f0498645c6ec642dcf450b036f"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/LegacyCaptchaResult",
            "description": "兼容旧图形验证码结果"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/auth/register": {
      "post": {
        "summary": "APP 用户注册",
        "deprecated": false,
        "description": "",
        "tags": [
          "认证登录"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PasswordRegisterBody"
              },
              "example": {
                "grantType": "password",
                "tenantId": "000000",
                "phone": "13800000000",
                "password": "e10adc3949ba59abbe56e057f20f883e",
                "nickName": "测试用户",
                "registerSource": "app",
                "validToken": "captcha-ticket-or-sms-token"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/LoginResult",
            "description": "登录结果"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/auth/login": {
      "post": {
        "summary": "APP 密码登录",
        "deprecated": false,
        "description": "",
        "tags": [
          "认证登录"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PasswordLoginBody"
              },
              "example": {
                "grantType": "password",
                "tenantId": "000000",
                "phone": "13800000000",
                "password": "e10adc3949ba59abbe56e057f20f883e",
                "validToken": "captcha-ticket"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/LoginResult",
            "description": "登录结果"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/auth/login/sms": {
      "post": {
        "summary": "APP 短信登录",
        "deprecated": false,
        "description": "",
        "tags": [
          "认证登录"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SmsLoginBody"
              },
              "example": {
                "grantType": "sms",
                "tenantId": "000000",
                "phone": "13800000000",
                "smsCode": "123456",
                "validToken": "captcha-ticket"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/LoginResult",
            "description": "登录结果"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/auth/sms/code": {
      "post": {
        "summary": "APP 发送短信验证码",
        "deprecated": false,
        "description": "",
        "tags": [
          "认证登录"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SmsCodeBody"
              },
              "example": {
                "tenantId": "000000",
                "phone": "13800000000",
                "sceneCode": "APP_LOGIN",
                "validToken": "captcha-ticket"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/VoidResult",
            "description": "通用成功响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/auth/profile": {
      "get": {
        "summary": "APP 当前用户资料",
        "deprecated": false,
        "description": "",
        "tags": [
          "认证登录"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "put": {
        "summary": "APP 修改用户资料",
        "deprecated": false,
        "description": "",
        "tags": [
          "认证登录"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProfileUpdateBody"
              },
              "example": {
                "nickName": "张三",
                "avatarOssId": "2060000000000000000",
                "sex": "0",
                "birthday": "1990-01-01",
                "regionCode": "110101",
                "addressDetail": "北京市东城区"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/auth/password": {
      "put": {
        "summary": "APP 修改密码",
        "deprecated": false,
        "description": "",
        "tags": [
          "认证登录"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PasswordChangeBody"
              },
              "example": {
                "oldPassword": "e10adc3949ba59abbe56e057f20f883e",
                "newPassword": "25d55ad283aa400af464c76d713c07ad",
                "validToken": "captcha-ticket"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/VoidResult",
            "description": "通用成功响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/auth/password/reset": {
      "put": {
        "summary": "APP 找回密码",
        "deprecated": false,
        "description": "",
        "tags": [
          "认证登录"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PasswordResetBody"
              },
              "example": {
                "tenantId": "000000",
                "phone": "13800000000",
                "smsCode": "123456",
                "newPassword": "25d55ad283aa400af464c76d713c07ad",
                "validToken": "captcha-ticket"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/VoidResult",
            "description": "通用成功响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/auth/phone": {
      "put": {
        "summary": "APP 换绑手机号",
        "deprecated": false,
        "description": "",
        "tags": [
          "认证登录"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PhoneChangeBody"
              },
              "example": {
                "newPhone": "13900000000",
                "smsCode": "123456",
                "validToken": "captcha-ticket"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/auth/account/deactivate": {
      "post": {
        "summary": "APP 注销账号",
        "deprecated": false,
        "description": "",
        "tags": [
          "认证登录"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AccountDeactivateBody"
              },
              "example": {
                "password": "e10adc3949ba59abbe56e057f20f883e",
                "reason": "user request"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/VoidResult",
            "description": "通用成功响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/auth/logout": {
      "delete": {
        "summary": "APP 退出登录",
        "deprecated": false,
        "description": "",
        "tags": [
          "认证登录"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/VoidResult",
            "description": "通用成功响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/files/upload": {
      "post": {
        "summary": "APP 单文件上传",
        "deprecated": false,
        "description": "",
        "tags": [
          "文件上传"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "example": ""
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": ""
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/FileUploadResult",
            "description": "文件上传结果"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/files/resumable/init": {
      "post": {
        "summary": "APP 分片上传初始化",
        "deprecated": false,
        "description": "",
        "tags": [
          "文件上传"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ResumableInitBody"
              },
              "example": {
                "fileName": "cover.jpg",
                "fileSize": 9532,
                "fileMd5": "d41d8cd98f00b204e9800998ecf8427e",
                "contentType": "image/jpeg",
                "chunkSize": 4194304,
                "totalChunks": 1,
                "bizType": "genealogy",
                "usageScene": "cover"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/files/resumable/chunk": {
      "post": {
        "summary": "APP 上传分片",
        "deprecated": false,
        "description": "",
        "tags": [
          "文件上传"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "uploadId": {
                    "type": "string",
                    "example": ""
                  },
                  "chunkIndex": {
                    "type": "integer",
                    "example": 0
                  },
                  "chunkMd5": {
                    "type": "string",
                    "example": "d41d8cd98f00b204e9800998ecf8427e"
                  },
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "example": ""
                  }
                },
                "required": [
                  "uploadId",
                  "chunkIndex",
                  "chunkMd5",
                  "file"
                ]
              },
              "example": {
                "uploadId": "",
                "chunkIndex": 0,
                "chunkMd5": "d41d8cd98f00b204e9800998ecf8427e",
                "file": ""
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/VoidResult",
            "description": "通用成功响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/files/resumable/complete": {
      "post": {
        "summary": "APP 完成分片上传",
        "deprecated": false,
        "description": "",
        "tags": [
          "文件上传"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ResumableCompleteBody"
              },
              "example": {
                "uploadId": "UPLOAD202607090001",
                "fileMd5": "d41d8cd98f00b204e9800998ecf8427e",
                "fileSize": 9532
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/FileUploadResult",
            "description": "文件上传结果"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/files/reference": {
      "post": {
        "summary": "APP 绑定文件业务引用",
        "deprecated": false,
        "description": "",
        "tags": [
          "文件上传"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FileReferenceBody"
              },
              "example": {
                "bizType": "family_feed",
                "bizName": "family feed image",
                "bizTable": "gen_family_feed",
                "bizId": 900013001,
                "bizField": "media_oss_ids",
                "ossId": "2060000000000000000",
                "usageScene": "feed_image"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/VoidResult",
            "description": "通用成功响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "delete": {
        "summary": "APP 释放文件业务引用",
        "deprecated": false,
        "description": "",
        "tags": [
          "文件上传"
        ],
        "parameters": [
          {
            "name": "bizTable",
            "in": "query",
            "description": "业务表名，用于文件引用绑定",
            "required": true,
            "example": "gen_family_feed",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "bizId",
            "in": "query",
            "description": "业务数据ID，用于文件引用绑定",
            "required": true,
            "example": 900013001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "bizField",
            "in": "query",
            "description": "业务字段名，例如avatar_oss_id、cover_oss_id",
            "required": true,
            "example": "media_ids",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/VoidResult",
            "description": "通用成功响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/region/children": {
      "get": {
        "summary": "查询下级行政区划",
        "deprecated": false,
        "description": "",
        "tags": [
          "行政区划"
        ],
        "parameters": [
          {
            "name": "parentCode",
            "in": "query",
            "description": "父级行政区划编码，不传或传0查省级",
            "required": false,
            "example": "51",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID",
            "example": "ced7e5f0498645c6ec642dcf450b036f",
            "schema": {
              "type": "string",
              "default": "ced7e5f0498645c6ec642dcf450b036f"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/region/path/{regionCode}": {
      "get": {
        "summary": "查询行政区划路径",
        "deprecated": false,
        "description": "",
        "tags": [
          "行政区划"
        ],
        "parameters": [
          {
            "name": "regionCode",
            "in": "path",
            "description": "行政区划编码",
            "required": true,
            "example": "510000",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID",
            "example": "ced7e5f0498645c6ec642dcf450b036f",
            "schema": {
              "type": "string",
              "default": "ced7e5f0498645c6ec642dcf450b036f"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/region/search": {
      "get": {
        "summary": "搜索行政区划",
        "deprecated": false,
        "description": "",
        "tags": [
          "行政区划"
        ],
        "parameters": [
          {
            "name": "keyword",
            "in": "query",
            "description": "搜索关键词，支持地区名称或编码模糊查询",
            "required": true,
            "example": "北京",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "level",
            "in": "query",
            "description": "行政区划级别，1省、2市、3区县、4乡镇街道、5村社区",
            "required": false,
            "example": 3,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "返回数量上限",
            "required": false,
            "example": 20,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID",
            "example": "ced7e5f0498645c6ec642dcf450b036f",
            "schema": {
              "type": "string",
              "default": "ced7e5f0498645c6ec642dcf450b036f"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/region/{regionCode}": {
      "get": {
        "summary": "查询行政区划详情",
        "deprecated": false,
        "description": "",
        "tags": [
          "行政区划"
        ],
        "parameters": [
          {
            "name": "regionCode",
            "in": "path",
            "description": "行政区划编码",
            "required": true,
            "example": "510000",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID",
            "example": "ced7e5f0498645c6ec642dcf450b036f",
            "schema": {
              "type": "string",
              "default": "ced7e5f0498645c6ec642dcf450b036f"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies": {
      "post": {
        "summary": "APP 创建家谱",
        "deprecated": false,
        "description": "",
        "tags": [
          "家谱"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenealogyCreateBody"
              },
              "example": {
                "genealogyName": "彭氏家谱",
                "surname": "彭",
                "ancestralHall": "陇西堂",
                "originPlace": "江西吉安",
                "regionCode": "360800",
                "addressDetail": "江西省吉安市",
                "coverOssId": "2060000000000000000",
                "intro": "彭氏家谱简介",
                "visibility": "1",
                "joinMode": "1"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/mine": {
      "get": {
        "summary": "APP 我的家谱",
        "deprecated": false,
        "description": "",
        "tags": [
          "家谱"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/public": {
      "get": {
        "summary": "APP 公开家谱",
        "deprecated": false,
        "description": "",
        "tags": [
          "家谱"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/options": {
      "get": {
        "summary": "APP 家谱下拉选项",
        "deprecated": false,
        "description": "",
        "tags": [
          "家谱"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}": {
      "get": {
        "summary": "APP 家谱详情",
        "deprecated": false,
        "description": "",
        "tags": [
          "家谱"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "put": {
        "summary": "APP 修改家谱",
        "deprecated": false,
        "description": "",
        "tags": [
          "家谱"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenealogyUpdateBody"
              },
              "example": {
                "genealogyName": "彭氏家谱",
                "surname": "彭",
                "ancestralHall": "陇西堂",
                "originPlace": "江西吉安",
                "regionCode": "360800",
                "addressDetail": "江西省吉安市",
                "coverOssId": "2060000000000000000",
                "intro": "更新后的家谱简介",
                "visibility": "1",
                "joinMode": "1"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/overview": {
      "get": {
        "summary": "APP 家谱概览",
        "deprecated": false,
        "description": "",
        "tags": [
          "家谱"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/join-applies": {
      "post": {
        "summary": "APP 申请加入家谱",
        "deprecated": false,
        "description": "",
        "tags": [
          "家谱"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenealogyJoinApplyBody"
              },
              "example": {
                "applicantName": "彭小明",
                "phone": "13800000000",
                "relationDesc": "本族成员",
                "applyReason": "申请加入家谱维护",
                "inviterUserId": 900000001
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/join-applies/mine": {
      "get": {
        "summary": "APP 我的加入申请",
        "deprecated": false,
        "description": "",
        "tags": [
          "家谱"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/join-applies/pending": {
      "get": {
        "summary": "APP 待审核加入申请",
        "deprecated": false,
        "description": "",
        "tags": [
          "家谱"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/join-applies/{applyId}/audit": {
      "put": {
        "summary": "APP 审核加入申请",
        "deprecated": false,
        "description": "",
        "tags": [
          "家谱"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "applyId",
            "in": "path",
            "description": "加入家谱申请ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenealogyJoinAuditBody"
              },
              "example": {
                "status": "1",
                "auditRemark": "信息核验通过"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/VoidResult",
            "description": "通用成功响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/join-applies/{applyId}": {
      "delete": {
        "summary": "APP 撤销加入申请",
        "deprecated": false,
        "description": "",
        "tags": [
          "家谱"
        ],
        "parameters": [
          {
            "name": "applyId",
            "in": "path",
            "description": "加入家谱申请ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/VoidResult",
            "description": "通用成功响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/members": {
      "get": {
        "summary": "APP 家谱成员列表",
        "deprecated": false,
        "description": "",
        "tags": [
          "家谱成员"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/members/options": {
      "get": {
        "summary": "APP 家谱成员选项",
        "deprecated": false,
        "description": "",
        "tags": [
          "家谱成员"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/members/{memberId}": {
      "put": {
        "summary": "APP 修改成员",
        "deprecated": false,
        "description": "",
        "tags": [
          "家谱成员"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "memberId",
            "in": "path",
            "description": "家谱成员ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenealogyMemberUpdateBody"
              },
              "example": {
                "memberName": "彭小明",
                "relationName": "族亲",
                "roleType": "member",
                "lineagePersonId": 900020001
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "delete": {
        "summary": "APP 移除成员",
        "deprecated": false,
        "description": "",
        "tags": [
          "家谱成员"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "memberId",
            "in": "path",
            "description": "家谱成员ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/VoidResult",
            "description": "通用成功响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/members/me": {
      "delete": {
        "summary": "APP 退出家谱",
        "deprecated": false,
        "description": "",
        "tags": [
          "家谱成员"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/VoidResult",
            "description": "通用成功响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/members/owner-transfer": {
      "put": {
        "summary": "APP 转让家谱所有者",
        "deprecated": false,
        "description": "",
        "tags": [
          "家谱成员"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenealogyOwnerTransferBody"
              },
              "example": {
                "targetMemberId": 900010002
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/VoidResult",
            "description": "通用成功响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/generation-poems": {
      "get": {
        "summary": "APP 查询字辈谱",
        "deprecated": false,
        "description": "",
        "tags": [
          "字辈谱"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "post": {
        "summary": "APP 新增字辈",
        "deprecated": false,
        "description": "",
        "tags": [
          "字辈谱"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenerationPoemBody"
              },
              "example": {
                "generationNo": 5,
                "generationText": "忠",
                "description": "fifth generation poem",
                "sortOrder": 5,
                "status": "0"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/generation-poems/batch/preview": {
      "post": {
        "summary": "APP 批量字辈预览",
        "deprecated": false,
        "description": "",
        "tags": [
          "字辈谱"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenerationPoemBatchBody"
              },
              "example": {
                "genealogyId": 900001001,
                "poemText": "德承家亦\n忠厚传芳",
                "disableMissing": false
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/generation-poems/batch/save": {
      "post": {
        "summary": "APP 批量保存字辈",
        "deprecated": false,
        "description": "",
        "tags": [
          "字辈谱"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenerationPoemBatchBody"
              },
              "example": {
                "genealogyId": 900001001,
                "poemText": "德承家亦\n忠厚传芳",
                "disableMissing": false
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/generation-poems/{poemId}": {
      "put": {
        "summary": "APP 修改字辈",
        "deprecated": false,
        "description": "",
        "tags": [
          "字辈谱"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "poemId",
            "in": "path",
            "description": "字辈谱ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenerationPoemBody"
              },
              "example": {
                "generationNo": 5,
                "generationText": "忠",
                "description": "fifth generation poem",
                "sortOrder": 5,
                "status": "0"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/lineage/persons": {
      "get": {
        "summary": "APP 世系人物列表",
        "deprecated": false,
        "description": "",
        "tags": [
          "世系人物"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "post": {
        "summary": "APP 新增世系人物",
        "deprecated": false,
        "description": "",
        "tags": [
          "世系人物"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LineagePersonBody"
              },
              "example": {
                "appUserId": 900000001,
                "personNo": "P202607090001",
                "personName": "彭德明",
                "aliasName": "德明",
                "sex": "0",
                "generationNo": 1,
                "generationName": "德",
                "avatarOssId": "2060000000000000000",
                "birthDate": "1950-01-01",
                "deathDate": null,
                "introduction": "first generation introduction"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/lineage/persons/page": {
      "get": {
        "summary": "APP 世系人物分页",
        "deprecated": false,
        "description": "",
        "tags": [
          "世系人物"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "pageNum",
            "in": "query",
            "description": "页码，从1开始",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 1
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "description": "每页条数",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 10
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/PageResult",
            "description": "通用分页响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/lineage/persons/options": {
      "get": {
        "summary": "APP 世系人物选项",
        "deprecated": false,
        "description": "",
        "tags": [
          "世系人物"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/lineage/tree": {
      "get": {
        "summary": "APP 世系树",
        "deprecated": false,
        "description": "",
        "tags": [
          "世系人物"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}": {
      "get": {
        "summary": "APP 世系人物详情",
        "deprecated": false,
        "description": "",
        "tags": [
          "世系人物"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "personId",
            "in": "path",
            "description": "世系人物ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "put": {
        "summary": "APP 修改世系人物",
        "deprecated": false,
        "description": "",
        "tags": [
          "世系人物"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "personId",
            "in": "path",
            "description": "世系人物ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LineagePersonBody"
              },
              "example": {
                "appUserId": 900000001,
                "personNo": "P202607090001",
                "personName": "彭德明",
                "aliasName": "德明",
                "sex": "0",
                "generationNo": 1,
                "generationName": "德",
                "avatarOssId": "2060000000000000000",
                "birthDate": "1950-01-01",
                "deathDate": null,
                "introduction": "first generation introduction"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "delete": {
        "summary": "APP 删除世系人物",
        "deprecated": false,
        "description": "",
        "tags": [
          "世系人物"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "personId",
            "in": "path",
            "description": "世系人物ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/VoidResult",
            "description": "通用成功响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}/children": {
      "post": {
        "summary": "APP 给人物添加子女",
        "deprecated": false,
        "description": "",
        "tags": [
          "世系人物"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "personId",
            "in": "path",
            "description": "世系人物ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LineagePersonBody"
              },
              "example": {
                "appUserId": 900000001,
                "personNo": "P202607090001",
                "personName": "彭德明",
                "aliasName": "德明",
                "sex": "0",
                "generationNo": 1,
                "generationName": "德",
                "avatarOssId": "2060000000000000000",
                "birthDate": "1950-01-01",
                "deathDate": null,
                "introduction": "first generation introduction"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}/parents": {
      "post": {
        "summary": "APP 给人物添加父母",
        "deprecated": false,
        "description": "",
        "tags": [
          "世系人物"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "personId",
            "in": "path",
            "description": "世系人物ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LineagePersonBody"
              },
              "example": {
                "appUserId": 900000001,
                "personNo": "P202607090001",
                "personName": "彭德明",
                "aliasName": "德明",
                "sex": "0",
                "generationNo": 1,
                "generationName": "德",
                "avatarOssId": "2060000000000000000",
                "birthDate": "1950-01-01",
                "deathDate": null,
                "introduction": "first generation introduction"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}/siblings": {
      "post": {
        "summary": "APP 给人物添加兄弟姐妹",
        "deprecated": false,
        "description": "",
        "tags": [
          "世系人物"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "personId",
            "in": "path",
            "description": "世系人物ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LineagePersonBody"
              },
              "example": {
                "appUserId": 900000001,
                "personNo": "P202607090001",
                "personName": "彭德明",
                "aliasName": "德明",
                "sex": "0",
                "generationNo": 1,
                "generationName": "德",
                "avatarOssId": "2060000000000000000",
                "birthDate": "1950-01-01",
                "deathDate": null,
                "introduction": "first generation introduction"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}/spouses": {
      "post": {
        "summary": "APP 给人物添加配偶",
        "deprecated": false,
        "description": "",
        "tags": [
          "世系人物"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "personId",
            "in": "path",
            "description": "世系人物ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LineagePersonBody"
              },
              "example": {
                "appUserId": 900000001,
                "personNo": "P202607090001",
                "personName": "彭德明",
                "aliasName": "德明",
                "sex": "0",
                "generationNo": 1,
                "generationName": "德",
                "avatarOssId": "2060000000000000000",
                "birthDate": "1950-01-01",
                "deathDate": null,
                "introduction": "first generation introduction"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/feeds": {
      "get": {
        "summary": "APP 家族圈动态列表",
        "deprecated": false,
        "description": "",
        "tags": [
          "家族圈"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "post": {
        "summary": "APP 发布家族圈动态",
        "deprecated": false,
        "description": "",
        "tags": [
          "家族圈"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FamilyFeedBody"
              },
              "example": {
                "content": "今天上传一张老照片。",
                "mediaOssIds": "2060000000000000001,2060000000000000002",
                "visibility": "1",
                "status": "0"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/feeds/page": {
      "get": {
        "summary": "APP 家族圈动态分页",
        "deprecated": false,
        "description": "",
        "tags": [
          "家族圈"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "pageNum",
            "in": "query",
            "description": "页码，从1开始",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 1
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "description": "每页条数",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 10
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/PageResult",
            "description": "通用分页响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/feeds/{feedId}": {
      "get": {
        "summary": "APP 家族圈动态详情",
        "deprecated": false,
        "description": "",
        "tags": [
          "家族圈"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "feedId",
            "in": "path",
            "description": "家族动态ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "put": {
        "summary": "APP 修改家族圈动态",
        "deprecated": false,
        "description": "",
        "tags": [
          "家族圈"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "feedId",
            "in": "path",
            "description": "家族动态ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FamilyFeedBody"
              },
              "example": {
                "content": "今天上传一张老照片。",
                "mediaOssIds": "2060000000000000001,2060000000000000002",
                "visibility": "1",
                "status": "0"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/feeds/{feedId}/likes": {
      "post": {
        "summary": "APP 点赞动态",
        "deprecated": false,
        "description": "",
        "tags": [
          "家族圈"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "feedId",
            "in": "path",
            "description": "家族动态ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/VoidResult",
            "description": "通用成功响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "delete": {
        "summary": "APP 取消点赞动态",
        "deprecated": false,
        "description": "",
        "tags": [
          "家族圈"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "feedId",
            "in": "path",
            "description": "家族动态ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/VoidResult",
            "description": "通用成功响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/feeds/{feedId}/comments": {
      "get": {
        "summary": "APP 动态评论列表",
        "deprecated": false,
        "description": "",
        "tags": [
          "家族圈"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "feedId",
            "in": "path",
            "description": "家族动态ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "post": {
        "summary": "APP 评论动态",
        "deprecated": false,
        "description": "",
        "tags": [
          "家族圈"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "feedId",
            "in": "path",
            "description": "家族动态ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FamilyFeedCommentBody"
              },
              "example": {
                "parentCommentId": null,
                "replyUserId": null,
                "content": "这张照片很有年代感。"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/feeds/{feedId}/comments/page": {
      "get": {
        "summary": "APP 动态评论分页",
        "deprecated": false,
        "description": "",
        "tags": [
          "家族圈"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "feedId",
            "in": "path",
            "description": "家族动态ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "pageNum",
            "in": "query",
            "description": "页码，从1开始",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 1
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "description": "每页条数",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 10
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/PageResult",
            "description": "通用分页响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/feeds/{feedId}/comments/{commentId}": {
      "delete": {
        "summary": "APP 删除动态评论",
        "deprecated": false,
        "description": "",
        "tags": [
          "家族圈"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "feedId",
            "in": "path",
            "description": "家族动态ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "commentId",
            "in": "path",
            "description": "评论ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/VoidResult",
            "description": "通用成功响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/article-categories": {
      "get": {
        "summary": "APP 谱文分类",
        "deprecated": false,
        "description": "",
        "tags": [
          "内容文章"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/articles": {
      "get": {
        "summary": "APP 谱文列表",
        "deprecated": false,
        "description": "",
        "tags": [
          "内容文章"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "post": {
        "summary": "APP 新增谱文",
        "deprecated": false,
        "description": "",
        "tags": [
          "内容文章"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ArticleBody"
              },
              "example": {
                "categoryId": 900040001,
                "articleTitle": "族谱源流",
                "articleSummary": "介绍本支源流",
                "coverOssId": "2060000000000000000",
                "articleContent": "<p>article content</p>",
                "authorName": "族谱管理员",
                "sortOrder": 1,
                "status": "0"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/articles/{articleId}": {
      "get": {
        "summary": "APP 谱文详情",
        "deprecated": false,
        "description": "",
        "tags": [
          "内容文章"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "articleId",
            "in": "path",
            "description": "谱文/官网文章ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "put": {
        "summary": "APP 修改谱文",
        "deprecated": false,
        "description": "",
        "tags": [
          "内容文章"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "articleId",
            "in": "path",
            "description": "谱文/官网文章ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ArticleBody"
              },
              "example": {
                "categoryId": 900040001,
                "articleTitle": "族谱源流",
                "articleSummary": "介绍本支源流",
                "coverOssId": "2060000000000000000",
                "articleContent": "<p>article content</p>",
                "authorName": "族谱管理员",
                "sortOrder": 1,
                "status": "0"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/help-articles": {
      "get": {
        "summary": "APP 帮助文章列表",
        "deprecated": false,
        "description": "",
        "tags": [
          "内容文章"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID",
            "example": "ced7e5f0498645c6ec642dcf450b036f",
            "schema": {
              "type": "string",
              "default": "ced7e5f0498645c6ec642dcf450b036f"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/help-articles/{helpId}": {
      "get": {
        "summary": "APP 帮助文章详情",
        "deprecated": false,
        "description": "",
        "tags": [
          "内容文章"
        ],
        "parameters": [
          {
            "name": "helpId",
            "in": "path",
            "description": "帮助文章ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID",
            "example": "ced7e5f0498645c6ec642dcf450b036f",
            "schema": {
              "type": "string",
              "default": "ced7e5f0498645c6ec642dcf450b036f"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/promotions": {
      "get": {
        "summary": "APP 应用推广列表",
        "deprecated": false,
        "description": "",
        "tags": [
          "内容文章"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID",
            "example": "ced7e5f0498645c6ec642dcf450b036f",
            "schema": {
              "type": "string",
              "default": "ced7e5f0498645c6ec642dcf450b036f"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/albums": {
      "get": {
        "summary": "APP 相册列表",
        "deprecated": false,
        "description": "",
        "tags": [
          "相册"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "post": {
        "summary": "APP 创建相册",
        "deprecated": false,
        "description": "",
        "tags": [
          "相册"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AlbumBody"
              },
              "example": {
                "albumName": "老照片",
                "albumDesc": "family old photos",
                "coverOssId": "2060000000000000000",
                "sortOrder": 1,
                "status": "0"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/albums/{albumId}": {
      "put": {
        "summary": "APP 修改相册",
        "deprecated": false,
        "description": "",
        "tags": [
          "相册"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "albumId",
            "in": "path",
            "description": "相册ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AlbumBody"
              },
              "example": {
                "albumName": "老照片",
                "albumDesc": "family old photos",
                "coverOssId": "2060000000000000000",
                "sortOrder": 1,
                "status": "0"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/albums/{albumId}/photos": {
      "get": {
        "summary": "APP 相册图片列表",
        "deprecated": false,
        "description": "",
        "tags": [
          "相册"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "albumId",
            "in": "path",
            "description": "相册ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "post": {
        "summary": "APP 上传相册图片记录",
        "deprecated": false,
        "description": "",
        "tags": [
          "相册"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "albumId",
            "in": "path",
            "description": "相册ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AlbumPhotoBody"
              },
              "example": {
                "ossId": "2060000000000000000",
                "photoTitle": "老宅合影",
                "photoDesc": "old house photo",
                "photographer": "彭小明",
                "shootTime": "2026-07-09 10:00:00",
                "sortOrder": 1,
                "status": "0"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/ceremonies": {
      "get": {
        "summary": "APP 祭祀列表",
        "deprecated": false,
        "description": "",
        "tags": [
          "祭祀"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "post": {
        "summary": "APP 创建祭祀",
        "deprecated": false,
        "description": "",
        "tags": [
          "祭祀"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CeremonyBody"
              },
              "example": {
                "ceremonyType": "ancestor",
                "ceremonyTitle": "清明祭祖",
                "ceremonyDesc": "online ancestor ceremony",
                "ceremonyTime": "2026-04-04 09:00:00",
                "location": "祠堂",
                "coverOssId": "2060000000000000000",
                "sortOrder": 1,
                "status": "0"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/ceremonies/{ceremonyId}": {
      "get": {
        "summary": "APP 祭祀详情",
        "deprecated": false,
        "description": "",
        "tags": [
          "祭祀"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "ceremonyId",
            "in": "path",
            "description": "祭祀/活动ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "put": {
        "summary": "APP 修改祭祀",
        "deprecated": false,
        "description": "",
        "tags": [
          "祭祀"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "ceremonyId",
            "in": "path",
            "description": "祭祀/活动ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CeremonyBody"
              },
              "example": {
                "ceremonyType": "ancestor",
                "ceremonyTitle": "清明祭祖",
                "ceremonyDesc": "online ancestor ceremony",
                "ceremonyTime": "2026-04-04 09:00:00",
                "location": "祠堂",
                "coverOssId": "2060000000000000000",
                "sortOrder": 1,
                "status": "0"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/ceremonies/{ceremonyId}/gifts": {
      "get": {
        "summary": "APP 祭祀献礼列表",
        "deprecated": false,
        "description": "",
        "tags": [
          "祭祀"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "ceremonyId",
            "in": "path",
            "description": "祭祀/活动ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "post": {
        "summary": "APP 新增祭祀献礼",
        "deprecated": false,
        "description": "",
        "tags": [
          "祭祀"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "ceremonyId",
            "in": "path",
            "description": "祭祀/活动ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CeremonyGiftBody"
              },
              "example": {
                "giverName": "彭小明",
                "giftAmount": 66.66,
                "giftMessage": "缅怀先祖"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/growth-records": {
      "get": {
        "summary": "APP 成长记录列表",
        "deprecated": false,
        "description": "",
        "tags": [
          "族务记录"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "post": {
        "summary": "APP 新增成长记录",
        "deprecated": false,
        "description": "",
        "tags": [
          "族务记录"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GrowthRecordBody"
              },
              "example": {
                "lineagePersonId": 900020001,
                "recordType": "birth",
                "recordTitle": "出生记录",
                "recordContent": "birth record",
                "recordDate": "2026-07-09 10:00:00",
                "remindTime": "2027-07-09 10:00:00",
                "mediaOssIds": "2060000000000000001",
                "sortOrder": 1,
                "status": "0"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/growth-records/{recordId}": {
      "get": {
        "summary": "APP 成长记录详情",
        "deprecated": false,
        "description": "",
        "tags": [
          "族务记录"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "recordId",
            "in": "path",
            "description": "记录ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "put": {
        "summary": "APP 修改成长记录",
        "deprecated": false,
        "description": "",
        "tags": [
          "族务记录"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "recordId",
            "in": "path",
            "description": "记录ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GrowthRecordBody"
              },
              "example": {
                "lineagePersonId": 900020001,
                "recordType": "birth",
                "recordTitle": "出生记录",
                "recordContent": "birth record",
                "recordDate": "2026-07-09 10:00:00",
                "remindTime": "2027-07-09 10:00:00",
                "mediaOssIds": "2060000000000000001",
                "sortOrder": 1,
                "status": "0"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/memos": {
      "get": {
        "summary": "APP 备忘录列表",
        "deprecated": false,
        "description": "",
        "tags": [
          "族务记录"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "post": {
        "summary": "APP 新增备忘录",
        "deprecated": false,
        "description": "",
        "tags": [
          "族务记录"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MemoBody"
              },
              "example": {
                "memoTitle": "修谱事项",
                "memoContent": "contact family members",
                "remindTime": "2026-08-01 09:00:00",
                "completed": "0",
                "mediaOssIds": "2060000000000000001",
                "sortOrder": 1,
                "status": "0"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/memos/{memoId}": {
      "get": {
        "summary": "APP 备忘录详情",
        "deprecated": false,
        "description": "",
        "tags": [
          "族务记录"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "memoId",
            "in": "path",
            "description": "",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "put": {
        "summary": "APP 修改备忘录",
        "deprecated": false,
        "description": "",
        "tags": [
          "族务记录"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "memoId",
            "in": "path",
            "description": "",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MemoBody"
              },
              "example": {
                "memoTitle": "修谱事项",
                "memoContent": "contact family members",
                "remindTime": "2026-08-01 09:00:00",
                "completed": "0",
                "mediaOssIds": "2060000000000000001",
                "sortOrder": 1,
                "status": "0"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/genealogies/{genealogyId}/merit-records": {
      "get": {
        "summary": "APP 功德记录列表",
        "deprecated": false,
        "description": "",
        "tags": [
          "族务记录"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "post": {
        "summary": "APP 新增功德记录",
        "deprecated": false,
        "description": "",
        "tags": [
          "族务记录"
        ],
        "parameters": [
          {
            "name": "genealogyId",
            "in": "path",
            "description": "家谱ID",
            "required": true,
            "example": 900001001,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MeritRecordBody"
              },
              "example": {
                "donorName": "彭小明",
                "meritType": "donation",
                "meritTitle": "修谱捐款",
                "meritContent": "support genealogy work",
                "amount": 100,
                "meritTime": "2026-07-09 10:00:00",
                "sortOrder": 1,
                "status": "0"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/notifications": {
      "get": {
        "summary": "APP 消息通知列表",
        "deprecated": false,
        "description": "",
        "tags": [
          "消息通知"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/notifications/{notificationId}/read": {
      "post": {
        "summary": "APP 标记通知已读",
        "deprecated": false,
        "description": "",
        "tags": [
          "消息通知"
        ],
        "parameters": [
          {
            "name": "notificationId",
            "in": "path",
            "description": "通知ID",
            "required": true,
            "example": "",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/VoidResult",
            "description": "通用成功响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/notifications/read-all": {
      "post": {
        "summary": "APP 全部标记已读",
        "deprecated": false,
        "description": "",
        "tags": [
          "消息通知"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/VoidResult",
            "description": "通用成功响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/feedback": {
      "get": {
        "summary": "APP 我的反馈列表",
        "deprecated": false,
        "description": "",
        "tags": [
          "意见反馈"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "post": {
        "summary": "APP 提交反馈",
        "deprecated": false,
        "description": "",
        "tags": [
          "意见反馈"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FeedbackBody"
              },
              "example": {
                "feedbackType": "bug",
                "feedbackContent": "upload image failed",
                "contactInfo": "13800000000"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/vip/packages": {
      "get": {
        "summary": "APP VIP 套餐列表",
        "deprecated": false,
        "description": "",
        "tags": [
          "VIP"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    },
    "/genealogy/app/vip/orders": {
      "get": {
        "summary": "APP VIP 订单列表",
        "deprecated": false,
        "description": "",
        "tags": [
          "VIP"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ListResult",
            "description": "通用列表响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      },
      "post": {
        "summary": "APP 创建 VIP 订单",
        "deprecated": false,
        "description": "",
        "tags": [
          "VIP"
        ],
        "parameters": [
          {
            "name": "clientid",
            "in": "header",
            "description": "客户端ID，请求Header携带，用于区分APP/PC/小程序等终端",
            "required": true,
            "example": "428a8310cd442757ae699df5d894f051",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VipOrderBody"
              },
              "example": {
                "packageId": 900060001,
                "genealogyId": 900001001,
                "payType": "wechat"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ObjectResult",
            "description": "通用对象响应"
          }
        },
        "security": [
          {
            "SaToken": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "PasswordRegisterBody": {
        "type": "object",
        "required": [
          "grantType",
          "tenantId",
          "phone",
          "password"
        ],
        "properties": {
          "clientId": {
            "description": "客户端ID，对应后台客户端管理中的APP/PC/小程序等终端",
            "type": "string"
          },
          "grantType": {
            "description": "授权类型，例如password、sms、wechat、apple",
            "type": "string",
            "example": "password"
          },
          "tenantId": {
            "description": "租户ID，用于区分不同租户的数据和验证策略",
            "type": "string",
            "example": "000000"
          },
          "phone": {
            "description": "手机号",
            "type": "string",
            "example": "13800000000"
          },
          "password": {
            "type": "string",
            "description": "32 位 MD5",
            "example": "e10adc3949ba59abbe56e057f20f883e"
          },
          "nickName": {
            "description": "用户昵称",
            "type": "string"
          },
          "registerSource": {
            "description": "注册来源，例如APP、PC、H5、MINI_PROGRAM",
            "type": "string"
          },
          "validToken": {
            "description": "验证中心通过后返回的票据，用于注册/登录/换绑等二次校验",
            "type": "string"
          }
        }
      },
      "PasswordLoginBody": {
        "type": "object",
        "required": [
          "grantType",
          "tenantId",
          "phone",
          "password"
        ],
        "properties": {
          "clientId": {
            "description": "客户端ID，对应后台客户端管理中的APP/PC/小程序等终端",
            "type": "string"
          },
          "grantType": {
            "description": "授权类型，例如password、sms、wechat、apple",
            "type": "string",
            "example": "password"
          },
          "tenantId": {
            "description": "租户ID，用于区分不同租户的数据和验证策略",
            "type": "string",
            "example": "000000"
          },
          "phone": {
            "description": "手机号",
            "type": "string",
            "example": "13800000000"
          },
          "password": {
            "type": "string",
            "description": "32 位 MD5",
            "example": "e10adc3949ba59abbe56e057f20f883e"
          },
          "validToken": {
            "description": "验证中心通过后返回的票据，用于注册/登录/换绑等二次校验",
            "type": "string"
          }
        }
      },
      "SmsLoginBody": {
        "type": "object",
        "required": [
          "grantType",
          "tenantId",
          "phone",
          "smsCode"
        ],
        "properties": {
          "clientId": {
            "description": "客户端ID，对应后台客户端管理中的APP/PC/小程序等终端",
            "type": "string"
          },
          "grantType": {
            "description": "授权类型，例如password、sms、wechat、apple",
            "type": "string",
            "example": "sms"
          },
          "tenantId": {
            "description": "租户ID，用于区分不同租户的数据和验证策略",
            "type": "string",
            "example": "000000"
          },
          "phone": {
            "description": "手机号",
            "type": "string",
            "example": "13800000000"
          },
          "smsCode": {
            "description": "短信验证码",
            "type": "string",
            "example": "1234"
          }
        }
      },
      "SmsCodeBody": {
        "type": "object",
        "required": [
          "grantType",
          "tenantId",
          "sceneCode",
          "phone",
          "validToken"
        ],
        "properties": {
          "clientId": {
            "description": "客户端ID，对应后台客户端管理中的APP/PC/小程序等终端",
            "type": "string"
          },
          "grantType": {
            "description": "授权类型，例如password、sms、wechat、apple",
            "type": "string",
            "example": "sms"
          },
          "tenantId": {
            "description": "租户ID，用于区分不同租户的数据和验证策略",
            "type": "string",
            "example": "000000"
          },
          "sceneCode": {
            "description": "验证场景编码，例如APP_LOGIN、PC_LOGIN、APP_REGISTER",
            "type": "string",
            "example": "APP_LOGIN"
          },
          "phone": {
            "description": "手机号",
            "type": "string",
            "example": "13800000000"
          },
          "validToken": {
            "description": "验证中心通过后返回的票据，用于注册/登录/换绑等二次校验",
            "type": "string"
          }
        }
      },
      "ProfileUpdateBody": {
        "type": "object",
        "properties": {
          "nickName": {
            "description": "用户昵称",
            "type": "string"
          },
          "avatarOssId": {
            "description": "头像文件OSS ID",
            "type": "integer",
            "format": "int64"
          },
          "sex": {
            "description": "性别，建议使用系统字典值",
            "type": "string"
          },
          "birthday": {
            "description": "生日，格式 yyyy-MM-dd",
            "type": "string",
            "format": "date"
          },
          "provinceCode": {
            "type": "string"
          },
          "cityCode": {
            "type": "string"
          },
          "districtCode": {
            "type": "string"
          }
        }
      },
      "PasswordChangeBody": {
        "type": "object",
        "required": [
          "oldPassword",
          "newPassword"
        ],
        "properties": {
          "oldPassword": {
            "type": "string",
            "description": "32 位 MD5"
          },
          "newPassword": {
            "type": "string",
            "description": "32 位 MD5"
          }
        }
      },
      "PasswordResetBody": {
        "type": "object",
        "required": [
          "tenantId",
          "phone",
          "smsCode",
          "newPassword"
        ],
        "properties": {
          "tenantId": {
            "description": "租户ID，用于区分不同租户的数据和验证策略",
            "type": "string",
            "example": "000000"
          },
          "phone": {
            "description": "手机号",
            "type": "string"
          },
          "smsCode": {
            "description": "短信验证码",
            "type": "string"
          },
          "newPassword": {
            "type": "string",
            "description": "32 位 MD5"
          },
          "validToken": {
            "description": "验证中心通过后返回的票据，用于注册/登录/换绑等二次校验",
            "type": "string"
          }
        }
      },
      "PhoneChangeBody": {
        "type": "object",
        "required": [
          "newPhone",
          "smsCode"
        ],
        "properties": {
          "newPhone": {
            "type": "string"
          },
          "smsCode": {
            "description": "短信验证码",
            "type": "string"
          },
          "validToken": {
            "description": "验证中心通过后返回的票据，用于注册/登录/换绑等二次校验",
            "type": "string"
          }
        }
      },
      "AccountDeactivateBody": {
        "type": "object",
        "required": [
          "password"
        ],
        "properties": {
          "password": {
            "type": "string",
            "description": "32 位 MD5"
          },
          "reason": {
            "description": "操作原因或说明",
            "type": "string"
          }
        }
      },
      "ResumableInitBody": {
        "type": "object",
        "required": [
          "fileName",
          "fileSize",
          "fileMd5",
          "chunkSize",
          "totalChunks"
        ],
        "properties": {
          "fileName": {
            "description": "原始文件名",
            "type": "string"
          },
          "fileSize": {
            "description": "文件大小，单位字节",
            "type": "integer",
            "format": "int64"
          },
          "fileMd5": {
            "description": "完整文件MD5，用于秒传和完整性校验",
            "type": "string"
          },
          "contentType": {
            "description": "文件MIME类型，例如 image/jpeg、video/mp4",
            "type": "string"
          },
          "chunkSize": {
            "description": "单个分片大小，单位字节",
            "type": "integer",
            "example": 4194304
          },
          "totalChunks": {
            "description": "总分片数",
            "type": "integer"
          },
          "bizType": {
            "description": "业务类型，例如avatar、cover、feed_image",
            "type": "string"
          },
          "usageScene": {
            "description": "文件使用场景，便于后续引用统计和清理",
            "type": "string"
          }
        }
      },
      "ResumableCompleteBody": {
        "type": "object",
        "required": [
          "uploadId",
          "fileMd5",
          "fileSize"
        ],
        "properties": {
          "uploadId": {
            "description": "分片上传任务ID",
            "type": "string"
          },
          "fileMd5": {
            "description": "完整文件MD5，用于秒传和完整性校验",
            "type": "string"
          },
          "fileSize": {
            "description": "文件大小，单位字节",
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "FileReferenceBody": {
        "type": "object",
        "required": [
          "bizType",
          "bizTable",
          "bizId",
          "bizField"
        ],
        "properties": {
          "bizType": {
            "description": "业务类型，例如avatar、cover、feed_image",
            "type": "string",
            "example": "family_feed"
          },
          "bizName": {
            "description": "业务名称，用于后台展示文件引用来源",
            "type": "string",
            "example": "家族圈动态"
          },
          "bizTable": {
            "description": "业务表名，用于文件引用绑定",
            "type": "string",
            "example": "gen_family_feed"
          },
          "bizId": {
            "description": "业务数据ID，用于文件引用绑定",
            "type": "integer",
            "format": "int64"
          },
          "bizField": {
            "description": "业务字段名，例如avatar_oss_id、cover_oss_id",
            "type": "string",
            "example": "media_ids"
          },
          "ossId": {
            "description": "OSS文件ID，表单内部使用，用户侧应通过上传组件获取",
            "type": "integer",
            "format": "int64"
          },
          "ossIds": {
            "type": "string",
            "example": "2060001,2060002"
          },
          "usageScene": {
            "description": "文件使用场景，便于后续引用统计和清理",
            "type": "string"
          },
          "usageName": {
            "type": "string"
          }
        }
      },
      "GenerationPoemBatchBody": {
        "type": "object",
        "properties": {
          "content": {
            "type": "string",
            "example": "德承家亦"
          },
          "stopMissingOldGeneration": {
            "type": "boolean",
            "example": false
          }
        }
      },
      "LineagePersonBody": {
        "type": "object",
        "properties": {
          "appUserId": {
            "type": "integer",
            "format": "int64"
          },
          "personNo": {
            "type": "string"
          },
          "personName": {
            "type": "string"
          },
          "aliasName": {
            "type": "string"
          },
          "sex": {
            "description": "性别，建议使用系统字典值",
            "type": "string",
            "example": "0"
          },
          "generationNo": {
            "description": "世代序号",
            "type": "integer"
          },
          "generationName": {
            "description": "字辈",
            "type": "string"
          },
          "avatarOssId": {
            "description": "头像文件OSS ID",
            "type": "integer",
            "format": "int64"
          },
          "birthDate": {
            "type": "string"
          },
          "deathDate": {
            "type": "string"
          },
          "introduction": {
            "type": "string"
          }
        }
      },
      "FamilyFeedBody": {
        "type": "object",
        "properties": {
          "content": {
            "type": "string"
          },
          "mediaOssIds": {
            "description": "媒体文件OSS ID列表，多个用逗号或数组传递以接口约定为准",
            "type": "string",
            "example": "2060001,2060002"
          },
          "visibility": {
            "description": "可见范围，例如0私密、1公开、2成员可见",
            "type": "string",
            "example": "1"
          },
          "status": {
            "description": "状态，建议使用对应字典值",
            "type": "string",
            "example": "0"
          }
        }
      },
      "FamilyFeedCommentBody": {
        "type": "object",
        "required": [
          "content"
        ],
        "properties": {
          "parentCommentId": {
            "type": "integer",
            "format": "int64",
            "nullable": true
          },
          "replyUserId": {
            "type": "integer",
            "format": "int64",
            "nullable": true
          },
          "content": {
            "type": "string"
          }
        }
      },
      "GenealogyCreateBody": {
        "type": "object",
        "required": [
          "genealogyName",
          "surname",
          "regionCode"
        ],
        "properties": {
          "genealogyName": {
            "description": "家谱名称",
            "type": "string"
          },
          "surname": {
            "description": "姓氏",
            "type": "string"
          },
          "ancestralHall": {
            "description": "堂号/祠堂名称",
            "type": "string"
          },
          "originPlace": {
            "description": "籍贯/起源地",
            "type": "string"
          },
          "regionCode": {
            "description": "行政区划编码",
            "type": "string"
          },
          "addressDetail": {
            "description": "详细地址",
            "type": "string"
          },
          "coverOssId": {
            "description": "封面图片OSS ID",
            "type": "integer",
            "format": "int64"
          },
          "intro": {
            "description": "简介",
            "type": "string"
          },
          "visibility": {
            "description": "可见范围，例如0私密、1公开、2成员可见",
            "type": "string"
          },
          "joinMode": {
            "description": "加入方式，例如0关闭、1审核、2邀请码",
            "type": "string"
          }
        },
        "example": {
          "genealogyName": "彭氏家谱",
          "surname": "彭",
          "ancestralHall": "陇西堂",
          "originPlace": "江西吉安",
          "regionCode": "360800",
          "addressDetail": "江西省吉安市",
          "coverOssId": 2060000000000000000,
          "intro": "彭氏家谱简介",
          "visibility": "1",
          "joinMode": "1"
        }
      },
      "GenealogyUpdateBody": {
        "type": "object",
        "properties": {
          "genealogyName": {
            "description": "家谱名称",
            "type": "string"
          },
          "surname": {
            "description": "姓氏",
            "type": "string"
          },
          "ancestralHall": {
            "description": "堂号/祠堂名称",
            "type": "string"
          },
          "originPlace": {
            "description": "籍贯/起源地",
            "type": "string"
          },
          "regionCode": {
            "description": "行政区划编码",
            "type": "string"
          },
          "addressDetail": {
            "description": "详细地址",
            "type": "string"
          },
          "coverOssId": {
            "description": "封面图片OSS ID",
            "type": "integer",
            "format": "int64"
          },
          "intro": {
            "description": "简介",
            "type": "string"
          },
          "visibility": {
            "description": "可见范围，例如0私密、1公开、2成员可见",
            "type": "string"
          },
          "joinMode": {
            "description": "加入方式，例如0关闭、1审核、2邀请码",
            "type": "string"
          }
        },
        "example": {
          "genealogyName": "彭氏家谱",
          "surname": "彭",
          "ancestralHall": "陇西堂",
          "originPlace": "江西吉安",
          "regionCode": "360800",
          "addressDetail": "江西省吉安市",
          "coverOssId": 2060000000000000000,
          "intro": "更新后的家谱简介",
          "visibility": "1",
          "joinMode": "1"
        }
      },
      "GenealogyJoinApplyBody": {
        "type": "object",
        "properties": {
          "applicantName": {
            "description": "申请人姓名",
            "type": "string"
          },
          "phone": {
            "description": "手机号",
            "type": "string"
          },
          "relationDesc": {
            "description": "与家谱/人物的关系说明",
            "type": "string"
          },
          "applyReason": {
            "description": "申请理由",
            "type": "string"
          },
          "inviterUserId": {
            "description": "邀请人业务用户ID",
            "type": "integer",
            "format": "int64"
          }
        },
        "example": {
          "applicantName": "彭小明",
          "phone": "13800000000",
          "relationDesc": "本族成员",
          "applyReason": "申请加入家谱维护",
          "inviterUserId": 900000001
        }
      },
      "GenealogyJoinAuditBody": {
        "type": "object",
        "required": [
          "status"
        ],
        "properties": {
          "status": {
            "description": "状态，建议使用对应字典值",
            "type": "string"
          },
          "auditRemark": {
            "description": "审核备注",
            "type": "string"
          }
        },
        "example": {
          "status": "1",
          "auditRemark": "信息核验通过"
        }
      },
      "GenealogyMemberUpdateBody": {
        "type": "object",
        "properties": {
          "memberName": {
            "description": "成员姓名",
            "type": "string"
          },
          "relationName": {
            "description": "成员关系名称",
            "type": "string"
          },
          "roleType": {
            "description": "成员角色类型，例如创建者、管理员、普通成员",
            "type": "string"
          },
          "lineagePersonId": {
            "description": "绑定的世系人物ID",
            "type": "integer",
            "format": "int64"
          }
        },
        "example": {
          "memberName": "彭小明",
          "relationName": "族亲",
          "roleType": "member",
          "lineagePersonId": 900020001
        }
      },
      "GenealogyOwnerTransferBody": {
        "type": "object",
        "required": [
          "targetMemberId"
        ],
        "properties": {
          "targetMemberId": {
            "description": "目标成员ID",
            "type": "integer",
            "format": "int64"
          }
        },
        "example": {
          "targetMemberId": 900010002
        }
      },
      "GenerationPoemBody": {
        "type": "object",
        "required": [
          "generationNo",
          "generationText"
        ],
        "properties": {
          "generationNo": {
            "description": "世代序号",
            "type": "integer",
            "format": "int64"
          },
          "generationText": {
            "description": "字辈内容，可单字或批量字辈文本",
            "type": "string"
          },
          "description": {
            "description": "说明或备注",
            "type": "string"
          },
          "sortOrder": {
            "description": "排序值，数值越小越靠前",
            "type": "integer",
            "format": "int64"
          },
          "status": {
            "description": "状态，建议使用对应字典值",
            "type": "string"
          }
        },
        "example": {
          "generationNo": 5,
          "generationText": "忠",
          "description": "fifth generation poem",
          "sortOrder": 5,
          "status": "0"
        }
      },
      "ArticleBody": {
        "type": "object",
        "required": [
          "articleTitle",
          "articleContent"
        ],
        "properties": {
          "categoryId": {
            "description": "分类ID",
            "type": "integer",
            "format": "int64"
          },
          "articleTitle": {
            "description": "文章标题",
            "type": "string"
          },
          "articleSummary": {
            "description": "文章摘要",
            "type": "string"
          },
          "coverOssId": {
            "description": "封面图片OSS ID",
            "type": "integer",
            "format": "int64"
          },
          "articleContent": {
            "description": "文章内容",
            "type": "string"
          },
          "authorName": {
            "description": "作者名称",
            "type": "string"
          },
          "sortOrder": {
            "description": "排序值，数值越小越靠前",
            "type": "integer",
            "format": "int64"
          },
          "status": {
            "description": "状态，建议使用对应字典值",
            "type": "string"
          }
        },
        "example": {
          "categoryId": 900040001,
          "articleTitle": "族谱源流",
          "articleSummary": "介绍本支源流",
          "coverOssId": 2060000000000000000,
          "articleContent": "<p>article content</p>",
          "authorName": "族谱管理员",
          "sortOrder": 1,
          "status": "0"
        }
      },
      "AlbumBody": {
        "type": "object",
        "required": [
          "albumName"
        ],
        "properties": {
          "albumName": {
            "description": "相册名称",
            "type": "string"
          },
          "albumDesc": {
            "description": "相册说明",
            "type": "string"
          },
          "coverOssId": {
            "description": "封面图片OSS ID",
            "type": "integer",
            "format": "int64"
          },
          "sortOrder": {
            "description": "排序值，数值越小越靠前",
            "type": "integer",
            "format": "int64"
          },
          "status": {
            "description": "状态，建议使用对应字典值",
            "type": "string"
          }
        },
        "example": {
          "albumName": "老照片",
          "albumDesc": "family old photos",
          "coverOssId": 2060000000000000000,
          "sortOrder": 1,
          "status": "0"
        }
      },
      "AlbumPhotoBody": {
        "type": "object",
        "required": [
          "ossId"
        ],
        "properties": {
          "ossId": {
            "description": "OSS文件ID，表单内部使用，用户侧应通过上传组件获取",
            "type": "integer",
            "format": "int64"
          },
          "photoTitle": {
            "description": "图片标题",
            "type": "string"
          },
          "photoDesc": {
            "description": "图片说明",
            "type": "string"
          },
          "photographer": {
            "description": "拍摄人",
            "type": "string"
          },
          "shootTime": {
            "description": "拍摄时间",
            "type": "string"
          },
          "sortOrder": {
            "description": "排序值，数值越小越靠前",
            "type": "integer",
            "format": "int64"
          },
          "status": {
            "description": "状态，建议使用对应字典值",
            "type": "string"
          }
        },
        "example": {
          "ossId": 2060000000000000000,
          "photoTitle": "老宅合影",
          "photoDesc": "old house photo",
          "photographer": "彭小明",
          "shootTime": "2026-07-09 10:00:00",
          "sortOrder": 1,
          "status": "0"
        }
      },
      "CeremonyBody": {
        "type": "object",
        "required": [
          "ceremonyType",
          "ceremonyTitle"
        ],
        "properties": {
          "ceremonyType": {
            "description": "祭祀/活动类型",
            "type": "string"
          },
          "ceremonyTitle": {
            "description": "祭祀/活动标题",
            "type": "string"
          },
          "ceremonyDesc": {
            "description": "祭祀/活动说明",
            "type": "string"
          },
          "ceremonyTime": {
            "description": "祭祀/活动时间",
            "type": "string"
          },
          "location": {
            "description": "地点",
            "type": "string"
          },
          "coverOssId": {
            "description": "封面图片OSS ID",
            "type": "integer",
            "format": "int64"
          },
          "sortOrder": {
            "description": "排序值，数值越小越靠前",
            "type": "integer",
            "format": "int64"
          },
          "status": {
            "description": "状态，建议使用对应字典值",
            "type": "string"
          }
        },
        "example": {
          "ceremonyType": "ancestor",
          "ceremonyTitle": "清明祭祖",
          "ceremonyDesc": "online ancestor ceremony",
          "ceremonyTime": "2026-04-04 09:00:00",
          "location": "祠堂",
          "coverOssId": 2060000000000000000,
          "sortOrder": 1,
          "status": "0"
        }
      },
      "CeremonyGiftBody": {
        "type": "object",
        "required": [
          "giftAmount"
        ],
        "properties": {
          "giverName": {
            "description": "赠送人/献礼人姓名",
            "type": "string"
          },
          "giftAmount": {
            "description": "礼物金额",
            "type": "number",
            "format": "double"
          },
          "giftMessage": {
            "description": "礼物留言",
            "type": "string"
          }
        },
        "example": {
          "giverName": "彭小明",
          "giftAmount": 66.66,
          "giftMessage": "缅怀先祖"
        }
      },
      "GrowthRecordBody": {
        "type": "object",
        "required": [
          "recordTitle"
        ],
        "properties": {
          "lineagePersonId": {
            "description": "绑定的世系人物ID",
            "type": "integer",
            "format": "int64"
          },
          "recordType": {
            "description": "记录类型",
            "type": "string"
          },
          "recordTitle": {
            "description": "记录标题",
            "type": "string"
          },
          "recordContent": {
            "description": "记录内容",
            "type": "string"
          },
          "recordDate": {
            "description": "记录日期",
            "type": "string"
          },
          "remindTime": {
            "description": "提醒时间",
            "type": "string"
          },
          "mediaOssIds": {
            "description": "媒体文件OSS ID列表，多个用逗号或数组传递以接口约定为准",
            "type": "string"
          },
          "sortOrder": {
            "description": "排序值，数值越小越靠前",
            "type": "integer",
            "format": "int64"
          },
          "status": {
            "description": "状态，建议使用对应字典值",
            "type": "string"
          }
        },
        "example": {
          "lineagePersonId": 900020001,
          "recordType": "birth",
          "recordTitle": "出生记录",
          "recordContent": "birth record",
          "recordDate": "2026-07-09 10:00:00",
          "remindTime": "2027-07-09 10:00:00",
          "mediaOssIds": "2060000000000000001",
          "sortOrder": 1,
          "status": "0"
        }
      },
      "MemoBody": {
        "type": "object",
        "required": [
          "memoTitle"
        ],
        "properties": {
          "memoTitle": {
            "description": "备忘标题",
            "type": "string"
          },
          "memoContent": {
            "description": "备忘内容",
            "type": "string"
          },
          "remindTime": {
            "description": "提醒时间",
            "type": "string"
          },
          "completed": {
            "description": "是否已完成",
            "type": "string"
          },
          "mediaOssIds": {
            "description": "媒体文件OSS ID列表，多个用逗号或数组传递以接口约定为准",
            "type": "string"
          },
          "sortOrder": {
            "description": "排序值，数值越小越靠前",
            "type": "integer",
            "format": "int64"
          },
          "status": {
            "description": "状态，建议使用对应字典值",
            "type": "string"
          }
        },
        "example": {
          "memoTitle": "修谱事项",
          "memoContent": "contact family members",
          "remindTime": "2026-08-01 09:00:00",
          "completed": "0",
          "mediaOssIds": "2060000000000000001",
          "sortOrder": 1,
          "status": "0"
        }
      },
      "MeritRecordBody": {
        "type": "object",
        "required": [
          "donorName",
          "meritTitle"
        ],
        "properties": {
          "donorName": {
            "description": "功德人/捐赠人姓名",
            "type": "string"
          },
          "meritType": {
            "description": "功德类型",
            "type": "string"
          },
          "meritTitle": {
            "description": "功德标题",
            "type": "string"
          },
          "meritContent": {
            "description": "功德内容",
            "type": "string"
          },
          "amount": {
            "description": "金额",
            "type": "number",
            "format": "double"
          },
          "meritTime": {
            "description": "功德时间",
            "type": "string"
          },
          "sortOrder": {
            "description": "排序值，数值越小越靠前",
            "type": "integer",
            "format": "int64"
          },
          "status": {
            "description": "状态，建议使用对应字典值",
            "type": "string"
          }
        },
        "example": {
          "donorName": "彭小明",
          "meritType": "donation",
          "meritTitle": "修谱捐款",
          "meritContent": "support genealogy work",
          "amount": 100,
          "meritTime": "2026-07-09 10:00:00",
          "sortOrder": 1,
          "status": "0"
        }
      },
      "FeedbackBody": {
        "type": "object",
        "required": [
          "feedbackContent"
        ],
        "properties": {
          "feedbackType": {
            "description": "反馈类型",
            "type": "string"
          },
          "feedbackContent": {
            "description": "反馈内容",
            "type": "string"
          },
          "contactInfo": {
            "description": "联系方式",
            "type": "string"
          }
        },
        "example": {
          "feedbackType": "bug",
          "feedbackContent": "upload image failed",
          "contactInfo": "13800000000"
        }
      },
      "VipOrderBody": {
        "type": "object",
        "required": [
          "packageId"
        ],
        "properties": {
          "packageId": {
            "description": "VIP套餐ID",
            "type": "integer",
            "format": "int64"
          },
          "genealogyId": {
            "description": "家谱ID",
            "type": "integer",
            "format": "int64"
          },
          "payType": {
            "description": "支付方式",
            "type": "string"
          }
        },
        "example": {
          "packageId": 900060001,
          "genealogyId": 900001001,
          "payType": "wechat"
        }
      },
      "VerificationChallengeBody": {
        "type": "object",
        "required": [
          "sceneCode"
        ],
        "properties": {
          "tenantId": {
            "type": "string",
            "description": "租户 ID"
          },
          "clientId": {
            "type": "string",
            "description": "客户端 ID"
          },
          "sceneCode": {
            "type": "string",
            "description": "验证场景编码，如 ADMIN_LOGIN/APP_LOGIN/APP_REGISTER"
          },
          "subject": {
            "type": "string",
            "description": "验证主体，如手机号/用户名/IP"
          }
        },
        "example": {
          "tenantId": "000000",
          "clientId": "428a8310cd442757ae699df5d894f051",
          "sceneCode": "APP_LOGIN",
          "subject": "13800000000"
        }
      },
      "VerificationCheckBody": {
        "type": "object",
        "required": [
          "sceneCode"
        ],
        "properties": {
          "tenantId": {
            "description": "租户ID，用于区分不同租户的数据和验证策略",
            "type": "string"
          },
          "clientId": {
            "description": "客户端ID，对应后台客户端管理中的APP/PC/小程序等终端",
            "type": "string"
          },
          "sceneCode": {
            "description": "验证场景编码，例如APP_LOGIN、PC_LOGIN、APP_REGISTER",
            "type": "string"
          },
          "subject": {
            "description": "验证主体，通常为手机号、用户ID或登录账号",
            "type": "string"
          },
          "challengeId": {
            "description": "验证挑战ID，由验证挑战接口返回",
            "type": "string"
          },
          "providerCode": {
            "type": "string",
            "description": "验证服务，tianai 或 ruoyi_image"
          },
          "captchaType": {
            "type": "string",
            "description": "SLIDER/ROTATE/CONCAT/WORD_IMAGE_CLICK/math/char"
          },
          "payload": {
            "type": "object",
            "additionalProperties": true,
            "description": "前端验证控件返回的轨迹/点击/图形验证码数据",
            "properties": {}
          }
        }
      },
      "RVoid": {
        "type": "object",
        "properties": {
          "code": {
            "description": "系统图形验证码或响应状态码",
            "type": "integer",
            "example": 200
          },
          "msg": {
            "description": "响应消息",
            "type": "string",
            "example": "操作成功"
          },
          "data": {
            "description": "响应数据主体",
            "type": "null"
          }
        }
      },
      "RObject": {
        "type": "object",
        "properties": {
          "code": {
            "description": "系统图形验证码或响应状态码",
            "type": "integer",
            "example": 200
          },
          "msg": {
            "description": "响应消息",
            "type": "string",
            "example": "操作成功"
          },
          "data": {
            "description": "响应数据主体",
            "type": "object",
            "additionalProperties": true,
            "properties": {}
          }
        }
      },
      "RList": {
        "type": "object",
        "properties": {
          "code": {
            "description": "系统图形验证码或响应状态码",
            "type": "integer",
            "example": 200
          },
          "msg": {
            "description": "响应消息",
            "type": "string",
            "example": "操作成功"
          },
          "data": {
            "description": "响应数据主体",
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true,
              "properties": {}
            }
          }
        }
      },
      "PageResult": {
        "type": "object",
        "properties": {
          "code": {
            "description": "系统图形验证码或响应状态码",
            "type": "integer",
            "example": 200
          },
          "msg": {
            "description": "响应消息",
            "type": "string",
            "example": "操作成功"
          },
          "rows": {
            "description": "分页数据列表",
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true,
              "properties": {}
            }
          },
          "total": {
            "type": "integer",
            "example": 0
          }
        }
      },
      "RLogin": {
        "type": "object",
        "properties": {
          "code": {
            "description": "系统图形验证码或响应状态码",
            "type": "integer",
            "example": 200
          },
          "msg": {
            "description": "响应消息",
            "type": "string",
            "example": "操作成功"
          },
          "data": {
            "description": "响应数据主体",
            "$ref": "#/components/schemas/LoginVo"
          }
        }
      },
      "LoginVo": {
        "type": "object",
        "properties": {
          "token": {
            "type": "string"
          },
          "accessToken": {
            "type": "string"
          },
          "tokenValue": {
            "type": "string"
          },
          "userId": {
            "type": "integer",
            "format": "int64"
          },
          "tenantId": {
            "description": "租户ID，用于区分不同租户的数据和验证策略",
            "type": "string"
          },
          "clientId": {
            "description": "客户端ID，对应后台客户端管理中的APP/PC/小程序等终端",
            "type": "string"
          },
          "clientKey": {
            "type": "string"
          }
        }
      },
      "RFileUpload": {
        "type": "object",
        "properties": {
          "code": {
            "description": "系统图形验证码或响应状态码",
            "type": "integer",
            "example": 200
          },
          "msg": {
            "description": "响应消息",
            "type": "string",
            "example": "操作成功"
          },
          "data": {
            "description": "响应数据主体",
            "$ref": "#/components/schemas/FileUploadVo"
          }
        }
      },
      "FileUploadVo": {
        "type": "object",
        "properties": {
          "ossId": {
            "description": "OSS文件ID，表单内部使用，用户侧应通过上传组件获取",
            "type": "integer",
            "format": "int64"
          },
          "url": {
            "type": "string"
          },
          "thumbnailUrl": {
            "type": "string",
            "nullable": true
          },
          "fileName": {
            "description": "原始文件名",
            "type": "string"
          },
          "originalName": {
            "type": "string"
          }
        }
      },
      "RVerificationRequire": {
        "type": "object",
        "properties": {
          "code": {
            "description": "系统图形验证码或响应状态码",
            "type": "integer",
            "example": 200
          },
          "msg": {
            "description": "响应消息",
            "type": "string",
            "example": "操作成功"
          },
          "data": {
            "description": "响应数据主体",
            "$ref": "#/components/schemas/VerificationRequireVo"
          }
        }
      },
      "VerificationRequireVo": {
        "type": "object",
        "properties": {
          "required": {
            "description": "当前场景是否需要验证",
            "type": "boolean"
          },
          "providerCode": {
            "description": "第三方服务商编码",
            "type": "string"
          },
          "captchaType": {
            "description": "验证码类型，例如SLIDER、ROTATE、CONCAT、WORD_IMAGE_CLICK",
            "type": "string"
          },
          "sceneCode": {
            "description": "验证场景编码，例如APP_LOGIN、PC_LOGIN、APP_REGISTER",
            "type": "string"
          },
          "ttlSeconds": {
            "description": "验证或票据有效秒数",
            "type": "integer"
          }
        },
        "example": {
          "required": true,
          "providerCode": "tianai",
          "captchaType": "SLIDER",
          "sceneCode": "APP_LOGIN",
          "ttlSeconds": 300
        }
      },
      "RVerificationChallenge": {
        "type": "object",
        "properties": {
          "code": {
            "description": "系统图形验证码或响应状态码",
            "type": "integer",
            "example": 200
          },
          "msg": {
            "description": "响应消息",
            "type": "string",
            "example": "操作成功"
          },
          "data": {
            "description": "响应数据主体",
            "$ref": "#/components/schemas/VerificationChallengeVo"
          }
        }
      },
      "VerificationChallengeVo": {
        "type": "object",
        "properties": {
          "required": {
            "description": "当前场景是否需要验证",
            "type": "boolean"
          },
          "providerCode": {
            "description": "第三方服务商编码",
            "type": "string"
          },
          "captchaType": {
            "description": "验证码类型，例如SLIDER、ROTATE、CONCAT、WORD_IMAGE_CLICK",
            "type": "string"
          },
          "challengeId": {
            "description": "验证挑战ID，由验证挑战接口返回",
            "type": "string"
          },
          "uuid": {
            "type": "string",
            "description": "系统图形验证码 uuid"
          },
          "img": {
            "type": "string",
            "description": "系统图形验证码 base64 图片"
          },
          "payload": {
            "type": "object",
            "additionalProperties": true,
            "description": "天爱验证码数据，包括背景图、模板图、尺寸等",
            "properties": {}
          },
          "expireSeconds": {
            "description": "验证挑战过期秒数",
            "type": "integer"
          }
        },
        "example": {
          "required": true,
          "providerCode": "tianai",
          "captchaType": "SLIDER",
          "challengeId": "CAPTCHA_CHALLENGE_ID",
          "payload": {
            "backgroundImage": "data:image/png;base64,...",
            "templateImage": "data:image/png;base64,...",
            "backgroundImageWidth": 340,
            "backgroundImageHeight": 180
          },
          "expireSeconds": 300
        }
      },
      "RVerificationCheck": {
        "type": "object",
        "properties": {
          "code": {
            "description": "系统图形验证码或响应状态码",
            "type": "integer",
            "example": 200
          },
          "msg": {
            "description": "响应消息",
            "type": "string",
            "example": "操作成功"
          },
          "data": {
            "description": "响应数据主体",
            "$ref": "#/components/schemas/VerificationCheckVo"
          }
        }
      },
      "VerificationCheckVo": {
        "type": "object",
        "properties": {
          "passed": {
            "description": "验证是否通过",
            "type": "boolean"
          },
          "validToken": {
            "type": "string",
            "description": "验证通过后交给业务接口的票据"
          },
          "expireSeconds": {
            "description": "验证挑战过期秒数",
            "type": "integer"
          },
          "message": {
            "description": "返回消息",
            "type": "string"
          }
        },
        "example": {
          "passed": true,
          "validToken": "captcha-ticket",
          "expireSeconds": 300,
          "message": "验证通过"
        }
      },
      "RLegacyCaptcha": {
        "type": "object",
        "properties": {
          "code": {
            "description": "系统图形验证码或响应状态码",
            "type": "integer",
            "example": 200
          },
          "msg": {
            "description": "响应消息",
            "type": "string",
            "example": "操作成功"
          },
          "data": {
            "description": "响应数据主体",
            "$ref": "#/components/schemas/LegacyCaptchaVo"
          }
        }
      },
      "LegacyCaptchaVo": {
        "type": "object",
        "properties": {
          "captchaEnabled": {
            "type": "boolean"
          },
          "uuid": {
            "description": "系统图形验证码UUID",
            "type": "string"
          },
          "img": {
            "type": "string",
            "description": "base64 图形验证码"
          }
        },
        "example": {
          "captchaEnabled": true,
          "uuid": "captcha-uuid",
          "img": "data:image/png;base64,..."
        }
      }
    },
    "responses": {
      "VoidResult": {
        "description": "通用成功响应",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/RVoid"
            }
          }
        }
      },
      "ObjectResult": {
        "description": "通用对象响应",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/RObject"
            }
          }
        }
      },
      "ListResult": {
        "description": "通用列表响应",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/RList"
            }
          }
        }
      },
      "PageResult": {
        "description": "通用分页响应",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/PageResult"
            }
          }
        }
      },
      "LoginResult": {
        "description": "登录结果",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/RLogin"
            }
          }
        }
      },
      "FileUploadResult": {
        "description": "文件上传结果",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/RFileUpload"
            }
          }
        }
      },
      "VerificationRequireResult": {
        "description": "验证需求查询结果",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/RVerificationRequire"
            }
          }
        }
      },
      "VerificationChallengeResult": {
        "description": "验证挑战生成结果",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/RVerificationChallenge"
            }
          }
        }
      },
      "VerificationCheckResult": {
        "description": "验证校验结果",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/RVerificationCheck"
            }
          }
        }
      },
      "LegacyCaptchaResult": {
        "description": "兼容旧图形验证码结果",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/RLegacyCaptcha"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "SaToken": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "description": "登录后返回的 token。若本地配置使用 sa-token 名称，请按项目实际 token-name 调整。"
      }
    }
  },
  "servers": [],
  "security": [
    {
      "SaToken": []
    }
  ]
}