docs: 更新 README — 去历史化,关联 apes-Authon 组织仓库

- 标题改为 apes-Authon-Server
- 移除 apes-Authdata 引用,以全新面貌展示
- 关联仓库更新为组织地址(Server/Web/history)
- 路线图阶段编号调整(Phase 5-7)
This commit is contained in:
figmar
2026-08-09 13:04:21 +08:00
parent 93e13653ab
commit 8c0244dfa0
2 changed files with 29 additions and 15 deletions
+28 -13
View File
@@ -1,17 +1,19 @@
# apes-Authon — 账权独立服务
# apes-Authon-Server — 账权独立服务后端
> 从 saas-service(账权平台)提取的纯净认证/授权/用户/角色/权限/多租户体系
> Spring Boot 独立账权服务平台 — 认证 / 授权 / 用户 / 角色 / 权限 / 多租户 / SSO
> **已通过编译验证**,可作为独立微服务运行
## 项目背景
本项目源自 `saas-service`(账权平台)单体应用,经过耦合度分析确认账权模块与业务模块零直接 Service 调用,具备独立服务化条件。本仓库是提取后的纯净账权代码,不包含任何业务逻辑(溯源、称重、水肥、巡检、维修、农大同步等)
apes-Authon 是一套从单体应用中提取的纯净认证授权服务,包含完整的用户管理、角色权限、菜单体系、多租户、客户套餐和 SSO 单点登录能力。本服务与业务系统零直接耦合,通过 Token + Redis 会话实现独立认证
### 提取依据
### 核心特性
- AuthContext 被 52 个文件 / 111 处引用,但业务 Service → 账权 Service 直接调用为 **0 个**
- 账权模块仅通过 ThreadLocalAuthContext)与业务模块间接耦合
- 新增业务模块(如巡检、维修)均不直接调用账权 Service,验证了独立服务化的可行性
- **多租户架构**:基于 `@TenantSource` AOP 切面 + dynamic-datasource 实现运行时数据源切换
- **认证体系**`@Login` 注解 + `AuthContext` ThreadLocal + Redis 会话,业务代码无感知
- **权限模型**:菜单 → 权限码 → 角色 → 成员角色的四级权限体系
- **SSO 集成**:内置伙伴云单点登录 Token 交换
- **外部 API 鉴权**AccessToken 机制,支持 Bearer / X-Access-Token 两种方式
## 技术栈
@@ -101,7 +103,7 @@ src/main/java/cn/apes/
### Phase 1: apes-commons 内联 ✅
- 反推 7 个核心类接口(AuthContext/Login/LoginUser/LoginCustomer/UserSession/Res/DbEntity
- 实现 LoginAspect AOP 切面(原在外部 JAR 中)
- 实现 LoginAspect AOP 切面
- 移除外部 JAR 依赖,pom.xml 无需手动安装
### Phase 2: 包名重构 ✅
@@ -117,14 +119,21 @@ src/main/java/cn/apes/
- 创建 `IpLocationService` 接口 + 桩实现
- **124 个源文件编译通过**
### Phase 4: 提交推送 ✅
- 代码推送到 Gitea 组织仓库
## 待完成事项
### Phase 4: SDK 化
### Phase 5: 模块补充
- [ ] AI 助手/LLM 模块提取(~54 Java 文件)
- [ ] 伙伴云表单配置模块提取(5 Controller + 7 .vue + 1 API
### Phase 6: SDK 化
- [ ]`AuthContext` 改造为可远程调用的 SDK
- [ ] 提供 `authon-sdk` 模块供业务系统引用
- [ ] Token 校验改为 HTTP API 调用
### Phase 5: 网关集成
### Phase 7: 网关集成
- [ ] 接入 API 网关(Spring Cloud Gateway / Nginx
- [ ] 请求头注入认证信息(替代 ThreadLocal
- [ ] 多租户数据源改为网关路由模式
@@ -166,6 +175,12 @@ java -jar target/apes-authon.jar
## 关联仓库
- 源仓库:[apes-Authdata](https://gitea.apescale.com/figmar/apes-Authdata) — 完整单体应用(含业务代码)
- 方案文档:`docs/账权模块独立服务化方案.html`(在 apes-Authdata 仓库中)
- 源码对比:`docs/源码版本对比分析-20260809.md`(在 apes-Authdata 仓库中)
| 仓库 | 说明 | 地址 |
|------|------|------|
| apes-Authon-Server | 后端账权服务(本仓库) | https://gitea.apescale.com/apes-Authon/apes-Authon-Server |
| apes-Authon-Web | 前端账权管理 | https://gitea.apescale.com/apes-Authon/apes-Authon-Web |
| apes-Authon-history | 剥离历史与分析归档 | https://gitea.apescale.com/apes-Authon/apes-Authon-history |
## License
MIT
+1 -2
View File
@@ -1,8 +1,7 @@
# 账权模块提取说明
> 提取日期:2026-08-09
> 仓库:apes-Authdata (saas-service)
> 目标仓库:apes-Authon
> 目标仓库:apes-Authon-Server
## 一、提取原则