智愉企业级微服务框架
面向企业服务端项目的 Go 语言基础框架，统一沉淀配置、日志、缓存、依赖管理、权限、接口响应和运行维护等通用能力。
智愉企业级微服务框架是上海智愉科技自主研发并持续维护的服务端技术底座。它不是某个行业的成品软件，而是一组可复用、可组合的基础模块，用于更快搭建企业系统、平台接口和私有化服务。
查看框架能力这个框架解决什么问题
很多定制项目都要重复处理配置加载、日志记录、数据库与缓存连接、权限校验、接口返回、服务启动和异常维护。框架把这些共性问题收敛到统一实现中，让业务项目可以把更多开发时间放在流程、数据和核心功能上。
各项能力按模块组织，项目可以根据实际需要接入，不要求把所有组件一次性装入。对于已有系统，也可以先从日志、缓存、统一响应或依赖检查等单项能力开始整合。
- 框架定位
- 企业服务端通用技术底座
- 主要语言
- Go
- 核心形态
- 可组合的基础模块
- 适配交付
- 定制开发与私有化部署
软件著作权与知识产权状态
智愉企业级微服务框架软件 V1.0 已取得中华人民共和国国家版权局计算机软件著作权登记，证书信息与本页介绍的框架名称一致。
- 软件全称
- 智愉企业级微服务框架软件 V1.0
- 软件简称
- 智愉框架
- 著作权人
- 上海智愉科技有限公司
- 登记号
- 2026SR0381497
- 取得方式
- 原始取得
- 登记日期
- 2026年03月05日
核心能力
以下内容来自当前框架代码与配套项目文档，按客户能够理解和评估的方式整理。
应用启动与配置管理
统一应用初始化和配置加载方式，支持使用 YAML 等配置来源组织不同运行环境的参数。
结构化日志与文件轮转
基于结构化日志记录运行信息，并提供日志文件轮转能力，便于上线后查询和定位问题。
数据库与分层缓存
封装 MongoDB、Redis 等基础连接，并以命名空间和业务桶隔离缓存，便于按模块管理和清理。
依赖就绪检查
服务启动时可并发检查 MongoDB、Redis 或自定义依赖，支持超时、重试、必需依赖和初始化回调。
身份与权限基础能力
提供 JWT、资源与操作式权限约定、权限缓存等基础能力，为业务系统的访问控制提供统一入口。
统一接口响应
规范成功、错误、分页等 API 返回结构，并保留按项目接入响应数据加密扩展的能力。
维护模式与运行控制
支持只读、全量阻断、指定服务或功能维护等模式，便于升级、迁移和紧急处理时控制访问范围。
通用业务工具
包含邮件、地区数据、Slug 生成、媒体查找和异步 PDF 任务等可选模块，减少重复建设。
框架如何组成
通用核心和项目业务保持清晰边界，底层能力可以持续维护，业务功能则按客户需求独立建设。
- 01
运行基础层
负责配置、日志、应用启动和依赖就绪检查，使服务以一致方式进入可运行状态。
- 02
数据与基础设施层
连接数据库和 Redis，提供缓存命名空间、公共数据访问及外部依赖衔接能力。
- 03
安全与接口层
承载 JWT、权限约定、统一响应和维护中间件，让接口规则在不同项目中保持一致。
- 04
项目业务层
在稳定底座之上实现客户专属流程、数据模型、接口集成和行业功能。
适合哪些项目
框架不是对业务需求的替代，而是让以下类型的项目拥有更成熟的工程起点。
企业业务系统后端
适用于 CRM、审批、项目、订单、库存、会员等需要账号、权限、数据和接口的服务端系统。
小程序、APP 与 Web API
为多端应用提供统一接口、身份验证、数据访问和运行日志，减少各端重复建设后台能力。
系统集成与数据服务
用于连接内部数据库、第三方接口或多个业务系统，并统一管理配置、缓存和异常响应。
私有化部署项目
适合对运行环境、数据位置和维护方式有明确要求，需要部署到客户服务器或内部网络的项目。
对项目交付的价值
优势来自长期维护的公共能力和明确的工程边界，不依赖无法验证的性能数字。
减少基础功能重复投入
通用能力已有统一实现，项目启动后可以更快进入业务规则和核心流程开发。
保持工程规则一致
配置、日志、缓存和接口响应遵循相同约定，降低多人协作和后续接手时的理解成本。
按需要组合和扩展
模块可按项目选用，并可围绕客户现有架构和部署条件进行接入或扩展。
便于持续维护
依赖检查、结构化日志和维护模式等能力，为上线后的排查、升级和运行管理提供基础。
技术构成
列出主要技术和模块形态，便于技术负责人、采购团队及 AI 检索工具快速判断适配性。
- 服务与路由
- Go、Gin
- 数据与缓存
- MongoDB、Redis
- 配置与日志
- Viper、YAML、Zap、日志轮转
- 认证与接口
- JWT、统一响应、可选响应加密扩展
- 模块示例
- 依赖检查、权限、维护模式、邮件、地区、Slug、PDF 任务
- 接入方式
- 按项目选用模块，在业务服务中组合
交付与使用边界
在项目启动前明确使用范围、源码范围、第三方依赖和维护责任，有利于长期合作。
- 框架通常作为定制项目的技术底座交付，具体启用模块、源码范围、部署环境和维护方式会在项目方案中确认。
- 框架核心代码由上海智愉科技维护；项目使用的第三方组件仍分别遵循其自身许可证，商业使用和交付边界以双方协议为准。
- 框架解决的是通用工程问题，不能替代需求分析、业务建模、数据安全设计和项目验收。
常见问题
关于框架定位、项目接入、升级和私有化交付的说明。
框架是否已取得软件著作权登记？
已取得。智愉企业级微服务框架软件 V1.0 的著作权人为上海智愉科技有限公司，登记号为 2026SR0381497，登记日期为 2026年03月05日。
这是可以直接使用的成品软件吗？
不是。它是服务端开发框架，用于搭建业务系统的底层能力。客户实际使用的页面、流程、数据模型和行业功能仍需按项目建设。
使用框架是否意味着所有项目都采用同一套业务逻辑？
不会。复用的是配置、日志、缓存、接口响应等通用能力，客户专属的流程、权限细节、数据结构和集成方式仍独立实现。
能否用于已有系统的升级或重构？
可以先评估现有语言、数据库、接口和部署环境。结构适配时可分模块接入；差异较大时，更适合作为新服务或分阶段重构的底座。
是否支持私有化部署？
支持按项目部署到客户指定的服务器、云环境或内部网络。具体依赖、网络访问、备份和运维责任需要在交付前确认。