Zheng: A Comprehensive J2EE Enterprise Development Framework and Architecture Guide

Project Overview Zheng is a J2EE enterprise‑level development solution that combines a front‑end template, core framework, distributed architecture, CI/CD, automated deployment, system monitoring, and seamless upgrades to provide a complete development platform.

Architecture The system follows a modular design with components such as zheng-common, zheng-admin, zheng-ui, zheng-upms, zheng-cms, zheng-pay, zheng-ucenter, zheng-oss, zheng-api, zheng-message, and others, each responsible for specific business domains. The repository structure is illustrated in the following tree:

zheng
├── zheng-common   -- SSM framework common module
├── zheng-admin    -- Backend management template
├── zheng-ui       -- Front‑end Thymeleaf templates (port:1000)
├── zheng-config   -- Configuration center (port:1001)
├── zheng-upms     -- User permission management system
│   ├── zheng-upms-common
│   ├── zheng-upms-dao
│   ├── zheng-upms-client
│   ├── zheng-upms-rpc-api
│   ├── zheng-upms-rpc-service
│   └── zheng-upms-server (SSO, port:1111)
├── zheng-cms      -- Content management system
│   ├── zheng-cms-common
│   ├── zheng-cms-dao
│   ├── zheng-cms-rpc-api
│   ├── zheng-cms-rpc-service
│   ├── zheng-cms-search (port:2221)
│   ├── zheng-cms-admin (port:2222)
│   ├── zheng-cms-job (port:2223)
│   └── zheng-cms-web (port:2224)
├── zheng-pay      -- Payment platform
│   ├── zheng-pay-common
│   ├── zheng-pay-dao
│   ├── zheng-pay-rpc-api
│   ├── zheng-pay-rpc-service
│   ├── zheng-pay-sdk
│   ├── zheng-pay-admin (port:3331)
│   └── zheng-pay-web (port:3332)
├── zheng-ucenter   -- User system (including third‑party login)
│   ├── zheng-ucenter-common
│   ├── zheng-ucenter-dao
│   ├── zheng-ucenter-rpc-api
│   ├── zheng-ucenter-rpc-service
│   └── zheng-ucenter-web (port:4441)
├── zheng-wechat   -- WeChat management system
│   ├── zheng-wechat-mp
│   │   ├── zheng-wechat-mp-dao
│   │   ├── zheng-wechat-mp-service
│   │   └── zheng-wechat-mp-admin (port:5551)
│   └── zheng-wechat-app
├── zheng-api      -- API gateway (port:6666)
├── zheng-oss      -- Object storage (ports:7771,7772)
├── zheng-message  -- Real‑time notification system (ports:8881,8882)
├── zheng-shop     -- E‑commerce system
└── zheng-demo     -- Demo modules and examples

Technology Stack The backend stack includes Spring Framework, Spring MVC, Apache Shiro, Spring Session, MyBatis, Dubbo, ZooKeeper, Redis, ActiveMQ, Quartz, Elasticsearch, FastDFS, Log4j, Swagger2, Jenkins, Maven, Netty‑socketio, and more. The front‑end stack features jQuery, Bootstrap, Bootstrap‑table, Font‑awesome, Waves, zTree, Select2, React, and several custom plugins.

Environment Setup Required tools: JDK 7+, MySQL 5.5+, Redis, Zookeeper, ActiveMQ, Nginx, Varnish, IntelliJ IDEA, PowerDesigner, Navicat. Services such as Zookeeper, Redis, ActiveMQ, and Nginx must be started first, followed by the various RPC services and web applications in the prescribed order.

Deployment War packages can be deployed on Tomcat; RPC services are packaged as JARs with assembly scripts for graceful shutdown. The guide also covers host file configuration, Maven compilation, and using ngrok for OSS development.

Framework Conventions Naming conventions enforce packages like service (ending with Service), controller (ending with Controller), task (ending with Task), and mapper (XML files ending with Mapper.xml). Model classes follow camel‑case conversion from table names, and configuration files follow the applicationContext-*.xml pattern. Detailed coding standards are aligned with the Alibaba Java Development Manual.

Resources The project source is hosted at https://gitee.com/shuzheng/zheng/ , with demo sites, architecture diagrams, and additional documentation available via the provided links.