---
description: 全局上下文约定
alwaysApply: true
---

# 全局上下文约定

## 注意事项

1. **修改 `.properties` 或 `.xml` 文件前必须征得用户同意**
2. **删除任意文件前必须征得用户同意**

## JSON使用规则

- 项目同时存在 **Fastjson、Gson、Jackson**；新代码优先与**当前修改文件**已用的库保持一致，避免在同一流程混用三种序列化。

## 异常与响应

- 业务错误：抛 `SelfException`（可带错误码、扩展数据、`SysLogEvent`）；由 `GlobalSelfExceptionHandler` 统一转 JSON。
- 静态工厂方法优先复用 `GlobalSelfExceptionHandler.createResParam(...)` 等同项目既有写法。

## 依赖与副作用

- 使用 `com.global.base.*`（gbase JAR）时，不假设本地有可替换实现；改动需考虑 **无该 JAR 时无法编译** 的环境。
- 线程与后台任务：参考 `ThreadTaskMgr`、`AsyncTaskQueueMgr` 等现有模式，避免自建无界线程池。

## Git使用规范

- 禁止自动提交，不得主动或自动执行 `git commit` 或 `git push`