How zccbbg/wms-ruoyi works
Project type and purpose
• This is a full-stack warehouse management system (WMS) backend, built on the RuoYi framework.
• The repo is a multimodule Maven project:
• ruoyi-admin-wms – the Spring Boot WMS service
• ruoyi-common – shared starter libraries (core, web, security, redis, encrypt, excel, mail, etc.)
• ruoyi-modules – domain modules (system management, code generator, demo)
• script – DB scripts and helper shell/batch scripts
• The frontend (Vue 3 + Element UI) lives in a separate repo, communicating with this backend over REST.
File structure
• At the top level you see pom.xml orchestrating modules.
• ruoyi-admin-wms follows a classic layered MVC:
• controller (REST endpoints)
• service (business logic)
• mapper (MyBatis XML + interfaces)
• domain: entity ↔ BO ↔ VO
• ruoyi-common modules inject cross-cutting concerns via Spring Boot auto-configuration.
• ruoyi-modules add system management and code-generation capabilities.
• script/sql/wms.sql defines the MySQL schema.
• Configs: application.yml, Redis, JWT, MyBatis, thread pools, i18n, logging (logback-plus.xml).
README for additional insights
• Auth: JWT + Spring Security + ruoyi-common-satoken
• Cache/session: Redis + ruoyi-common-redis
• ORM: MyBatis-Plus (ruoyi-common-mybatis)
• External integrations: email (ruoyi-common-mail), SMS (ruoyi-common-sms), OSS, ip2region
• Print: LODOP/web printing
• Code generator: one-click front/backend scaffolding (ruoyi-modules/ruoyi-generator)
Details
• I18n resource bundles feeding the web layer
• Config files (application.yml, banner.txt) as part of initialization
• JWT filter chain and dynamic permission loader