ruoyi-ai/docs/tenant-management.md

新增租户接口

开启 tenant.enable: true 后，超级管理员可通过 POST /system/tenant 创建租户。请求需要登录凭证和 system:tenant:add 权限；使用反向代理时，请按部署配置添加接口前缀。

请求参数

请求使用 Content-Type: application/json。

参数	说明
companyName	企业名称，必填且不能与已有租户重复。
contactUserName	联系人，必填。
contactPhone	联系电话，必填。
username	租户初始管理员用户名，必填。
password	租户初始管理员密码，必填。
packageId	已存在的租户套餐 ID，必填。建议使用字符串传输，避免浏览器对大整数的精度损失。
expireTime	过期时间，使用 yyyy-MM-dd HH:mm:ss，例如 2027-09-11 00:00:00；不传或传 null 表示不限制有效期。未带时区的时间按后端运行时区解释。
accountCount	可创建的用户数量，-1 表示不限制。

请求示例

请将套餐 ID 替换为当前系统中的有效套餐，并设置实际使用的管理员账号和密码。

{
  "companyName": "示例企业",
  "contactUserName": "联系人",
  "contactPhone": "13800000000",
  "username": "tenant_admin",
  "password": "ChangeMe_123456!",
  "packageId": "2018611998196109314",
  "expireTime": "2027-09-11 00:00:00",
  "accountCount": -1
}

日期配置

后端默认日期格式配置位于 ruoyi-admin/src/main/resources/application.yml：

spring:
  jackson:
    date-format: yyyy-MM-dd HH:mm:ss

扩展应用的 ObjectMapper 时，使用 Spring 注入的 Jackson2ObjectMapperBuilder，以保留全局日期格式、自定义 Jackson 模块和构建器配置。