docs: 架构文档补充统一全局上下文GlobalContext，统筹tid/uid/uname获取和异步传递

doc/资金服务平台 FundPlatform 架构设计文档.md

@@ -1240,8 +1240,171 @@ public class ReactiveContextFilter implements WebFilter {
 }
 ```
 
-**原 5. 用户上下文管理（已升级为支持异步的版本）**
+**5. 统一全局上下文管理（GlobalContext）**
 
+为了统一管理和传递全局参数（tid、uid、uname、traceId 等），设计一个综合的 GlobalContext：
+
+```java
+/**
+ * 全局上下文持有者
+ * 统一管理租户ID、用户ID、用户名、TraceId等全局参数
+ * 支持同步和异步场景
+ */
+public class GlobalContext {
+    
+    // ========== 全局参数键名 ==========
+    public static final String KEY_TENANT_ID = "tid";
+    public static final String KEY_USER_ID = "uid";
+    public static final String KEY_USERNAME = "uname";
+    public static final String KEY_TRACE_ID = "traceId";
+    public static final String KEY_TENANT_GROUP = "tgroup";
+    
+    // ========== ThreadLocal 存储 ==========
+    private static final ThreadLocal<Map<String, Object>> CONTEXT = ThreadLocal.withInitial(HashMap::new);
+    
+    // ========== 全局上下文载体（支持异步传递）==========
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class ContextSnapshot {
+        private String tenantId;
+        private Long userId;
+        private String username;
+        private String traceId;
+        private String tenantGroup;
+        private Map<String, Object> extra;
+        
+        public static ContextSnapshot create() {
+            return ContextSnapshot.builder()
+                .tenantId(getTenantId())
+                .userId(getUserId())
+                .username(getUsername())
+                .traceId(getTraceId())
+                .tenantGroup(getTenantGroup())
+                .extra(new HashMap<>(getAll()))
+                .build();
+        }
+        
+        public void apply() {
+            if (tenantId != null) set(KEY_TENANT_ID, tenantId);
+            if (userId != null) set(KEY_USER_ID, userId);
+            if (username != null) set(KEY_USERNAME, username);
+            if (traceId != null) set(KEY_TRACE_ID, traceId);
+            if (tenantGroup != null) set(KEY_TENANT_GROUP, tenantGroup);
+            if (extra != null) extra.forEach((k, v) -> {
+                if (!CONTEXT.get().containsKey(k)) set(k, v);
+            });
+        }
+    }
+    
+    // ========== 基础操作 ==========
+    @SuppressWarnings("unchecked")
+    public static <T> T get(String key) { return (T) CONTEXT.get().get(key); }
+    
+    public static void set(String key, Object value) {
+        CONTEXT.get().put(key, value);
+        if (value != null) MDC.put(key, String.valueOf(value));
+    }
+    
+    public static void clear() {
+        CONTEXT.get().clear();
+        MDC.clear();
+    }
+    
+    // ========== 便捷方法 ==========
+    public static String getTenantId() { return get(KEY_TENANT_ID); }
+    public static void setTenantId(String tenantId) { set(KEY_TENANT_ID, tenantId); }
+    
+    public static Long getUserId() {
+        Object uid = get(KEY_USER_ID);
+        return uid instanceof String ? Long.valueOf((String) uid) : (Long) uid;
+    }
+    public static void setUserId(Long userId) { set(KEY_USER_ID, userId); }
+    
+    public static String getUsername() { return get(KEY_USERNAME); }
+    public static void setUsername(String username) { set(KEY_USERNAME, username); }
+    
+    public static String getTraceId() { return get(KEY_TRACE_ID); }
+    public static void setTraceId(String traceId) { set(KEY_TRACE_ID, traceId); }
+    
+    // ========== 异步场景支持 ==========
+    public static ContextSnapshot snapshot() { return ContextSnapshot.create(); }
+    
+    public static Runnable wrap(Runnable runnable) {
+        ContextSnapshot snapshot = snapshot();
+        return () -> { try { snapshot.apply(); runnable.run(); } finally { clear(); } };
+    }
+    
+    public static <T> Callable<T> wrap(Callable<T> callable) {
+        ContextSnapshot snapshot = snapshot();
+        return () -> { try { snapshot.apply(); return callable.call(); } finally { clear(); } };
+    }
+    
+    public static <T> Supplier<T> wrap(Supplier<T> supplier) {
+        ContextSnapshot snapshot = snapshot();
+        return () -> { try { snapshot.apply(); return supplier.get(); } finally { clear(); } };
+    }
+    
+    public static <T> CompletableFuture<T> supplyAsync(Supplier<T> supplier, Executor executor) {
+        return CompletableFuture.supplyAsync(wrap(supplier), executor);
+    }
+    
+    public static CompletableFuture<Void> runAsync(Runnable runnable, Executor executor) {
+        return CompletableFuture.runAsync(wrap(runnable), executor);
+    }
+}
+```
+
+**6. GlobalContext 使用示例**
+
+```java
+// 同步场景
+@Service
+public class ProjectService {
+    public void createProject(ProjectDTO dto) {
+        String tid = GlobalContext.getTenantId();
+        Long uid = GlobalContext.getUserId();
+        String uname = GlobalContext.getUsername();
+        
+        log.info("[{}] 租户 {} 用户 {} 创建项目", tid, uname);
+        
+        Project project = new Project();
+        project.setTenantId(tid);
+        project.setCreatedBy(uid);
+        projectMapper.insert(project);
+    }
+}
+
+// 异步场景
+@Service
+public class AsyncService {
+    @Autowired private ThreadPoolExecutor executor;
+    
+    public void asyncProcess(Long projectId) {
+        executor.execute(GlobalContext.wrap(() -> {
+            String tid = GlobalContext.getTenantId();
+            Long uid = GlobalContext.getUserId();
+            String uname = GlobalContext.getUsername();
+            
+            log.info("[Async] 租户 {} 用户 {} 处理项目 {}", tid, uname, projectId);
+            
+            Project project = projectMapper.selectById(projectId);
+            project.setProcessedBy(uid);
+            projectMapper.updateById(project);
+        }));
+    }
+    
+    public CompletableFuture<Project> asyncQuery(Long projectId) {
+        return GlobalContext.supplyAsync(() -> {
+            log.info("[Async] 用户 {} 查询项目 {}", GlobalContext.getUsername(), projectId);
+            return projectMapper.selectById(projectId);
+        }, executor);
+    }
+}
+```
+
+**原 5. 用户上下文管理（已合并到 GlobalContext）**
 
 **7. 调用链上下文过滤器（接收方）**
 
@@ -2971,6 +3134,7 @@ fund-sys/
 | v1.1 | 2026-02-13 | 补充多租户架构（一库多租户/一库一租户）和 Head 日志追踪设计 | zhangjf |
 | v1.2 | 2026-02-13 | 补充 Shiro 认证框架、服务调用链 uid/uname 传递设计 | zhangjf |
 | v1.3 | 2026-02-13 | 补充 HikariCP 连接池、支持异步场景的 UserContext 封装 | zhangjf |
+| v1.4 | 2026-02-13 | 补充统一全局上下文 GlobalContext，统筹 tid/uid/uname 获取和异步传递 | zhangjf |
 
 ---