AIでCSV集計画面を作る｜列の対応・集計条件・書き出しを確認する

集計する数字を一つに決める

最初の画面では、指定月の出荷済み注文について商品別の数量を集計します。売上、利益、顧客単価を同時に作らず、対象とする日付、状態、数量の列を仕様に書きます。「売上を見たい」という指示だけでは、受注日と出荷日の違いや返品の扱いをAIが勝手に補ってしまいます。入力は一種類のCSVから始め、列名とサンプル三行を架空の値で渡します。完成条件は、どの注文が計算に含まれ、なぜ除外されたか説明できることです。数字だけのカードより先に、読込件数、対象件数、除外件数を表示します。

ファイルを読んでから列を対応させる

ファイル選択後すぐに集計せず、先頭行と数行のプレビューを表示します。注文日、状態、商品コード、数量をどの列から読むか確認し、同名列、空の見出し、必須列不足を検出します。列の位置が変わっても対応が崩れないよう、保存する設定には列名と役割を含めます。カンマを含む商品名や引用符付きの値があるため、単純なカンマ区切りの文字列分割は避けます。改行コード、文字コード、区切り文字も入力条件として示し、読めないファイルを空のデータとして扱わないよう依頼します。

• Replitの公開後の運営を確認する

日付と数量の読込規則を作る

例では注文日を年・月・日で受け付け、曖昧な月日順を推測しません。数量は整数を必須とし、空欄、数値でない文字、負数、桁あふれを別の理由として一覧に出します。返品が負数で届く運用なら通常注文の数量と区別する仕様を先に追加します。「1,200」や全角数字を受け付けるかも統一します。途中で都合のよい行だけを黙って採用すると元の表と合計が合わなくなります。入力値、変換した値、拒否理由を必要な範囲で残し、担当者が元の行番号へ戻って修正できる状態にします。

行の一部に問題がある場合は、全体を停止するか、担当者が除外を確認して続けるかを選べるようにします。除外に同意した行番号も結果と一緒に記録します。

集計と保存の責任を分ける

一時的な小さいCSVならブラウザー内で計算する方法があります。複数担当者が結果を共有したい場合は、Replitのデータベースなどへ集計条件と結果を保存する構成を検討します。理由を決めずに全ての元ファイルを永久保存しない設計にします。AIには読込、検証、フィルター、商品別合算、CSV出力を別の関数として作るよう頼みます。画面の並べ替えで合計対象まで変わらないこと、出力ボタンが古いフィルターの結果を使わないことを仕様に入れ、計算条件を画面と同じ状態から渡します。

• 集計SQLの正しさを点検する

五行の例を手計算と照合する

例として同じ商品Aの出荷済み数量2と3、未出荷数量4、別月の数量5、数量が空欄の行を用意します。当月の出荷済みを選んだ結果は数量5となり、未出荷と別月は対象外、空欄は検証エラーとして分けます。この数値は説明用の例で、実際の注文実績ではありません。数量だけでなく、対象二行、条件による除外二行、エラー一行という内訳も照合します。フィルターを変えた後に戻すと同じ結果になるか、出力CSVと画面の対象件数が一致するかも確かめます。

大きいファイルと二重読込に備える

アップロード時に件数や容量の上限を設け、超えた場合は分割などの案内を出します。上限は試作環境で処理時間とメモリを測って決めるもので、一律の対応件数を保証するものではありません。処理中は進行を表示し、別ファイルへ切り替えた結果が混ざらないようにします。同じ注文の重複行は注文IDと明細IDなどで判定します。見た目が同じ商品と数量でも別注文なら加算が必要です。画面の再読込でデータが二度追加されないよう、再集計と履歴保存を分けます。

• 境界値の練習データを作る

保存量と集計頻度から費用を読む

ReplitでAIに修正を依頼する利用量と、公開した画面の計算・データ保存にかかる費用を別に見ます。一回だけ処理するファイルを保存し続ける設計と、条件と結果だけを残す設計では必要な保存量が変わります。元CSVが必要なら保管期間と削除担当も決めます。月に読むファイル数、平均行数、再集計回数、出力ファイルの保持期間を記録すると見積もりやすくなります。個人情報の列は集計に不要なら取り込まず、具体的な請求条件は現在の公式料金画面で確認します。

結果を配る前に条件を添える

書き出すCSVには対象期間、状態条件、集計日時、元ファイルの識別名を追えるようにします。式のように見える文字列を表計算ソフトで開く場合の扱いも検討し、出力先に合わせて文字列を安全に扱います。数値列と商品コード列を区別し、先頭ゼロを落とさない構成にします。公開時は練習CSVと期待する結果を一緒に保管します。列や状態名を変更したら例を更新して再確認します。訂正後の出力には別の版番号を付け、旧出力と識別できるよう利用者へ案内します。