feat: add participant nickname search functionality and update related schemas

Author: ut42tech

apps/api/src/index.ts

@@ -8,6 +8,7 @@ import {
   createMentorRequestSchema,
   createPreRegistrationRequestSchema,
   historyBulkCheckOutRequestSchema,
+  participantSearchQuerySchema,
   participantsListQuerySchema,
   scanRequestSchema,
   updateMentorRequestSchema,
@@ -39,6 +40,7 @@ import {
   recordBulkCheckOut,
   recordCheckIn,
   recordCheckOut,
+  searchActiveParticipantsByNickname,
 } from './lib/checkin';
 import { createParticipantDriveFolder } from './lib/drive-folder';
 import {
@@ -570,6 +572,23 @@ app.post('/checkin/history/check-out-bulk', async (c) => {
   }
 });
 
+// マニュアル入力画面のニックネーム検索。`:participantId` ルートより前に
+// 登録する必要があるので注意（Hono は登録順マッチ）。
+app.get('/checkin/participants/search', async (c) => {
+  const parsed = participantSearchQuerySchema.safeParse({ q: c.req.query('q') });
+  if (!parsed.success) {
+    return c.json(invalidQueryError, 400);
+  }
+
+  const db = createDb(c.env);
+  try {
+    const items = await searchActiveParticipantsByNickname(db, parsed.data.q);
+    return c.json({ participants: items });
+  } catch (e) {
+    return c.json(internalError(e), 500);
+  }
+});
+
 // 受付専用の参加者プロフィール。QR/手入力後はまずここを表示し、
 // 現在の状態に応じた操作だけをフロントに出す。
 app.get('/checkin/participants/:participantId', async (c) => {

apps/api/src/lib/checkin.ts

@@ -1,8 +1,8 @@
 import type * as schema from '@tecnova/db';
 import { events, participants, sessions } from '@tecnova/db';
 import { fetchSheetRows, updateSheetRow } from '@tecnova/shared/google-sheets';
-import type { TodaySessionsResponse } from '@tecnova/shared/schemas';
-import { and, desc, eq, inArray, isNull, like } from 'drizzle-orm';
+import type { ParticipantSearchItem, TodaySessionsResponse } from '@tecnova/shared/schemas';
+import { and, asc, desc, eq, inArray, isNull, like } from 'drizzle-orm';
 import type { DrizzleD1Database } from 'drizzle-orm/d1';
 
 type Db = DrizzleD1Database<typeof schema>;
@@ -424,6 +424,26 @@ export const fetchParticipantProfile = async (
   };
 };
 
+// マニュアル入力画面のニックネーム検索。QR が読めない場面で使うので
+// 件数は実用上の上限（同名複数 + タイポ救済）として 50 件に制限する。
+export const searchActiveParticipantsByNickname = async (
+  db: Db,
+  query: string,
+  limit = 50,
+): Promise<ParticipantSearchItem[]> => {
+  const rows = await db
+    .select({
+      id: participants.id,
+      nickname: participants.nickname,
+      grade: participants.grade,
+    })
+    .from(participants)
+    .where(and(eq(participants.active, true), like(participants.nickname, `%${query}%`)))
+    .orderBy(asc(participants.nickname), asc(participants.id))
+    .limit(limit);
+  return rows;
+};
+
 export const fetchReceptionHistoryToday = async (db: Db): Promise<TodaySessionsResponse> => {
   const [event] = await db
     .select({ id: events.id, date: events.date })