随笔分类 -  技术-其他 / 架构规范

摘要:目录背景和价值🔍 一、实体查询(单对象获取)命名模式:get + 名词单数示例代码:✅ 规范要点:📋 二、实体列表查询(多对象获取)命名模式:list + 名词复数示例代码:✅ 规范要点:📄 三、分页列表查询(列表+分页)命名模式:list + 名词复数 + WithPaging示例代码:✅ 阅读全文
posted @ 2025-08-05 19:04 向着朝阳 阅读(88) 评论(0) 推荐(0)
摘要:目录背景和价值2 框架提供公共的异常处理类,容器异常处理拦截处理参考资料 背景和价值 设计统一的错误码结构 规划一套通用的错误码格式,让各个服务依据此格式生成错误码,从而保障不同服务针对同一类错误生成的错误码相似。常见的错误码结构设计如下: 三段式结构 服务标识段:用来识别不同的微服务,比如用户服务 阅读全文
posted @ 2025-05-27 17:05 向着朝阳 阅读(75) 评论(0) 推荐(0)
摘要:目录背景和价值Respons 基类单个对象返回值参考资料 背景和价值 服务之接返回包装类作用 统一服务之间,以及BFF和前端的返回对象包装类 避免丢异常信息 区分SingleResponse,MultiResponse,PageResponse 好处 返回值需携带扩展信息(如分页总条数、数据版本号) 阅读全文
posted @ 2025-05-27 16:52 向着朝阳 阅读(39) 评论(0) 推荐(0)
摘要:目录背景和价值1.1 BFF路径1.2 服务提供者路径2 api 版本 升级规范3 其他规范版本放哪里?什么情况下会发生全局版本升级一、重大架构或协议变更二、核心业务逻辑重构三、安全漏洞修复与合规要求四、技术栈迁移五、长期维护成本过高全局升级注意事项参考资料 背景和价值 1 路径规范 restful 阅读全文
posted @ 2025-05-27 15:39 向着朝阳 阅读(56) 评论(0) 推荐(0)
摘要:目录背景和价值一、基于Redis的自动续期方案二、双Token机制(Access Token + Refresh Token)三、被动刷新方案(每次请求返回新Token)四、混合方案(结合角色与动态策略)五、安全注意事项总结参考资料 背景和价值 以下是基于JWT实现会话时间延迟的常见方案及技术实现细 阅读全文
posted @ 2025-05-09 13:34 向着朝阳 阅读(134) 评论(0) 推荐(0)
摘要:目录背景和价值参考资料 背景和价值 参考资料 https://mp.weixin.qq.com/s?__biz=MzU0MzQxMzA5MQ==&mid=2247485040&idx=1&sn=b52592abb2c5c2ac519f9c95c26ae2f9&chksm=fa1c5957eb9c62 阅读全文
posted @ 2025-05-02 22:08 向着朝阳 阅读(24) 评论(0) 推荐(0)
摘要:目录背景和价值前端防抖并做页面加载友好提示前端预生成token,提交表单带上token,后端做校验 (推荐,复杂度中,适合金融支付场景)一、流程图概览后端分布式锁(简单,粗暴,难度度:低)2. 安全增强措施Redis全局锁二、实现步骤1. 获取锁(原子操作)2. 执行业务逻辑六、对比:Redis 锁 阅读全文
posted @ 2025-05-01 12:32 向着朝阳 阅读(113) 评论(0) 推荐(0)
摘要:目录鉴权方案对比分析适用场景再梳理方案1更适合以下场景:方案2更适合以下场景:方案2 鉴权实现BFF 层鉴权业务服务鉴权大模型MCP和业务服务查询集成四、关键决策点五、推荐架构模式混合依赖模式(Hybrid)技术实现示例六、总结参考资料 鉴权 在微服务架构,通常BFF,和业务服务。有2种鉴权方案 方 阅读全文
posted @ 2025-04-26 17:33 向着朝阳 阅读(258) 评论(0) 推荐(0)
摘要:目录1 定时任务执行过程可追溯设计2. 大数据量需分片处理(分布式调度)断点续跑3. 定时任务的依赖处理,避免上一个没有跑完,下一个却跑了。4 支持手动重跑(支持最小粒度的重试)5 防止重叠设计定时任务重叠的分布式锁通过态机设计 防止定时任务重叠6 自动补偿机制(失败重试几次,7 异常告警参考资料 阅读全文
posted @ 2025-04-24 21:34 向着朝阳 阅读(121) 评论(0) 推荐(0)
摘要:目录背景六边形架构介绍与传统分层架构的对比优势分层ModelPortApplicationAdapter代码实现输入端口收入端口实现类--应用服务输入适配器输出端口输出适配器项目结构代码示例常见问题和解决找不到Port的实现类参考资料 背景 什么情况下适合用六边形架构? 外部系统的集成方式多变的软件 阅读全文
posted @ 2025-04-20 12:06 向着朝阳 阅读(148) 评论(0) 推荐(0)
摘要:目录业务架构应用架构数据架构技术架构参考资料 业务架构 战略布局的定位:商业画布 业务全景图 (必选) 业务子领域:子域定义以及边界 业务子领域的业务场景清单以及业务流程(链接) 业务资产表 (通用流程建模, 局部复杂业务的业务活动下使用) 应用架构 统一语言(业务概念):名称,定义,领域对象,概念 阅读全文
posted @ 2025-04-08 22:40 向着朝阳 阅读(27) 评论(0) 推荐(0)
摘要:目录背景和价值应用架构数据架构技术架构非功能性需求参考资料 背景和价值 应用架构 检查项 价值 示例 措施 是否存在实体和所在的界限上下文不符 提升沟通效率。强化问题解决: 清晰的问题边界有利于找出更切合实际的解决方案,并更好地进行方案实施和评估。 间接客户的实体在政策服务。而不是在客户模块统一管理 阅读全文
posted @ 2025-04-01 20:38 向着朝阳 阅读(26) 评论(0) 推荐(0)
摘要:目录背景参考资料 背景 缺乏规范,有些团队代码杂乱无章,难以维护。现在推荐一种代码结构的写法。 基于流程框架的 任务和步骤的层级结构组织代码。 服务接口:跟流程框架的任务一致 (DDD的命令) 步骤:独立的方法,或者类封装接口。步骤内部的逻辑基于业务场景分层编写。 例: L5 (业务活动):订单评审 阅读全文
posted @ 2025-03-25 21:12 向着朝阳 阅读(33) 评论(0) 推荐(0)
摘要:目录1 架构规范1.1 【强制】服务之间依赖顺序是单向的,避免循环依赖。1.2 [强制] 层的调用规范1.3 [强制] API设计规范和升级规范4【推荐】BFF 编码规范2 编码规范2.1【推荐】配置,aop,工具类只需要在application、infrastructure、domain层定义。2 阅读全文
posted @ 2025-03-18 14:51 向着朝阳 阅读(19) 评论(0) 推荐(0)
摘要:目录一、MessageId 生成机制二、不同失败场景分析1. 客户端发送失败(未到达Broker)2. Broker处理失败(消息已到达Broker)三、生产环境解决方案方案1:客户端预生成唯一ID(推荐)方案2:异常处理中提取部分结果四、事务消息的特殊处理五、监控与排查建议六、各场景总结表 1 消 阅读全文
posted @ 2025-03-09 08:10 向着朝阳 阅读(114) 评论(0) 推荐(0)
摘要:目录参考资料 https://zhuanlan.zhihu.com/p/22212070144 参考资料 阅读全文
posted @ 2025-02-21 09:26 向着朝阳 阅读(10) 评论(0) 推荐(0)
摘要:目录背景和价值分支介绍master分支Hot fix分支release分支develop分支feature分支bug fix分支流程项目启动开发本地自测开发环境联调测试环境测试测试环境BUG修复UAT测试上线上线后一天生成有故障,需要紧急修复多项目并行情况环境规范分支命名规范冲突解决规范参考资料 背 阅读全文
posted @ 2025-02-18 11:18 向着朝阳 阅读(198) 评论(0) 推荐(0)
摘要:目录背景和价值迭代启动明确测试分支,并在白板上通告。 背景和价值 迭代启动 明确测试分支,并在白板上通告。 存在多团队一起修改同一个PSA的情况;甚至多项目并行的情况,需要做好信息互通 阅读全文
posted @ 2025-02-18 11:04 向着朝阳 阅读(7) 评论(0) 推荐(0)
摘要:目录背景和价值1. 域名访问 DSN2. 负载均衡器 (LVS等)3. NGINX+WAF(Web 应用防火墙)4. API 网关前端访问映射后端访问映射5. 业务网关 (可选)6. BFF7. 应用服务参考资料 背景和价值 使用云的架构 1. 域名访问 DSN 2. 负载均衡器 (LVS等) 为了 阅读全文
posted @ 2025-02-17 17:23 向着朝阳 阅读(30) 评论(0) 推荐(0)
摘要:银行存款利息计算案例 假设某银行有 100 个活期存款账户,日利率为 0.0001(万分之一),且系统在计算利息时精确到分(保留两位小数)。 具体计算与尾差产生 客户 本金(元) 应得利息(精确计算,元) 实际记录利息(四舍五入,元) 尾差(元) 客户 A 10000 1.00 0.0000 客户 阅读全文
posted @ 2025-02-14 15:52 向着朝阳 阅读(524) 评论(0) 推荐(0)