应用
应用清单
十三个可安装应用的分工、依赖顺序与许可档位,以及每个应用自己的文档页在哪。
想决定「先装哪个、装了它还要装什么」,或者要查某个应用的菜单、配置项和常见问题,从这一节进。每个应用一页,页里只写那个应用特有的东西。
平台侧的通用动作(安装、升级、启停、卸载、任务日志)不在这里重复,见 在部署里使用应用;怎么把一个仓库打成应用包,见 打包应用。
十三个应用
| 应用编码 | 名称 | 它管什么 | 许可 |
|---|---|---|---|
member | 会员管理 | 会员档案、等级、余额、积分、成长值、徽章、签到、收货地址 | 商业授权 |
mall | 商城管理 | 商品与 SKU、订单与售后、营销活动、优惠券、商家与数据统计 | 商业授权 |
pay | 支付管理 | 支付应用、支付渠道(支付宝 / 微信 / 余额)、支付订单与退款单 | 商业授权 |
quote | 报价管理 | 客户报价单、明细加价、税率运费、价格库导入导出 | MIT |
finance | 财务管理 | 聚合商城收款、售后退款与会员余额流水,给财务流水 / 会员退款 / 会员收入三个视图 | 商业授权 |
cms | 内容中心 | 文章、分类、标签、评论与前台站点渲染(/site/**) | 商业授权 |
gallery | 图床管理 | 多租户图片、分类、标签、相册、访问日志与存储配置 | MIT |
social | 社交互动 | 关注、收藏、评论、点赞、分享、拉黑与互动统计 | MIT |
im | 即时通讯 | 工作台、会话、消息、联系人、好友申请与群聊 | 商业授权 |
exam | 考试系统 | 题库分类、题目、试卷、考试安排、考试记录与在线答题 | 商业授权 |
enterprise | 企业数据 | 企业工商信息的增删改查、Excel 导入导出与对外门户接口 | 商业授权 |
license | 许可证 | 凭证签发与运营台账(运营侧)、名下许可证与激活兑换(客户侧) | 商业授权 |
hello | Hello 示例 | 插件开发范例:一张表加五组演示,不用于生产 | MIT |
「许可」这一列抄的是各仓库 app.json 里的 license 字段。MIT 的四个仓库是公开的;其余仓库写的 UNLICENSED 表示商业授权,条款见对应仓库 LICENSE。它决定的是代码能不能拿去看,与能不能装是两件事,后者见 授权档位。
依赖顺序
各仓库 app.json 的 dependencies 字段是这张表的来源。平台在装之前会读它,缺依赖时安装任务直接失败并写明缺哪个。
| 应用 | 需要已装 |
|---|---|
member、pay 之外的大多数 | 无 |
pay | member |
hello | member |
quote | im(可选,只影响站内消息那一条) |
finance | member、mall |
mall | member、pay、im |
要跑一套完整商城,安装顺序是 member → pay → im → mall,再按需加 finance。内容站则 cms 打头,gallery / social 随时可加。
cms 在依赖表里是特例:它的 app.json 没有声明依赖,前台却依赖它的主题直出其他应用的公开页(/site/gallery、/site/mall/** 那几屏)。没装 cms 时这些应用的后端与后台页面照常可用,前台那几屏取不到。
每页的写法
各应用页按同一副骨架组织,跳页时按标题找:
- 这个应用是什么:一屏能看完的职责边界,以及它不管的那部分归谁。
- 装它:装之前的前置条件(依赖、必须的配置或密钥)、装完在侧栏看到什么。
- 配它:这台部署要决定的那几个值,各写「改它之前先确认什么」。
- 用它:日常操作路径,按角色(管理员 / 会员 / 前台访客)分开。
- 出问题查什么:按现象排的排查顺序,给能复制的命令与接口。
- 实现索引:表、接口前缀、权限码、源码路径,放在页尾,不作为正文骨架。
配置项与表结构的全量清单在各仓库(app.json、migrations/*.sql、src/main/java/**/controller),页面只挑「部署时必须知道」的那几条。数字会随包版本走,各页最后一段标了它对应的应用版本。