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>
51 lines
3.0 KiB
Markdown
51 lines
3.0 KiB
Markdown
## 参考スクリプト ※必読
|
||
* 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 を用いた、一覧・詳細編集・新規登録・ログ閲覧画面の構築。
|
||
|
||
------------------------------ |