BuildShelf

CSV／Excel取込は、ファイルを読むだけでは本番運用できません。列マッピング、型変換、検証、重複処理、プレビュー、ステージング、失敗時のロールバック、監査履歴までを毎回作る必要があります。 本商品は、購入者がJSONベースのschema／mapping configを定義して様々な業務データへ適用できる、PythonのCSV・XLSX取込リファレンス実装です。 【主な内容】 ・CSVの文字コード、区切り文字、ヘッダー検出 ・XLSXテーブル／shared stringsの限定対応 ・設定駆動の列マッピングとスキーマ ・日付、数値、真偽値、列挙、文字列の正規化 ・必須項目、行単位、複数項目間の検証 ・複合キーを含む重複検出ポリシー ・プレビュー／dry-run ・valid／invalid／skipped行の分離とエラーレポート ・SQLiteステージング、取込履歴、監査ログ ・原子的なinsert-only適用とロールバック ・安全な再実行、決定的fixture、性能テスト ・スプレッドシート数式インジェクション対策 ・Docker／Compose、102件の自動テスト 【実動作画像（2〜6枚目）】 同梱の合成データと販売ZIPのコードによる実行結果から、項目を抜粋して再構成しました。顧客データは使用していません。 2. 合成CSVを取り込み、反映前に2行をステージング。 3. マッピング・正規化後の2行をプレビュー。 4. 別の合成CSVで無効行3件を検出し、セル値を含まないレポートを生成。 5. 正常行を一括反映し、監査履歴を確認。 6. この取込が所有する反映を取消。販売ZIPで自動テスト102件が成功。 【対象者】 CSV／Excel取込をSaaS、社内ツール、受託開発案件へ組み込むPython開発者。顧客ごとの列名や業務スキーマへ対応しつつ、取込基盤を毎回ゼロから作りたくない方。 【含まれないもの】 ホスティング、ブラウザのドラッグ＆ドロップUI、ノーコードマッパー、任意のExcel機能、旧式XLS、XLSM、マクロ、数式計算、結合セル、外部リンク、ERP／CRM固有連携、顧客固有スキーマは含みません。 【動作要件】 Python 3.9以上、SQLite。必須の外部Pythonパッケージはありません。Docker／Docker Composeは任意です。 【ライセンス】 1個人または1法人が、商用利用、改変、複数の社内プロジェクト、許可された顧客成果物への組み込みを行えます。本商品の再販売、再配布、公開リポジトリへの掲載、実質的に同等なテンプレートとしての再包装は禁止です。同梱ライセンス全文が優先されます。 【サポート】 README／Quickstart範囲のセットアップ質問と再現可能な商品不具合が対象です。個別開発、顧客固有マッピング、プロジェクト統合、デプロイ、SLA、回答時間保証、無期限更新は含みません。 【返金】 デジタル商品の性質上、ダウンロード後は原則返金不可です。ただし、重複購入、破損または利用不能なダウンロード、公開された商品説明との重大な相違、または適用法令上必要な場合は対応します。