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

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

本次重构涉及大量文件重命名和模块重组，
旨在建立更清晰的项目架构和统一的命名规范。

src/business/zulip/services/message_filter.service.spec.ts

@@ -13,7 +13,7 @@
 import { Test, TestingModule } from '@nestjs/testing';
 import * as fc from 'fast-check';
 import { MessageFilterService, ViolationType } from './message_filter.service';
-import { IZulipConfigService } from '../../../core/zulip/interfaces/zulip-core.interfaces';
+import { IZulipConfigService } from '../../../core/zulip_core/interfaces/zulip_core.interfaces';
 import { AppLoggerService } from '../../../core/utils/logger/logger.service';
 import { IRedisService } from '../../../core/redis/redis.interface';
 

src/business/zulip/services/message_filter.service.ts

@@ -7,6 +7,13 @@
  * - 防止恶意操作和滥用
  * - 与ConfigManager集成实现位置权限验证
  * 
+ * 职责分离：
+ * - 内容审核：检查消息内容是否包含敏感词和恶意链接
+ * - 频率控制：防止用户发送消息过于频繁导致刷屏
+ * - 权限验证：验证用户是否有权限向目标Stream发送消息
+ * - 违规记录：记录和统计用户的违规行为
+ * - 规则管理：动态管理敏感词列表和过滤规则
+ * 
  * 主要方法：
  * - filterContent(): 内容过滤，敏感词检查
  * - checkRateLimit(): 频率限制检查
@@ -23,14 +30,19 @@
  * - IRedisService: Redis缓存服务
  * - ConfigManagerService: 配置管理服务
  * 
+ * 最近修改：
+ * - 2026-01-07: 代码规范优化 - 清理未使用的导入(forwardRef) (修改者: moyin)
+ * - 2026-01-07: 代码规范优化 - 完善文件头注释和修改记录 (修改者: moyin)
+ * 
  * @author angjustinl
- * @version 1.1.0
+ * @version 1.1.2
  * @since 2025-12-25
+ * @lastModified 2026-01-07
  */
 
-import { Injectable, Logger, Inject, forwardRef } from '@nestjs/common';
+import { Injectable, Logger, Inject } from '@nestjs/common';
 import { IRedisService } from '../../../core/redis/redis.interface';
-import { IZulipConfigService } from '../../../core/zulip/interfaces/zulip-core.interfaces';
+import { IZulipConfigService } from '../../../core/zulip_core/interfaces/zulip_core.interfaces';
 
 /**
  * 内容过滤结果接口

src/business/zulip/services/session_cleanup.service.spec.ts

@@ -25,7 +25,7 @@ import {
   CleanupResult 
 } from './session_cleanup.service';
 import { SessionManagerService } from './session_manager.service';
-import { IZulipClientPoolService } from '../../../core/zulip/interfaces/zulip-core.interfaces';
+import { IZulipClientPoolService } from '../../../core/zulip_core/interfaces/zulip_core.interfaces';
 
 describe('SessionCleanupService', () => {
   let service: SessionCleanupService;

src/business/zulip/services/session_cleanup.service.ts

@@ -23,7 +23,7 @@
 
 import { Injectable, Logger, OnModuleInit, OnModuleDestroy, Inject } from '@nestjs/common';
 import { SessionManagerService } from './session_manager.service';
-import { IZulipClientPoolService } from '../../../core/zulip/interfaces/zulip-core.interfaces';
+import { IZulipClientPoolService } from '../../../core/zulip_core/interfaces/zulip_core.interfaces';
 
 /**
  * 清理任务配置接口

src/business/zulip/services/session_manager.service.spec.ts

@@ -13,7 +13,7 @@
 import { Test, TestingModule } from '@nestjs/testing';
 import * as fc from 'fast-check';
 import { SessionManagerService, GameSession, Position } from './session_manager.service';
-import { IZulipConfigService } from '../../../core/zulip/interfaces/zulip-core.interfaces';
+import { IZulipConfigService } from '../../../core/zulip_core/interfaces/zulip_core.interfaces';
 import { AppLoggerService } from '../../../core/utils/logger/logger.service';
 import { IRedisService } from '../../../core/redis/redis.interface';
 

src/business/zulip/services/session_manager.service.ts

@@ -8,6 +8,13 @@
  * - 支持会话状态的序列化和反序列化
  * - 支持服务重启后的状态恢复
  * 
+ * 职责分离：
+ * - 会话存储：管理会话数据在Redis中的存储和检索
+ * - 位置跟踪：维护玩家在游戏世界中的位置信息
+ * - 上下文注入：根据玩家位置确定消息的目标Stream和Topic
+ * - 空间过滤：根据地图ID筛选相关的玩家会话
+ * - 资源清理：定期清理过期会话和释放相关资源
+ * 
  * 主要方法：
  * - createSession(): 创建会话并绑定Socket_ID与Zulip_Queue_ID
  * - getSession(): 获取会话信息
@@ -28,15 +35,19 @@
  * - 消息分发时进行空间过滤
  * - 玩家登出时清理会话数据
  * 
+ * 最近修改：
+ * - 2026-01-07: 代码规范优化 - 完善文件头注释和修改记录 (修改者: moyin)
+ * 
  * @author angjustinl
- * @version 1.0.0
+ * @version 1.0.1
  * @since 2025-12-25
+ * @lastModified 2026-01-07
  */
 
 import { Injectable, Logger, Inject } from '@nestjs/common';
 import { IRedisService } from '../../../core/redis/redis.interface';
-import { IZulipConfigService } from '../../../core/zulip/interfaces/zulip-core.interfaces';
-import { Internal, Constants } from '../../../core/zulip/interfaces/zulip.interfaces';
+import { IZulipConfigService } from '../../../core/zulip_core/interfaces/zulip_core.interfaces';
+import { Internal, Constants } from '../../../core/zulip_core/interfaces/zulip.interfaces';
 
 /**
  * 游戏会话接口 - 重新导出以保持向后兼容

src/business/zulip/services/zulip_event_processor.service.spec.ts

@@ -26,7 +26,7 @@ import {
   MessageDistributor,
 } from './zulip_event_processor.service';
 import { SessionManagerService, GameSession } from './session_manager.service';
-import { IZulipConfigService, IZulipClientPoolService } from '../../../core/zulip/interfaces/zulip-core.interfaces';
+import { IZulipConfigService, IZulipClientPoolService } from '../../../core/zulip_core/interfaces/zulip_core.interfaces';
 import { AppLoggerService } from '../../../core/utils/logger/logger.service';
 
 describe('ZulipEventProcessorService', () => {

src/business/zulip/services/zulip_event_processor.service.ts

@@ -32,7 +32,7 @@
 
 import { Injectable, OnModuleDestroy, Inject, forwardRef, Logger } from '@nestjs/common';
 import { SessionManagerService } from './session_manager.service';
-import { IZulipConfigService, IZulipClientPoolService } from '../../../core/zulip/interfaces/zulip-core.interfaces';
+import { IZulipConfigService, IZulipClientPoolService } from '../../../core/zulip_core/interfaces/zulip_core.interfaces';
 
 /**
  * Zulip消息接口