カテゴリー: 開発メモ

業務アプリを作ろうと話が上がると、「画面も帳票も通知も、最初から全部入れたい」という声をよく聞きます。気持ちはわかりますが、小さな会社ほど最初は一部だけ動かす方が失敗が少ないです。入力と出力、誰が確認するか、失敗したときの影響――この4つを切り分けて小さく始めると、後からの修正も楽になります。

---

「全部入り」がうまくいかない典型的なパターン

たとえば在庫管理を考えます。「発注入力、在庫一覧、アラート通知、月次レポート、承認フロー……全部ほしい」とスタートすると、何が起きるか。

• 入力項目が多くて現場が使わなくなる
• 帳票のフォーマットが決まらず開発が止まる
• 通知条件が不明確で誤報が増える
• 結局Excelに戻る

一番まずいのは「作ったのに誰も使わない」状態です。これを避けるには、まず動く小さな一部から始めるのが正解です。

---

4つの要素に切り分けて考える

業務アプリは、どのような業務でも次の4つに分けて考えられます。

要素	内容	例
入力	データをどこからどう入れるか	CSVアップロード、手入力フォーム、外部システム連携
出力	結果をどう見せるか	検査レポート、集計CSV、メール本文
確認者	誰が結果をチェックするか	担当者の目視、上司の承認、自動チェック
失敗時の影響	間違えたとき何が起きるか	発注ミスで在庫過多、顧客への誤送信

この4つを全部同時に作る必要はありません。影響が小さくて確認しやすいものから始めればよいのです。

---

データ先行で進める――画面より先にCSVを見る

小さく始める一番の手は「画面を作らずにCSVを確認する」ことです。

たとえば、毎月発送している商品CSVがあります。これを検査ツールに通すだけで、次のようなことがわかります。

• 必須項目の漏れがないか
• 金額の桁違いがないか
• 重複する注文番号がないか

画面が一つもなくても、CSVを入れて検査レポートが出る――これだけで最初の「確認」は始められます。実際のデータを見てから「じゃあ次はWeb入力画面がほしい」「通知もほしい」と決める方が、無駄がありません。

3段階で広げる例

Phase	内容	自動化できる部分
Phase 1	CSV検査ツール	フォーマットチェック、必須項目確認、重複検出
Phase 2	Web入力画面＋検査	入力バリデーション、リアルタイムチェック
Phase 3	通知＋定期実行	メール送信、Slack通知、スケジュール実行

Phase 1で実際のデータを扱ってみて初めて、「どの項目がよく間違えるか」「誰が確認すべきか」が見えてきます。この情報がないとPhase 2以降の設計が的外れになります。

---

自動チェックと人間の判断を分ける

業務アプリを作るとき、「できるだけ自動化したい」と思うものですが、全部を自動化するのは現実的ではありません。ルールが明確なものは自動、判断が入るものは人間――この分け方が一番うまくいきます。

確認項目	聞く理由	自動化候補	人間判断
必須項目の有無	どの項目が業務上必須か	◯ 自動チェック可	－
金額の妥当性	上限・下限の基準があるか	◯ 閾値チェック可	△ 閾値の設定は人間
データの業務スコープ	どの範囲をアプリ化するか	－	◯ 現場の判断
例外処理の方針	エラー時どうするか	－	◯ 担当者の裁量
帳票フォーマット	誰に何を見せるか	△ テンプレート生成	◯ レイアウトの決定
コストと効果の見合い	どこまで自動化するか	－	◯ 経営判断
最終承認	出力を本番に使うか	－	◯ 責任者の判断
CSVの文字コード・改行	システムで読める形式か	◯ 自動検出可	－

自動チェックは「こういう間違いは絶対に見逃さない」という安心感を生みます。人間の判断は「このケースはどう扱うか」という柔軟性を担保します。両方を混ぜないことがポイントです。

---

アプリを作る前のチェックリスト

開発に着手する前に、次の項目を確認しておくと手戻りが減ります。

確認項目	チェック
現在の業務フローが紙かExcelか把握している	☐
入力データのサンプル（CSVのヘッダー行や項目名の一覧で構いません）がある	☐
出力する帳票やレポートのイメージがある	☐
間違えたときの影響範囲がわかっている	☐
誰が確認・承認するか決まっている	☐
最初は一部の機能だけでよいと合意している	☐

この中で「サンプルデータがある」は特に重要です。項目名やダミーデータであっても、どんなチェックが必要か、どの項目が間違えやすいかを整理する手がかりになります。

---

失敗時の影響で優先順位を決める

「全部作らない」といっても、どこから手を付けるか迷うものです。そんなときは失敗したときの影響の大きさで順番を決めます。

影響が大きいもの（顧客への誤送信、金額の桁違いなど）は、まず自動チェックを入れます。影響が小さくて人間が確認しやすいもの（社内共有の集計表など）は、後回しでも大丈夫です。

具体的には次のような優先順位になります。

1. 金額・数量の誤り ―― 自動チェックを最優先。CSV検査で桁違い・マイナス値を検出
2. 必須項目の漏れ ―─ 自動チェック。フォーマット検査で即座に発見
3. 重複データの検出 ―─ 自動チェック。IDや注文番号の重複を機械的に確認
4. 帳票の体裁 ―─ 人間確認。フォーマットは現場の意見を聞きながら決める
5. 承認フロー ―─ 人間判断。誰が責任を持つかは業務のルールによる

---

初回相談では機密CSVやスクリーンショットの送付は不要です

相談時に元データや画面のスクリーンショットを送らなくて大丈夫です。最初は「どういうデータを、どういう形で、誰が確認しているか」を口頭で教えていただければ進められます。実際のデータは、テスト環境が整った段階で別途確認します。

---

相談時に用意するとよい情報

• 現在使っているExcelやCSVの列名（項目名だけでOK）
• 月に何回くらいその作業をしているか
• よくある間違いや手戻りの内容
• 誰が最終的に確認・承認しているか
• 間違えたときにどう気づくか（または気づかないか）

---

小さな業務アプリは「全部作る」のではなく「一番効果のある一部を確実に動かす」のが正解です。CSVの検査から始めて、データの傾向が見えてから次の機能を足す。この進め方なら、作ったものが現場で使われないリスクを大きく減らせます。

手作業を減らしたいと考えたとき、すぐにスクリプトを書きたくなります。しかし、判断基準が曖昧なまま自動化しても、後で「このケースはどうする？」が大量に残ります。まずは現状の手作業をチェックリストとして書き出し、何を機械に任せて何を人間が判断するのかを整理するのが、効率よく自動化を進める近道です。

---

チェックリストを先に作る3つの理由

自動化の前にチェックリストを作る主な理由は次の3つです。

1. 確認内容が言語化される — 「なんとなくおかしいと気づく」を「列が空ならNG」という明確な条件に変えられます。
2. 人間の判断箇所が見える — 機械では判定できない例外処理やビジネス判断が、リストのどの項目に含まれるかがわかります。
3. 自動化の範囲が決まる — すべてを一気に自動化する必要はありません。安定して判定できる項目から順にスクリプト化できます。

たとえばShopifyへインポートするCSVを手作業で確認している場合、「価格列が空欄ではないか」「在庫数がマイナスになっていないか」「画像URLが404になっていないか」などを毎回目視でチェックしているはずです。これを一度リストに書き出すだけで、自動化の対象がぐっと具体になります。

---

現状の確認作業を観察してリストを作る

チェックリストを作るときは、まず現状の手作業をそのまま観察します。抽象的な分類ではなく、「実際に目と手を動かしていること」を一行ずつ書き出します。

観察の手順

1. 作業をそのまま記録する — 「CSVを開く」「件数を数える」「特定の列をソートして外れ値を探す」など、やっていることをそのままメモします。
2. 判断基準を書き添える — 「この列が空だったらNG」「この数値が前回と大きく違ったら確認」など、判定している条件を言葉にします。
3. 例外の対応も書く — 「だいたいこれでいいけど、たまに例外があって……」という部分こそ、人間の判断が必要な箇所です。

翻訳済みの商品データCSVをチェックする例で考えます。「商品名が翻訳されているか」は自動判定が難しいです。一方、「翻訳列が空欄ではないか」「文字数が原文と極端に違わないか」は機械で確認できます。このように「何をどう確認しているか」を分解していくと、自動化できる部分と人間が見るべき部分が自然に分かれていきます。

---

自動チェックと人間の判断を分類する

リストができたら、各項目を「自動化できるか」「人間の判断が必要か」に分類します。次の表は、CSVのインポート前確認を分類した例です。

チェック項目	現在の確認方法	自動化可否	人間の判断内容
必須列の空欄チェック	目視でスクロール	自動化可能	—
価格の範囲確認（0〜999,999）	ソートして上下を確認	自動化可能	—
行数の一致（前回CSVとの比較）	エディタの行数表示を見る	自動化可能	—
画像URLの到達確認	数個をブラウザで開く	自動化可能	—
翻訳品質の確認	一部を読んで違和感を探す	人間の判断	文脈に合っているか、不自然でないか
例外的な価格設定の判断	「これはセール品だから安くて正解」と判断	人間の判断	ビジネス上の判断、例外的な事情の確認
最終的なインポート実行の可否	全体を見て「よし」と決める	人間の判断	リスク評価、責任の所在

このように分類すると、自動化すべき項目と人間が判断すべき項目がはっきり分かれます。自動化可能な項目は機械に任せて、人の時間を「意味を確認する」「例外を判断する」ことに集中させられます。

---

安定した項目から順に自動化する

分類が終わったら、安定して判定できる項目から順にスクリプト化します。一度に全部を作る必要はありません。

自動化しやすいチェックの例

• フォーマット検証 — 日付列がYYYY-MM-DD形式か、数値列に文字が混じっていないか
• 空欄検出 — 必須列に空欄がないか
• 件数一致 — ヘッダー行の列数とデータ行の列数が一致しているか
• 差分表示 — 前回のCSVと比較して、増減した行をリストアップする

これらはルールが明確なので、一度スクリプトを書けば安定して動きます。CSVチェック用の簡易ツールでも、このあたりの基本チェックはすぐに対応できます。

人間の判断が残るチェックの例

• 意味の検証 — 翻訳が文脈に合っているか、商品説明に違和感がないか
• 例外処理 — 「今回は特別にこの価格でいい」といった個別の事情
• ビジネス判断 — このデータでインポートを実行してよいかどうかの最終決定
• 最終承認 — 自動チェックの結果を踏まえて「GO」を出すかどうか

人間の判断は自動化の対象ではなく、むしろ判断しやすくするための情報整理が自動化の目的です。自動チェックの結果がレポートとして手元にあれば、人の判断も早くなります。

---

チェックリスト作成の進め方まとめ

実際にチェックリストを作って自動化につなげる流れをまとめます。

1. 観察 — 現状の手作業をそのまま書き出す
2. 列挙 — 確認項目と判断基準を一行ずつリストにする
3. 分類 — 自動化できる項目と人間の判断が必要な項目に分ける
4. 実装 — 安定して判定できる項目からスクリプト化する

この流れで進めると、「何を自動化したくて、どこから手をつけるか」が最初から明確になります。スクリプトを書き始めてから要件を悩む時間が大幅に減ります。

初回相談では機密CSVやスクリーンショットの送付は不要です。現在の手作業を大まかに教えていただければ、チェックリストの作り方からご案内できます。

---

相談時に用意するとよい情報

• 現在、手作業で確認しているCSVの項目（大まかで構いません）
• チェックしている頻度（毎日、週1回、月次など）
• これまでに見落としたことのあるエラーの例
• チェック結果を誰にどう伝えているか
• 使っているツールや環境（Excel、Googleスプレッドシート、テキストエディタなど）

CSVチェックツールを作るとき、「空欄を埋める」「URLを直す」「JANの形式をそろえる」まで自動でやりたくなります。ただ、最初から自動修正を入れると、便利になる前に別の事故を作ることがあります。特にShopify商品CSVや在庫CSVは、1列の変更が商品ページ、在庫、画像、検索表示に広く効きます。

まず何が起きているか

CSVの不備には、機械的に直せるものと、業務判断が必要なものがあります。前後スペースの削除は比較的単純ですが、空欄を既定値で埋める、価格を丸める、画像URLを置き換える、説明文を翻訳する、といった処理は意図を確認しないと危険です。チェックツールの初期版は、直すより先に見つけて説明する方が役に立つことが多いです。

よくある危ない自動修正

• 空欄を「変更なし」と思い込んで埋める、または削除する
• JANコードやSKUを数値扱いし、先頭0を落とす
• 画像URLを推測で差し替え、違う商品画像にする
• Handleを自動生成して、既存商品の更新ではなく新規作成に寄せてしまう
• 英語説明文を一括生成し、ブランド用語や禁止表現を見落とす

最初に作るべき確認項目

• 列名が想定テンプレートと一致しているか
• 必須列、更新対象列、触らない列が分かれているか
• 空欄、重複、形式違い、異常に長い値があるか
• 投入前後で変わる行数、商品数、SKU数
• 修正候補ごとに、誰が判断するべきか

手作業で運用する場合の手順

まずはCSVを直接書き換えず、チェック結果だけを別ファイルに出します。次に、問題を「その場で直せる」「担当者確認が必要」「今回は触らない」に分けます。修正する場合も、元CSV、修正後CSV、差分レポートを残します。これだけで、どの判断で何が変わったかを後から説明しやすくなります。

小さく自動化できる部分

• 読み込み時の文字コード、列数、ヘッダー差分チェック
• JAN、URL、価格、数量などの形式チェック
• 更新対象列だけを抜き出した差分レポート
• 危険度別の警告表示
• 確認済みのルールだけを選択式で適用する処理

注意点

自動修正を否定しているわけではありません。問題は、ルールが固まる前に「たぶんこうだろう」で書き換えることです。CSV投入後の結果、売上、検索表示、在庫反映を保証することはできません。最初は検出と差分確認を中心にして、繰り返し安全に使えるルールだけを少しずつ自動化するのが現実的です。

相談前に整理しておくとよいこと

• チェックしたいCSVの種類: 商品、在庫、注文、帳票用など
• 過去に壊れた列、怖くて触れない列
• 自動化したい作業と、人が判断したい作業
• 投入前に見たいレポートの形
• 初回相談では、実CSVではなく列名と作業手順だけでもかまいません

参考にした公式情報

• Shopifyヘルプセンター: CSVファイルを使用した商品のインポートとエクスポート
• Shopify Help Center: Using CSV files to import and export products