MAAF Logo

Modular Application Architecture Framework

Moduláris Alkalmazás Architektúra

v1.0.0

Mire jó a MAAF?

Webfejlesztés

A MAAF egy moduláris, tiszta és skálázható backend architektúrát ad a webalkalmazásokhoz.

A use case‑orientált megközelítésnek köszönhetően az üzleti logika átlátható, a modulok pedig könnyen újrafelhasználhatók.

Tökéletes választás API‑khoz, admin rendszerekhez, SaaS‑okhoz és bármilyen összetett webes backendhez.

Mit ad?

tiszta domain réteg

moduláris szerkezet

keretrendszerfüggetlen runtime

HTTP kernel + routing

multi‑tenant támogatás

CLI

A MAAF saját CLI‑vel érkezik, amely gyorsítja a fejlesztést és egységesíti a workflow‑t.

A CLI modulokat, use case‑eket, adaptereket és konfigurációkat generál — így a fejlesztő a valódi logikára koncentrálhat.

Mit ad?

make:module

make:usecase

diagnosztikai parancsok

modul metaadat ellenőrzés

fejlesztői tooling

Komponensek

A MAAF Core egy microkernel‑szerű rendszer, amely komponensekből épül fel.

Minden komponens önálló, bővíthető és cserélhető — a modulok pedig ezekre épülnek.

Fő komponensek:

DI Container

Module Loader

EventBus

Config Engine

HTTP Kernel

CLI

A komponensek együtt egy stabil, kiszámítható és jól strukturált alapot adnak bármilyen alkalmazásnak.

API‑k és UX

A MAAF nem csak backend architektúra — egyben fejlesztői élmény platform is. A cél, hogy a fejlesztők gyorsan, tisztán és örömmel építsenek API‑kat és modulokat.

Mit ad?

konzisztens API‑tervezési minták

use case‑alapú endpoint struktúra

adapter‑alapú HTTP réteg

moduláris API dokumentáció

fejlesztőbarát UX a CLI‑ben és a Dashboardban

CLI

A MAAF UX‑e arra épül, hogy a fejlesztő mindig tudja: hol van a logika, miért ott van, és hogyan bővíthető tovább.

Integrációk és Ökoszisztéma

A MAAF úgy lett megtervezve, hogy könnyen illeszkedjen bármilyen meglévő rendszerhez vagy technológiához.

A moduláris felépítés és a port/adapter architektúra lehetővé teszi, hogy a MAAF komponensei rugalmasan kapcsolódjanak külső szolgáltatásokhoz, adatbázisokhoz, queue‑khoz vagy harmadik fél API‑khoz.

Mit ad?

tiszta adapter‑réteg külső rendszerekhez

könnyen cserélhető infrastruktúra (DB, cache, queue)

integrációs minták (event‑driven, async, webhook)

moduláris bővíthetőség

vendor‑lock‑in nélküli architektúra

A MAAF nem zár be egy ökoszisztémába — épp ellenkezőleg: összeköt.

Tesztelhetőség és Minőségbiztosítás

A MAAF egyik legnagyobb előnye, hogy a teljes architektúra a tesztelhetőség köré épül.

A tiszta domain, a use case‑ek és a port/adapter réteg mind azt szolgálják, hogy az üzleti logika könnyen, gyorsan és izoláltan tesztelhető legyen.

Mit ad?

domain‑szintű tiszta unit tesztek

use case tesztelés mockolt portokkal

adapter tesztek (HTTP, repository, event handler)

E2E tesztelési minták

stabil, regressziómentes fejlesztés

A MAAF‑ban a tesztelés nem extra munka — a rendszer természetes része.

A MAAF egy teljes körű PHP framework moduláris architektúrával, amely lehetővé teszi a gyors és rugalmas alkalmazásfejlesztést. Minden komponens önálló package-ként érhető el, így csak azt használhatod, amire szükséged van.



Core & App

maaf/core
A MAAF framework alapvető komponensei: DI Container, HTTP Kernel, Router, EventBus, Config Engine és CLI.
maaf/app
Példa alkalmazás a MAAF framework használatára, amely bemutatja az összes alapvető funkciót.

Csomagok



1. Alap platformcsomagok (core ecosystem)

maaf/auth
Moduláris autentikációs rendszer
  • moduláris auth (session + token + tenant aware)
  • plug in elhető provider logika
  • fejlesztőbarát middleware ek
maaf/tenant
Multi-tenant támogatás
  • tenant aware routing, model resolution, config override
  • multi tenant cache és queue izoláció
  • domain alapú és paraméter alapú tenant felismerés
maaf/module
Modul rendszer
  • modulok regisztrációja, lifecycle hookok
  • modulonkénti route, config, migration, asset kezelés
  • CLI generátorok
maaf/config
Konfiguráció kezelés
  • környezetfüggetlen, rétegezett konfiguráció
  • override olható modulonként
  • auditálható változások


2. Teljesítmény és infrastruktúra

maaf/runtime
Runtime és worker kezelés
  • worker alapú futtatás (Octane szerű, de MAAF filozófiával)
  • cache elt bootstrap
  • modul szintű preload
maaf/queue
Queue rendszer
  • queue driver absztrakció
  • modulonkénti worker konfiguráció
  • dashboard (Horizon szerű)
maaf/monitor
Monitoring és profiling
  • teljesítményprofilozás
  • modulonkénti metrikák
  • valós idejű diagnosztika (Pulse szerű)


3. Adatkezelés és keresés

maaf/search
Search engine integráció
  • moduláris indexelés
  • adapterek: Meilisearch, Elasticsearch, SQL fulltext
  • model független keresési pipeline
maaf/storage
File storage és CDN
  • fájlkezelés, asset pipeline
  • CDN integráció
  • modulonkénti storage namespace


4. Jogosultság, feature flag, workflow

maaf/permissions
Jogosultság kezelés
  • role based + policy based + rule based
  • modulonkénti jogosultságregisztráció
maaf/flags
Feature flags
  • feature flag rendszer (Pennant szerű)
  • rollout stratégiák
  • user szintű és tenant szintű engedélyezés
maaf/workflow
Workflow és state machines
  • állapotgépek
  • tranzakciós workflow k
  • audit log


5. Fizetés és integrációk

maaf/billing
Billing és payment
  • Stripe + PayPal + Barion adapterek
  • előfizetéskezelés
  • számlázási logika modulárisan
maaf/social
Social login
  • OAuth provider modulok
  • social login + social account linking


6. Fejlesztői élmény (DX)

maaf/devtools
DevTools és debugging
  • request inspector (Telescope szerű)
  • modulonkénti lognézet
  • query profiler
maaf/testing
Testing toolkit
  • integrációs teszt helper
  • modul sandbox környezet
  • böngészőteszt wrapper (Dusk szerű)
maaf/style
Code style és generátorok
  • kódstílus + generátorok
  • modul skeleton generálás
  • Pint szerű formatter


Starter kitek

maaf/starter-api
API-first projekt skeleton
  • API first projekt skeleton
  • auth + tenant + modulok előkészítve
maaf/starter-web
React/Vite frontend skeleton
  • React/Vite alapú frontend skeleton
  • moduláris UI komponensek
maaf/starter-admin
Admin panel skeleton
  • admin panel alapok
  • modulonkénti CRUD generátor