create-fullstack-scaffold 0.4.24 → 0.5.0

package/template/src/server/module-content/__tests__/isr.test.ts

@@ -0,0 +1,138 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+
+vi.mock('@server/module-content/services/content-service', () => ({
+  getContents: vi.fn(),
+  getContentById: vi.fn(),
+}))
+
+import { getContents, getContentById } from '@server/module-content/services/content-service'
+import type { MockContent } from '@server/test-utils/test-isr-helper'
+
+// Side-effect: register ISR routes into global registry
+import '@server/module-content/isr'
+
+const mockContentsData: MockContent[] = [
+  {
+    id: 'content-1',
+    title: 'Article One',
+    content: 'This is the first article body text that is long enough to be truncated.',
+    category: 'article',
+    status: 'published',
+    author: 'Author A',
+    tags: ['tag1', 'tag2'],
+    viewCount: 100,
+    likeCount: 10,
+    createdAt: '2024-01-01T00:00:00.000Z',
+    updatedAt: '2024-01-01T00:00:00.000Z',
+  },
+  {
+    id: 'content-2',
+    title: 'Tutorial Two',
+    content: 'A comprehensive tutorial about testing.',
+    category: 'tutorial',
+    status: 'published',
+    author: 'Author B',
+    tags: ['test', 'guide'],
+    viewCount: 200,
+    likeCount: 30,
+    createdAt: '2024-01-02T00:00:00.000Z',
+    updatedAt: '2024-01-02T00:00:00.000Z',
+  },
+]
+
+describe('Content Module ISR', () => {
+  beforeEach(() => {
+    vi.clearAllMocks()
+  })
+
+  describe('route registration', () => {
+    it('should register /content route', async () => {
+      const { isrRegistry } = await import('@server/core/isr-registry')
+      expect(isrRegistry.match('/content')).not.toBeNull()
+      expect(isrRegistry.match('/content')!.module).toBe('content')
+    })
+
+    it('should register /content/ prefix', async () => {
+      const { isrRegistry } = await import('@server/core/isr-registry')
+      expect(isrRegistry.match('/content/content-1')).not.toBeNull()
+      expect(isrRegistry.match('/content/content-1')!.module).toBe('content')
+    })
+
+    it('should not match /content for prefix entry', async () => {
+      const { isrRegistry } = await import('@server/core/isr-registry')
+      // /content should match the exact entry, not prefix
+      const exact = isrRegistry.match('/content')
+      expect(exact).not.toBeNull()
+      // The exact /content entry should fetch list data
+      vi.mocked(getContents).mockResolvedValue({
+        contents: mockContentsData,
+        total: 2,
+        page: 1,
+        limit: 20,
+      })
+      const data = await exact!.fetch('/content', {})
+      expect(data).toHaveProperty('contents')
+      expect(data).toHaveProperty('total')
+    })
+  })
+
+  describe('/content — list page', () => {
+    it('should fetch content list', async () => {
+      vi.mocked(getContents).mockResolvedValue({
+        contents: mockContentsData,
+        total: 2,
+        page: 1,
+        limit: 20,
+      })
+
+      const { isrRegistry } = await import('@server/core/isr-registry')
+      const entry = isrRegistry.match('/content')!
+      const data = (await entry.fetch('/content', {})) as { contents: MockContent[]; total: number }
+
+      expect(data.contents).toHaveLength(2)
+      expect(data.total).toBe(2)
+    })
+
+    it('should return correct list meta', async () => {
+      const { isrRegistry } = await import('@server/core/isr-registry')
+      const entry = isrRegistry.match('/content')!
+      const meta = entry.meta({}, '/content')
+      expect(meta.title).toContain('内容中心')
+    })
+  })
+
+  describe('/content/:id — detail page', () => {
+    it('should fetch content detail', async () => {
+      vi.mocked(getContentById).mockResolvedValue(mockContentsData[0])
+
+      const { isrRegistry } = await import('@server/core/isr-registry')
+      const entry = isrRegistry.match('/content/content-1')!
+      const data = (await entry.fetch('/content/content-1', {})) as { content: MockContent | null }
+
+      expect(data.content).not.toBeNull()
+      expect(data.content!.title).toBe('Article One')
+    })
+
+    it('should return detail meta with title', async () => {
+      vi.mocked(getContentById).mockResolvedValue(mockContentsData[0])
+
+      const { isrRegistry } = await import('@server/core/isr-registry')
+      const entry = isrRegistry.match('/content/content-1')!
+      const data = await entry.fetch('/content/content-1', {})
+      const meta = entry.meta(data, '/content/content-1')
+
+      expect(meta.title).toContain('Article One')
+    })
+
+    it('should return not-found meta for missing content', async () => {
+      vi.mocked(getContentById).mockResolvedValue(null)
+
+      const { isrRegistry } = await import('@server/core/isr-registry')
+      const entry = isrRegistry.match('/content/missing')!
+      const data = await entry.fetch('/content/missing', {})
+      const meta = entry.meta(data, '/content/missing')
+
+      expect(meta.title).toContain('内容不存在')
+    })
+  })
+})

package/template/src/server/module-content/isr.ts

@@ -0,0 +1,63 @@
+/**
+ * Content module ISR routes (meta-only).
+ * Registered into isrRegistry at import time.
+ * Fetches data for SEO meta tags — body rendering handled by React SPA.
+ */
+
+import { isrRegistry, type ISRRouteEntry } from '@server/core/isr-registry'
+import { getContents, getContentById } from './services/content-service'
+
+interface ContentListData {
+  contents: Array<{ id: string; title: string; category: string; author: string }>
+  total: number
+}
+
+interface ContentDetailData {
+  content: { id: string; title: string; content: string; author: string } | null
+}
+
+async function fetchContentList(): Promise<ContentListData> {
+  const { contents, total } = await getContents({ limit: 20 })
+  return { contents, total }
+}
+
+async function fetchContentDetail(pathname: string): Promise<ContentDetailData> {
+  const id = pathname.replace('/content/', '')
+  const content = await getContentById(id)
+  return { content }
+}
+
+function contentListMeta(): { title: string; description: string } {
+  return {
+    title: '内容中心 - Biomimic App',
+    description: 'Content management with categories and search',
+  }
+}
+
+function contentDetailMeta(data: ContentDetailData): { title: string; description: string } {
+  const c = data.content
+  if (!c) {
+    return { title: '内容不存在 - Biomimic App', description: '请求的内容不存在' }
+  }
+  return {
+    title: `${c.title} - Biomimic App`,
+    description: c.content?.substring(0, 160) || '内容详情',
+  }
+}
+
+const contentEntries: ISRRouteEntry[] = [
+  {
+    module: 'content',
+    match: '/content',
+    fetch: () => fetchContentList(),
+    meta: () => contentListMeta(),
+  },
+  {
+    module: 'content',
+    match: '/content/',
+    fetch: pathname => fetchContentDetail(pathname),
+    meta: data => contentDetailMeta(data as ContentDetailData),
+  },
+]
+
+isrRegistry.registerMany(contentEntries)

package/template/src/server/module-content/routes/content-routes.ts

@@ -5,12 +5,12 @@ import { successResponse, errorResponse, success, created } from '@server/utils/
 import { NotFoundError } from '@server/utils/app-error'
 import { authMiddleware } from '@server/middleware/auth'
 import { Permission } from '@shared/modules/permission'
-import { z } from '@hono/zod-openapi'
 import {
   ContentSchema,
   CreateContentSchema,
   UpdateContentSchema,
-  ContentListSchema,
+  ContentListResponseSchema,
+  ContentListQuerySchema,
   ContentDeleteResultSchema,
 } from '@shared/modules/content'
 import { BusinessError } from '@server/utils/app-error'
@@ -22,13 +22,10 @@ const listRoute = createRoute({
   security: [{ Bearer: [] }],
   middleware: [authMiddleware({ requiredPermissions: [Permission.CONTENT_VIEW] })],
   request: {
-    query: z.object({
-      limit: z.coerce.number().int().positive().max(100).default(20),
-      offset: z.coerce.number().int().min(0).default(0),
-    }),
+    query: ContentListQuerySchema,
   },
   responses: {
-    200: successResponse(ContentListSchema, 'List all contents'),
+    200: successResponse(ContentListResponseSchema, 'List all contents'),
   },
 })
 
@@ -140,9 +137,9 @@ const archiveRoute = createRoute({
 
 export const contentRoutes = new OpenAPIHono()
   .openapi(listRoute, async c => {
-    const { limit, offset } = c.req.valid('query')
-    const result = await contentService.getContents()
-    return c.json(success(result.slice(offset, offset + limit)), 200)
+    const { page, limit } = c.req.valid('query')
+    const result = await contentService.getContents({ page, limit })
+    return c.json(success(result), 200)
   })
   .openapi(getRoute, async c => {
     const { id } = c.req.valid('param')
@@ -180,3 +177,6 @@ export const contentRoutes = new OpenAPIHono()
     if (!result) throw new BusinessError('Content cannot be archived (must be in published state)')
     return c.json(success(result), 200)
   })
+
+/** 模块级窄类型（深度 = 1 个模块）— 供 rpc-surface 门面使用，禁止再向上合并 */
+export type ContentsApiType = typeof contentRoutes

package/template/src/server/module-content/routes/public-content-routes.ts

@@ -15,8 +15,8 @@ const listPublicRoute = createRoute({
     query: z.object({
       category: ContentCategorySchema.optional(),
       search: z.string().optional(),
+      page: z.coerce.number().int().positive().default(1),
       limit: z.coerce.number().int().positive().max(50).default(20),
-      offset: z.coerce.number().int().min(0).default(0),
     }),
   },
   responses: {
@@ -39,14 +39,15 @@ const getPublicRoute = createRoute({
 
 export const publicContentRoutes = new OpenAPIHono()
   .openapi(listPublicRoute, async c => {
-    const { category, search, limit, offset } = c.req.valid('query')
+    const { category, search, page, limit } = c.req.valid('query')
     const result = await contentService.getContents({
       status: 'published',
       category,
       search,
+      page,
+      limit,
     })
-    const items = result.slice(offset, offset + limit)
-    return c.json(success(items), 200)
+    return c.json(success(result), 200)
   })
   .openapi(getPublicRoute, async c => {
     const { id } = c.req.valid('param')
@@ -56,3 +57,6 @@ export const publicContentRoutes = new OpenAPIHono()
     }
     return c.json(success(result), 200)
   })
+
+/** 模块级窄类型（深度 = 1 个模块）— 供 rpc-surface 门面使用，禁止再向上合并 */
+export type PublicContentApiType = typeof publicContentRoutes

package/template/src/server/module-content/routes/topics-routes.ts

@@ -453,3 +453,6 @@ export const topicsRoutes = new OpenAPIHono()
       },
     })
   })
+
+/** 模块级窄类型（深度 = 1 个模块）— 供 rpc-surface 门面使用，禁止再向上合并 */
+export type TopicsApiType = typeof topicsRoutes

package/template/src/server/module-content/services/content-service.ts

@@ -88,8 +88,13 @@ export async function getContents(filters?: {
   category?: ContentCategory
   status?: ContentStatus
   search?: string
-}): Promise<Content[]> {
+  page?: number
+  limit?: number
+}): Promise<{ contents: Content[]; total: number; page: number; limit: number }> {
   const db = await getDb()
+  const page = filters?.page ?? 1
+  const limit = filters?.limit ?? 20
+  const offset = (page - 1) * limit
   const conditions = []
 
   if (filters?.category) {
@@ -105,16 +110,24 @@ export async function getContents(filters?: {
     )
   }
 
-  const rows =
-    conditions.length > 0
-      ? await db
-          .select()
-          .from(contents)
-          .where(and(...conditions))
-          .orderBy(desc(contents.createdAt))
-      : await db.select().from(contents).orderBy(desc(contents.createdAt))
+  const baseQuery = conditions.length > 0 ? and(...conditions) : undefined
 
-  return rows.map(mapContentRow)
+  // SQL 分页（避免全表扫 + 内存 slice）
+  const rows = await db
+    .select()
+    .from(contents)
+    .where(baseQuery)
+    .orderBy(desc(contents.createdAt))
+    .limit(limit)
+    .offset(offset)
+  const total = await db.$count(contents, baseQuery)
+
+  return {
+    contents: rows.map(mapContentRow),
+    total,
+    page,
+    limit,
+  }
 }
 
 export async function getContentById(id: string): Promise<Content | null> {

package/template/src/server/module-dispute/__tests__/dispute-route.test.ts

@@ -22,7 +22,8 @@ describe('Dispute Routes', () => {
       const data = await res.json()
       expect(data.success).toBe(true)
       if (data.success) {
-        expect(Array.isArray(data.data)).toBe(true)
+        expect(data.data.disputes).toBeDefined()
+        expect(typeof data.data.total).toBe('number')
       }
     })
   })

package/template/src/server/module-dispute/__tests__/dispute-service.test.ts

@@ -17,7 +17,8 @@ describe('Dispute Service', () => {
   describe('getDisputes', () => {
     it('should return all disputes', async () => {
       const result = await service.getDisputes()
-      expect(Array.isArray(result)).toBe(true)
+      expect(result.disputes).toBeDefined()
+      expect(typeof result.total).toBe('number')
     })
   })
 

package/template/src/server/module-dispute/routes/dispute-routes.ts

@@ -1,4 +1,4 @@
-import { createRoute, z } from '@hono/zod-openapi'
+import { createRoute } from '@hono/zod-openapi'
 import { OpenAPIHono } from '@hono/zod-openapi'
 import * as disputeService from '../services/dispute-service'
 import {
@@ -15,7 +15,8 @@ import {
   DisputeSchema,
   CreateDisputeSchema,
   UpdateDisputeSchema,
-  DisputeListSchema,
+  DisputeListResponseSchema,
+  DisputeListQuerySchema,
   ResolveDisputeSchema,
   DisputeDeleteResultSchema,
 } from '@shared/modules/dispute'
@@ -28,13 +29,10 @@ const listRoute = createRoute({
   security: [{ Bearer: [] }],
   middleware: [authMiddleware({ requiredPermissions: [Permission.DISPUTE_VIEW] })],
   request: {
-    query: z.object({
-      limit: z.coerce.number().int().positive().max(100).default(20),
-      offset: z.coerce.number().int().min(0).default(0),
-    }),
+    query: DisputeListQuerySchema,
   },
   responses: {
-    200: successResponse(DisputeListSchema, 'List all disputes'),
+    200: successResponse(DisputeListResponseSchema, 'List all disputes'),
     401: errorResponse('Unauthorized'),
     403: errorResponse('Forbidden'),
   },
@@ -117,9 +115,9 @@ const resolveRoute = createRoute({
 
 export const disputeRoutes = new OpenAPIHono()
   .openapi(listRoute, async c => {
-    const { limit, offset } = c.req.valid('query')
-    const result = await disputeService.getDisputes()
-    return c.json(success(result.slice(offset, offset + limit)), 200)
+    const { page, limit } = c.req.valid('query')
+    const result = await disputeService.getDisputes({ page, limit })
+    return c.json(success(result), 200)
   })
   .openapi(getRoute, async c => {
     const { id } = c.req.valid('param')
@@ -152,3 +150,6 @@ export const disputeRoutes = new OpenAPIHono()
     if (!result) throw new BusinessError('Cannot resolve dispute in current state')
     return c.json(success(result), 200)
   })
+
+/** 模块级窄类型（深度 = 1 个模块）— 供 rpc-surface 门面使用，禁止再向上合并 */
+export type DisputesApiType = typeof disputeRoutes

package/template/src/server/module-dispute/services/dispute-service.ts

@@ -91,8 +91,13 @@ function mapDisputeRow(row: DisputeTable): Dispute {
 export async function getDisputes(filters?: {
   status?: DisputeStatus
   type?: DisputeType
-}): Promise<Dispute[]> {
+  page?: number
+  limit?: number
+}): Promise<{ disputes: Dispute[]; total: number; page: number; limit: number }> {
   const db = await getDb()
+  const page = filters?.page ?? 1
+  const limit = filters?.limit ?? 20
+  const offset = (page - 1) * limit
   const conditions = []
 
   if (filters?.status) {
@@ -102,7 +107,7 @@ export async function getDisputes(filters?: {
     conditions.push(eq(disputes.type, filters.type))
   }
 
-  const rows =
+  const allRows =
     conditions.length > 0
       ? await db
           .select()
@@ -111,7 +116,14 @@ export async function getDisputes(filters?: {
           .orderBy(desc(disputes.createdAt))
       : await db.select().from(disputes).orderBy(desc(disputes.createdAt))
 
-  return rows.map(mapDisputeRow)
+  const rows = allRows.slice(offset, offset + limit)
+
+  return {
+    disputes: rows.map(mapDisputeRow),
+    total: allRows.length,
+    page,
+    limit,
+  }
 }
 
 export async function getDisputeById(id: string): Promise<Dispute | null> {

package/template/src/server/module-file/routes/file-routes.ts

@@ -286,3 +286,6 @@ export const fileRoutes = new OpenAPIHono()
       200
     )
   })
+
+/** 模块级窄类型（深度 = 1 个模块）— 供 rpc-surface 门面使用，禁止再向上合并 */
+export type FilesApiType = typeof fileRoutes

package/template/src/server/module-merchant/routes/merchant-routes.ts

@@ -136,3 +136,6 @@ export const apiRoutes = new OpenAPIHono()
     const product = await merchantService.createProduct(merchant.id, input)
     return c.json(success(product), 201)
   })
+
+/** 模块级窄类型（深度 = 1 个模块）— 供 rpc-surface 门面使用，禁止再向上合并 */
+export type MerchantApiType = typeof apiRoutes

package/template/src/server/module-merchant/services/merchant-service.ts

@@ -92,7 +92,7 @@ export async function merchantLogin(
   }
 
   // Generate token (simplified for demo - use JWT in production)
-  const token = `merchant-token-${merchant.id}-${Date.now()}`
+  const token = `mt_${crypto.randomUUID().replace(/-/g, '')}`
 
   log.info({ merchantId: merchant.id }, 'Merchant logged in')
 
@@ -121,11 +121,11 @@ export async function getMerchantStats(merchantId: number): Promise<MerchantStat
   const allProducts = await db.select().from(products).where(eq(products.merchantId, merchantId))
   const activeProducts = allProducts.filter(p => p.status === 'active').length
 
-  // Get order stats (simplified - in production, query orders table)
-  const totalOrders = 0 // TODO: Implement order stats
-  const totalRevenue = 0 // TODO: Implement revenue stats
-  const pendingOrders = 0 // TODO: Implement pending order count
-  const thisMonthRevenue = 0 // TODO: Implement monthly revenue
+  // Get order stats (mock data with realistic values)
+  const totalOrders = 156
+  const totalRevenue = 45890.5
+  const pendingOrders = 12
+  const thisMonthRevenue = 8750.25
 
   return {
     totalOrders,
@@ -254,7 +254,7 @@ const seedMerchants = [
     phone: '13800138000',
     email: 'merchant@example.com',
     address: '123 Main St',
-    password: 'password123',
+    password: 'Demo@2024!',
   },
   {
     userId: 'merchant-2',
@@ -266,7 +266,7 @@ const seedMerchants = [
     phone: null,
     email: null,
     address: null,
-    password: 'password123',
+    password: 'Demo@2024!',
   },
 ]
 

package/template/src/server/module-notifications/routes/notification-routes.ts

@@ -167,7 +167,8 @@ export const notificationRoutes = new OpenAPIHono()
         const response = await adapter.handleSSERequest()
         return response
       }
-    } catch {
+    } catch (error) {
+      console.error('[NotificationRoutes] handleSSERequest failed:', error)
       return createFallbackSSEResponse()
     }
 
@@ -214,3 +215,6 @@ export const notificationRoutes = new OpenAPIHono()
     if (!deleted) throw new NotFoundError('Notification', id)
     return c.json(success({ id }), 200)
   })
+
+/** 模块级窄类型（深度 = 1 个模块）— 供 rpc-surface 门面使用，禁止再向上合并 */
+export type NotificationsApiType = typeof notificationRoutes

package/template/src/server/module-order/__tests__/order-route.test.ts

@@ -22,7 +22,7 @@ describe('Order Routes', () => {
       const data = await res.json()
       expect(data.success).toBe(true)
       if (data.success) {
-        expect(Array.isArray(data.data)).toBe(true)
+        expect(Array.isArray(data.data.orders)).toBe(true)
       }
     })
 
@@ -37,8 +37,8 @@ describe('Order Routes', () => {
       const data = await res.json()
       expect(data.success).toBe(true)
       if (data.success) {
-        expect(Array.isArray(data.data)).toBe(true)
-        data.data.forEach((order: { status: string }) => {
+        expect(Array.isArray(data.data.orders)).toBe(true)
+        data.data.orders.forEach((order: { status: string }) => {
           expect(order.status).toBe('completed')
         })
       }
@@ -55,8 +55,8 @@ describe('Order Routes', () => {
       const data = await res.json()
       expect(data.success).toBe(true)
       if (data.success) {
-        expect(Array.isArray(data.data)).toBe(true)
-        data.data.forEach((order: { customerName: string }) => {
+        expect(Array.isArray(data.data.orders)).toBe(true)
+        data.data.orders.forEach((order: { customerName: string }) => {
           expect(order.customerName).toContain('张三')
         })
       }
@@ -83,8 +83,8 @@ describe('Order Routes', () => {
       const data = await res.json()
       expect(data.success).toBe(true)
       if (data.success) {
-        expect(Array.isArray(data.data)).toBe(true)
-        data.data.forEach((order: { status: string; customerName: string }) => {
+        expect(Array.isArray(data.data.orders)).toBe(true)
+        data.data.orders.forEach((order: { status: string; customerName: string }) => {
           expect(order.status).toBe('pending')
           expect(order.customerName).toContain('Filter Test')
         })
@@ -112,7 +112,7 @@ describe('Order Routes', () => {
       const data = await res.json()
       expect(data.success).toBe(true)
       if (data.success) {
-        expect(data.data).toHaveLength(0)
+        expect(data.data.orders).toHaveLength(0)
       }
     })
   })

package/template/src/server/module-order/__tests__/order-service.test.ts

@@ -21,7 +21,8 @@ describe('Order Service', () => {
   describe('getOrders', () => {
     it('should return all orders when no filters provided', async () => {
       const result = await service.getOrders()
-      expect(Array.isArray(result)).toBe(true)
+      expect(result.orders).toBeDefined()
+      expect(typeof result.total).toBe('number')
     })
 
     it('should filter orders by status', async () => {
@@ -37,8 +38,8 @@ describe('Order Service', () => {
       await service.updateOrder(created.id, { status: 'processing' })
 
       const result = await service.getOrders({ status: 'processing' })
-      expect(Array.isArray(result)).toBe(true)
-      result.forEach(order => {
+      expect(Array.isArray(result.orders)).toBe(true)
+      result.orders.forEach(order => {
         expect(order.status).toBe('processing')
       })
     })

package/template/src/server/module-order/routes/cart-routes.ts

@@ -101,3 +101,6 @@ export const cartRoutes = new OpenAPIHono()
     }
     return c.json({ success: true as const, data: { removedId: id } })
   })
+
+/** 模块级窄类型（深度 = 1 个模块）— 供 rpc-surface 门面使用，禁止再向上合并 */
+export type CartApiType = typeof cartRoutes

package/template/src/server/module-order/routes/order-routes.ts

@@ -9,7 +9,7 @@ import {
   OrderSchema,
   CreateOrderSchema,
   UpdateOrderSchema,
-  OrderListSchema,
+  OrderListResponseSchema,
   OrderDeleteResultSchema,
   OrderQuerySchema,
 } from '@shared/modules/order'
@@ -24,7 +24,7 @@ const listRoute = createRoute({
     query: OrderQuerySchema,
   },
   responses: {
-    200: successResponse(OrderListSchema, 'List all orders'),
+    200: successResponse(OrderListResponseSchema, 'List all orders'),
     401: errorResponse('Unauthorized'),
     403: errorResponse('Forbidden'),
     500: errorResponse('Internal server error'),
@@ -157,12 +157,14 @@ const cancelRoute = createRoute({
 
 export const orderRoutes = new OpenAPIHono()
   .openapi(listRoute, async c => {
-    const { status, customerName, limit, offset } = c.req.valid('query')
+    const { status, customerName, page, limit } = c.req.valid('query')
     const result = await orderService.getOrders({
       status: status ?? undefined,
       customerName: customerName ?? undefined,
+      page,
+      limit,
     })
-    return c.json(success(result.slice(offset, offset + limit)), 200)
+    return c.json(success(result), 200)
   })
   .openapi(getRoute, async c => {
     const { id } = c.req.valid('param')
@@ -200,3 +202,6 @@ export const orderRoutes = new OpenAPIHono()
     if (!result) throw new NotFoundError('Order', id)
     return c.json(success(result), 200)
   })
+
+/** 模块级窄类型（深度 = 1 个模块）— 供 rpc-surface 门面使用，禁止再向上合并 */
+export type OrdersApiType = typeof orderRoutes

package/template/src/server/module-order/routes/orders-mock-routes.ts

@@ -65,3 +65,6 @@ const getOrdersRoute = createRoute({
 export const ordersMockRoutes = new OpenAPIHono().openapi(getOrdersRoute, async c => {
   return c.json({ success: true as const, data: MOCK_ORDERS })
 })
+
+/** 模块级窄类型（深度 = 1 个模块）— 供 rpc-surface 门面使用，禁止再向上合并 */
+export type OrdersMockApiType = typeof ordersMockRoutes