create-fullstack-scaffold 0.4.25 → 0.5.1

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

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

@@ -50,8 +50,13 @@ export async function seedOrdersIfEmpty(): Promise<void> {
 export async function getOrders(filters?: {
   status?: OrderStatus
   customerName?: string
-}): Promise<Order[]> {
+  page?: number
+  limit?: number
+}): Promise<{ orders: Order[]; 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) {
@@ -66,7 +71,7 @@ export async function getOrders(filters?: {
     )
   }
 
-  const rows =
+  const allRows =
     conditions.length > 0
       ? await db
           .select()
@@ -75,17 +80,24 @@ export async function getOrders(filters?: {
           .orderBy(desc(orders.createdAt))
       : await db.select().from(orders).orderBy(desc(orders.createdAt))
 
-  return rows.map((row: OrderTable) => ({
-    id: `order-${row.id}`,
-    orderNo: row.orderNo,
-    customerName: row.customerName,
-    customerEmail: row.customerEmail,
-    productName: row.productName,
-    amount: row.amount,
-    status: row.status,
-    createdAt: toISOString(row.createdAt),
-    updatedAt: toISOString(row.updatedAt),
-  }))
+  const rows = allRows.slice(offset, offset + limit)
+
+  return {
+    orders: rows.map((row: OrderTable) => ({
+      id: `order-${row.id}`,
+      orderNo: row.orderNo,
+      customerName: row.customerName,
+      customerEmail: row.customerEmail,
+      productName: row.productName,
+      amount: row.amount,
+      status: row.status,
+      createdAt: toISOString(row.createdAt),
+      updatedAt: toISOString(row.updatedAt),
+    })),
+    total: allRows.length,
+    page,
+    limit,
+  }
 }
 
 export async function getOrderById(id: string): Promise<Order | null> {