# 数据库初始化 业务数据库名为 `community`,只包含以下四张表。由人工执行;应用不运行迁移或自动建表。以下 SQL 面向 MySQL 8。 ```sql CREATE DATABASE IF NOT EXISTS community CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE community; CREATE TABLE sys_user ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT '内部用户主键', user_code CHAR(32) NOT NULL COMMENT '用户业务编码', email VARCHAR(254) NOT NULL COMMENT '规范化后的登录邮箱', nickname VARCHAR(100) NOT NULL COMMENT '用户昵称', status VARCHAR(16) NOT NULL DEFAULT 'ACTIVE' COMMENT '账号状态', created_at DATETIME(3) NOT NULL COMMENT '创建时间 UTC', updated_at DATETIME(3) NOT NULL COMMENT '更新时间 UTC', PRIMARY KEY (id), UNIQUE KEY uk_user_code (user_code), UNIQUE KEY uk_user_email (email) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='平台用户'; CREATE TABLE project ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT '内部项目主键', project_code CHAR(32) NOT NULL COMMENT '项目业务编码', owner_user_id BIGINT NOT NULL COMMENT '所属平台用户', name VARCHAR(100) NOT NULL COMMENT '项目名称', description TEXT NOT NULL COMMENT '项目描述', project_type VARCHAR(64) NOT NULL COMMENT '配置中的项目类型编码', gitea_repo_id BIGINT NULL COMMENT 'Gitea 仓库标识', gitea_owner VARCHAR(100) NOT NULL COMMENT 'Gitea 仓库所属组织', gitea_repo_name VARCHAR(100) NOT NULL COMMENT 'Gitea 仓库名称', repo_status VARCHAR(16) NOT NULL DEFAULT 'CREATING' COMMENT '仓库状态 CREATING READY FAILED', publish_status VARCHAR(16) NOT NULL DEFAULT 'UNPUBLISHED' COMMENT '社区状态 UNPUBLISHED PUBLISHED', published_commit_sha VARCHAR(64) NULL COMMENT '社区已发布 Commit SHA', published_at DATETIME(3) NULL COMMENT '最近发布时间 UTC', source_project_id BIGINT NULL COMMENT 'Fork 来源项目', source_commit_sha VARCHAR(64) NULL COMMENT 'Fork 来源已发布 Commit SHA', deleted TINYINT(1) NOT NULL DEFAULT 0 COMMENT '逻辑删除标识', created_at DATETIME(3) NOT NULL COMMENT '创建时间 UTC', updated_at DATETIME(3) NOT NULL COMMENT '更新时间 UTC', PRIMARY KEY (id), UNIQUE KEY uk_project_code (project_code), UNIQUE KEY uk_project_repo (gitea_owner, gitea_repo_name), UNIQUE KEY uk_project_repo_id (gitea_repo_id), KEY idx_project_owner (owner_user_id, deleted, created_at), KEY idx_project_community (publish_status, deleted, published_at), KEY idx_project_type (publish_status, deleted, project_type, published_at), CONSTRAINT fk_project_owner FOREIGN KEY (owner_user_id) REFERENCES sys_user(id), CONSTRAINT fk_project_source FOREIGN KEY (source_project_id) REFERENCES project(id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户项目与社区发布'; CREATE TABLE project_comment ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT '内部评论主键', comment_code CHAR(32) NOT NULL COMMENT '评论业务编码', project_id BIGINT NOT NULL COMMENT '所属项目', user_id BIGINT NOT NULL COMMENT '评论用户', content TEXT NOT NULL COMMENT '纯文本评论内容', deleted TINYINT(1) NOT NULL DEFAULT 0 COMMENT '逻辑删除标识', created_at DATETIME(3) NOT NULL COMMENT '创建时间 UTC', updated_at DATETIME(3) NOT NULL COMMENT '更新时间 UTC', PRIMARY KEY (id), UNIQUE KEY uk_comment_code (comment_code), KEY idx_comment_project (project_id, deleted, created_at), CONSTRAINT fk_comment_project FOREIGN KEY (project_id) REFERENCES project(id), CONSTRAINT fk_comment_user FOREIGN KEY (user_id) REFERENCES sys_user(id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='项目评论'; CREATE TABLE project_like ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT '内部点赞主键', project_id BIGINT NOT NULL COMMENT '所属项目', user_id BIGINT NOT NULL COMMENT '点赞用户', created_at DATETIME(3) NOT NULL COMMENT '点赞时间 UTC', PRIMARY KEY (id), UNIQUE KEY uk_like_project_user (project_id, user_id), CONSTRAINT fk_like_project FOREIGN KEY (project_id) REFERENCES project(id), CONSTRAINT fk_like_user FOREIGN KEY (user_id) REFERENCES sys_user(id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='项目点赞'; ``` 内部 ID 仅用于数据库关联,对外使用业务编码。时间均由后端写入 UTC。`CREATING` 项目表示仓库初始化未完成,不代表编辑草稿。Gitea 数据库与业务库分离,不修改 Gitea 内部表。