Merge pull request #179 from kwnt-dev/chore/#178-frontend-comments-cleanup

chore: フロントエンドコメント追加・不要コード削除

Author: kwnt-dev

app/admin/cells/page.tsx

@@ -19,14 +19,14 @@ import { ConfirmDialog } from "@/components/ui/ConfirmDialog";
 
 type CellType = "damage" | "ban" | "rain";
 
-// 登録済みセルをcellId形式に変換（表示用）
+/** 登録済みセルをcellId形式に変換（表示用） */
 function groupsToCellIds(groups: CellGroup[], holeNumber: number): string[] {
   return groups
     .filter((g) => g.hole_number === holeNumber)
     .flatMap((g) => g.cells.map((c) => `cell_${c.x}_${c.y}`));
 }
 
-// 全ホールの登録済みセルマップ（GreenCardGrid用）
+/** 全ホールの登録済みセルマップ（GreenCardGrid用） */
 function groupsToCellsMap(groups: CellGroup[]): Record<number, string[]> {
   const map: Record<number, string[]> = {};
   groups.forEach((g) => {
@@ -38,6 +38,7 @@ function groupsToCellsMap(groups: CellGroup[]): Record<number, string[]> {
   return map;
 }
 
+/** セル設定ページ（左: 9ホール一覧、右: セル編集キャンバス） */
 export default function CellsEditPage() {
   const [course, setCourse] = useState<"out" | "in">("out");
   const [selectedHole, setSelectedHole] = useState<number>(1);
@@ -397,7 +398,6 @@ export default function CellsEditPage() {
               rainCells={cellMode === "rain" ? displayCells : []}
               onCellClick={handleCellClick}
               enablePaintMode={true}
-              activeCells={displayCells}
               showExit={false}
               showExitRoute={false}
               showBoundaryBuffer={false}

app/admin/history/page.tsx

@@ -14,6 +14,7 @@ import { Button } from "@/components/ui/button";
 import api from "@/lib/axios";
 import { PageHeader } from "@/components/layout/PageHeader";
 import { History as HistoryIcon, FileText } from "lucide-react";
+/** 日付ごとの履歴データ */
 type DateGroup = {
   date: string;
   eventName: string | null;
@@ -23,6 +24,7 @@ type DateGroup = {
   pdfUrl: string | null;
 };
 
+/** ピン履歴ページ（日付別の履歴一覧、PDF表示） */
 export default function HistoryPage() {
   const [histories, setHistories] = useState<DateGroup[]>([]);
   const [searchTerm, setSearchTerm] = useState("");

app/admin/page.tsx

@@ -15,6 +15,7 @@ import { HelpButton } from "@/components/ui/HelpButton";
 import { toast } from "sonner";
 import { Loader2 } from "lucide-react";
 
+/** セッションステータスのバッジ表示（未作成/作成中/公開中/確認済み/送信済み） */
 function StatusBadge({ session }: { session: PinSession | null }) {
   if (!session) {
     return (
@@ -54,6 +55,7 @@ function StatusBadge({ session }: { session: PinSession | null }) {
   }
 }
 
+/** 管理者ダッシュボード（左: コースグリッド、右: 自動提案 or ピン編集の二画面構成） */
 export default function DashboardPage() {
   const router = useRouter();
   const {

app/admin/pdf-preview/page.tsx

@@ -119,6 +119,8 @@ async function exportGridToImage(
 
 /**
  * OUT/INグリッドからPDF Blobを生成する共通処理
+ * Blob: PDFファイルのバイナリデータをメモリ上に保持するオブジェクト（Web API）
+ * ダウンロード時はBlobからURL生成、送信時はBlobからBase64に変換して使う
  */
 async function generatePdfBlob(
   outRef: React.RefObject<HTMLDivElement | null>,
@@ -154,6 +156,7 @@ function blobToBase64(blob: Blob): Promise<string> {
   });
 }
 
+/** PDFプレビュー画面の本体（セッションからピン取得→OUT/INグリッド表示→PDF生成・送信） */
 function PDFPreviewContent() {
   const outRef = useRef<HTMLDivElement>(null);
   const inRef = useRef<HTMLDivElement>(null);
@@ -312,6 +315,7 @@ function PDFPreviewContent() {
   );
 }
 
+/** PDFプレビューページ（useSearchParams: URLのクエリパラメータを取得するNext.jsフック。Suspense境界が必要） */
 export default function PDFPreviewPage() {
   return (
     <Suspense fallback={<Loading />}>

app/admin/schedule/page.tsx

@@ -28,6 +28,7 @@ import { HelpButton } from "@/components/ui/HelpButton";
 import { toast } from "sonner";
 import { ConfirmDialog } from "@/components/ui/ConfirmDialog";
 
+/** 予定データの型 */
 type Schedule = {
   id: string;
   date: string;
@@ -36,6 +37,7 @@ type Schedule = {
   notes: string | null;
 };
 
+/** 予定表ページ（カレンダー形式でイベント名・組数を管理） */
 export default function SchedulePage() {
   const [currentMonth, setCurrentMonth] = useState(() => new Date());
   const [schedules, setSchedules] = useState<Schedule[]>([]);

app/admin/users/page.tsx

@@ -24,6 +24,7 @@ import { Users } from "lucide-react";
 import { toast } from "sonner";
 import { ConfirmDialog } from "@/components/ui/ConfirmDialog";
 
+/** ユーザーデータの型 */
 type User = {
   id: string;
   name: string;
@@ -32,6 +33,7 @@ type User = {
   created_at: string;
 };
 
+/** ユーザー管理ページ（一覧表示・新規追加・編集・削除） */
 export default function UsersPage() {
   const [users, setUsers] = useState<User[]>([]);
   const [isOpen, setIsOpen] = useState(false);

app/login/page.tsx

@@ -18,6 +18,7 @@ import api from "@/lib/axios";
 import { GolfIcon } from "@/components/ui/GolfIcon";
 import { RotateCcw } from "lucide-react";
 
+/** ログインページ */
 export default function LoginPage() {
   const [email, setEmail] = useState("");
   const [password, setPassword] = useState("");
@@ -26,6 +27,7 @@ export default function LoginPage() {
   const [resetting, setResetting] = useState(false);
   const [resetMessage, setResetMessage] = useState("");
 
+  // デモデータリセット（全データを初期状態に戻す）
   async function handleDemoReset() {
     if (resetting) return;
 
@@ -53,6 +55,7 @@ export default function LoginPage() {
     }
   }
 
+  // ログイン処理（成功後、roleに応じて管理者/スタッフ画面に遷移）
   async function handleSubmit(e: React.FormEvent) {
     e.preventDefault();
     setError("");

app/staff/hole/[id]/page.tsx

@@ -9,6 +9,7 @@ import { ThemeToggle } from "@/components/theme/ThemeToggle";
 import { getPinSessionDetail } from "@/lib/pinSession";
 import { useContainerSize } from "@/hooks/useContainerSize";
 
+/** スタッフ用ホール個別編集ページ（ピン位置の確認・修正・保存） */
 export default function StaffHoleEditPage() {
   const params = useParams();
   const searchParams = useSearchParams();
@@ -100,6 +101,7 @@ export default function StaffHoleEditPage() {
     loadCells();
   }, [holeNumber]);
 
+  // ピン保存（既存ピンを削除→新しい位置で再作成）
   async function handleSave() {
     if (!pin || !sessionId) return;
 

app/staff/page.tsx

@@ -7,6 +7,7 @@ import { getPinSessions, PinSession } from "@/lib/pinSession";
 import { LogOut } from "lucide-react";
 import { ThemeToggle } from "@/components/theme/ThemeToggle";
 
+/** 日付文字列を「M/D（曜日）」形式に変換 */
 function formatDate(dateStr: string | null): string {
   if (!dateStr) return "";
   const date = new Date(dateStr + "T00:00:00");
@@ -17,6 +18,7 @@ function formatDate(dateStr: string | null): string {
   return `${month}/${day}（${weekday}）`;
 }
 
+/** スタッフホーム画面（OUT/INの選択画面） */
 export default function StaffPage() {
   const router = useRouter();
   const { user, logout } = useAuth();