AI Coding Assistant Lingma:コード補完のコンテキストとしてのナレッジベースのベストプラクティス

バックエンドのシナリオ

• [推奨] 高頻度のコードスニペットまたはファイルを選択する: 現在のプロジェクトで頻繁に表示されるか、再利用されるコードスニペットを選択します。これらのスニペットは再利用性が高く、ナレッジベースに含めるのに適しています。これらのスニペットを別のリポジトリに整理し、管理と取得を容易にするために別のナレッジベースにアップロードします。

• 現在のプロジェクトのコード: 取得を包括的に行うために、現在のプロジェクト全体をナレッジベースにアップロードすることもできます。これにより、コードの再利用性と開発効率が向上します。ただし、プロジェクトに干渉するコードや低品質のコードが含まれている場合、コード補完機能強化のパフォーマンスに影響を与える可能性があります。

フロントエンドのシナリオ

• [推奨] フロントエンドテンプレートページコードリポジトリ: 企業カスタムコンポーネントを、ログイン、登録、アカウント表示、送金ページなどの再利用性の高いフロントエンドページのテンプレートに組み立てます。企業にテンプレートライブラリがある場合は、企業コードナレッジベースにアップロードすることをお勧めします。

• 現在のプロジェクトのコードリポジトリ: 適切に構造化され、高品質のプロジェクトコードを企業ナレッジベースにアップロードして、包括的な取得を行います。リポジトリ内の低品質または干渉するコードは、コード補完のパフォーマンスに影響を与える可能性があります。

ケース 1: 企業フレームワークとミドルウェアロジックの再利用

企業は、在庫管理システムに統一された分散ロックメカニズムを必要としています。これは、ビジネスフレームワークをコードナレッジベースに統合することで実現できます。開発者は、IDE で新しいコードを記述するときに、これらのコードスニペットを簡単に使用できます。これにより、開発効率が向上し、反復開発が削減され、コード品質が向上し、ビジネスロジックの一貫性が確保されます。

コードリポジトリを選択して準備するためのヒントを以下に示します。

必要なビジネスニーズと実装を把握します。

• 在庫管理、注文処理、支払いシステムなど、システムで統一された実装が必要な主要なビジネスモジュールを特定します。

• 特定のビジネスシナリオの処理方法を設定します。たとえば、在庫システムには、在庫の削減、在庫レベルの確認、在庫のロックなど、さまざまなタスクがあり、各タスクには異なる実装メカニズムが必要です。

ビジネスフレームワークのコードファイルを選択し、コードナレッジベースにアップロードします。

• ビジネスフレームワークをフィルタリングして、主要なビジネスロジックを処理するコアコードを見つけ、整理して、別のコードナレッジベースにアップロードします。たとえば、更新中に安全に保つために分散ロックが必要な場合は、このロックを実装するメインコードを見つけます。

  /**
   * 企業が開発した分散ロックメカニズムを使用して、同時実行制御を実装します
   */
  @Service
  public class InventoryService {
      
      @Autowired
      private DistributedLockFramework lockFramework;
      
      @Autowired
      private InventoryRepository inventoryRepository;
      
      /**
       * 分散ロックメカニズムを使用して、在庫控除中の同時実行セキュリティを確保します
       * @param productId 製品 ID を指定します。
       * @param quantity 控除数量を指定します。
       * @return 控除が成功したかどうかを指定します。
       */
      public boolean deductInventory(Long productId, int quantity) {
          String lockKey = "inventory:" + productId;
          return lockFramework.withLock(lockKey, 30, TimeUnit.SECONDS, () -> {
              Inventory inventory = inventoryRepository.findByProductId(productId);
              if (inventory == null || inventory.getQuantity() < quantity) {
                  return false;
              }
              inventory.setQuantity(inventory.getQuantity() - quantity);
              inventoryRepository.save(inventory);
              return true;
          });
      }
  }

ケース 2: コアエンタープライズビジネスロジックの再利用

企業は、製品に単一のパーソナライズされた推奨ポリシーを設定したいと考えています。この場合、企業が開発したビジネスフレームワークを企業のコードナレッジベースに統合できます。その後、開発者は IDE でビジネスロジックを記述するときに、標準化されたコードスニペットを簡単に呼び出して再利用できます。これにより、開発効率が向上し、反復開発が削減され、コード品質が向上し、ビジネスロジックの一貫性と安定性が確保されます。

コードリポジトリを選択して準備するためのヒントを以下に示します。

必要なビジネスモジュールと実装を決定します。

• 主要なビジネスモジュールを特定します。商品推奨システムなど、システムで統一された実装が必要なビジネスの部分を見つけます。

• ビジネスアクションと主な手順を定義します。たとえば、パーソナライズされた推奨ポリシーには、ユーザー行動データの収集、ユーザーの興味のある機能の把握、可能性のある製品のリストの取得、これらの製品のスコアリングとランク付け、上位の選択肢の表示などの手順が含まれます。事前に記述されたコードを使用して、これらの手順を実装できます。

ビジネスフレームワークのコードファイルを選択し、コードナレッジベースにアップロードします。

• 主要なビジネスロジックを処理するメインコードを見つけ、整理して、別のコードナレッジベースにアップロードします。パーソナライズされた推奨ポリシーの例を次に示します。

  /**
   * 推奨エンジンサービス
   * ユーザーの行動と商品の特性に基づいてパーソナライズされた推奨を実装します
   */
  @Service
  public class RecommendationService {
      
      @Autowired
      private UserBehaviorRepository userBehaviorRepo;
      
      @Autowired
      private ProductRepository productRepo;
      
      /**
       * 指定されたユーザーの推奨リストを生成します
       * @param userId ユーザー ID を指定します。
       * @param limit 推奨できる商品の最大数を指定します。
       * @return 推奨商品の ID を指定します。
       */
      public List generateRecommendations(Long userId, int limit) {
          // ユーザー行動データを取得します
          List behaviors = userBehaviorRepo.findRecentByUserId(userId, 100);
          
          // ユーザーの興味のある機能を抽出します
          Map userInterests = extractUserInterests(behaviors);
          
          // 候補商品プールを取得します
          List candidateProducts = productRepo.findRecentlyActive(1000);
          
          // 商品スコアを計算してランク付けします
          List scoredProducts = candidateProducts.stream()
              .map(product -> new ScoredProduct(product, calculateScore(product, userInterests)))
              .sorted(Comparator.comparing(ScoredProduct::getScore).reversed())
              .collect(Collectors.toList());
          
          // スコアの高い商品を返します
          return scoredProducts.stream()
              .limit(limit)
              .map(sp -> sp.getProduct().getId())
              .collect(Collectors.toList());
      }
      
      // その他の補助メソッド
  }

ケース 3: 既存のプロジェクトを参照して新しいプロジェクトの効率を向上させる

企業が新しいプロジェクトを開始する場合、既存のプロジェクトの類似のコアモジュールのコードを使用できます。これにより、時間と費用が節約され、新しいプロジェクトの品質と安定性が向上します。

コードリポジトリを選択して準備するためのヒントを以下に示します。

必要なビジネスとシナリオに基づいて主要なビジネスモジュールを特定します。

• 類似の関数またはメソッドを特定します。たとえば、新規プロジェクトと古いプロジェクトの両方に、ユーザー管理、商品表示、注文処理などの関数がある場合は、関連するモジュールをリストします。

• コード品質を確認します。既存のプロジェクトコードが完全にテストされており、安定していて信頼できることを確認します。コードをクリーンで使いやすくするために、余分なファイルと構成を削除します。

特定のビジネスアクションとコアアクションを定義します。

• コア関数を抽出します。既存のプロジェクトから、再利用できる主要な機能モジュールのコードを抽出します。例:

  • ユーザー管理: ユーザー登録、ログイン、情報変更

  • 商品表示: 商品リスト、詳細ページ、検索機能

  • 注文処理: 注文、支払い処理、注文ステータスの更新

関連するビジネスフレームワークのコードファイルを選択し、コードナレッジベースにアップロードします。モジュール構造を使用して既存のプロジェクトのコードを再編成します。これにより、新しいプロジェクトの特定のモジュールを担当する異なるチームのコードが分離されます。モジュールごとに個別のコードリポジトリを作成します。

• コードナレッジベースの分離: 既存のプロジェクトのコードを適切なナレッジベースにアップロードします。たとえば、ユーザー管理、商品表示、注文処理モジュールのコードを個別のナレッジベースにアップロードします。

• 権限管理: 適切なチームのみが特定のコードにアクセスできるように権限を設定します。これにより、IDE でのコード補完中の干渉を防ぎます。