Platform architecture: MokoGitea + MokoSuite+ERP as unified infrastructure #203

New Issue

2026-06-06T17:41:25Z

jmiller commented

2026-06-06 17:41:25 +00:00

Summary

The entire Moko Consulting platform runs on two pillars that together provide a complete business infrastructure:

MokoGitea — Code & DevOps Platform

Git hosting and repository management
CI/CD pipelines (Gitea Actions)
Code project management (Gitea Projects, issues, milestones, kanban)
License management and update server
Organization/team management
Developer collaboration (PRs, code review)

MokoWaaS+ERP — Business & Project Management Platform

CMS (content management, articles, media)
Business project management (client projects, tasks, time tracking, deliverables)
ERP (contacts, deals pipeline, invoicing, inventory)
Customer portal (self-service, tickets, orders, invoices, e-signatures)
Helpdesk / ticketing
POS and MRP (licensed add-ons)
Email integration (IMAP, Google OAuth)
Marketing (Mailchimp, bulk notifications)

Division of Responsibility

Function	Platform	Notes
Code projects	MokoGitea Projects	Issues, sprints, dev kanban, code-level tracking
Client/business projects	MokoWaaS+ERP	Deliverables, milestones, time tracking, client-facing
Git / CI/CD	MokoGitea	Repos, Actions, PRs, releases
CMS / Content	MokoWaaS	Articles, media, frontend site
CRM / ERP	MokoWaaS+ERP	Contacts, deals, invoices, orders
Licensing	MokoGitea → MokoWaaS	Gitea holds license data, WaaS validates via API
Monitoring	Both	MokoWaaS heartbeat → MokoWaaSBase, Grafana
Customer portal	MokoWaaS+ERP	Orders, invoices, tickets, e-sign, license mgmt
Team/org management	MokoGitea	Orgs, teams, permissions
User-facing identity	MokoWaaS	Joomla users, social login, contact roles

Integration Points

MokoGitea                          MokoWaaS+ERP
┌──────────────────┐              ┌──────────────────┐
│ Git repos        │              │ CMS / Articles   │
│ CI/CD Actions    │              │ ERP Engine       │
│ Code Projects    │◄────────────►│ Business Projects│
│ Issues/Milestones│              │ Customer Portal  │
│ License Server   │─────────────►│ License Plugin   │
│ Update Server    │─────────────►│ Extension Updates│
│ Org/Team Mgmt    │              │ Helpdesk         │
│ Releases         │              │ POS / MRP        │
└──────────────────┘              │ E-Signature      │
                                  │ Email / Marketing│
                                  └──────────────────┘
                                          │
                                  ┌───────▼────────┐
                                  │ MokoWaaSBase   │
                                  │ Control Panel  │
                                  │ (Heartbeat Hub)│
                                  └────────────────┘

Goal

No third-party SaaS dependencies for core business operations. Everything between MokoGitea and MokoWaaS+ERP — self-hosted, self-managed, fully owned infrastructure.

Parent issue: #192

## Summary The entire Moko Consulting platform runs on **two pillars** that together provide a complete business infrastructure: ### MokoGitea — Code & DevOps Platform - Git hosting and repository management - CI/CD pipelines (Gitea Actions) - **Code project management** (Gitea Projects, issues, milestones, kanban) - License management and update server - Organization/team management - Developer collaboration (PRs, code review) ### MokoWaaS+ERP — Business & Project Management Platform - CMS (content management, articles, media) - **Business project management** (client projects, tasks, time tracking, deliverables) - ERP (contacts, deals pipeline, invoicing, inventory) - Customer portal (self-service, tickets, orders, invoices, e-signatures) - Helpdesk / ticketing - POS and MRP (licensed add-ons) - Email integration (IMAP, Google OAuth) - Marketing (Mailchimp, bulk notifications) ### Division of Responsibility | Function | Platform | Notes | |----------|----------|-------| | **Code projects** | MokoGitea Projects | Issues, sprints, dev kanban, code-level tracking | | **Client/business projects** | MokoWaaS+ERP | Deliverables, milestones, time tracking, client-facing | | **Git / CI/CD** | MokoGitea | Repos, Actions, PRs, releases | | **CMS / Content** | MokoWaaS | Articles, media, frontend site | | **CRM / ERP** | MokoWaaS+ERP | Contacts, deals, invoices, orders | | **Licensing** | MokoGitea → MokoWaaS | Gitea holds license data, WaaS validates via API | | **Monitoring** | Both | MokoWaaS heartbeat → MokoWaaSBase, Grafana | | **Customer portal** | MokoWaaS+ERP | Orders, invoices, tickets, e-sign, license mgmt | | **Team/org management** | MokoGitea | Orgs, teams, permissions | | **User-facing identity** | MokoWaaS | Joomla users, social login, contact roles | ### Integration Points ``` MokoGitea MokoWaaS+ERP ┌──────────────────┐ ┌──────────────────┐ │ Git repos │ │ CMS / Articles │ │ CI/CD Actions │ │ ERP Engine │ │ Code Projects │◄────────────►│ Business Projects│ │ Issues/Milestones│ │ Customer Portal │ │ License Server │─────────────►│ License Plugin │ │ Update Server │─────────────►│ Extension Updates│ │ Org/Team Mgmt │ │ Helpdesk │ │ Releases │ │ POS / MRP │ └──────────────────┘ │ E-Signature │ │ Email / Marketing│ └──────────────────┘ │ ┌───────▼────────┐ │ MokoWaaSBase │ │ Control Panel │ │ (Heartbeat Hub)│ └────────────────┘ ``` ### Goal No third-party SaaS dependencies for core business operations. Everything between MokoGitea and MokoWaaS+ERP — self-hosted, self-managed, fully owned infrastructure. **Parent issue:** #192

jmiller commented

2026-06-06 17:44:41 +00:00

Correction: MokoGitea is only the licensing backend

MokoGitea's role in the platform is:

Git hosting / CI/CD / code project management (dev tools)
Licensing backend — holds license keys, validates via API for MokoWaaS+ERP

Everything else lives in MokoWaaS+ERP:

CMS, ERP, customer portal, helpdesk, e-signature, POS, MRP, email, marketing, business project management

MokoGitea is NOT the ERP. MokoWaaS+ERP is the complete business platform. MokoGitea just serves license validation requests from it.

## Correction: MokoGitea is only the licensing backend MokoGitea's role in the platform is: 1. Git hosting / CI/CD / code project management (dev tools) 2. **Licensing backend** — holds license keys, validates via API for MokoWaaS+ERP **Everything else** lives in MokoWaaS+ERP: - CMS, ERP, customer portal, helpdesk, e-signature, POS, MRP, email, marketing, business project management MokoGitea is NOT the ERP. MokoWaaS+ERP is the complete business platform. MokoGitea just serves license validation requests from it.

jmiller changed title from ~~Platform architecture: MokoGitea + MokoWaaS+ERP as unified infrastructure~~ to Platform architecture: MokoGitea + MokoSuite+ERP as unified infrastructure

2026-06-07 15:15:17 +00:00

Sign in to join this conversation.

Priority Medium

Type Feature

Status —

Priority —

Type —

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: MokoConsulting/MokoSuite#203