跳到主要内容
SPARROW ZOO · 一体化开发生态

一个生态,
从脚手架到智能体平台

以统一工程规范为起点,连接认证、文件、权限与实时通讯。沉淀可复用的通用能力,让每一次业务开发都有基础可循。

Java / Spring Boot · React / Next.js

07 / 生态产品
14 / 开发文档
Spring Boot + React技术底座

PRODUCTS / 产品目录

从工程基础,到业务能力

围绕同一套工程思路,按需接入各项能力。现有服务与建设方向,在这里一目了然。

工程基石

Sparrow Scaffold

项目脚手架

统一工程规范,梳理 Parent 构建基线、BOM 版本组合与 Starter 集成,让组件演进和业务接入有据可循。

JavaSpring BootParent / BOMStarter
阅读工程指南
已完成

Unified Identity

Passport 认证服务

集中提供登录、注册与找回密码入口,支持前后端分离和单体应用的身份认证场景。

登录注册找回密码统一身份
02查看产品介绍
已完成

File Storage

File 文件服务

统一文件上传与存储入口,支持拖拽上传、进度展示和预览,并按业务选择存储路径。

拖拽上传上传进度文件预览
03查看产品介绍
建设中

Access Control

Security 权限系统

围绕角色、权限与资源组织访问控制,为业务服务规划统一的鉴权与授权能力。

RBAC鉴权授权资源隔离
04建设中
已完成

Instant Messaging

IM 即时通讯

面向单聊、群聊与消息推送的实时通讯服务,持续沉淀连接管理与消息处理的工程实践。

单聊群聊消息推送WebSocket
05查看产品介绍
已完成

Code Generator

代码生成器

以实体模型为起点,生成整洁架构后端与 React 前端的 CRUD 代码,减少重复编写。

CRUD整洁架构React
06查看产品介绍
已完成

UI Components

UI 组件库

基于 React 与 Next.js 的组件示例与交互演示,覆盖表单、表格、上传、拖拽等常见场景,可直接复用。

ReactNext.js组件示例
07查看产品介绍

DOCUMENTATION / 开发文档

让实践,成为下一次的起点

从工程架构、接口集成到问题排查,查阅项目中的实现说明与实践记录。

文档正文目前以中文提供。

14 篇文档
Web Storage / RPC

Web Storage 的边界与跨域 SSO:从 Safari 差异到客户端 RPC

区分同源、同站与 Web Storage 分区,说明如何用 Cookie token 或服务端会话解除同站 SSO 对 iframe 存储共享的依赖;比较共享 Domain Cookie 与 API 主机限定的 HttpOnly Cookie,并明确鉴权、凭据请求及跨站限制。

前端开发 / React
Nginx

Nginx 全站 HTTPS 上线

对外域名统一 443 SSL + 80→301 跳转,内部域名保持 80;用 Certbot 只签不改,先签证书再覆盖配置,附域名清单与上线步骤。

后端工程 / Nginx
React

把 React 组件嵌入非 React 页面

用 createRoot 与 useEffect 把客服挂件接进官网、商城等非 React 架构,讲清 HTML 片段的生成与注入。

前端开发 / React
Nginx

Next.js 15 · 四站静态上线

本机打包单个 tar.gz,上传服务器一条命令切换版本,附浏览器验收与踩坑总结。

后端工程 / Nginx
SMTP / IMAP

腾讯企业邮箱完整配置指南

核对管理员与成员两级权限、客户端专用密码,完成邮件客户端与 Java 接入,并排查 535 等认证问题。

后端工程 / Mail
Maven

Sparrow Parent 与 BOM

按生产与交付边界划分构建基线、组件版本和业务接入,附完整 POM 示例。

后端工程 / Java
OpenAPI

springdoc-openapi 集成说明

区分 Servlet MVC 与 WebFlux 技术栈,选择匹配的接口文档依赖。

后端工程 / Java
OpenAPI

OpenAPI 分组策略

处理多 Starter 共存时的配置冲突,为 File 与 Passport 设置独立接口分组。

后端工程 / Java
Maven

Maven 依赖源码与断点调试

理解源码包、字节码行号表与断点错位,梳理发布和联调中的处理方法。

后端工程 / Java
Netty

Netty 入站消息与 OOM

通过消息处理器案例,定位未释放引用造成的内存泄漏与心跳异常。

后端工程 / Java
Netty

Netty 内存共享与释放

梳理引用计数、零拷贝和深拷贝,明确消息转发中的内存释放责任。

后端工程 / Java
Thymeleaf

Thymeleaf 模板路径配置

结合视图名前导斜杠,排查 prefix 拼接双斜杠导致的模板资源错误。

后端工程 / Java
React

useCaptcha 验证码 Hook

拆解会话初始化、图片加载与点击刷新,以及监听清理和重试边界。

前端开发 / React
Next.js

next-intl 国际化指南

串联语言路由、中间件与消息上下文,理解多文件翻译配置和常见问题。

前端开发 / React

WHY SPARROW / 生态能力

通用能力,一起生长

从后端组件到前端公共库,把重复遇到的问题沉淀为可复用的工程基础。

统一身份

围绕 Passport 认证与跨域登录态共享,连接不同应用的身份入口。

工程规范

用 Parent、BOM 与 Starter 的清晰分工,组织构建规范、版本管理与框架集成。

实时连接

围绕 WebSocket 心跳、重连与 Netty 消息处理,积累实时通讯实践。

按需组合

通过公共协议、独立组件与共享前端能力,为不同业务保留组合和扩展空间。

START BUILDING / 开始构建

下一步,从理解工程开始

了解 Sparrow 的构建思路,找到适合当前业务的服务与实践。