create-dwy 0.5.0 → 0.6.0

package/templates/project/backend/.dwy.hbs

@@ -0,0 +1,5 @@
+{
+  "template": "{{template}}",
+  "dwy_version": "{{dwyVersion}}",
+  "created_at": "{{createdAt}}"
+}

package/templates/project/backend/.python-version

@@ -0,0 +1 @@
+3.11

package/templates/project/backend/CLAUDE.md.hbs

@@ -0,0 +1,40 @@
+# {{projectName}}
+
+{{projectDescription}}
+
+## Commands
+
+```bash
+# 开发环境
+docker compose -f docker-compose.dev.yml up -d    # 启动 PostgreSQL + Redis
+uv venv && uv pip install -e ".[dev]"              # 安装依赖
+uvicorn app.main:app --reload                       # 启动开发服务器
+
+# 数据库迁移
+alembic revision --autogenerate -m "描述"           # 生成迁移
+alembic upgrade head                                 # 执行迁移
+
+# 测试
+pytest tests/ -v
+
+# Lint
+ruff check src/ && ruff format --check src/
+
+# 部署
+./deploy.sh
+```
+
+## Architecture
+
+FastAPI 后端服务，基于 dwyeapi 基础设施。
+
+| 层 | 目录 | 职责 |
+|---|---|---|
+| routers | src/app/routers/ | 接收请求、调用 service、返回响应 |
+| services | src/app/services/ | 业务逻辑 |
+| models | src/app/models/ | ORM 模型 |
+| schemas | src/app/schemas/ | Pydantic 请求/响应 |
+
+## Git Commit Scope
+
+本项目的 scope 枚举：`api` | `model` | `service` | `config`

package/templates/project/{web/backend → backend}/alembic/script.py.mako

@@ -3,6 +3,7 @@
 Revision ID: ${up_revision}
 Revises: ${down_revision | comma,n}
 Create Date: ${create_date}
+
 """
 from typing import Sequence, Union
 
@@ -10,6 +11,7 @@ from alembic import op
 import sqlalchemy as sa
 ${imports if imports else ""}
 
+# revision identifiers, used by Alembic.
 revision: str = ${repr(up_revision)}
 down_revision: Union[str, None] = ${repr(down_revision)}
 branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}

package/templates/project/{web/backend → backend}/alembic.ini.hbs

@@ -1,6 +1,5 @@
 [alembic]
 script_location = alembic
-sqlalchemy.url = driver://user:pass@localhost/dbname
 
 [loggers]
 keys = root,sqlalchemy,alembic

package/templates/project/backend/deploy.sh.hbs

@@ -0,0 +1,18 @@
+#!/bin/bash
+set -euo pipefail
+
+PROJECT="{{projectName}}"
+SSH_ALIAS="{{sshAlias}}"
+REMOTE_DIR="/opt/$PROJECT"
+
+echo "Deploying $PROJECT..."
+
+git push origin master
+
+ssh $SSH_ALIAS "cd $REMOTE_DIR && git pull"
+
+ssh $SSH_ALIAS "cd $REMOTE_DIR && docker compose -f docker-compose.prod.yml exec backend alembic upgrade head"
+
+ssh $SSH_ALIAS "cd $REMOTE_DIR && docker compose -f docker-compose.prod.yml up -d --build backend"
+
+ssh $SSH_ALIAS "curl -sf http://127.0.0.1:{{backendPort}}/api/health" && echo "Deploy success" || echo "Health check failed"

package/templates/project/{web → backend}/docker-compose.prod.yml.hbs

@@ -1,6 +1,6 @@
 services:
   backend:
-    build: ./backend
+    build: .
     ports:
       - "127.0.0.1:{{backendPort}}:8000"
     env_file: .env

package/templates/project/{web/backend → backend}/pyproject.toml.hbs

@@ -4,15 +4,14 @@ version = "0.1.0"
 description = "{{projectDescription}}"
 requires-python = ">=3.11"
 dependencies = [
-    "danweiyuan-base>=0.1.0",
+    "dwyeapi>=0.2.0",
     "fastapi>=0.115.0",
     "uvicorn[standard]>=0.34.0",
     "sqlalchemy[asyncio]>=2.0.0",
     "asyncpg>=0.30.0",
-    "pydantic-settings>=2.7.0",
     "alembic>=1.13.0",
-    "python-jose[cryptography]>=3.3.0",
-    "passlib[bcrypt]>=1.7.0",
+    # 需要异步任务处理时取消注释:
+    # "dwyeapi[tasks]>=0.2.0",
 ]
 
 [project.optional-dependencies]
@@ -49,4 +48,4 @@ index-url = "https://pypi.tuna.tsinghua.edu.cn/simple/"
 extra-index-url = ["https://pypi.org/simple/"]
 
 [tool.uv.sources]
-danweiyuan-base = { index = "https://pypi.org/simple/" }
+dwyeapi = { index = "https://pypi.org/simple/" }

package/templates/project/{web/backend → backend}/src/app/config.py.hbs

@@ -1,6 +1,6 @@
 """{{projectName}} configuration."""
 
-from danweiyuan_base.config import BaseSettings
+from dwyeapi.config import BaseSettings
 
 
 class Settings(BaseSettings):

package/templates/project/backend/src/app/database.py

@@ -0,0 +1,10 @@
+"""Database engine and session factory."""
+
+from dwyeapi.database import create_async_engine_factory, create_session_factory
+from dwyeapi.dependencies import create_get_db
+
+from app.config import settings
+
+engine = create_async_engine_factory(settings.database_url)
+session_factory = create_session_factory(engine)
+get_db = create_get_db(session_factory)

package/templates/project/backend/src/app/dependencies.py

@@ -0,0 +1,5 @@
+"""FastAPI dependencies."""
+
+from app.database import get_db
+
+__all__ = ["get_db"]

package/templates/project/{web/backend → backend}/src/app/main.py.hbs

@@ -3,9 +3,9 @@
 from collections.abc import AsyncGenerator
 from contextlib import asynccontextmanager
 
-from danweiyuan_base.cache import close_redis, configure
-from danweiyuan_base.database import create_async_engine_factory, create_session_factory
-from danweiyuan_base.exceptions import register_exception_handlers
+from dwyeapi.cache import close_redis, configure
+from dwyeapi.database import create_async_engine_factory, create_session_factory
+from dwyeapi.exceptions import register_exception_handlers
 from fastapi import FastAPI
 from fastapi.middleware.cors import CORSMiddleware
 

package/templates/project/backend/src/app/models/base.py

@@ -0,0 +1,5 @@
+"""ORM model base — re-exports from dwyeapi."""
+
+from dwyeapi.database import Base, TimestampMixin
+
+__all__ = ["Base", "TimestampMixin"]

package/templates/project/web/CLAUDE.md.hbs

@@ -2,51 +2,44 @@
 
 {{projectDescription}}
 
-## Tech Stack
-
-- Frontend: Vue 3 + TypeScript + Tailwind CSS 4 + Vite
-- Backend: Python 3.11 + FastAPI + SQLAlchemy 2.0 (async)
-- Database: PostgreSQL 16 + Redis 7
-- Shared: @danweiyuan/eui, @danweiyuan/core, danweiyuan-base
-
 ## Commands
 
-### Development
-
 ```bash
-# Infrastructure
-docker compose -f docker-compose.dev.yml up -d
-
-# Backend
-cd backend
-uv run uvicorn app.main:app --reload --port 8000
+# 安装依赖
+pnpm install
 
-# Frontend
-cd frontend
+# 开发
 pnpm dev
-```
 
-### Deploy
+# 构建
+pnpm build
 
-```bash
-./deploy.sh              # Full deploy
-./deploy.sh --frontend   # Frontend only
-./deploy.sh --backend    # Backend only
+# 类型检查
+pnpm typecheck
 ```
 
-### Test
+## Architecture
 
-```bash
-cd backend && uv run pytest tests/ -v
-```
+pnpm monorepo 前端项目，基于 Vue 3 + TypeScript。
 
-## Architecture
+| 目录 | 说明 |
+|---|---|
+| apps/web/ | 主应用 |
+| packages/ | 共享包（按需添加） |
 
-```
-frontend/ → Vue 3 SPA
-backend/  → FastAPI (src/app/)
-  routers/  → HTTP endpoints
-  services/ → Business logic
-  models/   → SQLAlchemy ORM
-  schemas/  → Pydantic request/response
-```
+### apps/web/ 结构
+
+| 目录 | 说明 |
+|---|---|
+| views/ | 页面组件（一个路由对应一个文件） |
+| components/ | 可复用业务组件 |
+| composables/ | 组合式函数（use* 开头） |
+| layouts/ | 布局组件 |
+| stores/ | Pinia 状态管理 |
+| router/ | Vue Router 配置 |
+| api/ | API 请求模块 |
+| types/ | 共享类型定义 |
+
+## Git Commit Scope
+
+本项目的 scope 枚举：`web` | `shared`

package/templates/project/web/{frontend → apps/web}/index.html.hbs

@@ -2,6 +2,7 @@
 <html lang="zh-CN">
   <head>
     <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>{{projectName}}</title>
   </head>

package/templates/project/web/{frontend → apps/web}/package.json.hbs

@@ -1,16 +1,17 @@
 {
-  "name": "{{projectName}}-frontend",
+  "name": "@{{projectName}}/web",
   "private": true,
   "version": "0.0.0",
   "type": "module",
   "scripts": {
     "dev": "vite",
     "build": "vue-tsc -b && vite build",
+    "typecheck": "vue-tsc --noEmit",
     "preview": "vite preview"
   },
   "dependencies": {
-    "@danweiyuan/core": "^0.1.0",
-    "@danweiyuan/eui": "^0.2.0",
+    "@dwydev/ekit": "^0.2.1",
+    "@dwydev/eui": "^1.2.7",
     "axios": "^1.13.0",
     "lucide-vue-next": "^0.500.0",
     "pinia": "^3.0.0",

package/templates/project/web/apps/web/src/App.vue

@@ -0,0 +1,9 @@
+<script setup lang="ts">
+import DefaultLayout from '@/layouts/DefaultLayout.vue'
+</script>
+
+<template>
+  <DefaultLayout>
+    <router-view />
+  </DefaultLayout>
+</template>

package/templates/project/web/apps/web/src/api/client.ts

@@ -0,0 +1,5 @@
+import { createRequest } from '@dwydev/ekit'
+
+const request = createRequest({ baseURL: '/api' })
+
+export default request

package/templates/project/web/apps/web/src/layouts/DefaultLayout.vue

@@ -0,0 +1,8 @@
+<script setup lang="ts">
+</script>
+
+<template>
+  <div class="min-h-screen bg-background text-foreground">
+    <slot />
+  </div>
+</template>

package/templates/project/web/{frontend → apps/web}/src/router/index.ts

@@ -6,7 +6,7 @@ const router = createRouter({
     {
       path: '/',
       name: 'home',
-      component: () => import('../views/HomeView.vue'),
+      component: () => import('@/views/HomeView.vue'),
     },
   ],
 })

package/templates/project/web/{frontend → apps/web}/src/stores/auth.ts

@@ -1,10 +1,12 @@
 import { defineStore } from 'pinia'
-import { ref } from 'vue'
+import { computed, ref } from 'vue'
 
 export const useAuthStore = defineStore('auth', () => {
   const token = ref<string | null>(localStorage.getItem('token'))
   const user = ref<Record<string, unknown> | null>(null)
 
+  const isLoggedIn = computed(() => !!token.value)
+
   function setToken(t: string) {
     token.value = t
     localStorage.setItem('token', t)
@@ -16,5 +18,5 @@ export const useAuthStore = defineStore('auth', () => {
     localStorage.removeItem('token')
   }
 
-  return { token, user, setToken, logout }
+  return { token, user, isLoggedIn, setToken, logout }
 })

package/templates/project/web/apps/web/src/style.css

@@ -0,0 +1,2 @@
+@import "tailwindcss";
+@import "@dwydev/eui/theme/tokens.css";

package/templates/project/web/apps/web/src/types/router.d.ts

@@ -0,0 +1,8 @@
+import 'vue-router'
+
+declare module 'vue-router' {
+  interface RouteMeta {
+    requiresAuth?: boolean
+    title?: string
+  }
+}

package/templates/project/web/apps/web/src/views/HomeView.vue

@@ -0,0 +1,8 @@
+<script setup lang="ts">
+</script>
+
+<template>
+  <div class="flex items-center justify-center min-h-screen">
+    <h1 class="text-4xl font-bold">Welcome</h1>
+  </div>
+</template>

package/templates/project/web/apps/web/tsconfig.app.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "jsx": "preserve",
+    "paths": {
+      "@/*": ["./src/*"]
+    },
+    "types": ["vite/client"]
+  },
+  "include": ["src/**/*.ts", "src/**/*.tsx", "src/**/*.vue"]
+}

package/templates/project/web/apps/web/tsconfig.json

@@ -0,0 +1,6 @@
+{
+  "files": [],
+  "references": [
+    { "path": "./tsconfig.app.json" }
+  ]
+}

package/templates/project/web/{frontend → apps/web}/vite.config.ts.hbs

@@ -1,14 +1,20 @@
+import { fileURLToPath, URL } from 'node:url'
 import { defineConfig } from 'vite'
 import vue from '@vitejs/plugin-vue'
 import tailwindcss from '@tailwindcss/vite'
 
 export default defineConfig({
   plugins: [vue(), tailwindcss()],
+  resolve: {
+    alias: {
+      '@': fileURLToPath(new URL('./src', import.meta.url)),
+    },
+  },
   server: {
     port: 5173,
     proxy: {
       '/api': {
-        target: 'http://127.0.0.1:8000',
+        target: '{{apiProxy}}',
         changeOrigin: true,
       },
     },

package/templates/project/web/package.json.hbs

@@ -0,0 +1,16 @@
+{
+  "name": "{{projectName}}",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "pnpm -F @{{projectName}}/web dev",
+    "build": "pnpm -F @{{projectName}}/web build",
+    "typecheck": "pnpm -F @{{projectName}}/web typecheck",
+    "preview": "pnpm -F @{{projectName}}/web preview"
+  },
+  "engines": {
+    "node": ">=18",
+    "pnpm": ">=9"
+  }
+}

package/templates/project/web/pnpm-workspace.yaml

@@ -0,0 +1,3 @@
+packages:
+  - 'apps/*'
+  - 'packages/*'

package/templates/claude-global/rules/agent-team-execution.md

@@ -1,138 +0,0 @@
-# Agent 团队并行执行规则
-
-收到任务后，必须先评估是否可以通过 Agent 并行加速执行。这是强制检查，不可跳过。
-
-## 一、可并行性评估
-
-收到任务后立即判断：
-
-| 条件 | 判定 |
-|------|------|
-| 任务可拆为 2+ 个**无依赖**子任务 | → 任务级并行 |
-| 单个任务内有 2+ 个**独立步骤** | → 步骤级并行 |
-| 任务只有单一线性流程 | → 正常执行，不并行 |
-
-**核心原则：只有真正无依赖的工作才并行。** 如果子任务 B 需要子任务 A 的输出，它们必须串行。
-
-## 二、风险分级与自主度
-
-根据任务风险决定执行方式：
-
-### 低风险 — 直接并行执行
-
-- 只读操作（代码研究、搜索、文档查阅）
-- 新建独立文件（写 demo、写测试、写新组件）
-- 独立的 lint / format / 类型检查
-- 查询外部文档或 API
-
-**执行方式：** 直接派 Agent 并行，完成后汇报结果。
-
-### 中风险 — 确认后并行执行
-
-- 修改已有文件
-- 添加/升级依赖
-- 修改构建配置或路由配置
-
-**执行方式：** 先展示拆分计划（哪些 Agent、各做什么、修改哪些文件），用户确认后并行执行。
-
-### 高风险 — 确认 + 强制 Review
-
-- 删除文件或代码
-- 修改核心模块（数据库/认证/路由守卫/支付）
-- 架构重构
-- 涉及 git 操作（rebase / merge / force push）
-
-**执行方式：** 展示详细计划 + 影响分析，用户确认后执行，完成后**必须**触发 review + auto-fix 闭环。
-
-## 三、Agent 派遣协议
-
-### 任务级并行
-
-将大任务拆分为独立子任务，每个子任务派一个 Agent：
-
-1. 识别独立子任务，创建 TaskCreate 追踪
-2. 在**同一条消息**中派出所有 Agent（确保真正并行）
-3. 每个 Agent 的 prompt 必须包含：完整的任务上下文、要操作的文件范围、相关的代码规范要求
-4. 涉及文件修改的 Agent 使用 `isolation: "worktree"` 避免冲突
-5. 所有 Agent 完成后汇总结果
-
-### 步骤级并行
-
-在单个任务执行中，将独立步骤并行化：
-
-1. 识别当前步骤中哪些操作互不依赖
-2. 在同一条消息中发起多个工具调用（Agent、Bash、Grep、Glob 等均可并行）
-3. 等结果返回后再进入依赖这些结果的下一步
-
-### Agent Prompt 要求
-
-派遣 Agent 时，prompt 必须包含以下要素（不可省略）：
-
-- **目标：** 这个 Agent 具体要完成什么
-- **上下文：** 为什么要做这件事，整体任务的背景
-- **范围：** 要操作的文件/目录，明确边界
-- **规范：** 需遵循的代码规范（引用具体规则文件或关键约束）
-- **产出：** 期望的输出形式（代码、报告、修复等）
-
-**禁止：** 写模糊的 prompt 如"基于你的研究结果实现它"。每个 Agent 的 prompt 必须自包含。
-
-## 四、Review + Auto-Fix 闭环
-
-所有并行 Agent 完成后，执行质量保障流程：
-
-### 触发条件
-
-以下情况**必须**触发 review 闭环：
-
-- 任何高风险任务完成后
-- 3 个或以上 Agent 并行修改代码后
-- 用户明确要求 review 时
-
-以下情况**可跳过** review：
-
-- 纯只读研究任务
-- 单个低风险文件创建
-
-### Review 流程
-
-```
-Agent 完成 → code-reviewer Agent 审查 → 发现问题？
-  ├─ 否 → 汇报结果，完成
-  └─ 是 → 自动修复 → 再次 review → 通过？
-       ├─ 否 → 报告给用户，人工介入
-       └─ 是 → 汇报结果，完成
-```
-
-1. 启动 `superpowers:code-reviewer` Agent，审查所有变更
-2. 如发现问题，直接修复（不需再次确认）
-3. 修复后再次 review，最多循环 **2 轮**
-4. 2 轮后仍有问题，向用户报告剩余问题，交由人工判断
-
-### Review Agent 的 Prompt 要求
-
-- 说明本次变更的整体目标
-- 列出所有被修改/新建的文件
-- 引用相关的代码规范规则
-- 要求 review 聚焦：正确性、规范符合度、是否引入 bug
-
-## 五、执行报告
-
-并行任务全部完成后，向用户输出简洁的执行报告：
-
-```
-## 执行报告
-- **并行 Agent 数量：** N 个
-- **完成情况：** 全部完成 / X 个成功、Y 个失败
-- **Review 结果：** 通过 / 修复了 N 个问题
-- **变更文件：** 列出所有新建/修改的文件
-```
-
-仅在多 Agent 并行任务时输出报告，单 Agent 执行不需要。
-
-## 六、禁止事项
-
-- **禁止**派 Agent 做需要用户交互的操作（如需要用户输入、选择）
-- **禁止**多个 Agent 修改同一个文件（必须用 worktree 隔离或拆分为串行）
-- **禁止**在 Agent prompt 中省略上下文让 Agent "自己去查"
-- **禁止**跳过风险评估直接并行执行
-- **禁止**忽略 Agent 的失败结果，必须处理或报告