Nuxt 4 Server (Nitro) для backend-разработки

server/
├── api/                    ← API эндпоинты
│   ├── users.get.ts        → GET /api/users
│   ├── users.post.ts       → POST /api/users
│   ├── users/
│   │   ├── [id].get.ts     → GET /api/users/:id
│   │   ├── [id].put.ts     → PUT /api/users/:id
│   │   └── [id].delete.ts  → DELETE /api/users/:id
│   └── health.ts           → GET /api/health (по умолчанию GET)
├── routes/                 ← Non-API маршруты
│   └── sitemap.xml.ts      → GET /sitemap.xml
├── middleware/             ← Server middleware
│   └── auth.ts
├── plugins/                ← Server plugins
│   └── socket.io.ts
└── utils/                  ← Утилиты с auto-import
    └── prisma.ts

// server/api/users.get.ts - GET /api/users
export default defineEventHandler(async (event) => {
  const users = await prisma.user.findMany()
  return users
})

// server/api/users.post.ts - POST /api/users
export default defineEventHandler(async (event) => {
  const body = await readBody(event)
  const user = await prisma.user.create({ data: body })
  return user
})

// server/api/users/[id].get.ts - GET /api/users/:id
export default defineEventHandler(async (event) => {
  const id = getRouterParam(event, 'id')
  const user = await prisma.user.findUnique({
    where: { id }
  })

  if (!user) {
    throw createError({
      statusCode: 404,
      statusMessage: 'User not found'
    })
  }

  return user
})

// server/api/users/[id].delete.ts - DELETE /api/users/:id
export default defineEventHandler(async (event) => {
  const id = getRouterParam(event, 'id')
  await prisma.user.delete({ where: { id } })
  return { success: true }
})

app-name/
├── app/                     ← Frontend код
│   ├── components/
│   ├── composables/
│   ├── pages/
│   └── app.vue
├── server/                  ← Backend код
│   ├── api/                 ← API эндпоинты
│   │   ├── auth/
│   │   │   ├── login.post.ts
│   │   │   ├── logout.post.ts
│   │   │   └── me.get.ts
│   │   ├── users/
│   │   │   ├── index.get.ts
│   │   │   ├── index.post.ts
│   │   │   ├── [id].get.ts
│   │   │   ├── [id].put.ts
│   │   │   └── [id].delete.ts
│   │   └── health.ts
│   ├── middleware/          ← Server middleware
│   │   ├── auth.ts
│   │   └── logger.ts
│   ├── plugins/             ← Server plugins (запуск при старте)
│   │   └── socket.io.ts
│   ├── utils/               ← Auto-imported утилиты
│   │   ├── prisma.ts
│   │   └── validators.ts
│   └── generated/           ← Сгенерированный код (Prisma)
│       └── prisma/
├── prisma/                  ← Prisma схема
│   └── schema.prisma
├── nuxt.config.ts
└── package.json

// nuxt.config.ts
export default defineNuxtConfig({
  // SSR включён для полноценного сервера
  ssr: true,

  // Nitro конфигурация
  nitro: {
    // Preset для деплоя (node-server по умолчанию)
    preset: 'node-server',

    // Эксперментальные фичи
    experimental: {
      // Включить для Socket.io
      websocket: true
    }
  },

  // Runtime конфигурация для секретов
  runtimeConfig: {
    // Серверные переменные (не отдаются клиенту)
    databaseUrl: process.env.DATABASE_URL,
    jwtSecret: process.env.JWT_SECRET,

    // Публичные переменные
    public: {
      apiBase: process.env.NUXT_PUBLIC_API_BASE || '/api'
    }
  },

  compatibilityDate: '2025-01-21'
})

// server/utils/prisma.ts
import { PrismaClient } from '../generated/prisma'

const globalForPrisma = globalThis as unknown as {
  prisma: PrismaClient | undefined
}

export const prisma = globalForPrisma.prisma ?? new PrismaClient()

if (process.env.NODE_ENV !== 'production') {
  globalForPrisma.prisma = prisma
}

// server/api/users.get.ts
export default defineEventHandler(async (event) => {
  // prisma доступна без импорта благодаря auto-import
  const users = await prisma.user.findMany()
  return users
})

// server/middleware/auth.ts
export default defineEventHandler((event) => {
  // Пропускаем публичные маршруты
  const publicRoutes = ['/api/auth/login', '/api/health']
  if (publicRoutes.some(route => event.path.startsWith(route))) {
    return
  }

  const token = getHeader(event, 'authorization')?.split(' ')[1]

  if (!token) {
    throw createError({
      statusCode: 401,
      statusMessage: 'Unauthorized'
    })
  }

  // Добавляем данные в контекст
  event.context.userId = verifyToken(token)
})

// Правильно
export default defineEventHandler(async (event) => {
  return { ok: true }
})

// НЕПРАВИЛЬНО — вернёт 404!
export const handler = defineEventHandler(async (event) => {
  return { ok: true }
})