# Minerp ODM — Danh sách tính năng

**Minerp ODM** là mô hình dữ liệu & nền tảng nghiệp vụ của minerp — **map từ [ARTS ODM v7.3](https://www.omg.org/retail-depository/arts-odm-73/hmcontent.htm)** (835 entity) sang microservices bounded context, triển khai qua ERP console `minerp.vn/erp` và API `/api/{service}`.

> Cập nhật: 2026-10-05 · Nguồn: [`microservices-blueprint.md`](../../../../docs/blueprint/microservices-blueprint.md) · [`arts-odm-platform-gap-matrix.md`](../../../../docs/blueprint/arts-odm-platform-gap-matrix.md) · [`ownership-matrix.md`](../../../../docs/blueprint/ownership-matrix.md) · [`service-core`](../../../../docs/ba/artifacts/packages/platform/minerp/service-core/00-index.md) · [`service-extension`](../../../../docs/ba/artifacts/packages/platform/minerp/service-extension/00-index.md)

**Copy marketing ERP:** [`marketing/erp/00-index.md`](../../../../marketing/erp/00-index.md) · **Liên quan:** [Minerp Studio features](./minerp-studio-features.md) — extension merchant trên `storefront.vn` (không thuộc ODM core). · **Shop (khách):** [`marketing/shop/00-index.md`](../../../../marketing/shop/00-index.md)

---

## 0. Minerp ODM là gì?

| Khái niệm | Mô tả |
|-----------|--------|
| **ARTS ODM v7.3** | Chuẩn OMG — logical views, entity, quan hệ retail *(SoT gốc)* |
| **Minerp ODM** | Bản map & triển khai nội bộ: entity ARTS → service owner, API, ERP UI; kèm **mở rộng** ngoài ARTS thuần |
| **ARTS BPM** | Lớp process *(retailer vận hành thế nào)* — crosswalk với ODM qua [`Luong_ban_le_arts.md`](../../../../docs/meeting/luong-nghiep-vu-retail/Luong_ban_le_arts.md) |
| **Runtime** | FastAPI services `services/*` + console `www/platform` |

### Ba tầng trong Minerp ODM

```
┌─────────────────────────────────────────────────────────────┐
│  C. Minerp ODM Extensions (service-extension / KhaServices) │
│     Property, BMS, CMMS, marketplace… — Extend/Reuse/Alt ARTS │
├─────────────────────────────────────────────────────────────┤
│  B. Platform Layer (cross-cutting, mở rộng ngoài ARTS core)  │
│     IAM, Minerp Agent, Notification, Settings, Media, Email/Workflow│
├─────────────────────────────────────────────────────────────┤
│  A. Minerp ODM Core (14 ARTS-aligned domain services)        │
│     catalog · inventory · retail · party · finance · …       │
└─────────────────────────────────────────────────────────────┘
         ▲ map từ ARTS ODM v7.3 (835 entities, 15 domain areas)
```

### Quy tắc map entity (thang ưu tiên)

| Quyết định | Khi nào |
|------------|---------|
| **Reuse** | Entity ARTS đã có đúng owner — chỉ API/workflow |
| **Extend** | Cùng bounded context, thiếu cột/association |
| **Replica (CDC)** | Đọc cross-service — read-only |
| **New OLTP / Alt** | Gap ARTS hoặc ngữ cảnh runtime không gắn entity ARTS |

Single writer: mỗi aggregate chỉ một service ghi — xem [`ownership-matrix.md`](../../../../docs/blueprint/ownership-matrix.md).

---

## 1. ARTS Business Area → Minerp ODM map

Bám [ARTS business area content](../../../../docs/blueprint/microservices-blueprint.md) — **domain ownership**, không phải 1 microservice / 1 logical view.

| ARTS business area | Minerp ODM owner | Ghi chú |
|--------------------|------------------|---------|
| Party | `party_customer` + `auth` (credentials) + `settings` (type codes) | Party ≠ login user |
| Customer / Consumer journey | `party_customer` | Registration, segments, household |
| Items and Services Sold | `catalog_item` | Item master, supplier, apparel, recipe |
| Price | `pricing_promo` | Selling prices, markdown |
| Selling Rules | `pricing_promo` | Rules, restrictions |
| Customer Membership & Rewards | `loyalty_rewards` | Programs, earn/burn, vouchers |
| Inventory Planning & Stewardship | `inventory` | Stock ledger, ICD, transfers, receiving |
| Customer Order | `retail_transaction` + `inventory` | Order saga, fulfillment |
| Retail Transactions | `retail_transaction` | POS commit, tax, tender lines |
| Tender Control Transactions | `store_operations` + `payments_tender` | Period, till, safe |
| Stored Value Instruments | `payments_tender` | Stored value, authorization |
| Tax | `retail_transaction` | Tax groups, snapshots on commit |
| Place / Enterprise structures | `enterprise_reference` | BU, site, location, channel |
| Calendar / Currency / Language | `enterprise_reference` | Holidays, FX, i18n ref |
| Worker & HR | `hr_workforce` | Worker, time punch, commission |
| Financial Reporting | `finance_ledger` + `reporting_analytics` | GL + CDC marts |
| Food Service | `food_service` | Tables, kitchen queue |
| Forecourt | `forecourt` | Fuel, tanks, settlement |
| Access Control | `auth` *(hybrid)* + `store_operations` | RBAC scoped; POS access matrix |

---

## 2. Minerp ODM Core — 14 domain services

Initiative: [`service-core`](../../../../docs/ba/artifacts/packages/platform/minerp/service-core/00-index.md) · Luồng retail: [`Luong_ban_le_arts.md`](../../../../docs/meeting/luong-nghiep-vu-retail/Luong_ban_le_arts.md)

- **Copy landing (tổng quan ERP):** [`marketing/erp/erp-overview.md`](../../../../marketing/erp/erp-overview.md)

### 2.1 Enterprise Reference *(ARTS 10100–10400, 06100, 06500, 06400)*

**Service:** `enterprise_reference` · **ERP:** `/erp/services/enterprise_reference`

- **Copy landing (paragraph):** [`marketing/erp/erp-enterprise-reference.md`](../../../../marketing/erp/erp-enterprise-reference.md)

| ARTS / Minerp | Tính năng runtime |
|---------------|-------------------|
| Business Unit / BU Groups | CRUD BU, group-units, merch hierarchy |
| Place / Site / Location | Sites, locations, location hierarchy, selling locations |
| Channels & Touch-points | Channel master (v2 polymorphic) |
| Merchandise / POS Department | Hierarchy tree + edges |
| Calendar / Reporting period | Calendars, holidays (MVP) |
| Currency / Exchange rate | Currencies, exchange rates (MVP) |
| UoM / Measurement | Units, conversions, measurement systems |
| Language | Language catalog (ERP manager) |
| Weather *(extend)* | METAR weather operations |
| Events | Device/scheduled events (partial UI) |
| Equipment *(06400)* | Equipment registry list |
| **Registry ARTS** | Tra cứu 835+ entity theo `type_code` |
| **UI Coverage** | Ma trận logical view in-scope |
| Buildings *(extension tie-in)* | Tòa, tầng, căn CHDV |

### 2.2 Catalog Item *(ARTS 01000–01501, 21000)*

**Service:** `catalog_item` · **ERP:** `/erp/services/catalog_item`

- **Copy landing (paragraph):** [`marketing/erp/erp-catalog-item.md`](../../../../marketing/erp/erp-catalog-item.md)

| Nhóm ARTS | Tính năng |
|-----------|-----------|
| Item macro *(01000)* | Items CRUD, search, polymorphic subtypes |
| Branding *(01004)* | Brands, sub-brands |
| Apparel *(01015)* | Styles, colors, sizes, palettes, conversions |
| Recipe / BOM *(01030)* | Recipes, raw material components |
| Item supplier *(01500)* | Vendors, suppliers, deals, base costs |
| Assortment *(extend)* | Assortment plans |
| Fresh item *(21000)* | Fresh item attributes (slice) |
| Item events | Recall, processing transactions, maintenance events |
| Lookups | Price lines, container types, label content, item date types, related assoc types |

### 2.3 Pricing & Promo *(ARTS 01300, 01100–01120)*

**Service:** `pricing_promo` · **ERP:** `/erp/services/pricing_promo`

- **Copy landing (paragraph):** [`marketing/erp/erp-pricing-promo.md`](../../../../marketing/erp/erp-pricing-promo.md)

| ARTS | Tính năng |
|------|-----------|
| Item price maintenance | Selling prices CRUD, CDC → retail replica |
| Selling rules | Selling rules CRUD |
| Markdown | Temporary Price Change (TPC) |
| Planogram *(extend)* | Planogram zones |

### 2.4 Party & Customer *(ARTS 06310–07200)*

**Service:** `party_customer` · **ERP:** `/erp/services/party_customer`

- **Copy landing (paragraph):** [`marketing/erp/erp-party-customer.md`](../../../../marketing/erp/erp-party-customer.md)

| ARTS logical view | Tính năng |
|-------------------|-----------|
| Party / Person / Org | Parties CRUD, person names, affiliations |
| Address & contact *(06320)* | Contact methods, addresses, identifications |
| Core customer *(07000)* | Customers, lifecycle (suspend/merge/anonymize) |
| Customer accounts | CustomerAccount, special accounts (layaway/installment/registry) |
| Consumer journey *(07015–17)* | Conversion events, consumer registry *(partial)* |
| Household / Anonymous | Household tree, anonymous pool |
| Segments / demographics | Customer segments, wallet *(partial depth)* |
| Care & CRM | Care cases, concern tickets, correspondence |
| Purchase history *(07200)* | Projection từ retail CDC |
| Surveys / social *(extend)* | Customer surveys, social mentions *(partial)* |

### 2.5 Loyalty & Rewards *(ARTS 01400)*

**Service:** `loyalty_rewards` · **ERP:** `/erp/services/loyalty_rewards`

- **Copy landing (paragraph):** [`marketing/erp/erp-loyalty-rewards.md`](../../../../marketing/erp/erp-loyalty-rewards.md)

| ARTS | Tính năng |
|------|-----------|
| Reward derivation | Eligibility rules, evaluate, rebate approve |
| Promotions / campaigns | Campaigns, promotional offers, history |
| Vouchers | `RewardVoucherDocument` — phát hành & redeem |
| Membership | Programs, accounts, tiers *(slice)* |

### 2.6 Inventory *(ARTS 02000–02600, 02100–02130)*

**Service:** `inventory` · **ERP:** `/erp/services/inventory`

- **Copy landing (paragraph):** [`marketing/erp/erp-inventory.md`](../../../../marketing/erp/erp-inventory.md)

| ARTS | Tính năng |
|------|-----------|
| Stock ledger *(02000)* | On-hand, reserve/release |
| Adjustments *(02010)* | Inventory adjustments API |
| ICD / physical count *(02600)* | Inventory control documents CRUD |
| Receiving *(02130)* | Receiving complete |
| Transfers / requisitions | Transfer ship/receive, requisitions |
| Locations | Inventory location master |
| Procurement *(extension W7)* | Requisitions, vendor directory, contracts — Extend ICD/OTB |

### 2.7 Retail Transaction *(ARTS 02200–02395, 05000–05400, 07600)*

**Service:** `retail_transaction` · **ERP:** `/erp/services/retail_transaction`

- **Copy landing (paragraph):** [`marketing/erp/erp-retail-transaction.md`](../../../../marketing/erp/erp-retail-transaction.md)

| ARTS | Tính năng |
|------|-----------|
| Transaction macro | `POST /sales/commit`, line APIs |
| Item sale / voids | Sale lines, void lines, hybrid guard với store-ops |
| Taxation *(02320)* | Tax groups, rates, `TaxSnapshotService` |
| Tender lines *(02330)* | Tender on commit + payments integration |
| Price modifiers | Modifiers on commit |
| Documents *(02302)* | Sale documents |
| Customer order *(07600)* | Order saga, cancel/fulfill/ship |
| Order maintenance *(07610/20)* | Control lines, omni desk |
| Shipping / rental / deposit | Special line types (minimal) |
| Sale / return | Return API |
| **POS desk** | Preview tax & commit |
| **Order progress** *(EA1628)* | Progress timeline API |

### 2.8 Store Operations *(ARTS 02410–02450, 02510–02520, 10120)*

**Service:** `store_operations` · **ERP:** `/erp/services/store_operations`

- **Copy landing (paragraph):** [`marketing/erp/erp-store-operations.md`](../../../../marketing/erp/erp-store-operations.md)

| ARTS | Tính năng |
|------|-----------|
| Sign on/off *(02410)* | POS operator sessions |
| Period open/close *(02430)* | Reporting periods |
| Till movement *(02420)* | Till settlement slice |
| Voids / drawer limit | Void controls, drawer limit overrides |
| Workstation master *(10120)* | Workstations, till binding |
| Tender control | Safes, external depositories, tender control txns |
| Control transactions | Store control transaction registry (v2) |

### 2.9 Payments & Tender *(ARTS 01420, tender integration)*

**Service:** `payments_tender` · **ERP:** `/erp/services/payments_tender`

- **Copy landing (paragraph):** [`marketing/erp/erp-payments-tender.md`](../../../../marketing/erp/erp-payments-tender.md)

| ARTS | Tính năng |
|------|-----------|
| Tender authorization | Authorize, capture, void |
| Stored value *(01420)* | Stored value instruments & control |
| Tender types | Tender master (v2) |
| PSP integration *(extend)* | Webhook audit, Payoo sandbox admin |

### 2.10 Finance Ledger *(ARTS 04000–04300)*

**Service:** `finance_ledger` · **ERP:** `/erp/services/finance_ledger`

- **Copy landing (paragraph):** [`marketing/erp/erp-finance-ledger.md`](../../../../marketing/erp/erp-finance-ledger.md)

| ARTS | Tính năng |
|------|-----------|
| Chart of accounts | Ledger accounts (VAS), COA admin |
| Journal entries | Posting, journal inquiry theo kỳ/BU |
| Trial balance | TB slice |
| Treasury *(extend W11)* | Bank statements, fixed assets, AP invoices |
| Budget vs actual | Budget comparison (BQL/adm) |
| GL hub BQL | CoA VAS, đối soát, HĐĐT (GĐ5) |

### 2.11 Reporting & Analytics *(ARTS 03000–03200, 03100–03160)*

**Service:** `reporting_analytics` · **ERP:** `/erp/services/reporting_analytics`

- **Copy landing (paragraph):** [`marketing/erp/erp-reporting-analytics.md`](../../../../marketing/erp/erp-reporting-analytics.md)

| ARTS | Tính năng |
|------|-----------|
| Sales / ops marts | CDC replica lines, journal replicas |
| Store ops reporting | Till/tender settlement mart |
| Inventory events | Stock activity snapshots |
| **Dashboard BQL** | KPI từ CDC marts |
| Report catalog / builder | Danh mục báo cáo, thiết kế custom |
| Scheduled reports | Lịch gửi tự động |
| Custom dashboard | Widget layout |
| **AI Copilot báo cáo** *(extend)* | LLM trợ lý phân tích |
| Audit log | Nhật ký thao tác platform |

### 2.12 HR Workforce *(ARTS 11100–11160)*

**Service:** `hr_workforce` · **ERP:** `/erp/services/hr_workforce`

- **Copy landing (paragraph):** [`marketing/erp/erp-hr-workforce.md`](../../../../marketing/erp/erp-hr-workforce.md)

| ARTS | Tính năng |
|------|-----------|
| Worker macro *(11100)* | Workers hire/terminate/assign |
| Positions / jobs / tasks | HR master CRUD |
| Time punch *(11150)* | Chấm công, approve |
| Worker access *(11130)* | Workstation access validate |
| Commission *(11140)* | Accrual from sale, commission summary |

### 2.13 Food Service *(ARTS 02360)*

**Service:** `food_service` · **ERP:** `/erp/services/food_service`

- **Copy landing (paragraph):** [`marketing/erp/erp-food-service.md`](../../../../marketing/erp/erp-food-service.md)

- Food desk — tables, orders, kitchen route
- Table turn, kitchen queue
- Transaction replicas (read)

### 2.14 Forecourt *(ARTS 20000–20050)*

**Service:** `forecourt` · **ERP:** `/erp/services/forecourt`

- **Copy landing (paragraph):** [`marketing/erp/erp-forecourt.md`](../../../../marketing/erp/erp-forecourt.md)

- Forecourt desk — fueling txn, settle
- Tanks, fuel price active rule, alarms
- Transaction replicas (read)

---

## 3. Platform Layer — mở rộng ngoài ARTS ODM thuần

Cross-cutting services — không map 1:1 một ARTS macro view, nhưng là **phần của Minerp ODM** khi triển khai sản phẩm.

### 3.1 IAM (`auth`) — *(ARTS 06210/06220 hybrid)*

| Tính năng | Ghi chú |
|-----------|---------|
| JWT, OAuth (Google), refresh sessions | Enterprise IAM |
| Scoped RBAC | Role → Permission; assignment global/tenant/store |
| Tenants & entitlements | Registry tenant, SKU catalog (`shop_ai`, `email_builder`, …) |
| Users & invite | Seat quota, entitled-service roles |
| Outbox + Kafka relay | Transactional events |
| Webhooks | Subscriptions + delivery log |
| **Deferred vs ARTS** | `Group`, `PermissionDelegation`, workstation-level access → simplified |

**ERP:** `/erp/services/auth` — Users, Roles, Permissions, Tenants, Users & Access

- **Copy landing (paragraph):** [`marketing/erp/erp-auth.md`](../../../../marketing/erp/erp-auth.md)

### 3.2 System Settings (`settings`)

| Tính năng | Ghi chú |
|-----------|---------|
| Operational lookups | Contact purpose, social network, fee types, ticket categories, SLA… |
| Tenant overlay | Global catalog + tenant override + resolved merge |
| Runtime parameters | `setting_entry` scoped global/tenant/store |
| **Không own** | ARTS enterprise ref (Site, Currency…) → `enterprise_reference` |

**ERP:** `/erp/services/settings`

- **Copy landing (paragraph):** [`marketing/erp/erp-settings.md`](../../../../marketing/erp/erp-settings.md)

### 3.3 Notification (`notification`)

- Kafka inbound → routing → dispatch (email, in-app, push)
- Inbox, preferences, retry/DLQ, tenant isolation
- Round-robin recipient, rule routing
- ERP in-app / Zalo / push — reuse cho CSKH & property comms

- **Copy landing (paragraph):** [`marketing/erp/erp-notification.md`](../../../../marketing/erp/erp-notification.md)

### 3.4 Media Delivery (`media_delivery`)

- Platform CDN SoR — `MediaObject` registry
- MinIO / S3 + public delivery URL
- Consumers: CMS, auth avatar, agent uploads, ticket attachments

- **Copy landing (paragraph):** [`marketing/erp/erp-media-delivery.md`](../../../../marketing/erp/erp-media-delivery.md)

### 3.5 Email Builder & Workflow Builder *(SKU add-on)*

| SKU | Service | Tính năng |
|-----|---------|-----------|
| `email_builder` | `email_builder` | Mail connections (SMTP/OAuth/SendGrid), templates (Puck→MJML), send, delivery analytics |
| `workflow_builder` | `workflow_builder` | Visual graphs, shop/property triggers, Celery runs, nodes: send email, HTTP, batch, Mailchimp sync, tag customer, `llm_generate` |

Proxy Studio: `storefront.vn` · Platform API: `minerp.vn/api/email-builder`, `/api/workflow-builder`

---

## 4. Minerp Agent — nền tảng AI *(service `multi-agent`)*

**Minerp Agent** là runtime AI của platform: chat nội bộ, knowledge base, orchestration, bot đa kênh. Triển khai tại `services/multi-agent` · API `https://minerp.vn/api/multi-agent`. **Shop AI** (SKU `shop_ai`) là add-on merchant trên Studio, chạy trên cùng runtime.

- **Copy landing (paragraph):** [`marketing/erp/erp-minerp-agent.md`](../../../../marketing/erp/erp-minerp-agent.md)

Product API PydanticAI — **Extend** Minerp ODM, không fork SoR nghiệp vụ.

### 4.1 Platform surface (`www/platform`)

| Route | Tính năng |
|-------|-----------|
| `/chat` | WebSocket chat — model picker, file upload, tool calls, orchestration (Direct / Team / Handoff) |
| `/kb` | Knowledge bases, documents, sync sources/connectors |
| `/admin` | Orgs, users, conversations, ratings, stats, RBAC admin |
| `/admin/mcp` | **MCP Hub** — connections, OAuth, health, usage stats, tool audit |

### 4.2 Backend (`services/multi-agent`)

| Nhóm | Tính năng |
|------|-----------|
| Orchestration | Agent runner (single / multi / handoff), conversation CRUD, message ratings, share |
| RAG | Qdrant prod / Chroma dev, collection `minerp_rag`, ingest PDF/TXT/MD |
| **MCP Hub** | Catalog connectors, CRUD connections, PydanticAI bridge, HTTP hub JSON-RPC, OAuth2 PKCE, health pool, SSRF guard, tool budgets, audit + usage stats, connection templates, multi-account `account_label` |
| Channels | Zalo, Messenger, Telegram, Slack — `ChannelBot` per tenant |
| CSKH marketplace *(Wave 9)* | Tools đọc catalog/orders qua BFF — `bot_kind=platform` |
| Shop AI *(SKU `shop_ai`)* | Widget chat, FAQ, catalog→RAG sync, live agent, quality report, **Studio MCP tools** — `bot_kind=shop_cskh` |
| Internal API | `llm_generate`, `email_generate` cho Workflow Builder |
| Infra | Outbox/Kafka, Celery, hybrid RBAC, rate limit |

> Chi tiết MCP Hub + lộ trình Phase 0–2: [minerp-platform-features.md](./minerp-platform-features.md)  
> Chi tiết UI Shop AI trên Studio: [minerp-studio-features.md §9](./minerp-studio-features.md#9-shop-ai-add-on-sku-shop_ai)

---

## 5. Minerp ODM Extensions — KhaServices / BMS

Initiative [`service-extension`](../../../../docs/ba/artifacts/packages/platform/minerp/service-extension/00-index.md) — **mở rộng** trên nền ODM core theo quyết định D1–D13; validate vertical **CHDV/KhaService**. Pattern: **Reuse** Party/RT/Finance — **Forbidden** fork SoR.

### 5.1 Nhóm nghiệp vụ (I–X)

| Nhóm | Service(s) | Tính năng chính |
|------|------------|-----------------|
| **I. Cư trú & tòa nhà** | `enterprise_reference`, `facility_management` | Buildings, occupancy, residents, import CSV, households |
| **II. Vận hành & an ninh** | `facility_management` | Visitor passes, vehicles, guard shifts + GPS, patrol, cleaning |
| **III. CSKH cư dân** | `service_desk`, `party_customer` | Tickets, SLA, work orders, service catalog |
| **IV. Phí & thu** | `billing`, `payments_tender` | Property invoices, AR aging, refunds, PSP (Payoo) |
| **V. Tài chính BQL** | `finance_ledger` | GL VAS hub, treasury, budget vs actual, HĐĐT |
| **VI. Thủ tục HC** | `forms_workflow` | Chuyển nhà, nhà thầu, approval inbox/history/delegation |
| **VII. Tiện ích & lưu trú** | `facility_booking`, `hospitality_booking` | Amenity booking, lodging reservation |
| **VIII. Cộng đồng** | `community` | Feed, events, moderation, building regulations |
| **IX. IoT & BMS** | `iot_facilities` | PCCC alerts, utility meters, energy/BMS/security dashboards |
| **X. CMMS & tài sản** | `enterprise_assets`, `asset_maintenance`, `service_desk` | Equipment registry, PM schedules, checklist, auto WO, CAPA, material catalog |
| **Marketplace in-building** | `marketplace` | Merchant, listing, place order qua RT |
| **Partner / franchise** | `partner_network` | Franchise agreements, investor ROI dashboard |
| **OTA / channel** | `channel_manager` | OTA stub, listing, import → hospitality |
| **Procurement BQL** | `inventory` *(extend)* | Vendor portal, contracts, renewal alerts |
| **Marketing CRM** | `party_customer` *(extend)* | Campaigns BQL *(wave 11A)* |
| **CSKH omnichannel** | Minerp Agent + ERP | Telegram/Zalo/web embed — `/erp/.../cskh` |
| **Loyalty coin** | `loyalty_rewards` *(extend)* | Coin/reward property *(wave 7)* |

### 5.2 ERP console — Property hub

Tất cả dưới nhóm **Quản lý tòa nhà** trên `www/platform` — permission `BQL_PROPERTY_*`.

| Module ERP | Route pattern |
|------------|---------------|
| Bảng điều hành BQL | `/erp/property/.../dashboard` |
| Cư dân, hộ, liên lạc | residents, households, communication |
| An ninh & vận hành | visitor-passes, vehicles, guard-shifts, patrol, cleaning |
| Ticket & WO | `/erp/service-desk/tickets`, work-orders |
| Phí & hoàn tiền | `/erp/billing/property/invoices` |
| IoT / năng lượng | iot-alerts, utility-meters, dashboards |
| CMMS | pm-schedules, checklist, auto-wo, capa |
| Marketplace / Partner | marketplace console, partner network |

---

## 6. BPM process coverage (retail core)

Minerp ODM core align **ARTS BPM Level 0–3** — 18 flow `F-RET-01…14` + admin coverage COV.

| Phase | BPM focus | Services |
|-------|-----------|----------|
| **P1** | Source, merchandising, enterprise ref, customer | catalog, ER, party, pricing |
| **P2** | Supply chain, channels, sale | inventory, store-ops, retail, payments, loyalty |
| **P3** | Finance, reporting | finance-ledger, reporting-analytics |
| **P4** | Verticals | food-service, forecourt, hr-workforce |
| **COV** | Admin ERP coverage backlog | Extend API + polymorphic registry UI |

Ma trận phủ luồng: [`18-flow-coverage-matrix.md`](../../../../docs/ba/artifacts/packages/platform/minerp/service-core/18-flow-coverage-matrix.md)

---

## 7. Trạng thái map ARTS → runtime

Snapshot từ [`arts-odm-platform-gap-matrix.md`](../../../../docs/blueprint/arts-odm-platform-gap-matrix.md):

| Trạng thái | Ý nghĩa |
|------------|---------|
| **Done** | DDL + API + pytest/UAT slice |
| **Partial** | DDL/API một phần logical view |
| **Alt** | Đơn giản hóa so với ARTS (documented ADR) |
| **N/A** | Ngoài scope (ARTS DW, NRF sample DB, third-party ERP) |

**Highlight Done:** retail commit/void/tax, customer orders, inventory ledger/ICD, loyalty engine, POS period/till, food/forecourt/hr M40 slice, purchase history projection, polymorphic registry v2 (Phase 3 M41–M52).

**Partial / backlog:** consumer journey depth, layaway/registry full workflow, full tender settlement E2E, ARTS 040xx ledger views đầy đủ, promotion depth tại POS.

---

## 8. Danh sách microservices

### ODM Core (14)

`catalog_item` · `enterprise_reference` · `party_customer` · `pricing_promo` · `inventory` · `retail_transaction` · `store_operations` · `payments_tender` · `loyalty_rewards` · `finance_ledger` · `reporting_analytics` · `food_service` · `forecourt` · `hr_workforce`

### Platform layer

`auth` · `settings` · `notification` · **Minerp Agent** (`multi-agent`) · `media_delivery` · `email_builder` · `workflow_builder`

### ODM Extensions (KhaServices)

`facility_management` · `service_desk` · `billing` · `forms_workflow` · `facility_booking` · `community` · `iot_facilities` · `enterprise_assets` · `asset_maintenance` · `hospitality_booking` · `channel_manager` · `marketplace` · `partner_network`

---

## 9. Entitlements SKU

| SKU | Layer |
|-----|-------|
| Core pack | ODM Core + Platform IAM/settings |
| `email_builder` | Email Builder |
| `workflow_builder` | Workflow Automation |
| `shop_ai` | Shop AI — add-on merchant trên Minerp Agent (Studio) |
| `storefront_studio` | Minerp Studio *(extension UI)* |

---

## 10. Health check (staging)

```
https://minerp.vn/api/auth/health/ready
https://minerp.vn/api/catalog-item/health/ready
https://minerp.vn/api/multi-agent/health/ready
https://minerp.vn/api/workflow-builder/health/ready
https://minerp.vn/api/email-builder/health/ready
```

---

## Tóm tắt

```
Minerp ODM
├── A. Core (ARTS ODM v7.3 → 14 services)
│   └── Merchandising · Ops · Customer · Finance · Verticals
├── B. Platform (mở rộng)
│   └── IAM · Settings · Notification · Media · Minerp Agent · Email* · Workflow*
└── C. Extensions (KhaServices / BMS)
    └── Property · CMMS · IoT · Marketplace · Partner · …
```

---

## Tài liệu liên quan

| Loại | Path |
|------|------|
| Studio (merchant extension) | [`minerp-studio-features.md`](./minerp-studio-features.md) |
| Microservices blueprint | [`docs/blueprint/microservices-blueprint.md`](../../../../docs/blueprint/microservices-blueprint.md) |
| Gap matrix ARTS ↔ platform | [`docs/blueprint/arts-odm-platform-gap-matrix.md`](../../../../docs/blueprint/arts-odm-platform-gap-matrix.md) |
| Ownership matrix (835 entities) | [`docs/blueprint/ownership-matrix.md`](../../../../docs/blueprint/ownership-matrix.md) |
| Retail BPM + ODM luồng | [`docs/meeting/luong-nghiep-vu-retail/Luong_ban_le_arts.md`](../../../../docs/meeting/luong-nghiep-vu-retail/Luong_ban_le_arts.md) |
| Service core BA | [`docs/ba/.../minerp/service-core/00-index.md`](../../../../docs/ba/artifacts/packages/platform/minerp/service-core/00-index.md) |
| Service extension BA | [`docs/ba/.../minerp/service-extension/00-index.md`](../../../../docs/ba/artifacts/packages/platform/minerp/service-extension/00-index.md) |
| Minerp Agent | [`services/multi-agent/README.md`](../../../../services/multi-agent/README.md) |
| ARTS ODM v7.3 (OMG) | https://www.omg.org/retail-depository/arts-odm-73/ |