Appearance
术语表
新人必读。日常沟通、代码、文档里高频出现的词。
账户与租户
| 术语 | 含义 |
|---|---|
| platform | 平台方(我们自己)的管理账号,最高权限 |
| channel | 渠道商,管理旗下多个商户 |
| merchant | 商户 = 租户,SaaS 的付费主体,一切业务数据的归属单位 |
| user | 商户的终端用户(C 端消费者/会员) |
| mid | Merchant ID,商户/租户 ID。所有业务表都有 mid 字段,所有查询必须带 mid 过滤 |
| fid | 当前登录者的账号 ID(from ID),TokenGet.getFid() 获取 |
| Token | 每个已认证请求携带,TokenGet.get()/getMid()/getFid() 解析 |
后端
| 术语 | 含义 |
|---|---|
| BasicQueryController | 控制器基类,自带 GET /query(分页)、GET /get |
| BasicCurdController | 在上者基础上加 POST /save、POST /update、DELETE /delete |
| UpdateFields | 字段更新构建器,UpdateFields.newBuilder().put(k,v).build(),禁止整实体 save 式更新 |
| QueryWrapper | 查询条件构建器 |
| 契约模块 | <svc>-contract(纯接口+DTO,提供方消费方都依赖)/ <svc>-contract-feign(@FeignClient + SPI 适配器,只有消费方依赖)。带自己的语义化版本 |
| 框架 SPI | cn.hiapi.core.basic.cloud.ICloudXxxService,跨服务调用的唯一入口;取实现用 dispatchContext.getCloudService(...),不是 getServiceOne(...) |
| Outbox / NotifyRecord | 支付成功通知用本地消息表模式,15s 兜底重投 |
前端
| 术语 | 含义 |
|---|---|
| TablePage | 管理后台标准列表组件(搜索头+表格+分页),列表页一律用它 |
| useApi / apiQuery | 管理后台 HTTP 客户端;apiQuery(url,data) 自动拼 /query 发 GET |
| HiapiUtils | UniApp 端唯一 HTTP 工具(包装 alova),禁止直接用 alovaInstance |
| 装修 / widget | 页面可视化装修体系;组件在 uniapp-design,hiapi-<project>-<widget> 命名 |
| 子应用 / 微前端 | 管理后台经 Qiankun 从 CDN 加载的独立前端(设计器、VEM 后台等) |
平台级
| 术语 | 含义 |
|---|---|
| nuwa(女娲) | Go 应用市场服务:应用上架/安装/升级 + 软件授权(License) |
| License / 票据 | 客户私有化部署的授权凭证(Ed25519 签名),含配额/有效期 |
| 保护模块 / hiapi-core-public | 核心业务代码加密打包,运行时经 C++ JNI 加载,防私自部署/转卖 |
| 水印 | 模块 zip 内注入 META-INF/HIAPI_WATERMARK,追溯泄露源 |
| 契约先行 | 跨团队新接口先提 OpenAPI 草案 PR、双方评审后再开发,见 contracts |