# Together-Base **Repository Path**: baymax007/together-base ## Basic Information - **Project Name**: Together-Base - **Description**: Together 项目开发脚手架，万物的起点 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-01-06 - **Last Updated**: 2026-01-06 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

logo

Together-Base

秦风·无衣 岂曰无衣？与子同袍。王于兴师，修我戈矛。与子同仇！ 岂曰无衣？与子同泽。王于兴师，修我矛戟。与子偕作！ 岂曰无衣？与子同裳。王于兴师，修我甲兵。与子偕行！

--- ## 🚀 项目介绍 - 后端基于 **Java 17 + Spring Boot 3 + Spring Cloud & Alibaba + Sa-Token + Dubbo** 构建的微服务系统; - 前端采用 **Vue3 + TypeScript + UniApp** 技术栈，兼具高扩展性、易维护性与模块解耦特性; - 系统创新性支持 **单体与微服务架构** 自由切换，可灵活适配从初创团队到中小型企业的不同业务规模与部署场景; - 不仅适用于企业级生产环境部署，更能满足个人学习研究、毕业设计及二次开发等多样化需求。 --- ## 🏗 项目架构 ## 🧩 系统模块 ``` 📦 together │ ├─ 📦 together-common # 系统公共模块 │ ├─ 📁 together-common-core # 公共核心包 │ ├─ 📁 together-common-datasource # 动态数据源封装 │ ├─ 📁 together-common-dubbo # Dubbo 扩展封装 │ ├─ 📁 together-common-job # XXL-Job 封装 │ ├─ 📁 together-common-log # 日志模块封装 │ ├─ 📁 together-common-mybatis # MyBatis 扩展封装 │ ├─ 📁 together-common-redis # redis缓存工具模块 │ ├─ 📁 together-common-seata # 分布式事务模块 │ ├─ 📁 together-common-security # 安全认证封装（含 Sa-Token） │ ├─ 📁 together-common-sentinel # sentinel扩展封装 │ ├─ 📁 together-common-sms # 短信模块封装 │ ├─ 📁 together-common-storage # 文件存储封装 │ └─ 📁 together-common-swagger # swagger文档模块 │ ├─ 📦 together-api # API 公共模块 │ ├─ 📁 together-api-upms # 用户权限 API 公共模块 │ └─ 📁 together-api-user # 商城用户 API 公共模块 │ ├─ 📦 together-biz │ ├─ 📁 together-biz-upms # 用户权限业务处理模块 │ └─ 📁 together-biz-user # 商城用户业务处理模块 │ ├─ 📦 together-auth # 授权服务 [端口: 5227] │ ├─ 📦 together-boot # 单体启动模块 [端口:9999] │ ├─ 📦 together-gateway # 网关服务 [端口: 9999] │ └─ 📦 together-visual # 系统可视化与运维模块 ├─ 📁 together-codegen # 代码生成器模块 └─ 📁 together-monitor # 监控服务监控 [端口: 7001] ``` ## 🔧 后端技术栈 | 技术组件 | 说明 | |------------------------|--------------------------------------------------------------------------------------------| | **Spring Boot 3** | 现代化 Java 应用开发框架，提供自动配置和快速启动 | | **Apache Dubbo 3** | 高性能 RPC 框架，支持多协议、多注册中心和 Triple 协议，实现服务间高效通信 | | **Spring Cloud Alibaba** | 基于 Spring Cloud 的阿里巴巴微服务组件集合，集成服务注册与发现（Nacos）、配置管理、负载均衡、链路追踪，同时支持 RocketMQ 消息队列、Seata 分布式事务等丰富功能，全面增强微服务生态能力。 | | **Spring Boot Admin** | 应用监控管理平台，提供实时健康检查、日志查看、线程监控等 | | **Sa-Token** | 简洁轻量的权限认证框架，支持单点登录、权限校验、会话管理等 | | **Knife4j** | Swagger UI 增强工具，用于自动生成在线接口文档，支持接口分组和权限注解 | | **Nacos** | 服务注册与配置中心，支持服务发现与动态配置管理，兼容 Dubbo 和 Spring Cloud | | **Druid** | 高性能数据库连接池，支持 SQL 监控、防火墙、慢查询日志等 | | **MyBatis & MyBatis-Plus** | 数据访问层框架，MyBatis 实现 ORM 映射，Plus 提供分页、Lambda 表达式、自动 CRUD 等功能增强 | | **Redis & Redisson** | Redis 用作缓存、分布式锁、限流等，Redisson 提供分布式锁及高级客户端支持 | | **RocketMQ** | 分布式消息中间件，支持高吞吐、低延迟、顺序消息和事务消息等，服务间异步解耦和事件驱动 | | **Seata** | 分布式事务框架，保障多服务、多数据源操作一致性，集成于 Spring Cloud Alibaba | | **Sentinel** | 流量防卫利器，支持服务限流、熔断降级、系统负载保护和动态规则配置 | | **XXL-JOB** | 轻量级分布式任务调度平台，支持定时任务管理和执行 | --- ### 🖥 前端技术栈 | 平台 | 技术栈 | 说明 | |------------|-----------------------------------|--------------------------------| | 管理后台 | Vue3 + Vite + Pinia + TS（vben模板） | 响应式后台管理系统 | | 移动端 | UniApp + Vue3 + Pinia + TS + Wot-Ui | 支持 H5 / 小程序 / App，多端统一开发 | --- ## 📦 项目模块划分 系统按微服务拆分，典型模块包括： | 服务名 | 功能说明 | |------------------|--------------------------------------------| | **网关服务** | 统一入口，路由转发，权限拦截等 | | **认证服务** | 登录、注册、Token 鉴权等 | | **用户服务** | 用户中心、收货地址、账户信息等 | --- # ⚠️ 项目声明 - 📄 关于开源协议 本项目遵循 **[MIT 开源协议](https://gitee.com/jiang4yu/together/blob/master/LICENSE)**，且做出如下承诺： > 作者所在国家没有特殊要求的情况下，协议不变！ > > 第一任作者(发起人)没有死亡的情况下，协议终身不变！ - 📚关于分发与使用 > 您与作者均可以将本项目用于 个人学习、教育培训、商业合作等各类合法场景中，但请保留原始协议声明和版权信息； > > 您与作者均可以自由地使用、修改和分发本项目； > > 您与作者均基于本项目制作衍生作品，无需向作者报备； > > 本项目禁止用于任何违法、侵权或有损他人权益的行为或者活动中； - 👥关于沟通与交流 > 本项目除开发者贡献交流群外，不开设任何交流群、论坛、星球、频道等渠道，如您在使用中遇到问题，欢迎通过 Issues 或 Gitee 提交反馈！ - 💰关于赞助与支持 > 本项目不接受任何形式（贡献和优化代码除外）的赞助，对于您的好意只能表示心领了； > > 虽然作者很穷，但尚能果腹，所以希望您将援助之手伸向更需要的人； > > 如您喜欢本项目或者觉得本项目不错，欢迎关注它，或者给他一颗⭐Star； - ⚠️关于责任与损失 > 本项目为开源项目，在力求功能完整与稳定的前提下，不对其适用于任何特定场景或用途提供任何形式的保证。 > > 项目中所涉及的代码、文档等资料，推荐作为学习参考使用，商用请根据实际情况谨慎评估和测试，并遵守相关法律法规； > > 对于使用本项目造成的任何直接或间接的任何形式的损失，作者概不负责，也负不了责； - 🤝关于社区开源活动 > 因关注到开源社区有各类推广活动或宣传活动中，需要冲击排行榜，需要投票等行为，本项目做出如下承诺： > > 本项目绝不主动进行任何形式的拉票、冲榜宣传行为 > 使用本项目即表示您已知悉并同意以上声明；感谢每一位使用和支持的朋友，我们将不断优化和迭代，为开源助力 💪 --- ## 📄 关于MIT协议解析与商用指南 MIT协议是一种简洁且灵活的开源许可证，广泛应用于开源社区和商业项目中。以下是MIT协议的主要要求和注意事项： **基本要求** MIT协议要求保留原作者的版权声明和许可声明。这些声明通常需要放置在源代码文件的头部或项目根目录下的LICENSE文件中。 **主要特性** MIT协议允许用户自由使用、复制、修改、合并、发布、分发、转授权以及销售软件副本。协议中明确规定软件是“按现状”提供的，不提供任何形式的保证，同时限制了提供者的责任。 **商用要求** 在商业环境中使用MIT协议授权的软件时，需要确保保留版权声明，并在产品文档中列出所使用的开源软件及其许可证信息。此外，还需尊重其他知识产权（如商标和专利），并在复杂场景下咨询法律顾问。 **分发注意事项** 分发基于MIT协议的软件时，需保留原作者的版权声明，提供完整的许可文档，并标明修改记录。如果软件依赖其他开源组件，需确保这些组件的许可证兼容。此外，虽然MIT协议不强制要求提供源代码，但在有人请求时应能够提供。 **潜在纠纷** 尽管MIT协议灵活，但可能会遇到版权归属争议、专利侵权风险或商标滥用等问题。企业需确保内部政策与开源许可证条款一致，以避免合同冲突。 **总结** MIT协议因其简洁性和灵活性而备受欢迎，但在商业应用中需谨慎遵守其规定。通过保持透明度、尊重知识产权，并在必要时寻求法律意见，可以更好地利用开源资源推动技术发展。