packages/ecommerce-admin/
├── src/
│   ├── types.ts              # OrderStatus, AdminOrder, EcommerceMetrics, Zod schemas
│   ├── backend/
│   │   ├── repository.ts     # SqliteOrderRepository (WAL SQLite with parameterization)
│   │   ├── service.ts        # EcommerceOrderService (State machine transitions & metrics)
│   │   ├── routes.ts         # createEcommerceAdminRoutes (Mountable Hono router)
│   │   └── index.ts          # Backend barrel
│   ├── frontend/
│   │   ├── EcommerceAdminDashboard.tsx  # Master Admin Portal Component
│   │   ├── useEcommerceAdmin.ts         # SWR / Fetch hook for orders & metrics
│   │   ├── components/       # MetricCards, OrderTable, ReceiptModal
│   │   └── index.ts          # Frontend barrel
│   └── index.ts              # SSoT Unified Barrel

import { Hono } from 'hono';
import {
  EcommerceOrderService,
  SqliteOrderRepository,
  createEcommerceAdminRoutes,
  type CreateOrderInput,
} from '@kido/ecommerce-admin';

// 1. Initialize SQLite Repository & Order Service
const repo = new SqliteOrderRepository({ dbPath: './data/ecommerce.db' });
const orderService = new EcommerceOrderService(repo);

// 2. Programmatically create an order
const newOrder: CreateOrderInput = {
  customer: {
    fullName: 'Nguyễn Văn An',
    email: 'an.nguyen@example.com',
    phone: '0905123456',
    address: '123 Nguyễn Văn Linh, Quận Hải Châu',
    city: 'Đà Nẵng',
    zipCode: '550000',
  },
  items: [
    {
      sku: 'FLASHLIGHT-TACTICAL',
      name: 'Tactical Flashlight Pro 2026',
      quantity: 2,
      unitPrice: 19.99,
      totalPrice: 39.98,
    },
  ],
  totalAmount: 39.98,
  currency: 'USD',
  paymentMethod: 'VIETQR',
  notes: 'Giao giờ hành chính',
};

const created = orderService.createOrder(newOrder);
console.log(`Order created: ${created.id} (Status: ${created.status})`);

// 3. Perform Valid State Machine Transition: PENDING -> PAID
const paidOrder = orderService.updateOrderStatus(
  created.id,
  'PAID',
  'Payment confirmed via VietQR Webhook',
  'SEPAY-TXN-998811'
);
console.log(`Order updated: ${paidOrder?.id} -> Status: ${paidOrder?.status}`);

// 4. Mount Admin REST API into Main Hono App
const app = new Hono();

app.route(
  '/api/admin/ecommerce',
  createEcommerceAdminRoutes({
    service: orderService,
    bankConfig: {
      bankId: 'MBBank',
      accountNo: '0905123456',
      accountName: 'CONG TY TNHH KIDO',
    },
  })
);

export default app;

import React from 'react';
import { EcommerceAdminDashboard } from '@kido/ecommerce-admin';

export function AdminPage() {
  return (
    <div className="min-h-screen bg-slate-900 text-slate-100 p-8">
      <EcommerceAdminDashboard
        apiBaseUrl="/api/admin/ecommerce"
        exchangeRate={25400} // USD to VND converter for metrics
        bankConfig={{
          bankId: 'MBBank',
          accountNo: '0905123456',
          accountName: 'CONG TY TNHH KIDO',
        }}
      />
    </div>
  );
}