zheng
A Java/Spring starter kit of modular enterprise services: user permissions, CMS, payments, WeChat, storage and
- Stars
- 16.6k
- Forks
- 7.2k
- Licence
- MIT
- Language
- Java
- Last update
- 3.9 years ago
- Type
- Framework
No commits in over a year — check for forks or alternatives before adopting.
What it is
zheng is a collection of Java server-side modules built on Spring, Spring MVC and MyBatis, meant as a starting point for building business web systems. It bundles pieces such as a permissions system with single sign-on, a content management system, a payment center, a user center with third-party login, WeChat integration, file storage, a config center and a notification system. The README says it is aimed at small and medium-sized businesses building enterprise Java applications.
- Set up central login and permission control (RBAC with per-user overrides) shared across several internal apps
- Run a content management site with an admin backend and search service, using the module layout described in the README
- Use the shared admin template (zheng-admin) as a front end for back-office tools
- Build a file storage service that can use cloud providers such as Alibaba OSS, Qiniu or Tencent COS
Great for
- Java teams building internal admin systems who want a pre-made permissions and login layer
- Developers in a Chinese-language ecosystem familiar with SSM and Dubbo
- Teams that want to study how a multi-module Spring microservice layout is organized
- Projects that need WeChat official account or mini-program backends and can reuse the existing modules
Not ideal for
- Beginners with no Java or Spring experience, since the project spans many modules and services with little guidance in the README
- Teams wanting a modern stack: the listed technologies (Dubbo, TBSchedule, ZooKeeper, Thymeleaf, ActiveMQ, FastDFS) are older and the last push was 2022-12-16
- Anyone needing a single small library, because the repository is a large multi-service suite
How to get it
- 1
Clone and build from source
You'll need: Java · Maven
Clone the repository
git clone https://github.com/shuzheng/zheng - 2
Run it
- Clone the repository and open it in a Java IDE or Maven build tool
- Review the module list in the README to choose which services you need
- Configure the database, Redis and ZooKeeper connections for the modules you run (check each module's configuration; the README excerpt does not give exact steps)
- Start the modules you need on their listed ports, such as the SSO server on port 1111
- 3
Get the most out of it
- Use zheng-upms-client to add single sign-on and unified session management to your own apps
- Use zheng-upms-dao and zheng-cms-dao code generation modules to avoid writing data-access code by hand
- Use the zheng-admin template for consistent back-office screens
- Use zheng-pay-sdk or zheng-oss-sdk to call payment and storage services from your own code
Downloads
Strengths
- Covers many common back-office needs (SSO, permissions, CMS, payments, storage) in one codebase
- The permission model is described clearly in the README: role permissions plus user add and subtract rules
- MIT license, so it can be used and modified commercially
Trade-offs
- The README is mostly in Chinese and the installation steps are not shown, so setup takes work
- Relies on many older components and the last recorded push is December 2022, so maintenance status is unclear
- Large scope with many modules and ports makes it hard to adopt only part of it
How it compares
| Project | Stars | Type | Level | Updated | Best for |
|---|---|---|---|---|---|
| zheng (this) | 16.6k | Framework | advanced | 3.9 years ago | Java teams building internal admin systems who want a pre-made permissions and login layer |
| yudao-cloud | 19.7k | App | advanced | 5 days ago | Java teams building internal business or admin systems |
| ruoyi-vue-pro | 40.2k | Framework | advanced | 5 days ago | Java developers building an internal admin or back-office system |
| asynq | 13.8k | Library | intermediate | 18 days ago | Go developers who need background jobs such as sending emails or resizing images |
| awesome-cheatsheets | 46.6k | Learning resource | beginner | 20 days ago | Developers brushing up on a language or tool they use only occasionally |
| AnotherRedisDesktopManager | 34.8k | App | beginner | 3 months ago | Developers who prefer a visual interface over redis-cli for inspecting keys |
Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.