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 #在庫管理システム #コード再利用 #ロジスティクス