BuildShelf

「公開ページやPDFが変わったかを定期確認したい」。簡単に見える要件でも、実運用ではリダイレクト、タイムアウト、不正なURL、壊れたPDF、履歴保存、取得失敗、差分表示、チェックサム付き書き出しまで必要になります。 Evidence Monitorは、その共通基盤を毎回ゼロから作らないための開発者向けリファレンス実装です。公開HTML、PDF、ダウンロード可能なファイルを直接取得し、内容を版として保存。テキストまたはバイナリの変更を分類し、履歴や差分を確認できます。 【主な内容】 ・公開HTML・PDF・ファイルの直接監視 ・SSRFを意識した接続先、リダイレクト、タイムアウト、サイズ、MIME検証 ・内容アドレス方式による版保存とアプリケーションレベルの整合性確認 ・SQLiteによる対象、実行、版、失敗、ヘルス履歴 ・テキスト／バイナリの変更検出と差分履歴 ・PDFテキスト抽出 ・取得失敗時も直前の正常版を保持 ・マニフェストとチェックサムを含む証拠データ一式の書き出し ・CLI、テスト、Docker／Docker Compose、運用・セキュリティ資料 【実動作画像（2〜6枚目）】 同梱の合成データと販売ZIPのコードによる実行結果から、項目を抜粋して再構成しました。顧客データは使用していません。 2. 公開URLの合成対象を設定し、CLIで設定を検証。 3. 合成HTMLを2回取得し、初回版と本文変更版を記録。 4. 2版の正規化テキスト差分を確認。 5. 選択した版を書き出し、ZIPとSHA-256チェックサムを生成。 6. 監視状態を確認。販売ZIPで自動テスト116件が成功。 【対象者】 ・規約、価格、告知、行政資料などの変更監視を実装する開発者 ・公開情報の版管理をSaaSや社内ツールへ追加したいチーム ・顧客向け監視業務の共通基盤を持ちたい受託開発者 【含まれないもの】 ホスティング、運用代行、ログインが必要なサイトの取得、ブラウザ自動操作、CAPTCHA回避、広範囲クローリング、画像だけのPDFへのOCR、法的な証拠能力の保証、個別カスタマイズは含まれません。 【動作要件】 Node.js 22.13以上、npm、SQLiteを利用できるローカルファイルシステム。Docker／Docker Composeは任意です。 【ライセンス】 1個人または1法人が、商用利用、改変、複数の社内プロジェクトでの利用、許可された顧客成果物への組み込みを行えます。本商品の再販売、再配布、公開リポジトリへの掲載、実質的に同等なテンプレートとしての再包装は禁止です。第三者ソフトウェアには各ライセンスが適用されます。同梱ライセンス全文が優先されます。 【サポート】 README／Quickstartの範囲内のセットアップ質問と、再現可能な商品不具合を対象とします。個別開発、特定サイト向けアダプター、導入代行、デプロイ、コンサルティング、SLA、回答時間保証、無期限更新は含みません。 【返金】 デジタル商品の性質上、ダウンロード後は原則返金不可です。ただし、重複購入、破損または利用不能なダウンロード、公開された商品説明との重大な相違、または適用法令上必要な場合は対応します。