refactor:项目架构重构和命名规范化

- 统一文件命名为snake_case格式(kebab-case  snake_case)
- 重构zulip模块为zulip_core,明确Core层职责
- 重构user-mgmt模块为user_mgmt,统一命名规范
- 调整模块依赖关系,优化架构分层
- 删除过时的文件和目录结构
- 更新相关文档和配置文件

本次重构涉及大量文件重命名和模块重组,
旨在建立更清晰的项目架构和统一的命名规范。
This commit is contained in:
moyin
2026-01-08 00:14:14 +08:00
parent 4fa4bd1a70
commit bb796a2469
178 changed files with 24767 additions and 3484 deletions

View File

@@ -5,6 +5,13 @@
* - 定义用户数据表的实体映射和字段约束
* - 提供用户数据的持久化存储结构
* - 支持多种登录方式的用户信息存储
* - 实现完整的用户数据模型和关系映射
*
* 职责分离:
* - 数据映射TypeORM实体与数据库表的映射关系
* - 约束定义:字段类型、长度、唯一性等约束规则
* - 关系管理:与其他实体的关联关系定义
* - 索引优化:数据库查询性能优化策略
*
* 依赖模块:
* - TypeORM: ORM框架提供数据库映射功能
@@ -14,13 +21,17 @@
* 存储引擎InnoDB
* 字符集utf8mb4
*
* 最近修改:
* - 2026-01-07: 代码规范优化 - 完善注释规范,添加完整的文件头和字段注释
*
* @author moyin
* @version 1.0.0
* @version 1.0.1
* @since 2025-12-17
* @lastModified 2026-01-07
*/
import { Entity, Column, PrimaryGeneratedColumn, CreateDateColumn, UpdateDateColumn, OneToOne } from 'typeorm';
import { UserStatus } from '../../../business/user-mgmt/enums/user-status.enum';
import { UserStatus } from '../../../business/user_mgmt/user_status.enum';
import { ZulipAccounts } from '../zulip_accounts/zulip_accounts.entity';
/**
@@ -434,6 +445,34 @@ export class Users {
})
updated_at: Date;
/**
* 删除时间
*
* 数据库设计:
* - 类型DATETIME精确到秒
* - 约束:允许空,软删除时手动设置
* - 索引:用于过滤已删除记录
*
* 业务规则:
* - null正常状态未删除
* - 有值:已软删除,记录删除时间
* - 软删除的记录在查询时需要手动过滤
* - 支持数据恢复和审计追踪
*
* 应用场景:
* - 数据安全删除,避免误删
* - 数据审计和合规要求
* - 支持数据恢复功能
* - 删除操作的时间追踪
*/
@Column({
type: 'datetime',
nullable: true,
default: null,
comment: '软删除时间null表示未删除'
})
deleted_at?: Date;
/**
* 关联的Zulip账号
*