Skip to content

术语表 ​

这里收录 78 个在本仓反复出现的术语。一个术语只给一句话,解释到「能继续读下一页」为止;想深挖就点最后一列的落点。

1. 怎么用这张表 ​

  • 读文档卡住时,先按 Ctrl+F 搜术语,不要从头读。
  • 第 4 列是「本仓落点」:能点的是页面,不能点的是类名或表名,复制到 IDE 里搜。
  • 同一概念在不同层有不同叫法(如「功能权限」≈「权限点」),第 5 节专门列了易混组。
  • 本表只解释本仓实际存在的东西;标了「未使用」「未建模」的,就是现状,不要按上游项目假设。

2. 产品与项目管理 ​

组内按拼音排序;拉丁缩写排在组末。

术语英文 / 缩写一句话解释本仓落点
场景Scenario角色在特定目标下的一段业务活动角色与场景
功能点Feature知识库里的最小业务单元,用 ID 对齐产品与代码能力地图
功能卡Feature Card一个功能点的接口、表、权限点与代码定位单页功能卡索引
关键流程Key Flow跨模块的端到端业务链路,如开通租户关键流程
规划中Planned只有需求与决策、尚无代码的能力状态 🚧路线图与决策
领域模型Domain Model实体、关系与边界,如用户-角色-菜单领域模型
路线图Roadmap能力按版本投放的顺序与依赖路线图与决策
里程碑Milestone阶段交付节点,用于对齐范围与验收项目管理知识框架
能力地图Capability Map113 项能力按已实现 / 预留 / 规划分层能力地图
业务角色Business Role使用系统的人,如管理员、运营,不是权限角色角色与场景
验收标准Acceptance Criteria可自检的完成定义,写清输入、输出与边界练习与自测
预留模块Reserved Module源码在库但 pom 注释、不参与构建的 13 个模块预留模块概览
PRDProduct Requirements Document立项需求原件,知识库只引用不改写PRD 产品概述
WBSWork Breakdown Structure工作分解结构,对应任务树 / 计划能力项目管理知识框架

3. 平台与权限 ​

术语英文 / 缩写一句话解释本仓落点
按钮权限Button Permissionsystem_menu 中 type=3 的记录,只挂权限点与按钮MenuTypeEnum.BUTTON
部门Dept组织树节点,也是数据权限的默认维度DeptDO(system_dept)
超管Super Admin角色码 super_admin,权限判断直接放行RoleServiceImpl#L241
菜单Menu目录 / 菜单 / 按钮三级,permission 字段挂权限点MenuDO(system_menu)
短信渠道SMS Channel短信服务商账号与签名配置,发送时按渠道取SmsChannelDO(system_sms_channel)
岗位Post用户的任职标记,参与展示、导出与筛选PostDO(system_post)
岗位职级Post Level本仓未单独建模,仅用岗位的 sort 表达顺序PostDO(无 level 字段)
公告Notice面向全员的通知发布,可置顶与定时NoticeDO(system_notice)
角色Role权限集合的载体,用户通过角色获得菜单与权限点RoleDO(system_role)
邮件模版Mail Template邮件正文模板,变量占位后由发送服务渲染MailTemplateDO(system_mail_template)
权限点Permission形如 system:user:create 的最小校验单位MenuDO.permission
社交登录Social Login微信、钉钉等第三方身份换取本系统令牌SocialUserDO(system_social_user)
套餐Tenant Package租户可用的菜单集合,开通时裁剪TenantPackageDO(system_tenant_package)
数据权限Data Permission按部门 / 自定义范围过滤行,区别于功能权限DeptDataPermissionRule
刷新令牌Refresh Token短期访问令牌过期后换取新令牌的长期凭证AuthController#L85-L91
令牌Token / JWT请求头携带的登录凭证,服务端校验后建上下文OAuth2AccessTokenDO、TokenAuthenticationFilter
租户Tenant一套独立数据空间的客户单位,业务表带 tenant_idTenantBaseDO、TenantContextHolder
租户忽略@TenantIgnore标记全局表 / 方法,SQL 不拼 tenant_idTenantDatabaseInterceptor#L46
站内信Notify Message站内通知,模板与消息分表存储NotifyMessageDO(system_notify_message)
字典Dict枚举型下拉的库内配置,按类型分组DictTypeDO / DictDataDO
OAuth2OAuth 2.0授权码等模式的令牌协议,本仓作客户端OAuth2ClientDO(system_oauth2_client)
SSOSingle Sign-On本仓无独立 SSO 服务端,靠 OAuth2 客户端对接OAuth2ClientDO、AuthController#L66
验证码Captcha滑块 / 点选验证,答案存 Redis,默认 blockPuzzleapplication.yaml#L103-L118

4. 数据与持久化 ​

术语英文 / 缩写一句话解释本仓落点
代码生成Codegen由表结构生成 CRUD 代码、页面与 SQL 片段CodegenEngine
读写分离Read-Write Splitting主库写、从库读,用 @DS("slave") 切换application-local.yaml#L70-L74
多数据源Dynamic DataSource运行时可增删的数据库连接,按 @DS 切换DataSourceConfigDO(infra_data_source_config)
分页Pagination页码 / 页大小 + total,插件自动拼 limitPageParam、PageResult
类型处理器TypeHandlerJava 集合 / 对象与 JSON 列互转JacksonTypeHandler(AdminUserDO#L61)
逻辑删除Logical Deletedeleted 标记,查询自动过滤、删除只改标记BaseDO#deleted
审计字段Audit Fieldscreator / create_time / updater / update_time 四件套BaseDO
事务Transaction多表写入同成功或同回滚AdminUserServiceImpl#L96
数据源Data Source业务库或从库的连接配置,含主从与租户库DataSourceConfigDO
树表Tree Tableparent_id 自关联的层级表,代码生成类型 2CodegenTemplateTypeEnum.TREE
雪花 IDSnowflake ID全局唯一 long 主键,避免分库分表冲突IdTypeEnvironmentPostProcessor
主子表Master-Detail一张主表带明细表,模板类型 10 / 11 / 12CodegenTemplateTypeEnum
DDLData Definition Language建表 / 改表语句,本仓集中在一个 SQL 文件sql/mysql/pmforge.sql#L5021
DOData Object与表一一对应的持久化对象AdminUserDO
MapperMyBatis Mapper数据访问接口,继承 BaseMapperX 获得通用 CRUDAdminUserMapper
VOView Object接口入参 / 出参对象,承载校验与展示字段UserSaveReqVO

5. 中间件与运维 ​

术语英文 / 缩写一句话解释本仓落点
错误码Error Code10 位数字,类型 + 系统 + 模块 + 序号,按段分配GlobalErrorCodeConstants、ServiceErrorCodeRange
定时任务Scheduled JobQuartz 调度 + 业务 JobHandler,日志落 infra_job_logSchedulerManager
分布式锁Distributed Lock多实例互斥,基于 Redis,注解 @Lock4jPmforgeLock4jConfiguration
加密传输API Encrypt请求 / 响应体加解密,注解 @ApiEncrypt 开启ApiEncryptFilter
幂等Idempotency同一请求重复执行只生效一次,注解 @IdempotentIdempotentAspect
限流Rate Limit按用户 / IP / 表达式限制单位时间调用次数RateLimiterAspect
验签Signature Verification开放接口按密钥与时序签名,防篡改与重放ApiSignatureAspect
自动配置Auto-configuration通过 imports 文件按条件装配 BeanAutoConfiguration.imports
ActuatorSpring Boot Actuator生产就绪端点,本仓挂在 /actuator 下application-local.yaml#L148-L159
API 日志API Access Log记录请求、响应、耗时与异常,异步落库ApiAccessLogFilter
BOMBill of Materials统一管理依赖版本的父 pompmforge-dependencies
CronCron Expression6 段调度表达式,秒级,非法时拒绝保存CronUtils
Flyway / LiquibaseDB Migration Tool本仓未使用,DDL 由 sql/ 手工执行sql/mysql/pmforge.sql
JobHandlerJob Handler任务执行接口,Bean 名即 handler_nameJobHandler(starter-job#L31)
OpenTelemetryOTel链路追踪 API / SDK,生成 traceId 与 spanPmforgeTracerAutoConfiguration#L36
ProfileSpring Profile环境配置开关,默认 localapplication.yaml#L6
Prometheus / MetricsMetricsMicrometer 指标,暴露给 Prometheus 抓取PmforgeMetricsAutoConfiguration
Pub/SubPublish / SubscribeRedis 频道广播,在线即收、不持久化AbstractRedisChannelMessage
RabbitMQRabbitMQ可选消息中间件,生产端自动透传租户TenantRabbitMQMessagePostProcessor
RedisRedis缓存、会话、验证码、限流与消息的共用底座PmforgeRedisAutoConfiguration
StarterSpring Boot Starter可插拔能力包,含 core 与 config 两部分pmforge-framework/*
StreamRedis Stream带消费组与 ACK 的持久化消息队列AbstractRedisStreamMessage
TraceTrace ID一次请求的全局标识,写在响应头并入库TraceFilter#L28
WebSocketWebSocket长连接推送,路径 /infra/ws,五种 senderWebSocketSessionManagerImpl
XSSCross-Site Scripting跨站脚本过滤,默认开启,可配开关XssFilter

6. 最容易混的 10 组 ​

  • 业务角色 vs 权限角色:前者是「谁在用」(产品层),后者是「能访问什么」(RoleDO);同一业务角色可以对应多个权限角色。
  • 功能权限 vs 数据权限:功能权限决定「能不能调这个接口」,数据权限决定「这次查询能返回哪些行」。
  • 权限点 vs 菜单:权限点只是字符串,必须登记在 system_menu.permission 才可被反查;没登记就是 403。
  • 租户 vs 部门:租户是数据隔离的第一层(tenant_id),部门是租户内部的第二层(数据权限)。
  • 租户忽略 vs 数据权限关闭:@TenantIgnore 关掉租户条件;@DataPermission(enable = false) 关掉部门条件,两者互不替代。
  • 逻辑删除 vs 物理删除:本仓默认逻辑删除(deleted),DDL 里的 deleted bit(1) 不是备份字段。
  • DTO vs VO vs DO:DO 对表、VO 对接口、DTO 跨模块传输;功能卡里的「接口」用的是 VO。
  • Starter vs 模块:Starter 是框架能力(pmforge-framework),模块是业务能力(pmforge-module-*)。
  • BOM vs parent:BOM 只管版本(dependencyManagement),parent 还管构建插件与聚合。
  • Stream vs Pub/Sub:要可靠、可重放、有消费组用 Stream;只要在线广播、允许丢用 Pub/Sub。

7. 按场景速查 ​

我想……先看
判断一个需求有没有现成能力能力地图
知道一个功能对应哪些接口和表功能卡索引
搞清登录后菜单是怎么算出来的AuthController#L93-L118
加一个新权限点鉴权与权限点
搞清一次请求经过哪些 Filter请求处理链路
解释为什么查询自动带 tenant_id多租户
让不同部门看到不同数据数据权限
新建一张表并生成 CRUD代码生成闭环
任务在 local 不执行常见问题
多实例下消息送不到消息与实时推送
查一个错误码属于哪个模块错误码段
看某个配置项的默认值配置项速查

8. 相关页面 ​