メインコンテンツへスキップ

Day118|Universal WMS Coreの「中枢」を整える:中央集権モジュールの実装

    こんにちは、こんです🦊
    今日は、Universal WMS Coreの「中枢神経」とも言える中央集権的なデータ操作モジュールを実装しました。

    これでようやく、「どこからでも同じルールでデータを操作できる」状態が整いました。Week3の肝になる部分です。


    🧪 実験のきっかけ

    Mini WMSでは各画面が独立してlocalStorageにアクセスしていましたが、それぞれの仕様が微妙に異なっていたり、再利用性が低くなったりしていたのが課題でした。

    Universal WMS Coreでは、「公式窓口(apiClient)」を1つに集約し、データ処理を一元化することで、開発スピードとメンテナンス性を両立させたいと考えました。


    ⚙️ 今日やったこと(サブタスク2)

    ✅ データ操作の「公式窓口」を作成(apiClient.ts)

    すべてのCRUD処理を apiClient オブジェクトに集約しました。

    export const apiClient = {
      products: {
        getAll: () => loadData('products'),
        add: (newProduct) => {
          const current = loadData('products') || [];
          const updated = [...current, newProduct];
          saveData('products', updated);
          return { success: true };
        },
        // update, delete も追って追加予定
      },
      transactions: {
        add: (txn) => {
          const all = loadData('inventory_transactions') || [];
          saveData('inventory_transactions', [...all, txn]);
          return { success: true };
        },
        // getAll も後日追加
      }
    };

    ✅ データ永続化モジュールの切り出し(database.ts)

    loadData() / saveData() を専用モジュールとして実装。

    export const loadData = (key) => {
      try {
        const raw = localStorage.getItem(key);
        return raw ? JSON.parse(raw) : [];
      } catch (e) {
        console.error(e);
        return [];
      }
    };
    
    export const saveData = (key, data) => {
      try {
        localStorage.setItem(key, JSON.stringify(data));
      } catch (e) {
        console.error(e);
      }
    };

    ✅ Zustandによる状態管理との連携準備

    次のステップで useWmsStore() に統合予定。
    今回はデータ処理の「中継地点」として、APIと状態管理の間に位置するモジュールを設計しました。


    📌 なぜ中央集権モジュールが必要なのか?

    画像

    📷 開発中の構成図(簡略版)

    App
     ├─ ProductList
     ├─ InboundForm
     ├─ OutboundForm
     └─ InventoryView
             ↓
         useWmsStore (Zustand)
             ↓
         apiClient(中央集権モジュール)
             ↓
         localStorage(データ保存庫)

    💡 今日の学びと気づき

    画像

    🔮 明日の予告:Day119

    いよいよ Zustandストア(useWmsStore.ts) の再構築に入ります。

    • 状態構造を products, inventory, locations に整理

    • 各CRUD操作をapiClientとつなぐ

    • 在庫数を自動計算するセレクターの実装


    ✍️ 最後に

    Mini WMSでは「とりあえず動くもの」を目指していました。
    Universal WMS Coreでは「長く育てられる土台」を目指しています。

    今日作った中央集権モジュールは、まさにその土台の「中心軸」。

    ここからさらに、WMSらしい機能群(ロケーション・棚卸・在庫トレース)を、少しずつ積み上げていきます。地味だけど、たしかな一歩でした。


    🔗 公開中のWMS

    Mini-WMS(Week2版) → https://khoorzruog.com/tools/mini-wms/
    25/07/29 URL変更しました → https://khoorzruog.com/tools/universal-wms-v1/

    Universal-WMS(Week3版) → (※準備中)


    🧷 #100日チャレンジ #React #WMS開発 #業務改善 #DX #Zustand #localStorage #在庫管理システム #コード再利用 #ロジスティクス

     
     
    スプレッドシートやAppSheetで業務改善に挑戦中のコンです。 DXとか自動化って聞くと、ちょっと身構えちゃうけど—— 小さな“ラク”から始めれば、きっと変えていける。 ゆるく、楽しく、現場で役立つノウハウを、コン目線でお届けしていきます!

    あなたへのおすすめ