Tagtag StarterTagtag Starter
Getting Started

项目介绍

Tagtag Starter 后台管理框架的详细介绍。

Tagtag Starter 是一个基于 Java 和 Spring Boot 3 构建的通用、模块化后台管理框架。它旨在为构建商业应用提供一个轻量、坚实的基础，帮助开发者快速搭建高质量的后台管理系统。

Tagtag Starter 的定位非常明确：做最适合新项目的起步脚手架。我们不追求大而全的复杂功能，而是专注于提供一个功能简洁、上手简单的开发底座，让开发者能够专注于业务逻辑的实现，而不是和配置文件斗智斗勇。

核心特性

  • 模块化架构：系统被拆分为多个功能明确的模块（common、framework、kernel、contract、module 等），结构清晰，易于维护和扩展。就像乐高积木一样，想怎么搭就怎么搭。
  • 契约优先设计：使用 contract 模块将 API 定义与实现分离，代码结构更规范，便于前后端协作和接口管理。前后端再也不用因为接口定义吵架了。
  • 完备的权限体系：内置基于 RBAC（基于角色的访问控制）的权限管理系统，支持菜单权限、按钮权限和数据权限。谁该看什么、能做什么，一清二楚。
  • 丰富的核心功能：内置操作日志、接口限流、字典管理、文件存储等核心功能，满足大多数后台系统的需求。开箱即用，不用自己造轮子。
  • 现代技术栈：后端基于 Spring Boot 3、MyBatis Plus 和 Redis 构建，前端基于 Vue 3 + TypeScript + Vite 构建，采用 Vben Admin 5 框架。用最新的技术，写最优雅的代码。
  • 灵活的扩展机制：模块化设计使得新增业务功能只需创建一个新的 Maven 模块，不会污染现有核心代码。想加什么功能就加什么，不用担心把核心搞坏了。

为什么选择 Tagtag Starter？

在众多的后台管理框架中，Tagtag 具有以下独特优势：

1. 极致简洁，快速上手

  • 拒绝过度设计：没有复杂的微服务架构负担，没有难以理解的抽象层。Tagtag 保持了代码的纯净与直观，您可以在几分钟内跑通项目，而不是花几天时间研究配置。毕竟，我们的目标是写业务代码，不是研究框架源码。
  • 新项目的最佳选择：当您需要开启一个新的后台项目时，Tagtag 提供了最纯粹的起点。它没有预装成吨的冗余代码，让您能够轻装上阵，专注于业务逻辑的实现。就像买新车一样，不需要先拆掉一堆用不上的配件。
  • 清晰的文档：提供完整、清晰的文档，帮助开发者快速上手和深入理解框架。我们相信，好的文档比好的代码更重要（当然，我们的代码也不错）。

2. 恰到好处的功能集

  • 只给您最需要的：我们仅内置了几乎所有后台系统都必须的基础功能——用户管理、角色权限、菜单配置、操作日志、接口限流、字典管理和文件存储。不多不少，刚刚好。
  • 无复杂集成：没有预装一大堆可能永远用不上的中间件和第三方库。保持代码库的轻盈，意味着更少的维护成本和更低的各种依赖冲突风险。毕竟，谁也不想因为一个不常用的依赖把整个项目搞崩。
  • 可按需扩展：您可以根据项目需求，轻松扩展新的功能模块。就像点外卖一样，想吃啥就加啥，不用强制消费。

3. 清晰的代码结构

  • 易于理解与扩展：基于标准的 Spring Boot 结构，结合模块化设计，使得代码逻辑一目了然。即使是新手开发者也能快速看懂并上手开发，方便团队在此基础上进行二次定制。不用像读天书一样研究代码。
  • 规范的开发模式：内置了统一的响应封装、异常处理和日志规范，为团队协作建立了一套标准化的开发模版。团队成员再也不用因为代码风格问题争论不休了。
  • 优秀的代码质量：遵循严格的代码规范，代码结构清晰，注释完善，便于维护和扩展。我们相信，好的代码是会说话的。

4. 拥抱现代技术栈

  • 后端技术栈：基于 Spring Boot 3 + JDK 17 构建，集成 MyBatis Plus、Redis、Spring Security、JWT 等主流技术。用最新的技术，写最稳的代码。
  • 前端技术栈：基于 Vue 3 + TypeScript + Vite 构建，采用 Vben Admin 5 框架，使用 Tailwind CSS 和 Shadcn UI 进行界面开发。界面美观，交互流畅，用户体验一级棒。
  • 持续更新：我们会持续关注和采用最新的技术栈，确保框架始终保持现代化。毕竟，技术发展这么快，我们可不能掉队。

5. 灵活的模块化扩展

  • 按需扩展：得益于清晰的模块划分，新增业务功能只需创建一个新的 Maven 模块，不会污染现有核心代码。就像搭积木一样，想加什么功能就加什么。
  • 即插即用：各模块职责分明，耦合度低。无论是集成新的第三方服务，还是拆分现有业务逻辑，模块化的设计都能让扩展变得轻松自如。不用牵一发而动全身。
  • 松耦合设计：模块之间通过契约层进行通信，降低了模块间的依赖关系，提高了系统的灵活性和可维护性。改一个模块，不用担心把其他模块搞坏。

使用场景

Tagtag 适合以下类型的项目：

  • 企业内部管理系统：如 CRM、ERP、OA 等企业内部管理系统。让企业运营更高效，让员工工作更轻松。
  • SaaS 平台：适合构建多租户 SaaS 平台的后台管理系统。一套系统，服务多个客户，省钱又省心。
  • 电商后台：适合构建电商平台的后台管理系统。商品管理、订单处理、数据分析，一应俱全。
  • 内容管理系统：适合构建各种内容管理系统。文章、图片、视频，想管理什么就管理什么。
  • API 管理平台：适合构建 API 管理和监控平台。接口文档、接口测试、接口监控，一站式搞定。
  • 其他后台管理系统：适合构建各种类型的后台管理系统。只要是后台管理系统，Tagtag 都能胜任。

Tagtag 不适合以下类型的项目：

  • 高并发、高流量的互联网应用：如社交网络、直播平台等。这种级别的项目，还是用专业的分布式架构吧。
  • 复杂的微服务架构项目：如果您的项目需要复杂的微服务架构，Tagtag 可能不是最佳选择。我们专注于单体应用，简单才是美。
  • 需要大量定制化 UI 的项目：如果您需要高度定制化的 UI 设计，可能需要对前端代码进行大量修改。不过，我们的 UI 已经很漂亮了，您可能根本不需要定制。

快速开始

想要快速上手 Tagtag Starter？请查看我们的 快速开始指南，您可以在几分钟内跑通整个项目。相信我，比煮一碗泡面还快。

架构设计

Tagtag 采用前后端分离的架构设计，后端基于 Java 和 Spring Boot 3 构建，前端基于 Vue 3 + TypeScript + Vite 构建。想要了解更多关于 Tagtag 的架构设计，请查看我们的 架构文档。我们的架构设计就像搭积木一样清晰，保证你看完就能懂。

社区与贡献

Tagtag 是一个开源项目，我们欢迎社区的贡献和反馈。如果您有任何问题或建议，欢迎在 GitHub 上提交 Issue 或 Pull Request。我们承诺，每一个 Issue 都会认真对待，每一个 PR 都会仔细 review。

感谢您对 Tagtag Starter 的关注和支持！我们相信，Tagtag Starter 会成为您构建后台管理系统的得力助手。选择 Tagtag Starter，就是选择简单、高效、优雅的开发体验。让我们一起，用最少的代码，实现最大的价值。

快速上手

在几分钟内搭建并运行 Tagtag Starter。