feat(M08-C): 建立管理员房态运营入口

backend/src/routes/store-room-management.ts

@@ -64,11 +64,21 @@ const disabledPeriodSchema = z.object({
   endsAt: z.coerce.date(),
   reason: z.string().trim().max(255).default('')
 }).refine((value) => value.endsAt > value.startsAt);
+const roomStatusSchema = z.object({
+  storeId: z.string().regex(/^[1-9]\d{0,19}$/),
+  configurationStatus: z.enum(['ENABLED', 'DISABLED']).optional(),
+  operationalStatus: z.enum([
+    'AVAILABLE', 'MAINTENANCE', 'RESERVED', 'IN_USE', 'CLEANING_REQUIRED'
+  ]).optional(),
+  reason: z.string().trim().min(1).max(255)
+}).strict().refine((value) => value.configurationStatus || value.operationalStatus, {
+  message: 'at least one room status is required'
+});
 
 export interface StoreRoomRouteOptions {
   repository: Pick<StoreRoomRepository,
     'listStores' | 'createStore' | 'updateStore' | 'archiveStore' | 'listRooms'
-    | 'createRoom' | 'updateRoom' | 'archiveRoom' | 'addDisabledPeriod'>;
+    | 'createRoom' | 'updateRoom' | 'updateRoomStatus' | 'archiveRoom' | 'addDisabledPeriod'>;
   authRepository: Pick<AuthRepository, 'validateSession'>;
   accessControl: { getAccessProfile(tenantId: string, userId: string): Promise<AccessProfile> };
   jwtSecret: string;
@@ -80,6 +90,11 @@ export async function registerStoreRoomRoutes(app: FastifyInstance, options: Sto
     if (!actor) return;
     return { code: 0, data: await options.repository.listStores(actor), traceId: request.traceId };
   });
+  app.get('/app-api/management/stores', async (request, reply) => {
+    const actor = await requireOperator(request, reply, options);
+    if (!actor) return;
+    return { code: 0, data: await options.repository.listStores(actor), traceId: request.traceId };
+  });
   app.post('/admin-api/stores', async (request, reply) => {
     const actor = await requireOperator(request, reply, options);
     const body = storeSchema.safeParse(request.body);
@@ -119,6 +134,15 @@ export async function registerStoreRoomRoutes(app: FastifyInstance, options: Sto
       traceId: request.traceId
     }));
   });
+  app.get('/app-api/management/stores/:storeId/rooms', async (request, reply) => {
+    const actor = await requireOperator(request, reply, options);
+    const params = storeIdSchema.safeParse(request.params);
+    if (!actor || !params.success) return actor ? invalid(reply, request.traceId) : undefined;
+    return mutate(reply, request.traceId, async () => ({
+      code: 0, data: await options.repository.listRooms(actor, params.data.storeId),
+      traceId: request.traceId
+    }));
+  });
   app.post('/admin-api/rooms', async (request, reply) => {
     const actor = await requireOperator(request, reply, options);
     const body = roomSchema.safeParse(request.body);
@@ -140,6 +164,21 @@ export async function registerStoreRoomRoutes(app: FastifyInstance, options: Sto
       traceId: request.traceId
     }));
   });
+  for (const path of ['/admin-api/rooms/:id/status', '/app-api/management/rooms/:id/status']) {
+    app.patch(path, async (request, reply) => {
+      const actor = await requireOperator(request, reply, options);
+      const params = idSchema.safeParse(request.params);
+      const body = roomStatusSchema.safeParse(request.body);
+      if (!actor || !params.success || !body.success) {
+        return actor ? invalid(reply, request.traceId) : undefined;
+      }
+      return mutate(reply, request.traceId, async () => ({
+        code: 0,
+        data: await options.repository.updateRoomStatus(actor, params.data.id, body.data),
+        traceId: request.traceId
+      }));
+    });
+  }
   app.delete('/admin-api/rooms/:id', async (request, reply) => {
     const actor = await requireOperator(request, reply, options);
     const params = idSchema.safeParse(request.params);