create-dwy 0.8.0 → 0.9.0

package/templates/project/fullstack-monorepo/backend/tests/conftest.py.hbs

@@ -0,0 +1,42 @@
+"""测试通用 fixture。
+
+测试环境变量必须在 import app 之前设置,否则 Settings 实例化会失败。
+"""
+
+import os
+
+# ── 测试环境变量(必须在导入应用前设置)──
+os.environ.setdefault("ENVIRONMENT", "dev")
+os.environ.setdefault("DATABASE_URL", "sqlite+aiosqlite:///./test.db")
+os.environ.setdefault("SECRET_KEY", "test-secret-only-for-tests")
+os.environ.setdefault("REDIS_URL", "redis://localhost:{{portPrefix}}6379/0")
+
+from collections.abc import AsyncGenerator  # noqa: E402
+
+import pytest_asyncio  # noqa: E402
+from httpx import ASGITransport, AsyncClient  # noqa: E402
+
+
+@pytest_asyncio.fixture(autouse=True)
+async def setup_db() -> AsyncGenerator[None]:
+    """每个测试用例前后创建/销毁表。"""
+    from dwyeapi.database import Base
+
+    from app.main import app  # noqa: F401 -- 触发应用装配
+    from dwy_shared.database import engine  # 若 dwy-shared 没有 engine,则改 import 来源
+
+    async with engine.begin() as conn:
+        await conn.run_sync(Base.metadata.create_all)
+    yield
+    async with engine.begin() as conn:
+        await conn.run_sync(Base.metadata.drop_all)
+
+
+@pytest_asyncio.fixture
+async def client() -> AsyncGenerator[AsyncClient]:
+    """异步 HTTP 测试客户端。"""
+    from app.main import app
+
+    transport = ASGITransport(app=app)
+    async with AsyncClient(transport=transport, base_url="http://test") as ac:
+        yield ac

package/templates/project/fullstack-monorepo/dev.sh.hbs

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+BACKEND_PORT={{portPrefix}}8001
+FRONTEND_PORT={{portPrefix}}5173
+BACKEND_PID=""
+FRONTEND_PID=""
+
+# ── 清理函数 ──
+
+cleanup() {
+  echo ""
+  echo "正在关闭服务..."
+  [ -n "$FRONTEND_PID" ] && kill "$FRONTEND_PID" 2>/dev/null
+  [ -n "$BACKEND_PID" ] && kill "$BACKEND_PID" 2>/dev/null
+  wait 2>/dev/null
+  echo "已关闭前后端进程。Docker 基础设施保持运行。"
+}
+trap cleanup EXIT
+
+kill_port() {
+  local port=$1
+  local pids
+  pids=$(lsof -ti:"$port" 2>/dev/null || true)
+  if [ -n "$pids" ]; then
+    echo "  端口 $port 被占用 (PID: $pids)，正在释放..."
+    echo "$pids" | xargs kill -9 2>/dev/null || true
+    sleep 0.5
+  fi
+}
+
+# ── 1. 释放被占用的端口 ──
+
+echo "▶ 检查端口占用..."
+kill_port $BACKEND_PORT
+kill_port $FRONTEND_PORT
+
+# ── 2. 启动 Docker 基础设施 ──
+
+echo "▶ 启动 Docker 基础设施..."
+docker compose -f "$SCRIPT_DIR/docker-compose.dev.yml" up -d --remove-orphans
+
+echo "▶ 等待 PostgreSQL 就绪..."
+until docker compose -f "$SCRIPT_DIR/docker-compose.dev.yml" exec -T db pg_isready > /dev/null 2>&1; do
+  sleep 1
+done
+
+echo "▶ 等待 Redis 就绪..."
+until docker compose -f "$SCRIPT_DIR/docker-compose.dev.yml" exec -T redis redis-cli ping > /dev/null 2>&1; do
+  sleep 1
+done
+
+echo ""
+echo "✔ 基础设施就绪"
+echo "  PostgreSQL  → 127.0.0.1:{{portPrefix}}5432"
+echo "  Redis       → 127.0.0.1:{{portPrefix}}6379"
+echo ""
+
+# ── 3. 启动后端 ──
+
+echo "▶ 启动后端 (port $BACKEND_PORT)..."
+cd "$SCRIPT_DIR/backend"
+uv run uvicorn app.main:app --reload --port $BACKEND_PORT &
+BACKEND_PID=$!
+
+# ── 4. 启动前端 ──
+
+echo "▶ 启动前端 (port $FRONTEND_PORT)..."
+cd "$SCRIPT_DIR/frontend"
+pnpm dev &
+FRONTEND_PID=$!
+
+echo ""
+echo "════════════════════════════════════════"
+echo "  {{projectName}} 开发环境已启动"
+echo "  前端: http://localhost:$FRONTEND_PORT"
+echo "  后端: http://localhost:$BACKEND_PORT"
+echo "  按 Ctrl+C 关闭前后端"
+echo "════════════════════════════════════════"
+echo ""
+
+wait

package/templates/project/fullstack-monorepo/docker-compose.dev.yml.hbs

@@ -0,0 +1,36 @@
+services:
+  db:
+    image: postgres:16.12-alpine3.23
+    ports:
+      - "127.0.0.1:{{portPrefix}}5432:5432"
+    environment:
+      TZ: Asia/Shanghai
+      PGTZ: Asia/Shanghai
+      POSTGRES_DB: ${POSTGRES_DB}
+      POSTGRES_USER: ${POSTGRES_USER}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+    command: ["postgres", "-c", "timezone=Asia/Shanghai"]
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER}"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+  redis:
+    image: redis:7.4.9-alpine3.21
+    ports:
+      - "127.0.0.1:{{portPrefix}}6379:6379"
+    command: redis-server --maxmemory 256mb --maxmemory-policy allkeys-lru
+    volumes:
+      - redisdata:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 5s
+      timeout: 3s
+      retries: 5
+
+volumes:
+  pgdata:
+  redisdata:

package/templates/project/fullstack-monorepo/frontend/CLAUDE.md.hbs

@@ -0,0 +1,35 @@
+# Frontend 架构约束
+
+## 技术栈
+
+- Vue 3 + TypeScript + Vite + Pinia + Vue Router
+- 组件库：`@dwydev/eui`（**禁止**引入 Element Plus、Ant Design Vue、Naive UI 等其他组件库）
+- 工具库：`@dwydev/ekit`（HTTP、storage、cookie、date、validators、copy、qs、file、hooks、masking）
+
+## 仓库布局
+
+pnpm workspace monorepo：
+
+- `apps/web/` — 主 SPA 应用，唯一入口
+- `packages/core/` — 横切核心（HTTP / config / format / 加密等通用工具）
+- `packages/ui/` — 项目级共享 UI 组件（基于 `@dwydev/eui` 二次封装）
+- `packages/features/<domain>/` — 业务域分包，每个 feature 自管路由 + 页面
+
+## 依赖管理
+
+所有第三方包版本统一在 `pnpm-workspace.yaml` 的 `catalog:` 字段管理，子包用 `catalog:` 引用。
+
+## 加新业务域 feature
+
+复制 `packages/features/{{initialDomain}}/` 改名 → 在 `apps/web/src/router/index.ts` 用 `createFeatureRoutes()` 注册。
+
+## 禁止事项
+
+- 禁止重复造轮子：HTTP 用 `@dwydev/ekit` 的 `createRequest`，日期用其 date 模块，剪贴板/防抖等用其 hooks
+- 禁止在 `apps/web/` 中堆积业务页面，新业务必须放到 `packages/features/<domain>/`
+- 禁止跨 feature 直接 import 对方内部模块，必须经由 `packages/core` 或事件总线
+
+## 测试
+
+- 类型检查：`pnpm typecheck`
+- 构建：`pnpm build`

package/templates/project/fullstack-monorepo/frontend/Dockerfile

@@ -0,0 +1,18 @@
+# 构建阶段
+FROM node:20-alpine AS builder
+
+WORKDIR /app
+
+COPY . .
+
+RUN corepack enable && pnpm install --frozen-lockfile && pnpm build
+
+# 生产阶段
+FROM nginx:alpine
+
+COPY --from=builder /app/apps/web/dist /usr/share/nginx/html
+COPY nginx.conf /etc/nginx/conf.d/default.conf
+
+EXPOSE 80
+
+CMD ["nginx", "-g", "daemon off;"]

package/templates/project/fullstack-monorepo/frontend/apps/web/index.html.hbs

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="description" content="{{projectDescription}}" />
+    <title>{{projectName}}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/templates/project/fullstack-monorepo/frontend/apps/web/package.json.hbs

@@ -0,0 +1,31 @@
+{
+  "name": "@{{projectName}}/web",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vue-tsc -b && vite build",
+    "preview": "vite preview",
+    "typecheck": "vue-tsc --noEmit"
+  },
+  "dependencies": {
+    "vue": "catalog:",
+    "vue-router": "catalog:",
+    "pinia": "catalog:",
+    "axios": "catalog:",
+    "@dwydev/eui": "catalog:",
+    "@dwydev/ekit": "catalog:",
+    "@{{projectName}}/core": "workspace:*",
+    "@{{projectName}}/ui": "workspace:*",
+    "@{{projectName}}/features-{{initialDomain}}": "workspace:*"
+  },
+  "devDependencies": {
+    "vite": "catalog:",
+    "typescript": "catalog:",
+    "vue-tsc": "catalog:",
+    "@vitejs/plugin-vue": "catalog:",
+    "@tailwindcss/vite": "catalog:",
+    "tailwindcss": "catalog:",
+    "@vue/tsconfig": "catalog:"
+  }
+}

package/templates/project/fullstack-monorepo/frontend/apps/web/src/App.vue.hbs

@@ -0,0 +1,10 @@
+<script setup lang="ts">
+import { EConfigProvider, EToast } from '@dwydev/eui'
+</script>
+
+<template>
+  <EConfigProvider>
+    <RouterView />
+    <EToast />
+  </EConfigProvider>
+</template>

package/templates/project/fullstack-monorepo/frontend/apps/web/src/api/client.ts.hbs

@@ -0,0 +1,11 @@
+import { createRequest } from '@dwydev/ekit'
+
+/**
+ * 全局 HTTP 客户端。
+ * - baseURL `/api` 走 vite dev proxy 转发到后端
+ * - token 注入 / 401 refresh / 响应 unwrap 由 ekit 插件链处理，按需开启
+ */
+export const http = createRequest({
+  baseURL: '/api',
+  timeout: 15000,
+})

package/templates/project/fullstack-monorepo/frontend/apps/web/src/index.css

@@ -0,0 +1,12 @@
+@import "tailwindcss";
+
+html,
+body,
+#app {
+  height: 100%;
+  margin: 0;
+}
+
+body {
+  font-family: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+}

package/templates/project/fullstack-monorepo/frontend/apps/web/src/main.ts

@@ -0,0 +1,17 @@
+import { createApp } from 'vue'
+import { createPinia } from 'pinia'
+import { EUI } from '@dwydev/eui'
+
+import App from './App.vue'
+import router from './router'
+
+import '@dwydev/eui/theme/tokens.css'
+import './index.css'
+
+const app = createApp(App)
+
+app.use(createPinia())
+app.use(router)
+app.use(EUI)
+
+app.mount('#app')

package/templates/project/fullstack-monorepo/frontend/apps/web/src/router/index.ts.hbs

@@ -0,0 +1,24 @@
+import { createRouter, createWebHistory, type RouteRecordRaw } from 'vue-router'
+import { createFeatureRoutes } from '@{{projectName}}/features-{{initialDomain}}'
+
+const routes: RouteRecordRaw[] = [
+  {
+    path: '/',
+    name: 'home',
+    component: () => import('../views/HomeView.vue'),
+    meta: { title: '{{projectName}}' },
+  },
+  ...createFeatureRoutes(),
+]
+
+const router = createRouter({
+  history: createWebHistory(),
+  routes,
+})
+
+router.afterEach((to) => {
+  const title = (to.meta?.title as string | undefined) || '{{projectName}}'
+  document.title = title
+})
+
+export default router

package/templates/project/fullstack-monorepo/frontend/apps/web/src/views/HomeView.vue.hbs

@@ -0,0 +1,36 @@
+<script setup lang="ts">
+import { ref } from 'vue'
+import { http } from '../api/client'
+
+const status = ref<string>('')
+const loading = ref(false)
+
+async function checkBackend() {
+  loading.value = true
+  try {
+    const res = await http.get('/health')
+    status.value = JSON.stringify(res, null, 2)
+  } catch (err) {
+    status.value = `error: ${(err as Error).message}`
+  } finally {
+    loading.value = false
+  }
+}
+</script>
+
+<template>
+  <main class="min-h-screen flex flex-col items-center justify-center gap-6 p-8">
+    <h1 class="text-3xl font-semibold">Welcome to {{projectName}}</h1>
+    <p class="text-sm text-gray-500">{{projectDescription}}</p>
+
+    <button
+      class="px-4 py-2 rounded-md bg-black text-white text-sm disabled:opacity-50"
+      :disabled="loading"
+      @click="checkBackend"
+    >
+      \{{ loading ? 'Checking...' : 'Check backend /api/health' }}
+    </button>
+
+    <pre v-if="status" class="text-xs bg-gray-100 p-3 rounded max-w-xl overflow-auto">\{{ status }}</pre>
+  </main>
+</template>

package/templates/project/fullstack-monorepo/frontend/apps/web/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "types": ["vite/client"]
+  },
+  "include": ["src/**/*", "src/**/*.vue"]
+}

package/templates/project/fullstack-monorepo/frontend/apps/web/vite.config.ts.hbs

@@ -0,0 +1,27 @@
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import tailwindcss from '@tailwindcss/vite'
+import { fileURLToPath, URL } from 'node:url'
+
+export default defineConfig({
+  plugins: [vue(), tailwindcss()],
+  resolve: {
+    alias: {
+      '@': fileURLToPath(new URL('./src', import.meta.url)),
+      '@{{projectName}}/core': fileURLToPath(new URL('../../packages/core/src/index.ts', import.meta.url)),
+      '@{{projectName}}/ui': fileURLToPath(new URL('../../packages/ui/src/index.ts', import.meta.url)),
+      '@{{projectName}}/features-{{initialDomain}}': fileURLToPath(
+        new URL('../../packages/features/{{initialDomain}}/src/index.ts', import.meta.url),
+      ),
+    },
+  },
+  server: {
+    port: {{portPrefix}}5173,
+    proxy: {
+      '/api': {
+        target: '{{apiProxy}}',
+        changeOrigin: true,
+      },
+    },
+  },
+})

package/templates/project/fullstack-monorepo/frontend/nginx.conf

@@ -0,0 +1,11 @@
+server {
+    listen 80;
+    server_name _;
+
+    root /usr/share/nginx/html;
+    index index.html;
+
+    location / {
+        try_files $uri $uri/ /index.html;
+    }
+}

package/templates/project/fullstack-monorepo/frontend/package.json.hbs

@@ -0,0 +1,13 @@
+{
+  "name": "{{projectName}}-frontend-workspace",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "pnpm --filter web dev",
+    "build": "pnpm -r build",
+    "preview": "pnpm --filter web preview",
+    "typecheck": "pnpm -r typecheck"
+  },
+  "devDependencies": {},
+  "packageManager": "pnpm@10.19.0"
+}

package/templates/project/fullstack-monorepo/frontend/packages/core/package.json.hbs

@@ -0,0 +1,15 @@
+{
+  "name": "@{{projectName}}/core",
+  "private": true,
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "dependencies": {
+    "axios": "catalog:",
+    "zod": "catalog:",
+    "@dwydev/ekit": "catalog:"
+  },
+  "peerDependencies": {
+    "vue": "catalog:"
+  }
+}

package/templates/project/fullstack-monorepo/frontend/packages/core/src/index.ts

@@ -0,0 +1,3 @@
+// 横切核心：HTTP / config / format / 加密等通用工具
+// 业务无关，可被任意 feature 包消费
+export {}

package/templates/project/fullstack-monorepo/frontend/packages/features/{{initialDomain}}/package.json.hbs

@@ -0,0 +1,14 @@
+{
+  "name": "@{{projectName}}/features-{{initialDomain}}",
+  "private": true,
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "dependencies": {
+    "@{{projectName}}/core": "workspace:*",
+    "@{{projectName}}/ui": "workspace:*",
+    "vue": "catalog:",
+    "vue-router": "catalog:",
+    "@dwydev/eui": "catalog:"
+  }
+}

package/templates/project/fullstack-monorepo/frontend/packages/features/{{initialDomain}}/src/index.ts.hbs

@@ -0,0 +1,16 @@
+import type { RouteRecordRaw } from 'vue-router'
+
+/**
+ * 业务域 `{{initialDomain}}` 的路由工厂。
+ * 主 app 通过 `...createFeatureRoutes()` 装载本域路由。
+ */
+export function createFeatureRoutes(): RouteRecordRaw[] {
+  return [
+    {
+      path: '/{{initialDomain}}',
+      name: '{{initialDomain}}-index',
+      component: () => import('./pages/IndexPage.vue'),
+      meta: { title: '{{initialDomain}}' },
+    },
+  ]
+}

package/templates/project/fullstack-monorepo/frontend/packages/features/{{initialDomain}}/src/pages/IndexPage.vue.hbs

@@ -0,0 +1,9 @@
+<script setup lang="ts">
+</script>
+
+<template>
+  <div class="p-8">
+    <h2 class="text-xl font-semibold">{{initialDomain}} feature index</h2>
+    <p class="text-sm text-gray-500 mt-2">Edit packages/features/{{initialDomain}}/src/pages/IndexPage.vue</p>
+  </div>
+</template>

package/templates/project/fullstack-monorepo/frontend/packages/ui/package.json.hbs

@@ -0,0 +1,15 @@
+{
+  "name": "@{{projectName}}/ui",
+  "private": true,
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "dependencies": {
+    "@dwydev/eui": "catalog:",
+    "@dwydev/ekit": "catalog:"
+  },
+  "peerDependencies": {
+    "vue": "catalog:",
+    "vue-router": "catalog:"
+  }
+}

package/templates/project/fullstack-monorepo/frontend/packages/ui/src/index.ts

@@ -0,0 +1,3 @@
+// 项目级共享 UI 组件（基于 @dwydev/eui 二次封装）
+// 仅放跨 feature 复用的展示型组件，不放业务逻辑
+export {}

package/templates/project/fullstack-monorepo/frontend/pnpm-workspace.yaml.hbs

@@ -0,0 +1,23 @@
+packages:
+  - 'apps/*'
+  - 'packages/*'
+  - 'packages/features/*'
+
+catalog:
+  vue: ^3.5.32
+  vue-router: ^4.6.4
+  pinia: ^3.0.4
+  axios: ^1.7.0
+  dayjs: ^1.11.13
+  zod: ^3.23.0
+  '@vueuse/core': ^11.0.0
+  lucide-vue-next: ^0.460.0
+  tailwindcss: ^4.0.0
+  '@tailwindcss/vite': ^4.0.0
+  '@dwydev/eui': ^2.1.0
+  '@dwydev/ekit': ^0.8.0
+  vite: ^8.0.0
+  typescript: ^5.6.0
+  vue-tsc: ^2.1.0
+  '@vitejs/plugin-vue': ^5.1.0
+  '@vue/tsconfig': ^0.7.0

package/templates/project/fullstack-monorepo/frontend/tsconfig.base.json.hbs

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "useDefineForClassFields": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["apps/web/src/*"],
+      "@{{projectName}}/core": ["packages/core/src/index.ts"],
+      "@{{projectName}}/ui": ["packages/ui/src/index.ts"],
+      "@{{projectName}}/features-{{initialDomain}}": ["packages/features/{{initialDomain}}/src/index.ts"]
+    }
+  }
+}