explaingit

hs-web/hsweb-framework

8,400JavaAudience · developerComplexity · 4/5LicenseSetup · hard

TLDR

A Java backend framework built on Spring Boot for enterprise management systems, with fully reactive non-blocking database access, role-based permission control, and modular Maven dependencies.

Mindmap

mindmap
  root((hsweb))
    What it does
      Java backend framework
      Reactive management system
      Enterprise admin backbone
    Tech Stack
      Spring Boot 2.x
      Spring WebFlux
      r2dbc reactive DB
      Maven modules
    Features
      RBAC permissions
      Non-blocking DB access
      SQL injection protection
      User management
    Use Cases
      Admin dashboard backend
      Multi-user access control
      Reactive REST APIs
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Build an enterprise admin backend with user management and role-based access control that handles many concurrent requests without blocking.

USE CASE 2

Add permission-controlled REST API endpoints to a Spring Boot application using annotations from the hsweb-authorization module.

USE CASE 3

Integrate the hsweb permission and user-management modules into an existing Spring WebFlux project via Maven dependencies.

Tech stack

JavaSpring BootSpring WebFluxr2dbcMavenMySQLPostgreSQL

Getting it running

Difficulty · hard Time to first run · 1day+

Requires working knowledge of Project Reactor and Spring Boot, documentation and community resources are primarily in Chinese.

Use freely for any purpose including commercial products, as long as you keep the copyright notice, Apache 2.0.

In plain English

hsweb is a Java-based backend management framework built on Spring Boot 2.x. It is described as one of the first enterprise backend management systems to use fully reactive programming throughout, meaning the server handles many requests at once without blocking threads while waiting for databases or other services to respond. The README and documentation are primarily in Chinese. The framework is built on Spring WebFlux and a reactive database access library called r2dbc. This combination allows the application to work with databases like MySQL, PostgreSQL, SQL Server, and H2 in a non-blocking way. It also includes a custom ORM layer called hsweb-easy-orm, which provides a query-builder style API for reading and writing data, with built-in protection against SQL injection. The permission system is a significant part of the framework. It supports role-based access control (RBAC), data-level permission control (restricting what rows or fields a user can see), and multi-dimensional permission management. Permissions can be applied to API endpoints using annotations on controller methods. The project is divided into several modules: a core module, authorization, commons, concurrency and caching helpers, a datasource module, logging, and a system module containing common built-in features like user management and data dictionaries. Developers are expected to add individual modules as Maven dependencies rather than cloning and modifying the whole project. The recommended way to start using hsweb is to look at the example project linked in the README and add only the modules you need. A working knowledge of Project Reactor and Spring Boot is expected before getting started. The project is licensed under Apache 2.0.

Copy-paste prompts

Prompt 1
I'm using hsweb-framework with Spring WebFlux and r2dbc. Write a reactive controller with a permission annotation that restricts a DELETE endpoint to admin roles only.
Prompt 2
Help me add the hsweb-authorization Maven dependency to my Spring Boot project and configure the permission system to protect a set of REST endpoints.
Prompt 3
Write a hsweb easy-orm query builder example that fetches paginated records from a PostgreSQL table filtered by a dynamic condition using reactive streams.
Prompt 4
I'm starting a new project with hsweb-framework. Write a pom.xml snippet that includes the core, authorization, and datasource modules as dependencies.
Open on GitHub → Explain another repo

← hs-web on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.