中小企業のためのオープンソース活用|第9回

「記事が増えてきたので、カテゴリとキーワードで探せるようにしたい」「CRMの画面に担当者名が出ず、代わりに番号が表示される」。こうした改善を、自社でどこまで進められるでしょうか。

ソースコードを確認できるOSSでは、AIに現象と関連コードを渡し、原因の候補や修正案を一緒に整理できます。アイプランナーで実際に進めたWordPressのプラグイン開発と、VtigerCRM OSS 8.4の不具合修正を例に、どこから着手し、何を試して公開し、更新後もどう維持するかを紹介します。

まず、設定・拡張・本体修正のどこで解決できるかを確認する

「案件の一覧で必要な情報をすぐ見たい」という相談なら、最初に表示項目や絞り込みの設定を確かめます。既存設定で足りない場合は、プラグインや拡張モジュールで追加できるかを調べます。本体側の処理に原因がある場合は、修正範囲と更新時の影響を見積もってから判断します。

要望に合わせた着手方法
方法向いている例進める前に確かめること
標準設定CRMの一覧表示、項目の配置、絞り込み変更前の設定を控え、対象の利用者ロールで目的の操作ができるかを見る。
プラグイン・拡張WordPressの記事ナビ、定型業務向けの画面や通知既存の拡張を使えるか、機能を外した場合に何が残るかを確かめる。
本体の修正標準処理の不具合で、設定や拡張で回避できない場合公式の修正情報と対象バージョンを調べ、適用差分を更新時に確認できるようにする。

利用者を限った表示改善なら、社内で試しやすく、動作も目で確かめられます。一方、認証、顧客ごとの閲覧権限、金額計算、大量のデータ更新は、変更箇所が小さくても業務への影響が大きい領域です。実装案の検討にAIを使いつつ、こうした変更は経験のある担当者や保守先にレビューを依頼します。

事例1|WordPressの記事を探しやすくする「IP Site Plus」

このサイトでは、WordPressで記事を管理し、Emanon Freeで基本の表示を整えています。記事のカテゴリ・キーワード検索や、利用ガイドの配布には、AIを活用して開発した独自プラグイン「IP Site Plus」を使っています。「記事ナビ」を固定ページに置き、公開記事を条件で探せるようにしました。

実際の運用では、日本語を変換している途中に検索が実行されたり、PCで使うメニュー設定がスマートフォンの表示に影響したりする問題が見つかりました。こうした問題は、実際に記事を探す読者と同じ操作をして確認します。たとえば「しょうだん」を「商談」に変換し、文字を確定するまでは検索結果が切り替わらないかを見る。一度見つかった操作を確認手順に残しておけば、検索やメニューを更新したときにも試せます。

機能をプラグインにまとめると、テーマを直接編集せずに配備でき、追加機能の差分も追いやすくなります。試作の合格条件に「ログアウト状態で下書きが検索結果に出ない」「カテゴリを選んでから検索しても、その条件が維持される」を加えると、公開時の確認も具体的になります。

事例2|VtigerCRM OSS 8.4の不具合を、症状から絞り込む

VtigerCRM OSS 8.4では、ChatGPTを使って、症状から調べる箇所を絞り、修正差分や確認項目を整理しました。次の2件は、アイプランナーで修正を適用し、結果を確認した事例です。

標準Webフォームで空欄が「0」になる

管理画面の上書き値を空欄にして保存すると、開き直したときに「0」と表示される問題です。フォーム設定を保存する処理を見直し、空欄は未設定として扱い、明示した「0」は入力値として保持するようにしました。適用後、空欄が「0」に変わる問題の解消を確認しました。別の環境で検証する場合は、空欄と「0」に加え、文字列を固定したときの保存結果と、テスト送信後にCRMへ入る値を照合します。

顧客ポータルで担当者名の代わりに「19×1」が出る

顧客ポータルの問い合わせ一覧と詳細で、担当者の内部IDが表示される問題です。CRM側APIの呼び出しを確認し、既存の名称変換処理に必要なユーザー情報を渡すようにしました。適用後、担当者名の表示を確認し、修正箇所をVtigerコミュニティにも掲載しました。この種の変更を検証するときは、一覧と詳細の両方を開き、表示名とあわせて顧客ごとの閲覧範囲を確かめます。

AIには、実装の前に「どの処理を確認するか」を聞く

  1. 現象と期待する結果を1つずつ書く。 操作手順、発生条件、対象バージョンを記録します。新機能なら、誰がどの画面で何をできれば完了かを決めます。
  2. 検証用データと関連コードを用意する。 本番と同じバージョン・設定に近い環境を用意し、架空データで再現します。AIに共有するログやコード片から、顧客情報、認証情報、APIキーを除きます。
  3. 原因の候補と根拠を確認する。 入力から保存、表示までどの処理がつながるかを説明させ、実際のコードで確かめます。変更候補のファイルが特定できたら、最小の差分とテスト項目を出してもらいます。
  4. 差分をレビューし、検証環境で動かす。 調査の対象外だった処理まで変わっていないか、利用者の権限や既存データへの影響がないかを確認します。

公開前に動作を確かめ、次の更新で再確認できるようにする

画面を開けたら、普段の担当者でも同じ操作ができるか、他の機能に影響が出ていないかを確認します。コードや設定を元に戻せることも事前に試し、エラーや権限の問題が出た場合に誰が切り戻しを判断するかを決めます。CRMやWordPressの更新時にも、検証環境で同じケースを試せるように、変更内容と一緒に残します。

改修の公開と更新を判断するための記録
確認項目記録する内容今回の例
再現と修正結果操作手順、修正前後の値、確認した環境と日付空欄、明示した「0」、固定の文字列を別々に保存し、開き直した結果を残す。
他の機能への影響確認した画面、権限、既存機能、端末顧客ポータルを別の取引先のテストユーザーでも開き、閲覧できる範囲を確認する。
元に戻す手順旧版のZIPやコード差分、設定とDBのバックアップ、復元手順、判断する人DBを書き換える改修では、旧コードとDBの互換性や、バックアップ復元で公開後の新規入力が失われる場合の扱いまで事前に決める。
製品を更新する日対象バージョン、変更ファイル、次に検証する人と項目本体更新に同じ不具合の修正が含まれるか確認し、必要な場合だけ自社の差分を新しい版に合わせて検証する。

コードの生成が早くなっても、動作検証と運用の時間は見積もりに残します。たとえば、資料一覧の更新にかかる月間の作業時間を測り、導入後に減った作業時間と、開発・検証・次回アップデートに使う時間を同じ表で比べます。担当者の交代時にテスト手順を引き継げるかも、自社で続けられるかを判断する材料になります。

最初の1件は、効果を自分たちで確かめられる改善から

「指定したカテゴリの記事を一覧にする」「営業が毎朝見る案件一覧の絞り込みを整える」など、改善前後の違いを利用者が確認できるものから始めます。標準設定で足りるかを試し、開発が必要なら小さな範囲で作って、動作確認と元に戻す手順まで一度通してみてください。そこでかかった時間と担当者に必要な知識が、次の改修を社内で進めるか、外部の支援を使うかの判断材料になります。