Skip to content
Projects

madong-code/madong-admin-saas

View on GitHub

madong-code/madong-admin-saas has 1,054 GitHub stars and 144 forks. GitHot measured -45 stars in 24 hours, +2 in 7 days, and +35 in 15 days. Last checked 2026-11-21 13:42 UTC. Last push 2026-11-18.

How these counts are measured

Measured star growth

in 24h
-45
in 7 days
+2
in 15 days
+35
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Standard multi-tenant SaaS admin backend library based on PHP Webman, built-in tenant isolation, RBAC permission, CRUD generator and workflow engine, paired with Vue3 Vben frontend.

Web & Apps

README.en.md

Original

Need the standard version [single-user standalone version]? Visit the backend repository: madong-code/madong-admin

Madong Logo

Madong-Saas Multitenant SaaS Backend

The multitenant SaaS backend built on the Webman resident-memory framework

PHP Webman MySQL Redis License

Docs Download Center

中文 | English

Introduction

Madong-Saas is a multitenant SaaS backend built on the PHP Webman resident-memory framework, providing stable and efficient API services for frontend applications.

  • The backend adopts a clear business layering architecture (DAO / Service / Controller) and a plugin system;
  • Multitenancy (SaaS) is supported natively, with tenant isolation and per-tenant resource configuration;
  • The frontend is based on the mono monorepo (big-repo) edition; the standard-version frontend can be reused, but some service interfaces differ and require targeted adjustments.

Frontend and backend are deployed separately; the frontend directory must be downloaded or created on its own.

Repository Addresses

This project is the backend service (core). The companion frontend, container, and tooling repositories are listed below (pulled from GitHub by default; use the Gitee / GitCode mirrors when network access is limited):

Module GitHub Gitee Mirror GitCode Mirror
Backend service https://github.com/madong-code/madong-admin-saas https://gitee.com/motion-code/madong-admin-saas https://gitcode.com/motion-code/madong-admin-saas
Mono [Platform / Tenant / Install] https://github.com/madong-code/madong-mono https://gitee.com/motion-code/madong-mono https://gitcode.com/motion-code/madong-mono
Web https://github.com/madong-code/web-nuxt https://gitee.com/motion-code/web-nuxt https://gitcode.com/motion-code/web-nuxt
Skills https://github.com/madong-code/madong-admin-saas-skills https://gitee.com/motion-code/madong-admin-saas-skills https://gitcode.com/motion-code/madong-admin-saas-skills
Container https://github.com/madong-code/docker-webman https://gitee.com/motion-code/docker-webman https://gitcode.com/motion-code/docker-webman

Component libraries: madong/query (data query), madong/helper (general helpers), and madong/swagger (API docs) are included as Composer dependencies.

Runtime Environment

  • PHP 8.2–8.4 (extensions required: pdo, redis, gd, zip; event recommended)
  • Composer >= 2.x
  • MySQL 5.7+ / 8.0
  • Redis 5.0+
  • Nginx / Apache (optional for production)

Quick Start

Following the standard directory layout, clone this repository into madong/backend and the frontend into the sibling directory madong/template.

# 1. Clone the backend service
git clone https://github.com/madong-code/madong-admin-saas.git madong/backend
cd madong/backend

# 2. Install dependencies
composer install

# 3. Start the service (MySQL and Redis must be prepared in advance)
# Windows
php windows.php
# Linux / macOS
php start.php start -d

# 4. Visual installation
# Open http://127.0.0.1:8500 in your browser to launch the install wizard,
# fill in the database / Redis connection info and admin account as prompted,
# and the system will auto-generate .env and initialize the data tables

Clone the frontend (admin) into madong/template; for deployment refer to the madong-mono repository. For containerized deployment refer to docker-webman.

Directory Structure

madong/                       # project root
├── backend/                  # backend service (this repo)
└── template/                 # frontend templates (admin / portal)

Versions

Version Description
5.x Current version; backend split into its own library (this repo) with a multitenant SaaS architecture
4.x and earlier Full-stack monorepo version; see the v4.x-final tag

How to Contribute

Contributions are very welcome! Open an Issue or submit a Pull Request.

  1. Fork the repository
  2. Create a branch: git checkout -b feature/xxxx
  3. Commit: git commit -am 'feat(function): add xxxxx'
  4. Push: git push origin feature/xxxx
  5. Submit a Pull Request

Git Commit Convention

Reference Conventional Commits: feat / fix / style / perf / refactor / revert / test / docs / chore / ci / types / wip.

License

Apache-2.0