## 参考スクリプト ※必読
* Samples\LINEWORKS_scripts\createLINEWORKSGroup.js
LINEWORKSへの認証関連もすべて記述されているものを流用。

## 開発要件書：LINE WORKS メーリングリスト管理WEBアプリケーション## 1. 概要
本プロジェクトは、LINE WORKS上のメーリングリスト（ML）専用グループをWeb画面から一元管理するアプリケーションです。既存のコマンドライン（CLI）スクリプトのロジックを移植し、直感的なUIで操作可能にします。
## 2. システム構成・技術スタック

* バックエンド: Node.js (Express または Hono)
* フロントエンド: React + Vite (または Next.js App Router)
* UIコンポーネント: shadcn/ui + Tailwind CSS
* 認証基盤: 既存Keycloak（OIDC連携）
* インフラ: 自社設置 Dokploy サーバー（Dockerコンテナデプロイ）
* 外部API: LINE WORKS API 2.0

## 3. 機能要件## ① グループ一覧表示機能

* 取得条件：LINE WORKS上のグループのうち、グループ名が 【ML】 から始まるもののみを抽出して一覧表示。
* 画面要素：データテーブル（検索・ソート機能付き）。

## ② グループ詳細・編集機能

* 選択したグループの「マスター（管理者）」および「メンバー」の構成員一覧を取得・表示。
* 画面上からマスター/メンバーの追加・削除操作。
* 保存ボタンでLINE WORKS APIへ変更を反映。

## ③ 新規グループ登録機能

* フォームから必要事項を入力し、LINE WORKSへ新規グループを登録。
* 設定パラメータ：既存の参考スクリプト（createLINEWORKSGroup.js）の仕様を完全踏襲。
* バリデーション：グループ名先頭に自動で 【ML】 を付与、または必須入力化。

## ④ 処理ログ保存・閲覧機能

* 「誰が」「いつ」「どのグループに」「どのような変更（追加/削除/変更）を行ったか」を記録。
* ログの保存先：SQLite または 簡易ファイル/DB（DokployのVolumeに永続化）。
* 画面上から過去の処理ログをタイムラインまたはテーブル形式で閲覧可能。

## 4. 開発ステップ（Claude Codeへの指示順序）

   1. 環境構築 & 認証実装:
   * Dokployデプロイを見据えた Dockerfile の作成。
      * Keycloakと連携したログイン・セッション管理の実装。
   2. LINE WORKS APIクライアントの移植:
   * Samples\LINEWORKS_scripts\createLINEWORKSGroup.js の認証ロジック、各APIコール（一覧・詳細・登録・更新・削除）の関数化。
   3. バックエンドAPI実装:
   * フロントエンドから呼び出すための各エンドポイント、およびログ記録ロジックの実装。
   4. フロントエンドUI実装:
   * shadcn/ui を用いた、一覧・詳細編集・新規登録・ログ閲覧画面の構築。
   
------------------------------