ce58cb4be4
GitHub(nextgroup2706/ken_nogi)は今後使わず自社Gitea運用に切替え。 NodeSrvは旧リポジトリの履歴を破棄しファイルのみ統合(Dokploy用サービスアカウントは 別途mygit-admin/NodeSrv.gitに履歴あり)。notepmエクスポート(12GB)とPleasanter インストーラzip(208MB)はサイズが大きいため.gitignoreで除外。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
3.0 KiB
3.0 KiB
参考スクリプト ※必読
- 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への指示順序）
- 環境構築 & 認証実装:
- Dokployデプロイを見据えた Dockerfile の作成。
- Keycloakと連携したログイン・セッション管理の実装。
- LINE WORKS APIクライアントの移植:
- Samples\LINEWORKS_scripts\createLINEWORKSGroup.js の認証ロジック、各APIコール（一覧・詳細・登録・更新・削除）の関数化。
- バックエンドAPI実装:
- フロントエンドから呼び出すための各エンドポイント、およびログ記録ロジックの実装。
- フロントエンドUI実装:
- shadcn/ui を用いた、一覧・詳細編集・新規登録・ログ閲覧画面の構築。