功能模块
受众：开发者 摘要：功能模块索引：业务模块清单 / 后续规划 / 业务模块剥离规划 / 反哺底座。
本文档是功能入口索引，只帮助你快速找到对应模块。具体配置、API 和示例放在各模块文档中，这里不重复展开。
当前主要模块
| Maven 模块 | 文档 | 当前定位 |
|---|---|---|
spring-open-core-iam | 统一身份 | IAM、用户、RBAC、租户、数据范围、认证和工作空间平台基础 |
spring-open-core-knowledge | 知识库 | Knowledge 后台管理面 |
spring-open-core-plugin | Plugin | Plugin 后台治理面，覆盖状态落库、启停、生命周期计划和执行审计 |
spring-open-core-site | 站点信息 | 站点公开信息、访问策略和业务健康入口 |
spring-open-core-dict | 字典 | 字典、字典项、来源治理和展示文案解析 |
spring-open-core-organization | 组织岗位 | 岗位和用户岗位关系 |
spring-open-core-audit | 操作审计 | 后台写操作审计日志、查询和导出 |
spring-open-core-file | 文件元数据 | 文件记录、当前用户文件、业务绑定和文件产物 |
spring-open-core-reporting | 报表中心 | 报表定义、即时快照和异步导出聚合 |
spring-open-core-risk | 风控限额 | 风控规则、风险事件、冻结和人工复核 |
spring-open-core-cashier | 收银台 | 支付订单、渠道编排、回调、对账、补偿和支付报价 |
spring-open-core-member-points | 会员积分 | 签到、积分规则、订单奖励、退款冲正、人工调整和过期任务 |
spring-open-module-cms | 内容管理 | 页面、公告、轮播图、导航、内容块、专题和广告位 |
spring-open-module-blog | 博客 | 文章、分类、标签、评论、审核记录、作者内容和内容互动 |
spring-open-module-forum | 论坛 | 板块、主题、回复、举报、处理记录、互动状态和基础版规 |
spring-open-module-mall | 商城 | 商品、分类、收藏、购物车、地址、订单、支付同步、评价和售后申请 |
spring-open-module-advertising | 自营广告 | 广告位、广告素材、素材审核、事件报表、预算结算、Provider 运维诊断和收益报表结算状态运营 |
spring-open-module-search | 统一搜索 | 聚合 CMS、Blog、Forum、Mall 等公开内容搜索、热词和建议 |
spring-open-module-short-link | 短链接 | 短链接、公开解析和浏览器跳转 |
spring-open-module-live-code | 活码 | 动态二维码目标管理、公开解析和扫码跳转 |
spring-open-module-live | 直播 | 直播间、预告、开播状态、公开展示入口、聊天治理和后续直播 Provider 边界 |
spring-open-core-entitlement | 权益 / 套餐 / 配额 | 中性套餐、权益项、配额策略、用户权益、余额和流水底座 |
spring-open-core-voucher | 卡券 | 中性卡券模板、适用范围、发放批次、卡券实例、锁定、核销和操作日志底座 |
spring-open-module-distribution | 分销模块 | 邀请关系、团队树、佣金规则、归因、结算、内部打款和风控审计，默认启用；无规则 / 无有效关系时不产生佣金 |
spring-open-module-marketplace | 供需撮合 | 供需信息、服务端推广定价、用户侧撮合订单、撮合结算和后续分账对账能力 |
spring-open-module-marketing | 营销活动 | 营销活动 Admin contract、活动类型 / 状态、活动配置和后续签到 / 抽奖玩法边界 |
spring-open-module-ai | AI 总览、AI 模型平台、AI 模型网关、AI Skill、AI Agent 接入 | AI 模型供应商平台、模型网关、Provider、模型目录、AI Skill、Token 计量计费和用户控制台，旧 Open Platform AI 为迁移兼容来源 |
spring-open-module-open-platform | 开放平台 | 第三方应用、签名、防重放、scope、调用日志和开放 API 底座；旧 AI 路由在迁移期继续兼容 |
spring-open-module-payment-platform | 聚合支付平台 | 商户入驻、商户应用、聚合收款通道、服务商账号、开放支付、退款、报价、结算和分账能力，默认启用；真实收款仍依赖商户、通道和 Provider 配置 |
spring-open-module-install | 企业安装 | 安装状态、令牌校验、环境预检、根路径接管和 V1.0 安装向导 |
业务模块默认遵循可插拔边界：模块之间不做 Maven 强耦合，跨模块只保存标量 ID，联动通过事件、Notification、Queue、Payment Facade 或应用装配层完成。默认装配只放“用户端入口、后台 Admin 页面、后端 contract 三层都能直接走通”的模块；仍在孵化或依赖外部业务事件的模块放入显式 Maven profile，避免安装后出现菜单、接口或流程半成品。
历史巨石模块当前不存在；IAM、Config、Notification、File、Async Task、Runtime、Audit、Organization、Queue、Scheduler、WebSocket、SQL Console 等能力均按真实 owning core 模块承接，不保留旧兼容入口。system 是可用业务语义，判断规则见 核心模块治理。
默认装配分级
本表按“后端 contract + Admin 页 + 用户端入口”三层实测。结论遵循“跑通不等于全模块都上”：默认装配只保留当前用户可走通的模块；仍在孵化的能力先留在对应模块内作为显式 Provider / sandbox / mock 配置，不把整模块移出默认 application。当前没有需要从默认装配摘除的整模块 Preview，Preview 仅用于外部真实链、三方支付、三方直播、三方广告 Provider 等深水子能力。
| 模块 | 后端 contract | Admin 页 | 用户端入口 | 默认决策 | 重新启用条件 |
|---|---|---|---|---|---|
spring-open-module-live | LiveRoomApiController / LiveRoomPublicApiController，含 mock stream provider 与测试 | views/admin/src/views/live/rooms/index.vue | App views/app/src/live/*，PC views/pc/app/pages/live/* | 默认装配 | 已满足当前预告、开播状态和公开展示闭环 |
spring-open-module-marketing | Campaign / Check-in / Lottery Admin 与用户 contract，含模块测试 | views/admin/src/views/marketing/* | App views/app/src/marketing/lottery.vue，PC views/pc/app/pages/marketing/lottery.vue | 默认装配 | 已满足活动、签到和抽奖首段闭环 |
spring-open-module-marketplace | Listing / Order / Settlement / Public Listing / Promotion Pricing contract，含 Controller 与迁移测试 | views/admin/src/views/marketplace/* | App views/app/src/marketplace/*，PC views/pc/app/pages/marketplace/* | 默认装配 | 已满足供需浏览、发布审核、服务端推广定价、用户侧订单可见和撮合订单首段闭环 |
spring-open-module-form | 表单定义、发布、提交、模板、协作、Webhook 与开放 API contract 已落地 | views/admin/src/views/forms/index.vue | App views/app/src/form/public.vue，PC views/pc/app/pages/forms/[channelCode].vue | 默认装配 | 已满足后台建表单、发布渠道和用户公开提交闭环 |
spring-open-module-meeting | Meeting Admin / Open / RTC / 用户 contract，含 application assembly 与迁移测试 | views/admin/src/views/meeting/operations/index.vue | App views/app/src/meeting/index.vue，PC views/pc/app/pages/meeting.vue | 默认装配 | 已满足会议运营、用户入口和开放 API 首段闭口 |
spring-open-module-distribution | 分销关系、规则、佣金、结算、风控 contract 已落地 | views/admin/src/views/distribution/* | App views/app/src/distribution/index.vue，PC views/pc/app/pages/account/distribution.vue | 默认装配 | 已内置 Mall 商城订单支付 / 售后退款业务事件来源，缺省启用；如需关闭用户侧入口和业务侧佣金处理，显式配置 spring.open.distribution.enabled=false |
spring-open-module-video | 视频内容、创作者、互动、举报处理、规则热榜和付费解锁 contract 已落地 | views/admin/src/views/video/contents/index.vue、views/admin/src/views/video/reports/index.vue | App views/app/src/video/index.vue，PC views/pc/app/pages/video.vue | 默认装配 | 已满足后台内容运营、举报处理、公开视频浏览、互动规则热榜、创作者概览 / 最近作品和付费观看首段闭环；个性化推荐和完整创作者中心后续增强 |
spring-open-module-reading | 作品、章节目录、章节正文、书架、阅读进度、关键词搜索、规则推荐榜单、版权投诉、付费章节 contract、书源配置和同步底座已落地 | views/admin/src/views/reading/works/index.vue、views/admin/src/views/reading/copyright-complaints/index.vue、views/admin/src/views/reading/sources/index.vue | App views/app/src/reading/*，PC views/pc/app/pages/reading/* | 默认装配 | 已满足后台作品 / 章节运营、版权投诉处理、用户书库、目录、阅读器、搜索、规则推荐榜单、受控书源导入、单源同步和到期同步首段闭环；真实外部 Provider 和个性化推荐后续增强 |
模块成熟度矩阵
成熟度用于发布、售卖和二开预期管理；默认装配只表示“当前应用默认带上且能启动 / 预览”。两者不能混用。
| 成熟度 | 判定标准 | 发布口径 |
|---|---|---|
| GA | 后端 contract、Admin、必要用户端入口、迁移 / seed、文档和基础测试均已闭口；真实生产仍按模块文档配置外部 Provider | 可作为当前版本稳定能力对外介绍 |
| Beta | 主链路已可用，但真实 Provider、复杂运营面、报表 / 风控深水区或用户侧细节仍在增强 | 可默认装配和试用，不承诺完整行业方案 |
| Preview | 仅有底座、contract 或受控入口；缺少真实业务闭环或依赖外部环境验证 | 只作为二开样板或候选能力，不作为完整产品售卖 |
| 模块 / 能力 | 成熟度 | 后端 | Admin | App | PC | 默认装配 | 说明 |
|---|---|---|---|---|---|---|---|
| IAM / Auth / RBAC / Tenant | GA | 已闭口 | 已闭口 | 登录 / 账号入口 | 登录 / 账号入口 | 是 | 统一账号、权限、菜单、租户和身份绑定是平台基础能力 |
| Config / Feature Flag / Site / Dict / I18n / Template | GA | 已闭口 | 已闭口 | 按需消费 | 按需消费 | 是 | 平台配置、站点信息、字典、多语言、模板和功能开关作为框架基础能力 |
| Audit / File / Notification / Queue / Scheduler / Database Backup / Outbox / WebSocket | GA | 已闭口 | 已闭口 | 按需消费 | 按需消费 | 是 | 运维、异步、通知、数据库备份、补偿和实时通信底座已具备后台观测入口；数据库备份默认关闭，需要管理员显式启用 |
| Money / Cashier / Entitlement / Voucher / Member Points | GA | 已闭口 | 已闭口 | 余额 / 收银台 / 积分入口 | 余额 / 收银台 / 积分入口 | 是 | 账本、收银台、权益、卡券和积分运营已形成可复用资金 / 权益底座 |
| CMS / Blog / Forum / Mall / Search | GA | 已闭口 | 已闭口 | 已闭口 | 已闭口 | 是 | 内容、社区、商城和统一搜索是当前业务金路径基线 |
| Short Link / Live Code | GA | 已闭口 | 已闭口 | 公开解析 | 公开解析 | 是 | 短链和活码已覆盖后台管理、公开解析和统计入口 |
| Open Platform | GA | 已闭口 | 已闭口 | 开发者控制台 | 开发者控制台 | 是 | 应用、scope、签名、防重放、调用日志和商业化 contract 已闭口 |
| Payment Platform | GA | 已闭口 | 已闭口 | 商户入口 | 商户入口 | 是 | 聚合支付平台默认启用；真实收款依赖商户、通道和 Provider 配置 |
| Install | GA | 已闭口 | 不适用 | 安装向导 | 安装向导 | 是 | 安装状态、环境预检、令牌和根路径接管已闭口 |
| Distribution | GA | 已闭口 | 已闭口 | 已闭口 | 已闭口 | 是 | 默认启用，Mall 支付 / 售后已接入佣金事件；内部余额打款、外部引用打款和收益日报已闭口，真实银行 / 三方 SDK / 链上广播 Provider 继续增强 |
| AI Platform / Gateway / Skill | Beta | 已闭口 | 已闭口 | 控制台 / 网关调用 | 控制台 / 网关调用 | 是 | 模型平台、网关和 Skill 底座可用；真实 Provider 运营、检测告警和高级编排继续增强 |
| Knowledge / RAG | Beta | 已闭口 | 已闭口 | 问答入口 | 问答入口 | 是 | agent-context、索引策略和 fallback 可用；生产向量库、增量扫描和外部 embedding 继续增强 |
| Web3 | Beta | 已闭口 | 已闭口 | 钱包入口 | 钱包入口 | 是 | 钱包、链配置和 readiness 诊断可用；Swap / Liquidity / Bridge 真实链验收继续增强 |
| Beta | 已闭口 | 已闭口 | 按业务接入 | 按业务接入 | 是 | 微信账号、回调和消息底座可用；真实公众号 / 小程序联调按部署环境验收 | |
| Reporting / Risk / Content Safety / SQL Console | Beta | 已闭口 | 已闭口 | 按需消费 | 按需消费 | 是 | 报表、风控、内容安全和 SQL 控制台已有后台入口，行业规则和生产策略继续按模块扩展 |
| Advertising | Beta | 已闭口 | 已闭口 | 展示 / 事件上报 | 展示 / 事件上报 | 是 | 自营广告、曝光 / 点击 / 转化事件、事件保护、内容安全预检、基础报表、预算结算、Provider 运维诊断、收益报表受控导入和结算状态运营已闭口；真实厂商 Provider SDK、复杂反作弊和广告主自动结算继续增强 |
| Marketing | Beta | 已闭口 | 已闭口 | 抽奖 / 活动入口 | 抽奖 / 活动入口 | 是 | 活动、签到和抽奖首段可用；复杂营销玩法按后续业务模块扩展 |
| Marketplace | Beta | 已闭口 | 已闭口 | 供需浏览 / 发布 / 推广 / 订单确认取消 | 供需浏览 / 发布 / 推广 / 订单确认取消 | 是 | 供需发布、服务端推广定价、用户侧订单可见、退款申请审核、后台退款执行、退款查询补偿和结算后台已闭口；退款 Provider 异步回调继续增强 |
| Live | Beta | 已闭口 | 已闭口 | 直播列表 / 详情 | 直播列表 / 详情 | 是 | 预告、开播状态、聊天治理、踢出聊天室用户、直播带货入口和公开展示可用；真实直播 Provider 和更深运营审计继续增强 |
| Video | Beta | 已闭口 | 已闭口 | 视频入口 + 创作者最近作品 | 视频入口 + 创作者最近作品 | 是 | 内容、互动、举报处理、互动规则热榜、创作者概览 / 最近作品和付费解锁首段可用；完整创作者中心和个性化推荐继续增强 |
| Reading | Beta | 已闭口 | 已闭口 | 书库 / 阅读器 / 榜单 / 投诉 | 书库 / 阅读器 / 榜单 / 投诉 | 是 | 作品、章节、付费章节、书架、阅读进度、搜索、规则推荐榜单、版权投诉、受控书源导入和同步底座可用；真实外部 Provider 和个性化推荐继续增强 |
| Form / Meeting | Beta | 已闭口 | 已闭口 | 用户入口 | 用户入口 | 是 | 表单发布 / 提交和会议预约 / RTC contract 可用；真实 RTC / 大会场 / 表单商业化深水区继续增强 |
| Chat / Conversation | Beta | 已闭口 | 已闭口 | 会话入口 | 会话入口 | 是 | 会话、消息和 WebSocket 底座可用；复杂社交关系、群组运营和机器人体验继续增强 |
| 外部真实链 / 三方支付 / 三方直播 / 三方广告 Provider 深度能力 | Preview | contract 或受控 Provider | 按模块入口展示 | 按需 | 按需 | 否 | 不伪装成已完成；以 sandbox、mock 或受控 Provider smoke 闭口，真实环境验收单独记录 |
业务模块产品化扩展方向
以下模块已进入主仓库并按默认装配 / 成熟度矩阵管理。本节只记录后续产品化深化方向，以及未来剥离为独立二次开发项目时的边界。
| 规划模块 | 定位 | 归类说明 |
|---|---|---|
spring-open-module-marketplace | 供需发布 | 供应、需求、分类、地区、预算、有效期、线索、撮合、举报和审核 |
spring-open-module-video | 视频内容 | 视频内容、付费观看、播放互动、规则热榜和举报处理首段，后续扩展短视频流、作者主页、审核记录、个性化推荐和创作者中心 |
spring-open-module-reading | 阅读 / 小说 | 作品、章节、付费章节、书架、阅读进度、规则推荐榜单、搜索、版权投诉、书源配置、合法接口导入和同步底座首段，后续扩展真实外部 Provider 和个性化推荐 |
spring-open-module-meeting | 会议平台 | 会议预约、入会 token、主持人控制、RTC contract、录制 / 转写 / AI 摘要、商业套餐和开放 API；真实 RTC / SFU / TURN 容量验收按部署环境复验 |
签到可以作为 Marketing 第一批优先孵化能力。签到奖励不在 Marketing 中写死积分、优惠券、余额、会员经验或通知，而是通过事件和 Contributor 扩展给对应模块处理，便于后续二次开发项目替换奖励体系。
团购和商品众筹 / 预售众筹归 Mall 交易增强；订单、支付、退款和售后仍由 Mall 负责。众筹只按商品众筹 / 预售众筹规划，不做证券、股权或真实金融募集语义。
业务模块剥离规划
CMS、Blog、Forum、Mall、Marketing、Marketplace、Live、Video 和 Reading 当前在主仓库内孵化，后期都要能剥离为基于本框架的独立二次开发项目：
| 模块 | 后期独立项目方向 | 依托框架能力 | 剥离边界 |
|---|---|---|---|
spring-open-module-cms | 内容运营 / 官网 / 门户项目 | IAM、Storage、Search、Notification、Scheduler | cms_ 表、/api/v1/cms/**、spring.open.cms.*、cms:* 权限和 CMS 文档独立维护 |
spring-open-module-blog | 博客 / 作者内容项目 | IAM、Storage、Search、Notification、Queue | blog_ 表、/api/v1/blog/**、spring.open.blog.*、blog:* 权限和 Blog 文档独立维护 |
spring-open-module-forum | 社区 / 论坛项目 | IAM、Storage、Search、Notification、WebSocket、Queue | forum_ 表、/api/v1/forum/**、spring.open.forum.*、forum:* 权限和 Forum 文档独立维护 |
spring-open-module-mall | 商城 / 电商项目 | IAM、Storage、Search、Notification、Payment、Queue | mall_ 表、/api/v1/mall/**、spring.open.mall.*、mall:* 权限和 Mall 文档独立维护 |
spring-open-module-ai | AI 模型供应商平台项目 | IAM、RateLimit、Notification、Money / Billing、Open Platform、WebSocket / SSE | spring.open.ai.*、/api/v1/admin/ai/platform/**、/api/v1/ai/gateway/**、ai:*:* 后台权限、AI 模型平台文档和旧 Open Platform AI 兼容迁移说明独立维护 |
spring-open-module-open-platform | 开放平台项目 | IAM、RateLimit、Notification、Open Platform、Audit | /api/v1/open/**、开放应用、签名、防重放、scope、调用日志和开放 API 文档独立维护 |
spring-open-module-payment-platform | 聚合支付 / 平台收单项目 | IAM、Open Platform、Cashier、Payment、Money、Queue、Scheduler | payment_platform_ 表、/api/v1/payment-platform/**、spring.open.payment-platform.*、payment-platform:* 权限和聚合支付平台文档独立维护 |
spring-open-module-short-link | 短链接项目 | IAM、Search、Notification、RateLimit、Scheduler | short_link 表、/api/v1/short-links/**、spring.open.short-link.*、short-link:* 权限和短链接文档独立维护 |
spring-open-module-live-code | 活码 / 动态二维码项目 | IAM、Storage、Notification、RateLimit、Scheduler | live_code 表、/api/v1/live-codes/**、spring.open.live-code.*、live-code:* 权限和活码文档独立维护 |
spring-open-module-marketing | 营销活动项目 | IAM、Notification、Queue、Scheduler、Cache、RateLimit | marketing_ 表、/api/v1/marketing/**、spring.open.marketing.*、marketing:* 权限和 Marketing 文档独立维护 |
spring-open-module-marketplace | 供需撮合项目 | IAM、Storage、Search、Notification、Moderation | marketplace_ 表、/api/v1/marketplace/**、spring.open.marketplace.*、marketplace:* 权限和 Marketplace 文档独立维护 |
spring-open-module-live | 直播项目 | IAM、Storage、Notification、WebSocket、Queue、直播 Provider | live_ 表、/api/v1/live/**、spring.open.live.*、live:* 权限和 Live 文档独立维护 |
spring-open-module-video | 短视频 / 视频内容项目 | IAM、Storage、Search、Notification、WebSocket、Queue、Media Provider、Moderation | video_ 表、/api/v1/video/**、spring.open.video.*、video:* 权限和 Video 文档独立维护 |
spring-open-module-reading | 阅读 / 小说项目 | IAM、Storage、Search、Notification、Queue、Scheduler、Source Provider | reading_ 表、/api/v1/reading/**、spring.open.reading.*、reading:* 权限和 Reading 文档独立维护 |
spring-open-module-meeting | 会议 SaaS 产品 | IAM、RTC Provider、Conversation、Core File、Runtime、Scheduler、Audit、Entitlement、Cashier / Money、Open Platform | meeting_ 表、/api/v1/meetings/**、/api/v1/admin/meetings/**、spring.open.meeting.*、meeting:* 权限和 Meeting 文档独立维护 |
剥离原则：
- 这些模块不是框架核心能力，也不是彼此的附属功能。
- 模块只能依赖框架对外稳定能力，不依赖框架内部实现细节。
- 不把模块专属常量、业务枚举、权限、菜单、配置、表结构或路由写入
spring-open-core、通用 starter 或其他业务模块。 - 模块之间不建立 Maven 强依赖；跨模块联动通过事件、Facade、Provider 或应用装配层完成。
- 未来剥离后，每个模块都应能拥有自己的应用装配、部署文档、前端视图和发布节奏，同时继续复用框架能力。
业务模块反哺底座
业务模块不是只向框架索取能力，也要反向孵化框架底座。Blog、Forum、Mall、Distribution、Marketing、Marketplace、Live、Video、Reading、App、PC、XBox 等模块在真实业务闭环中沉淀出的通用能力，满足多模块复用后应抽回主分支底座。
当前重点候选：
| 孵化来源 | 可反哺底座 |
|---|---|
| Blog / CMS | 发布状态、分类标签、作者资料、内容附件、内容审核 |
| Forum | 关注关系、互动状态、举报审核、版规校验、社区 Feed |
| Mall | 交易履约事件、幂等操作、售后附件、支付 / 通知联动 |
| Distribution | 邀请分享、增长事件、归因前置、结算审计边界 |
| Marketing | 签到奖励事件、活动奖励事件、奖池参与记录、中奖审计 |
| Marketplace | 供需信息审核、线索记录、信息撮合、付费置顶边界 |
| Live | 实时互动、直播预约提醒、直播带货跳转、流媒体 Provider 边界 |
| Video | Feed、媒体处理 Provider、互动审核、推荐 Provider 和创作者内容边界 |
| Reading | 外部内容源 Provider、书源健康、阅读进度、阅读偏好和章节导入任务 |
| App / PC | 用户偏好、主题、设备入口、消息体验和页面导航约定 |
| XBox | 社交资料、会话消息、钱包身份、Gate / Entitlement、AI Bot 会话 |
抽象规则：
- 至少两个模块或视图端复用后再抽底座。
- 多模块复用且会造成重复实现的能力，优先级高于普通业务页面和单模块增强。
- 底座命名不带单一业务产品语义。
- 原业务模块抽象完成后改为消费底座，避免长期保留重复私有实现。
- 订单、佣金、文章、主题、XBox 社区玩法等专属实体继续留在各自模块。
基础能力
| 文档 | 说明 |
|---|---|
| Web 规范 | 统一响应、异常处理、Validation、TraceId、Locale 和原始响应 |
| 配置中心 | Config Facade、数据库配置、缓存刷新、多实例通知和敏感值脱敏 |
| 站点信息 | 站点公开信息、访问策略、WebSocket 元数据和统一业务健康入口 |
| 数据库 | 数据源、MyBatis-Plus、BaseEntity、BaseService、分页、逻辑删除和 Liquibase |
| 多语言 | Spring i18n、资源文件、数据库文案、缺失 key 收集和 Validation 文案 |
| 字典 | 字典、字典项、来源治理和展示文案解析 |
| 模板 | 文本模板、变量占位符、缺失变量校验和通知/邮件/短信集成 |
| 缓存 | Cache Facade、store、TTL、隔离诊断和 Redis / memory / file 缓存 |
| Redis 基础 | RedisManager、Redisson、Topic、分布式锁、key 前缀和序列化 |
| 限流 | 登录、短信验证码、开放平台和普通接口通用限流 |
| Feature Flag | Pennant-like 功能开关、动态 Store、灰度 rollout、variant、属性 gate 和 Admin 管理 |
| JSON:API | 可选 Resource Document 表示层、relationship、link、meta 和 error object |
业务基础设施
| 文档 | 说明 |
|---|---|
| 统一身份 | 统一账号、RBAC、菜单权限、按钮权限、数据权限、审计和在线用户 |
| 核心模块治理 | 核心 owning module 边界、System 语义使用规则和治理验证 |
| 组织岗位 | 岗位、用户岗位关系和组织维度岗位约束 |
| 操作审计 | 后台写操作审计日志、查询和 CSV 导出 |
| 文件元数据 | 文件记录、当前用户文件、临时 URL、业务绑定和文件产物 |
| 内容管理 | 官网、首页、公告、轮播图、导航、专题和广告位内容运营 |
| 博客 | 用户文章、分类、标签、搜索、作者主页和后续内容互动 |
| 论坛 | 板块、主题、回复、后台管理和后续社区互动 |
| 商城 | 商品分类、商品列表、商品详情、后台商品管理和后续交易闭环 |
| 自营广告 | 广告位、广告素材、素材审核、内容安全预检、投放事件、报表、预算结算、Provider 运维和收益报表结算状态运营能力 |
| 聚合支付平台 | 商户入驻、商户应用、收款通道、服务商账号、开放支付、退款、报价、结算和分账能力 |
| 收银台 | 支付订单、渠道编排、回调、对账、补偿和支付报价 |
| 会员积分 | 签到、积分规则、订单奖励、退款冲正、人工调整和过期任务 |
| 统一搜索 | 聚合 CMS、博客、论坛、商城等公开内容的统一搜索入口 |
| 队列 | Laravel-like Job、provider、worker、失败任务、失败通知和后台运维 |
| 任务调度 | Scheduler Facade、provider、执行日志、失败重试、手动触发和后台运维 |
| 数据库备份 | 后台可控的 MySQL / PostgreSQL 手动备份、定时备份、Queue 执行、备份后校验、可选加密、副本、通知、保留策略、下载和删除 |
| Hook | 方法级同步增强，适合 @Hook.Execute、Hook.execute(...) 和外层审计 / 指标 / 鉴权扩展 |
| 管道 | 有序流程编排，适合校验链、支付前置检查、Web3 确认和 AI 任务处理 |
| 责任链 | 条件决策责任链，适合风控、审批、策略分流和内容审核规则 |
| 审批工作流 | 审批 / 复核 / 工单状态机，适合内容审核、售后、提现、投放和商户入驻等人工状态动作 |
| 权益 / 套餐 / 配额 | 中性套餐目录、权益项、配额策略、用户权益、余额和流水底座 |
| 卡券 | 中性卡券模板、发放、锁定、核销和操作日志底座 |
| 文档解析 | Document Facade、plain-text provider、文档来源、抽取选项和后续 Tika provider 边界 |
| 内容安全 | Content Safety Facade、keyword / noop provider、Provider 路由和后续第三方内容安全接入边界 |
| 风控限额 | 风控规则、风险事件、冻结记录和人工复核任务 |
| 报表中心 | 报表定义、即时快照和异步导出聚合 |
| 知识库 | 项目知识扫描、Markdown 切片、关键词检索和 Ask 上下文 |
| AI 任务 | AI 任务模型、handler 注册、同步执行和后续队列/调度/管道衔接 |
| AI 模型 | AI 模型调用 Facade、Manager、ConfigResolver、Provider SPI 和后续网关 Provider 边界 |
| AI 模型平台 | AI 模型供应商平台、模型网关、Token 计量计费和后续用户控制台 |
| AI 模型网关 | OpenAI Compatible 网关、模型路由、流式响应、Token 计量和用户 API Key 调用入口 |
| AI Skill | SKILL.md 解析、激活匹配、版本、启停和运行日志 |
| AI Agent 接入 | OpenAPI 元数据、Open Platform 调用、工具调用约定和签名接入说明 |
| 事件 | Event Facade、同步/异步发布、Spring 监听和事务提交后监听 |
| 日志 | 请求日志、TraceId、操作日志、登录日志、调度日志、通知发送日志和开放平台调用日志 |
| 观测 | Actuator 健康检查、应用信息、基础指标和后续观测平台接入边界 |
| WebSocket 通信 | 连接管理、用户绑定、设备推送、分组发送、广播和 Redisson 多实例 |
生态能力
| 文档 | 说明 |
|---|---|
| 邮件 | SMTP、QQ/Gmail/网易邮箱配置和 Notification 邮件通道 |
| 短信 | sms4j 生态服务商、短信宝、发送验证码和 Notification 短信通道 |
| 文件存储 | local/public disk、MinIO、腾讯云 COS、阿里云 OSS、FTP/SFTP/WebDAV 等 |
| 翻译 | Translate Provider、批量翻译、JSON 结构化翻译和占位符保护 |
| 支付 | 支付宝、微信、PayPal、银联、QQ 钱包、京东支付和 Web3 支付边界 |
| 微信生态 | 微信公众号、小程序、微信开放平台的 WxJava SDK 适配、账号配置、回调和消息日志底座 |
| Web3 | EVM 常用能力、开放能力、生产联调、安全边界和后续路线 |
| 金额与资产 | 法币、虚拟币、Web3 资产编码、金额换算和统一时间格式 |
| 开放平台 | 第三方开发者接入、签名算法、scope、限流和调用日志 |
运行与体验
| 文档 | 说明 |
|---|---|
| 视图页面 | Thymeleaf 轻量页面、本地 Vue/Pico WebJar 和可选 vendor 路径 |
| 前端工程 | views/ 前端源码、VitePress 文档站和构建导出 |
| 企业安装 | 安装状态、安装入口、根路径接管和 V1.0 安装向导规划 |
| Docker 环境 | 应用镜像、MySQL、PostgreSQL、Redis 和本地持久化 |
| 部署 | dev/test/prod/lite 运行模式、目录语义和生产建议 |
| 测试 | Maven 测试、依赖树检查、Docker smoke、Web3 RPC smoke 和文档检查 |
专题入口
专题文档不在模块索引重复展开。需要 Web3 生产联调、事件补偿、支付结算等专题时，从 Web3 文档进入；需要 OpenAPI 元数据和 Swagger UI 时，从 API 文档 进入。