12 Modules Architecture

MStore Dashboard menggunakan arsitektur modular dengan 12 domain modules yang mencakup seluruh kebutuhan bisnis ERP.

Module Overview

Module Summary

#	Module	Domain	Description	Business Level
01	`01_core`	Core	Auth, notifications, settings	L0+
02	`02_finance`	Finance	Invoice, payment, AR/AP, ledger	L1+
03	`03_inventory`	Inventory	Products, stock management	L0+
04	`04_procurement`	Procurement	PO, suppliers, approvals	L0+
05	`05_sales`	Sales	POS, transactions, receipts	L0+
06	`06_hr`	HR	Employees, payroll, attendance	L1+
07	`07_crm`	CRM	Customers, campaigns, leads	L1+
08	`08_cs`	Customer Service	Tickets, SLA, chat	L1+
09	`09_audit`	Audit	Audit logs, compliance	L2+
10	`10_analytics`	Analytics	Dashboards, KPI, reports	L2+
11	`11_holding`	Holding	Multi-entity, consolidation	L3+
12	`12_global`	Global	IAM, security, policies	L4

Business Levels

Level	Name	Description
L0	Micro/Solo	Single owner, cashier
L1	SME	Managers, supervisors
L2	Enterprise	Auditors, analysts
L3	Holding	Multi-entity management
L4	MNC	Global administrators

Module Details

01_core - Core Foundation

01_core

Purpose: Authentication, notifications, dan system settingsSubmodules:

auth/ - Login, logout, token management
notifications/ - Push notifications, alerts
settings/ - User preferences, app config
user/ - User profile, roles

Key Features:

JWT authentication
Role-based access control (RBAC)
Real-time notifications
Theme preferences

features/01_core/
├── api/
│   ├── auth/
│   │   ├── login.ts
│   │   ├── logout.ts
│   │   └── refreshToken.ts
│   └── notifications/
│       ├── getList.ts
│       └── markAsRead.ts
├── store/
│   ├── auth.ts
│   └── notifications.ts
├── composables/
│   ├── useAuth.ts
│   └── useNotifications.ts
└── types/
    ├── auth.types.ts
    └── notification.types.ts

02_finance - Finance Management

02_finance

Purpose: Manajemen keuangan, invoice, dan pembayaranSubmodules:

invoice/ - Pembuatan dan tracking invoice
payment/ - Metode pembayaran, reconciliation
ar/ - Accounts Receivable (piutang)
ap/ - Accounts Payable (hutang)
ledger/ - General ledger, trial balance
cashflow/ - Cash flow management

Key Features:

Multi-currency support
Tax calculation
Payment gateway integration
Financial reports

features/02_finance/
├── api/
│   ├── invoice/
│   ├── payment/
│   ├── ar/
│   └── ap/
├── store/
│   └── finance.store.ts
├── components/
│   ├── InvoiceTable.vue
│   ├── PaymentForm.vue
│   └── ARAPSummary.vue
└── types/
    └── finance.types.ts

03_inventory - Inventory Management

03_inventory

Purpose: Manajemen produk dan stokSubmodules:

product/ - Product master, categories
stock/ - Stock levels, warehouses
adjustment/ - Stock opname, variance
transfer/ - Inter-warehouse transfer

Key Features:

Multi-warehouse support
Barcode/SKU management
Stock alerts (low stock)
Batch/serial tracking

features/03_inventory/
├── api/
│   ├── getList.ts
│   ├── create.ts
│   ├── update.ts
│   └── delete.ts
├── store/
│   └── inventory.store.ts
├── components/
│   ├── InventoryTable.vue
│   ├── ProductForm.vue
│   └── StockAdjustment.vue
├── composables/
│   ├── useInventoryList.ts
│   └── useStockOpname.ts
└── types/
    └── inventory.types.ts

04_procurement - Procurement

04_procurement

Purpose: Purchase order dan supplier managementSubmodules:

po/ - Purchase Order creation, tracking
rfq/ - Request for Quotation
supplier/ - Supplier master, contacts
approval/ - Multi-level approval workflow

Key Features:

Supplier comparison
PO approval workflow
Goods receipt
Supplier performance tracking

05_sales - Sales & POS

05_sales

Purpose: Point of Sale dan transaksi penjualanSubmodules:

pos/ - POS interface, cart
checkout/ - Payment collection
receipt/ - Receipt printing
transaction/ - Transaction history
return/ - Sales return handling
shift/ - Shift management

Key Features:

Offline-capable POS
Multiple payment methods
Thermal printer support
Real-time stock update

features/05_sales/
├── api/
│   ├── createTransaction.ts
│   ├── getTransactions.ts
│   └── processReturn.ts
├── store/
│   ├── sales.store.ts
│   └── cart.store.ts
├── components/
│   ├── POSInterface.vue
│   ├── CartSummary.vue
│   └── ReceiptPreview.vue
└── composables/
    ├── usePOS.ts
    └── useCheckout.ts

06_hr - Human Resources

06_hr

Purpose: Employee management dan payrollSubmodules:

employee/ - Staff directory, profiles
attendance/ - Check-in/out, timesheet
leave/ - Leave requests, balance
payroll/ - Salary, deductions

Key Features:

Attendance tracking
Leave management
Payroll calculation
Employee documents

07_crm - Customer Relationship

07_crm

Purpose: Customer management dan marketingSubmodules:

customer/ - Customer database
campaign/ - Marketing campaigns
lead/ - Lead tracking
loyalty/ - Loyalty program

Key Features:

Customer segmentation
Campaign management
Lead pipeline
Points/rewards system

08_cs - Customer Service

08_cs

Purpose: Customer support dan ticketingSubmodules:

ticket/ - Support tickets
chat/ - Real-time messaging
sla/ - SLA tracking
kb/ - Knowledge base

Key Features:

Ticket management
Multi-channel support
SLA monitoring
Self-service portal

09_audit - Audit & Compliance

09_audit

Purpose: Audit trail dan complianceSubmodules:

log/ - Activity logging
compliance/ - Compliance reporting
sod/ - Segregation of Duties
report/ - Audit reports

Key Features:

Full audit trail
Compliance checklists
SoD validation
Regulatory reports

10_analytics - Analytics & BI

10_analytics

Purpose: Business intelligence dan reportingSubmodules:

dashboard/ - KPI dashboards
report/ - Custom reports
kpi/ - Key performance indicators
forecast/ - Sales forecasting

Key Features:

Real-time dashboards
Custom report builder
KPI tracking
Predictive analytics

11_holding - Multi-Entity

11_holding

Purpose: Multi-company dan consolidationSubmodules:

entity/ - Entity registry
consolidation/ - Financial consolidation
intercompany/ - Intercompany transactions

Key Features:

Multi-entity management
Consolidated reporting
Intercompany elimination
Group-level analytics

12_global - Global Administration

12_global

Purpose: Global settings dan securitySubmodules:

iam/ - Identity & Access Management
security/ - Security policies
policy/ - Business rules (OPA)
esg/ - ESG compliance

Key Features:

SSO integration
Policy management
Security monitoring
ESG reporting

Module Dependencies

Adding New Module

Create Module Structure

# Create new module (e.g., 13_new_module)
mkdir -p features/13_new_module/{api,components,composables,store,types}

Define Types

// features/13_new_module/types/index.ts
export interface NewEntity {
  id: string
  name: string
  createdAt: Date
}

Create Store

// features/13_new_module/store/newModule.store.ts
export const useNewModuleStore = defineStore('newModule', () => {
  const items = ref<NewEntity[]>([])
  const loading = ref(false)

  return { items, loading }
})

Create Barrel Export

// features/13_new_module/index.ts
export * from './api'
export * from './store'
export * from './composables'
export * from './types'

Create Pages

mkdir -p app/pages/new-module
touch app/pages/new-module/index.vue

Best Practices

Module Isolation

Setiap module harus self-contained
Hindari direct import antar module (gunakan store)
Share utilities via utils/ folder
Share types via barrel export

Cross-Module Communication

// Good: Use store
import { useInventoryStore } from '~/features/03_inventory'
const inventoryStore = useInventoryStore()

// Avoid: Direct import
import { getInventoryList } from '~/features/03_inventory/api/getList'

Naming Convention

Module folder: {number}_{name} (e.g., 03_inventory)
Store: use{Module}Store
Composable: use{Module}{Action}
Component: {Module}{Type}

Next Steps

State Management

Pinia state management patterns

Data Flow

Data flow antar layers

Core Architecture

Documentation Index

​12 Modules Architecture

​Module Overview

​Module Summary

​Business Levels

​Module Details

​01_core - Core Foundation

01_core

​02_finance - Finance Management

02_finance

​03_inventory - Inventory Management

03_inventory

​04_procurement - Procurement

04_procurement

​05_sales - Sales & POS

05_sales

​06_hr - Human Resources

06_hr

​07_crm - Customer Relationship

07_crm

​08_cs - Customer Service

08_cs

​09_audit - Audit & Compliance

09_audit

​10_analytics - Analytics & BI

10_analytics

​11_holding - Multi-Entity

11_holding

​12_global - Global Administration

12_global

​Module Dependencies

​Adding New Module

​Best Practices

​Next Steps

State Management

Data Flow

12 Modules Architecture

Module Overview

Module Summary

Business Levels

Module Details

01_core - Core Foundation

02_finance - Finance Management

03_inventory - Inventory Management

04_procurement - Procurement

05_sales - Sales & POS

06_hr - Human Resources

07_crm - Customer Relationship

08_cs - Customer Service

09_audit - Audit & Compliance

10_analytics - Analytics & BI

11_holding - Multi-Entity

12_global - Global Administration

Module Dependencies

Adding New Module

Best Practices

Next Steps