開発・検証方針

HUBLO Free（無料テーマ）・デザインパック・HUBLO Pro Plugins（WP Product Release & Download Manager・WP Content Access Gate Lite・WP Safe Update & Visual Check Manager等を含む）の開発・検証にあたっての方針を説明します。

HUBLOの開発方針

HUBLOは、「作って終わり」ではなく「実際に動くことを確認してから届ける」ことを重視して開発しています。企画・仕様検討・実装・検証・ドキュメント作成という一連の流れを経てから、商品として公開する方針を取っています。

AI活用について

HUBLOの商品は、AI（Claude Code等）を設計・実装・ドキュメント作成の支援ツールとして活用しています。これは隠さずお伝えします。

ただし、AIが生成したコードをそのまま検証なしに販売することはしていません。すべての商品は、後述する実機確認・自動テスト・ログ確認のプロセスを経てから、販売可否を判断しています。AIは「初稿を作るための道具」であり、「検証を代行するもの」ではないという位置づけです。

開発の流れ

1. 企画・仕様検討：解決したい課題・機能範囲・「やらないこと」を先に整理します
2. 実装：WordPressコーディング規約に沿って実装します
3. 静的検証：PHP構文チェック（`php -l`）でエラーがないことを確認します
4. 実機確認：LocalWP環境に実際にインストール・有効化し、管理画面・公開ページの両方で動作を確認します
5. 自動テスト：WP-CLIによる機能テスト、Playwrightによるブラウザ操作の自動テストを実施します
6. ログ確認：debug.logを確認し、プラグイン起因の新規エラーが出ていないことを確認します
7. 再インストール確認：配布用ZIPファイルから実際に新規インストール・有効化を行い、開発環境限定の問題が含まれていないかを確認します
8. ドキュメント作成：README・KNOWN_LIMITATIONS・使い方記事等を作成します
9. 販売ページ作成：できること・できないことを踏まえた商品ページ・FAQを作成します

実施している検証項目

• LocalWP実機確認：実際のWordPress環境にプラグイン・テーマをインストールし、管理画面・公開ページの両方で動作を確認しています
• PHP構文チェック（lint）：`php -l`によりPHPの構文エラーがないことを確認しています
• WP-CLI機能テスト：コマンドラインから、各機能が仕様どおりに動作するかを自動テストで確認しています
• Playwright E2Eテスト：実際のブラウザ操作を自動化したテストで、管理画面の操作・表示崩れ・エラー表示の有無を確認しています
• debug.log確認：プラグイン有効化直後・各種テスト実行後に、PHPのFatal error・Warning・Notice・Deprecatedが新たに発生していないかを確認しています
• ZIPからの新規インストール確認：配布用ZIPファイルから実際に新規インストール・有効化を行い、開発環境限定の問題が含まれていないかを確認しています

各商品の具体的なテスト件数・結果は商品ごとに内部記録として残していますが、購入者向けには各商品ページ・FAQ・KNOWN_LIMITATIONSの記載を通じて、できること／できないことを正直にお伝えする方針です。

実データ検証の限界について

上記の自動テスト（WP-CLI機能テスト・Playwright E2Eテスト・PHP構文チェック・debug.log確認）は、いずれも開発内部で用意した合成データ（テスト用フィクスチャ）を用いて実施しています。外部サービスが実際に出力する実データそのものを用いた検証ではありません。

特に、外部サービスの実データを取り込む形の商品（例：WP ASP Revenue & Journal CSV ManagerによるFANZA・DLsite・A8.net・もしもアフィリエイトの売上CSVインポート、会計ソフト（freee・マネーフォワード等）向けの仕訳CSV出力）については、本稿執筆時点で、各サービスから実際にエクスポートしたファイルを用いた実データ検証は行っていません。想定される列構成に合わせて作成した合成テスト用CSVでの検証にとどまります。

そのため、「公式CSV対応確認済み」「実データでの動作確認済み」といった、実データ検証が完了したかのような表現は、人間が実際に該当サービスから実CSVをエクスポートし、本商品で読み込んで結果を確認するまでは使用しません。対象商品によっては、実データ検証の手順を整理した確認ガイド（例：`products/wp-asp-revenue-journal-csv-manager/docs_for_seller/real_csv_validation_guide.md`）を用意している場合がありますが、ガイドの存在自体は実データ検証が完了したことを意味しません。すべての商品に同様のガイドが存在するとは限りません。

商品別の安全方針の要約

HUBLO Pro Plugins等の各商品は、機能に応じて安全設計のレベルが異なります。以下は工場全体で共通する設計原則の要約であり、各商品固有の詳細は各商品の`README.md`・`KNOWN_LIMITATIONS.md`をご確認ください。

• 検出・整理候補の提示までにとどめ、既存の投稿本文・タイトル等を自動で書き換えない商品があります
• 投稿データ・タクソノミー等を実際に書き換える商品もありますが、いずれも一括変更の実行前にプレビュー確認・確認テキスト入力（EXECUTE確認）等の誤操作防止の仕組みを経てからのみ実行される設計です
• いずれの商品も、記事・ページの自動投稿・自動公開（publish）は行いません
• いずれの商品も、外部サイトのスクレイピングは行いません
• いずれの商品も、第三者の管理画面への自動ログインは行いません
• いずれの商品も、商品ページ・READMEに明記されていない外部APIへの通信は行いません

これは工場全体に適用する一般的な設計方針であり、19商品それぞれの挙動を網羅的に列挙するものではありません。個別の挙動は各商品自身のドキュメントを正としてください。

できること・できないこと・既知の制限を明記する方針

各商品ページには、「できること」だけでなく「できないこと」「行わないこと」を必ず明記しています。また、各商品には`KNOWN_LIMITATIONS.md`（既知の制限事項）を用意しており、環境依存の注意点・意図的に実装していない機能を記載しています。購入前に必ずKNOWN_LIMITATIONSの内容をご確認ください。多くのお問い合わせは、既知の制限に該当している場合があります。

完全無欠を保証するものではありません

上記の検証プロセスを経ていますが、すべてのWordPress環境・サーバー環境・PHP設定・他プラグインとの組み合わせにおいて、不具合が一切発生しないことを保証するものではありません。「完全に防げる」「必ず安全」といった絶対的な保証はいたしません。ソフトウェアである以上、予期しない環境要因により意図しない挙動が生じる可能性があることをご理解のうえご利用ください。

導入前のバックアップを強く推奨します

本商品群は、いずれも自動バックアップ・自動ロールバック機能を持ちません（WP Safe Update & Visual Check Managerも、更新前後の確認材料を提供するツールであり、バックアップ機能そのものではありません）。プラグイン・テーマの導入前には、必ずサイト全体（データベース・ファイル）のバックアップを取得してください。可能であれば、本番環境ではなくテスト環境で先に動作確認することを推奨します。

不具合報告への姿勢

再現可能な不具合のご報告をいただいた場合、事象の確認・原因調査を行い、必要に応じて修正版を提供します。対応範囲・返信目安はサポート範囲ページをご確認ください。

アップデート方針

不具合修正・機能改善のアップデートは、新しいバージョンについても同様の検証プロセス（実機確認・自動テスト・ログ確認・再インストール確認）を経てから提供します。アップデート内容はCHANGELOGに記録します。

ご購入・ご利用の前に

• 各商品の`README.md`・使い方記事で、基本的な使い方をご確認ください
• 各商品の`KNOWN_LIMITATIONS.md`で、既知の制限事項をご確認ください
• ご利用前に必ずサイト全体のバックアップを取得してください
• 可能であれば、本番環境より先にテスト環境で動作確認を行ってください

サポート範囲はサポート範囲ページ、返金・キャンセルの取り扱いは返金・キャンセル方針ページをご確認ください。ご不明な点はお問い合わせページからご連絡ください。