create-fullstack-scaffold 0.1.1 → 0.2.0

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

@@ -0,0 +1,163 @@
+import { eq } from 'drizzle-orm'
+import type { Plugin, CreatePluginInput } from '@shared/schemas'
+import { getDb } from '@server/db'
+import { plugins, type PluginTable } from '@server/db/schema'
+import { generateUUID } from '@server/utils/uuid'
+import { NotFoundError, AuthorizationError, ConflictError } from '@server/utils/app-error'
+import { parseJsonField, serializeJsonField } from '@server/utils/json'
+
+function mapRow(row: PluginTable): Plugin {
+  return {
+    id: row.id,
+    name: row.name,
+    slug: row.slug,
+    description: row.description ?? '',
+    readme: row.readme ?? undefined,
+    authorId: row.authorId,
+    authorName: row.authorName,
+    repositoryUrl: row.repositoryUrl ?? undefined,
+    homepageUrl: row.homepageUrl ?? undefined,
+    npmPackage: row.npmPackage ?? undefined,
+    license: row.license ?? undefined,
+    version: row.version,
+    status: row.status as Plugin['status'],
+    downloadCount: row.downloadCount,
+    viewCount: row.viewCount,
+    featured: row.featured,
+    screenshotUrl: row.screenshotUrl ?? undefined,
+    siteUrls: parseJsonField<string[]>(row.siteUrls),
+    tags: parseJsonField<string[]>(row.tags),
+    commands: parseJsonField<Array<{ name: string; description?: string }>>(row.commands),
+    rejectReason: row.rejectReason ?? undefined,
+    createdAt: row.createdAt.getTime(),
+    updatedAt: row.updatedAt.getTime(),
+  }
+}
+
+export interface CreatePluginData extends CreatePluginInput {
+  authorId: string
+  authorName: string
+  screenshotUrl?: string
+  readme?: string
+}
+
+export async function createPlugin(data: CreatePluginData): Promise<Plugin> {
+  const db = await getDb()
+
+  const existing = await db.select().from(plugins).where(eq(plugins.slug, data.slug))
+  if (existing.length > 0) {
+    throw new ConflictError(`Plugin with slug '${data.slug}' already exists`)
+  }
+
+  const id = generateUUID()
+  const now = new Date()
+  const result = await db
+    .insert(plugins)
+    .values({
+      id,
+      name: data.name,
+      slug: data.slug,
+      description: data.description,
+      readme: data.readme ?? null,
+      authorId: data.authorId,
+      authorName: data.authorName,
+      repositoryUrl: data.repositoryUrl ?? null,
+      homepageUrl: data.homepageUrl ?? null,
+      npmPackage: data.npmPackage ?? null,
+      license: data.license ?? null,
+      version: '0.0.1',
+      status: 'pending',
+      screenshotUrl: data.screenshotUrl ?? null,
+      siteUrls: serializeJsonField(data.siteUrls),
+      tags: serializeJsonField(data.tags),
+      commands: serializeJsonField(data.commands),
+      createdAt: now,
+      updatedAt: now,
+    })
+    .returning()
+
+  return mapRow(result[0])
+}
+
+export interface UpdatePluginData {
+  name?: string
+  description?: string
+  readme?: string | null
+  repositoryUrl?: string | null
+  homepageUrl?: string | null
+  npmPackage?: string | null
+  license?: string | null
+  screenshotUrl?: string | null
+  siteUrls?: string[] | null
+  tags?: string[] | null
+  commands?: Array<{ name: string; description?: string | null }> | null
+}
+
+export async function updatePlugin(
+  slug: string,
+  data: UpdatePluginData,
+  userId: string
+): Promise<Plugin> {
+  const db = await getDb()
+
+  const rows = await db.select().from(plugins).where(eq(plugins.slug, slug))
+  if (rows.length === 0) {
+    throw new NotFoundError('Plugin', slug)
+  }
+
+  const existing = rows[0]
+  if (existing.authorId !== userId) {
+    throw new AuthorizationError('Only the plugin author can update this plugin')
+  }
+
+  const updateData: Partial<PluginTable> = {
+    updatedAt: new Date(),
+  }
+
+  if (data.name !== undefined) updateData.name = data.name
+  if (data.description !== undefined) updateData.description = data.description
+  if (data.readme !== undefined) updateData.readme = data.readme
+  if (data.repositoryUrl !== undefined) updateData.repositoryUrl = data.repositoryUrl
+  if (data.homepageUrl !== undefined) updateData.homepageUrl = data.homepageUrl
+  if (data.npmPackage !== undefined) updateData.npmPackage = data.npmPackage
+  if (data.license !== undefined) updateData.license = data.license
+  if (data.screenshotUrl !== undefined) updateData.screenshotUrl = data.screenshotUrl
+  if (data.siteUrls !== undefined) updateData.siteUrls = serializeJsonField(data.siteUrls)
+  if (data.tags !== undefined) updateData.tags = serializeJsonField(data.tags)
+  if (data.commands !== undefined) updateData.commands = serializeJsonField(data.commands)
+
+  const result = await db.update(plugins).set(updateData).where(eq(plugins.slug, slug)).returning()
+  return mapRow(result[0])
+}
+
+export async function deletePlugin(slug: string, userId: string): Promise<void> {
+  const db = await getDb()
+
+  const rows = await db.select().from(plugins).where(eq(plugins.slug, slug))
+  if (rows.length === 0) {
+    throw new NotFoundError('Plugin', slug)
+  }
+
+  const existing = rows[0]
+  if (existing.authorId !== userId) {
+    throw new AuthorizationError('Only the plugin author can delete this plugin')
+  }
+
+  await db.delete(plugins).where(eq(plugins.slug, slug))
+}
+
+export async function trackInstall(slug: string): Promise<void> {
+  const db = await getDb()
+
+  const rows = await db.select().from(plugins).where(eq(plugins.slug, slug))
+  if (rows.length === 0) {
+    throw new NotFoundError('Plugin', slug)
+  }
+
+  await db
+    .update(plugins)
+    .set({ downloadCount: rows[0].downloadCount + 1, updatedAt: new Date() })
+    .where(eq(plugins.slug, slug))
+}
+
+export { mapRow, parseJsonField, serializeJsonField }

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

@@ -68,7 +68,7 @@ function ticketWithoutReplies(row: TicketTable): Ticket {
 
 export async function seedTicketsIfEmpty(): Promise<void> {
   const db = await getDb()
-  const existing = await db.select().from(tickets).all()
+  const existing = await db.select().from(tickets)
   if (existing.length === 0) {
     const PRIORITIES: TicketPriority[] = ['low', 'medium', 'high', 'urgent']
     const STATUSES: TicketStatus[] = [

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

@@ -23,8 +23,6 @@ const listRoute = createRoute({
   method: 'get',
   path: '/todos',
   tags: ['todos'],
-  security: [{ Bearer: [] }],
-  middleware: [authMiddleware()],
   responses: {
     200: successResponse(TodoListSchema, 'List all todos'),
     500: errorResponse('Internal server error'),
@@ -35,8 +33,6 @@ const getRoute = createRoute({
   method: 'get',
   path: '/todos/{id}',
   tags: ['todos'],
-  security: [{ Bearer: [] }],
-  middleware: [authMiddleware()],
   request: {
     params: z.object({ id: z.coerce.number().int().positive() }),
   },

package/template/src/server/route-registry.ts

@@ -7,6 +7,7 @@ import { auditLogRoutes } from './module-permission/routes/audit-log-routes'
 import { notificationRoutes } from './module-notifications/routes/notification-routes'
 import { chatRoutes } from './module-chat/routes/chat-routes'
 import { adminRoutes } from './module-admin/routes/admin-routes'
+import { clientAuthRoutes } from './module-admin/routes/client-auth-routes'
 import { captchaRoutes } from './module-captcha/routes/captcha-routes'
 import { orderRoutes } from './module-order/routes/order-routes'
 import { ticketRoutes } from './module-ticket/routes/ticket-routes'
@@ -14,6 +15,13 @@ import { disputeRoutes } from './module-dispute/routes/dispute-routes'
 import { contentRoutes } from './module-content/routes/content-routes'
 import { publicContentRoutes } from './module-content/routes/public-content-routes'
 import { fileRoutes } from './module-file/routes/file-routes'
+import { authRoutes } from './module-auth/routes/auth-routes'
+import { pluginRoutes } from './module-plugin/routes/plugin-routes'
+import { pluginAdminRoutes } from './module-plugin/routes/plugin-admin-routes'
+import { dashboardRoutes } from './module-admin/routes/dashboard-routes'
+import { cartRoutes } from './module-order/routes/cart-routes'
+import { ordersMockRoutes } from './module-order/routes/orders-mock-routes'
+import { topicsRoutes } from './module-content/routes/topics-routes'
 
 const apiRateLimit = rateLimitMiddleware({
   windowMs: 60_000,
@@ -21,13 +29,18 @@ const apiRateLimit = rateLimitMiddleware({
   message: 'Too many requests',
 })
 
-// 客户端路由 - 普通用户使用的 API
 export const clientApiRoutes = new OpenAPIHono()
   .use('*', apiRateLimit)
+  .route('/api', clientAuthRoutes)
+  .route('/api', authRoutes)
   .route('/api', chatRoutes)
   .route('/api', notificationRoutes)
   .route('/api', apiRoutes)
+  .route('/api', pluginRoutes)
   .route('/api', publicContentRoutes)
+  .route('/api', cartRoutes)
+  .route('/api', ordersMockRoutes)
+  .route('/api', topicsRoutes)
 
 // 管理后台路由 - 普通用户使用的 API + 管理功能
 export const adminApiRoutes = new OpenAPIHono()
@@ -41,6 +54,8 @@ export const adminApiRoutes = new OpenAPIHono()
   .route('/api', roleRoutes)
   .route('/api', auditLogRoutes)
   .route('/api', adminRoutes)
+  .route('/api', pluginAdminRoutes)
+  .route('/api', dashboardRoutes)
 
 // 导出类型
 export type ClientApiRoutes = typeof clientApiRoutes

package/template/src/server/test-utils/test-client.ts

@@ -51,8 +51,7 @@ export function createTestClient(baseUrl?: string, options?: TestClientOptions)
     })
   }
   return hc<AppType>('http://localhost', {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    fetch: (input: any, init?: any) => {
+    fetch: (input: RequestInfo | URL, init?: RequestInit) => {
       const request = new Request(input, init)
       Object.entries(defaultHeaders).forEach(([key, value]) => {
         if (!request.headers.has(key)) {

package/template/src/server/utils/auth.ts

@@ -42,6 +42,8 @@ const mockTokens: Map<string, string> = new Map([
   ['user-token', '3'],
 ])
 
+const userPasswordHashes: Map<string, string> = new Map()
+
 export function getAuthUser(c: Context): AuthUser {
   return c.get('authUser')
 }
@@ -63,3 +65,7 @@ export function getMockUsers(): User[] {
 export function getMockTokens(): Map<string, string> {
   return mockTokens
 }
+
+export function getUserPasswordHashes(): Map<string, string> {
+  return userPasswordHashes
+}

package/template/src/server/utils/json.ts

@@ -0,0 +1,13 @@
+export function parseJsonField<T>(field: string | null | undefined): T | undefined {
+  if (!field) return undefined
+  try {
+    return JSON.parse(field) as T
+  } catch {
+    return undefined
+  }
+}
+
+export function serializeJsonField<T>(value: T | undefined | null): string | null {
+  if (value === undefined || value === null) return null
+  return JSON.stringify(value)
+}

package/template/src/shared/core/module-manifest.ts

@@ -28,12 +28,9 @@ export interface ModuleManifest {
   /** Route registration info */
   routes: {
     /** Routes mounted under client API (/api) */
-    client?: {
-      /** Import path to the route variable (relative to module dir) */
-      importPath: string
-      /** Exported variable name from the route file */
-      exportName: string
-    }
+    client?:
+      | { importPath: string; exportName: string }
+      | { importPath: string; exportName: string }[]
     /** Routes mounted under admin API (/api/admin) */
     admin?: {
       importPath: string

package/template/src/shared/modules/auth/index.ts

@@ -0,0 +1,12 @@
+export {
+  DeveloperProfileSchema,
+  LoginSchema,
+  RegisterSchema,
+  TokenResponseSchema,
+  ProfileSchema,
+  type DeveloperProfile,
+  type LoginInput,
+  type RegisterInput,
+  type TokenResponse,
+  type Profile,
+} from './schemas'

package/template/src/shared/modules/auth/schemas.ts

@@ -0,0 +1,50 @@
+import { z } from '@hono/zod-openapi'
+
+export const DeveloperProfileSchema = z.object({
+  id: z.string(),
+  username: z.string(),
+  email: z.string().email(),
+  role: z.string(),
+  createdAt: z.string().datetime(),
+})
+
+export const LoginSchema = z
+  .object({
+    account: z.string().nullish(),
+    email: z.string().email().nullish(),
+    password: z.string().min(6),
+  })
+  .refine(data => data.account || data.email, {
+    message: 'Either account or email is required',
+    path: ['account'],
+  })
+
+export const RegisterSchema = z.object({
+  username: z.string().min(3).max(50),
+  email: z.string().email(),
+  password: z.string().min(6).max(100),
+})
+
+export const TokenResponseSchema = z.object({
+  token: z.string(),
+  profile: DeveloperProfileSchema,
+})
+
+export const ProfileSchema = z.object({
+  id: z.string(),
+  username: z.string(),
+  email: z.string().email(),
+  bio: z.string().optional().nullable(),
+  joinDate: z.string(),
+  stats: z.object({
+    posts: z.number(),
+    followers: z.number(),
+    following: z.number(),
+  }),
+})
+
+export type DeveloperProfile = z.infer<typeof DeveloperProfileSchema>
+export type LoginInput = z.infer<typeof LoginSchema>
+export type RegisterInput = z.infer<typeof RegisterSchema>
+export type TokenResponse = z.infer<typeof TokenResponseSchema>
+export type Profile = z.infer<typeof ProfileSchema>

package/template/src/shared/modules/cart/index.ts

@@ -0,0 +1 @@
+export * from './schemas'

package/template/src/shared/modules/cart/schemas.ts

@@ -0,0 +1,41 @@
+import { z } from '@hono/zod-openapi'
+
+export const CartItemSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+  variant: z.string(),
+  price: z.number(),
+  quantity: z.number(),
+  color: z.string(),
+})
+
+export const CartSummarySchema = z.object({
+  subtotal: z.number(),
+  shipping: z.number(),
+  tax: z.number(),
+  total: z.number(),
+  totalItems: z.number(),
+})
+
+export const CartResponseSchema = z.object({
+  items: z.array(CartItemSchema),
+  summary: CartSummarySchema,
+})
+
+export const AddCartItemSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+  variant: z.string(),
+  price: z.number(),
+  quantity: z.number().min(1).default(1),
+  color: z.string(),
+})
+
+export const CartItemIdSchema = z.object({
+  id: z.string(),
+})
+
+export type CartItem = z.infer<typeof CartItemSchema>
+export type CartSummary = z.infer<typeof CartSummarySchema>
+export type CartResponse = z.infer<typeof CartResponseSchema>
+export type AddCartItemInput = z.infer<typeof AddCartItemSchema>

package/template/src/shared/modules/community/index.ts

@@ -0,0 +1 @@
+export * from './schemas'

package/template/src/shared/modules/community/schemas.ts

@@ -0,0 +1,58 @@
+import { z } from '@hono/zod-openapi'
+
+export const TopicStatusSchema = z.enum(['hot', 'unanswered', 'solved'])
+
+export const TopicTagSchema = z.object({
+  label: z.string(),
+  color: z.string(),
+})
+
+export const TopicAuthorSchema = z.object({
+  name: z.string(),
+  initials: z.string(),
+})
+
+export const TopicSchema = z.object({
+  id: z.string(),
+  title: z.string(),
+  excerpt: z.string(),
+  votes: z.number(),
+  replyCount: z.number(),
+  viewCount: z.number(),
+  status: TopicStatusSchema,
+  tags: z.array(TopicTagSchema),
+  author: TopicAuthorSchema,
+  createdAt: z.string(),
+})
+
+export const TopicsResponseSchema = z.array(TopicSchema)
+
+export const ProfileStatsSchema = z.object({
+  topics: z.number(),
+  replies: z.number(),
+  likes: z.number(),
+})
+
+export const ActivityTypeSchema = z.enum(['topic', 'reply', 'like'])
+
+export const ProfileActivitySchema = z.object({
+  id: z.string(),
+  type: ActivityTypeSchema,
+  text: z.string(),
+  target: z.string(),
+  time: z.string(),
+})
+
+export const ProfileResponseSchema = z.object({
+  stats: ProfileStatsSchema,
+  activity: z.array(ProfileActivitySchema),
+})
+
+export type TopicStatus = z.infer<typeof TopicStatusSchema>
+export type TopicTag = z.infer<typeof TopicTagSchema>
+export type TopicAuthor = z.infer<typeof TopicAuthorSchema>
+export type Topic = z.infer<typeof TopicSchema>
+export type ProfileStats = z.infer<typeof ProfileStatsSchema>
+export type ActivityType = z.infer<typeof ActivityTypeSchema>
+export type ProfileActivity = z.infer<typeof ProfileActivitySchema>
+export type ProfileResponse = z.infer<typeof ProfileResponseSchema>

package/template/src/shared/modules/dashboard/index.ts

@@ -0,0 +1 @@
+export * from './schemas'

package/template/src/shared/modules/dashboard/schemas.ts

@@ -0,0 +1,35 @@
+import { z } from '@hono/zod-openapi'
+
+export const DashboardStatSchema = z.object({
+  label: z.string(),
+  value: z.string(),
+  trend: z.number(),
+})
+
+export const RevenueDataSchema = z.object({
+  month: z.string(),
+  value: z.number(),
+})
+
+export const ActivityStatusSchema = z.enum(['Active', 'Pending', 'Inactive'])
+
+export const ActivitySchema = z.object({
+  id: z.number(),
+  user: z.string(),
+  action: z.string(),
+  date: z.string(),
+  status: ActivityStatusSchema,
+})
+
+export const DashboardResponseSchema = z.object({
+  stats: z.array(DashboardStatSchema),
+  revenue: z.array(RevenueDataSchema),
+  userGrowth: z.array(RevenueDataSchema),
+  activity: z.array(ActivitySchema),
+})
+
+export type DashboardStat = z.infer<typeof DashboardStatSchema>
+export type RevenueData = z.infer<typeof RevenueDataSchema>
+export type ActivityStatus = z.infer<typeof ActivityStatusSchema>
+export type Activity = z.infer<typeof ActivitySchema>
+export type DashboardResponse = z.infer<typeof DashboardResponseSchema>

package/template/src/shared/modules/index.ts

@@ -68,3 +68,44 @@ export {
   type PermissionInfo,
   type UserPermissions,
 } from './permission'
+export {
+  DeveloperProfileSchema,
+  LoginSchema,
+  RegisterSchema,
+  TokenResponseSchema,
+  type DeveloperProfile,
+  type LoginInput,
+  type RegisterInput,
+  type TokenResponse,
+} from './auth'
+export {
+  PluginSchema,
+  PluginStatusSchema,
+  CreatePluginSchema,
+  UpdatePluginSchema,
+  PluginVersionStatusSchema,
+  VersionSchema,
+  CategorySchema,
+  ReviewSchema,
+  CreateReviewSchema,
+  MarketplaceStatsSchema,
+  PluginListResponseSchema,
+  AdminPluginSchema,
+  AdminDashboardStatsSchema,
+  PluginListQuerySchema,
+  PluginSlugSchema,
+  type Plugin,
+  type PluginStatus,
+  type CreatePluginInput,
+  type UpdatePluginInput,
+  type PluginVersionStatus,
+  type Version,
+  type Category,
+  type Review,
+  type CreateReviewInput,
+  type MarketplaceStats,
+  type PluginListResponse,
+  type AdminPlugin,
+  type AdminDashboardStats,
+  type PluginListQuery,
+} from './plugins'

package/template/src/shared/modules/order/schemas.ts

@@ -61,3 +61,32 @@ export type DeleteResult = z.infer<typeof DeleteResultSchema>
 export type ProcessOrderInput = z.infer<typeof ProcessOrderSchema>
 export type CancelOrderInput = z.infer<typeof CancelOrderSchema>
 export type OrderQueryInput = z.infer<typeof OrderQuerySchema>
+
+export const RemoveCartItemResponseSchema = z.object({ removedId: z.string() })
+
+export const ECommerceProductSchema = z.object({
+  name: z.string(),
+  color: z.string(),
+})
+
+export const ECommerceOrderStatusSchema = z.enum([
+  'processing',
+  'shipped',
+  'delivered',
+  'cancelled',
+])
+
+export const ECommerceOrderSchema = z.object({
+  id: z.string(),
+  date: z.string(),
+  status: ECommerceOrderStatusSchema,
+  products: z.array(ECommerceProductSchema),
+  total: z.number(),
+})
+
+export const ECommerceOrderListSchema = z.array(ECommerceOrderSchema)
+
+export type RemoveCartItemResponse = z.infer<typeof RemoveCartItemResponseSchema>
+export type ECommerceProduct = z.infer<typeof ECommerceProductSchema>
+export type ECommerceOrderStatus = z.infer<typeof ECommerceOrderStatusSchema>
+export type ECommerceOrder = z.infer<typeof ECommerceOrderSchema>

package/template/src/shared/modules/plugins/index.ts

@@ -0,0 +1,48 @@
+export {
+  PluginSchema,
+  PluginStatusSchema,
+  CreatePluginSchema,
+  UpdatePluginSchema,
+  PluginVersionStatusSchema,
+  VersionSchema,
+  CategorySchema,
+  ReviewSchema,
+  CreateReviewSchema,
+  MarketplaceStatsSchema,
+  PluginListResponseSchema,
+  AdminPluginSchema,
+  AdminDashboardStatsSchema,
+  PluginListQuerySchema,
+  PluginSlugSchema,
+  PluginSearchQuerySchema,
+  PluginDeleteResponseSchema,
+  ReviewIdParamsSchema,
+  ReviewDeleteResponseSchema,
+  CategorySlugParamsSchema,
+  CategoryPluginsQuerySchema,
+  PluginListAdminSchema,
+  AdminListQuerySchema,
+  AdminListAllQuerySchema,
+  RejectPluginBodySchema,
+  BulkApproveBodySchema,
+  BulkRejectBodySchema,
+  BulkResponseSchema,
+  CreateCategoryBodySchema,
+  UpdateCategoryBodySchema,
+  CategoryIdParamsSchema,
+  CategoryIdResponseSchema,
+  type Plugin,
+  type PluginStatus,
+  type CreatePluginInput,
+  type UpdatePluginInput,
+  type PluginVersionStatus,
+  type Version,
+  type Category,
+  type Review,
+  type CreateReviewInput,
+  type MarketplaceStats,
+  type PluginListResponse,
+  type AdminPlugin,
+  type AdminDashboardStats,
+  type PluginListQuery,
+} from './schemas'