oidc-gateway-demo/database.md

数据库表结构设计

一、统一认证网关（主工程）表结构

1. 用户表（users）

字段名	类型	说明
id	BIGINT	主键，自增
username	VARCHAR(50)	用户名（租户/子系统内唯一）
password	VARCHAR(255)	密码（加密存储）
user_type	ENUM	用户类型（TENANT/SUBSYSTEM）
tenant_id	BIGINT	所属租户ID，外键->tenants.id（所有用户必填，标识归属租户）
subsystem_id	BIGINT	所属子系统ID，外键->subsystems.id（仅子系统用户必填）
email	VARCHAR(100)	邮箱
phone	VARCHAR(20)	手机号
real_name	VARCHAR(50)	真实姓名
status	ENUM	状态（ACTIVE/INACTIVE/LOCKED/DELETED）
create_time	TIMESTAMP	创建时间
update_time	TIMESTAMP	更新时间
UNIQUE KEY uk_tenant_username (tenant_id, username)
UNIQUE KEY uk_subsystem_username (subsystem_id, username)

主键：id 外键：tenant_id 关联 tenants.id（所有用户必填），subsystem_id 关联 subsystems.id（仅子系统用户必填）

2. 租户表（tenants）

字段名	类型	说明
id	BIGINT	主键，自增
tenant_code	VARCHAR(50)	租户唯一标识
tenant_name	VARCHAR(100)	租户名称
description	TEXT	描述
status	ENUM	状态（ACTIVE/INACTIVE）
create_time	TIMESTAMP	创建时间
update_time	TIMESTAMP	更新时间

主键：id

3. 子系统表（subsystems）

字段名	类型	说明
id	BIGINT	主键，自增
subsystem_code	VARCHAR(50)	子系统唯一标识
subsystem_name	VARCHAR(100)	子系统名称
description	TEXT	描述
base_url	VARCHAR(255)	子系统入口地址
status	ENUM	状态（ACTIVE/INACTIVE）
create_time	TIMESTAMP	创建时间
update_time	TIMESTAMP	更新时间

主键：id

4. 租户-子系统权限表（tenant_subsystem_permissions）

字段名	类型	说明
id	BIGINT	主键，自增
tenant_id	BIGINT	租户ID，外键->tenants.id
subsystem_id	BIGINT	子系统ID，外键->subsystems.id
permissions	JSON	权限配置
status	ENUM	状态（ACTIVE/INACTIVE）
create_time	TIMESTAMP	创建时间
update_time	TIMESTAMP	更新时间
UNIQUE KEY uk_tenant_subsystem (tenant_id, subsystem_id)

主键：id 外键：tenant_id 关联 tenants.id，subsystem_id 关联 subsystems.id

二、子系统（如订单、支付等）表结构

1. 业务用户表（users 和 统一认证网关（主工程） 用的不是一个数据库,表名可以重复）

字段名	类型	说明
id	BIGINT	主键，自增
user_id	BIGINT	关联统一认证网关 users 表的 id 字段，外键->users.id
username	VARCHAR(50)	业务系统内用户名
...	...	业务相关字段（如地址、类型等）
create_time	TIMESTAMP	创建时间
update_time	TIMESTAMP	更新时间

主键：id 外键：user_id 关联统一认证网关 users.id（users 表为统一认证主工程的用户表）

---

主外键关系说明：

• users.tenant_id → tenants.id
• users.subsystem_id → subsystems.id
• tenant_subsystem_permissions.tenant_id → tenants.id
• tenant_subsystem_permissions.subsystem_id → subsystems.id
• 子系统业务用户表 user_id → 统一认证 users.id
• 业务数据表 user_id → 统一认证 users.id

-- 插入租户 INSERT INTO tenants (id, tenant_code, tenant_name, description, status, create_time, update_time) VALUES (1, 'test-tenant', '测试租户', '测试用租户', 'ACTIVE', NOW(), NOW());

-- 插入用户 INSERT INTO users ( id, username, password, user_type, tenant_id, subsystem_id, email, phone, real_name, status, create_time, update_time ) VALUES ( 1, 'testuser', '$2a$10$wH6Qw6Qw6Qw6Qw6Qw6Qw6uQw6Qw6Qw6Qw6Qw6Qw6Qw6Qw6Qw6Qw6', -- 密码123456的BCrypt加密 'TENANT', 1, NULL, 'testuser@example.com', '13800000000', '测试用户', 'ACTIVE', NOW(), NOW() );

租户ID：1 或 租户名：test-tenant 用户名：testuser 密码：123456