FTEG Platform Architecture

Prompt 2c done Canonical model: fteg-store + fteg-erp + sme-erp (Business OS). Yuzu Marketing = client on Business OS; 9981 Yuzu = product. Source: /srv/www/hubs/GROUP-ARCHITECTURE.md § restudy

3Architecture layers

12Implementation prompts

100Client target (Business OS)

RM300kYearly revenue goal

Team rule: After each implementation prompt, update data/ecosystem.json and refresh this page so progress stays visible on platform-38792281.fteg.dev.

1. Three layers

┌─────────────────────────────────────────────────────────────┐
│  fteg-store (platform)                                       │
│  catalog · billing · client portal · provision               │
│  NOT parked under any ERP                                    │
└───────────────────────────┬─────────────────────────────────┘
                            │
      ┌─────────────────────┼─────────────────────┐
      ▼                     ▼                     ▼
 fteg-erp                                    sme-erp (Business OS)
 (FTEG 法人)                                 (Yuzu Marketing + other SMEs)
                                                     └─ 9981 Yuzu = product
      │                     │                     │
      └─────────────────────┴─────────────────────┘
                            │
              product tenants: CMS, Reservation, Commerce, …

Today: store logic still inside hubs/fteg-erp. Target: standalone hubs/fteg-store — DESIGN.md (Prompt 2a).

2. fteg-store (commercial platform)

Design: /srv/www/hubs/fteg-store/DESIGN.md · Setup: SETUP.md · Package: pkg-fteg-store v0.2

Store buyers (Prompt 2c live)

code	buyer_type	pricing_tier	ERP hub	CRM in fteg-erp?
`fteg`	internal	`internal_rm0`	`fteg-erp`	No
`ymsb`	Yuzu Marketing	`inter_co`	`sme-erp` (Business OS)	Yes — FTEG client
`external`	SME	`standard`	`sme-erp` if Business OS	Yes

Staff subscribe + RM0 invoices: StaffSubscribeService in pkg-fteg-store. Seeder: StoreBuyerSeeder.

Owns	Does not own
Global catalog & plans (FTEG admin only) Store buyers & subscriptions Invoices / Fiuu (`package-billing`) Client portal (external SMEs) Product instance registry + provision	Company HR / full CRM for group entities CMS content editing (that's CMS BO) fung-erp executive rollup

3. entity-erp (company OS)

Instance	Legal entity	Sold on store?
`fteg-erp`	FTEG Technology	No — platform operator
`sme-erp`	Client companies (SMEs)	Yes — Business OS SKU
`ymsb-erp`	Yuzu Marketing (transitional shell)	Prefer Business OS on `sme-erp`

Example — Yuzu Marketing Sdn Bhd
FTEG client → buys Business OS (sme-erp) → company hub.
9981 Yuzu = their custom ecommerce product instance (launcher from Business OS / portal), not a second ERP.

Portal vs ERP hub
• Products only → client portal opens each product BO
• + Business OS → ERP hub lists integrated products (launcher, not CMS editor)

4. CMS — 1 site = 1 purchase

Scenario	Subscriptions	CMS BOs
FTEG official + investor	2 × `cms-web` (RM0)	2 separate tenants
Client needs 5 websites	5 × `cms-web`	5 BOs; portal/ERP lists all 5
FTEG 官网 (Corporate Web)	Optional: no store	`fteg-officialweb` deploy

ERP and portal show many instances; each CMS BO edits one site.

5. Yuzu Marketing (YMSB) — Business OS client

Yuzu Marketing Sdn Bhd = FTEG CRM + store buyer ymsb → purchases Business OS → erp_hub=sme-erp.
9981 Yuzu = custom ecommerce under that company (product instance / legacy commerce BO).
Same pattern as any SME: portal + Business OS launcher lists 9981, CMS, etc.
ymsb-erp brand-registry shell is transitional — target is the sme-erp workspace for Yuzu Marketing.

6. Store buyers

Buyer	Pricing	entity-erp	fteg-erp CRM client?
External SME	Standard	sme-erp (if Business OS)	Yes
Yuzu Marketing (ymsb)	Inter-co OK	sme-erp (Business OS)	Yes — FTEG client
FTEG	Internal RM0	fteg-erp	No (not client of self)

7. Business OS pricing & quotas (mission)

Tier	Price	Seats	Storage	CPU units / mo	Product instances	CRM records
Starter	RM300/mo · RM3,000/yr	3	2 GB	1,000	10	500
Pro	RM1,000/mo · RM8,000/yr	15	20 GB	10,000	50	5,000

Soft alerts at 80% / 100%. Starter over-quota → upgrade to business-os-pro-yearly (RM8k/yr).
VPS cost floor ~RM350–650/mo shared host; target ≥3× margin — not 100 VPS clones.
See Business OS plan · METERING.md · CAPACITY.md.

8. Shared packages

Package	Role
`pkg-crm`	Clients & leads (per entity-erp)
`package-billing`	Invoices & payments
`pkg-cloudflare`	DNS / hostnames BO
`myinvois`	e-Invoice / LHDN
`package-cms` + SEO	Web CMS product tenant

8b. Maintainability restudy

Verdict: prefer this structure. Two live company-OS shapes (fteg-erp + multi-tenant sme-erp) beat a permanent third peer (ymsb-erp). Yuzu Marketing onboards like any SME; 9981 is a product instance.
Full comparison table: GROUP-ARCHITECTURE.md § Structure restudy.

8c. Group / buyer metrics API (fung)

FTEG: GET /api/group/metrics on fteg-erp.
Yuzu Marketing: GET /api/buyers/ymsb/metrics on fteg-store (YMSB_METRICS_SOURCE=store). Transitional ymsb-erp group API = fallback only.

9. Implementation progress

Prompt	Topic	Status
0	Architecture doc + this page	Done
1a	pkg-crm v0.4.2 in fteg-erp	Done
1b	fteg-erp tests green (146 pass)	Done
2a	fteg-store DESIGN.md	Done
2b	fteg-store app + pkg-fteg-store	Done
2c	Store buyers FTEG + YMSB (RM0)	Done
3a–b	CMS 1-site policy · Business OS SKU	Done
4a–b	ymsb-erp shell · brand registry + store link	Done
5a	Multi-product portal / ERP console	Done
5b	Group metrics API (fung prep)	Done
A	fung-erp G0 shell	Done
B	sme-erp multi-tenant + 100-client capacity	Done
C	Business OS Pro metering + VPS cost model	Done
G1	fung-erp cached metrics + group totals	Done
G2	fung-erp headcount + 9981 operator widgets	Done
G3	Board pack PDF export	Done
S2	FTEG can invoice clients	Done
S3	YMSB feeds fung finance	Done
S4	Boss compare dashboard	Done

Full copy-paste prompts: /srv/www/hubs/IMPLEMENTATION-PROMPTS.md

10. Related links

Updated 2026-07-21 · ecosystem.json v0.5.18 · Yuzu metrics via fteg-store buyer API