create-dwy 0.5.0 → 0.6.0

package/templates/claude-global/skills/dwy-frontend-core/SKILL.md

@@ -1,181 +0,0 @@
----
-name: dwy-frontend-core
-description: "@danweiyuan/core 前端工具库速查。触发条件：需要 HTTP 请求封装、localStorage、表单校验、日期格式化、Vue composable 工具时。"
----
-
-# @danweiyuan/core 工具库速查
-
-Vue 3 项目通用工具库，包含 5 个模块：request、storage、validators、date、hooks。
-
-## 安装
-
-```bash
-pnpm add @danweiyuan/core
-# peerDependencies: axios ^1.0.0, vue ^3.4.0
-```
-
-```ts
-import { createRequest, useStorage, isPhone, formatDate, useDebounce } from '@danweiyuan/core'
-```
-
-## 查阅源码
-
-每个模块源码在 `frontend/core/src/{module}/index.ts`，函数简短可直接阅读。
-
----
-
-## request — Axios 插件化封装
-
-```ts
-import { createRequest, tokenPlugin, headerPlugin, unwrapPlugin, refreshTokenPlugin } from '@danweiyuan/core'
-```
-
-### createRequest(options?)
-
-创建带插件系统的 Axios 实例。插件按顺序执行请求/响应拦截。
-
-```ts
-const http = createRequest({
-  baseURL: '/api',      // 默认 '/api'
-  timeout: 30000,       // 默认 30000
-  plugins: [
-    tokenPlugin({ getToken: () => localStorage.getItem('token') }),
-    unwrapPlugin(),
-  ],
-})
-```
-
-### 内置插件
-
-| 插件 | 用途 | 参数 |
-|------|------|------|
-| tokenPlugin | 自动注入 Bearer token | `{ getToken: () => string \| null }` |
-| headerPlugin | 注入自定义请求头 | `{ name: string, getValue: () => string \| null }` |
-| unwrapPlugin | 解包 `{ code, data, message }` 响应，code !== 200 时 reject | 无参数 |
-| refreshTokenPlugin | 401 自动刷新 token 并重试 | `{ getRefreshToken, refreshFn, onRefreshFail, isLoginUrl? }` |
-
-### RequestPlugin 接口
-
-```ts
-interface RequestPlugin {
-  onRequest?: (config: InternalAxiosRequestConfig) => config | Promise<config>
-  onResponse?: (response: AxiosResponse) => response | Promise<response>
-  onResponseError?: (error: AxiosError) => any
-}
-```
-
-### refreshTokenPlugin 详解
-
-```ts
-refreshTokenPlugin({
-  getRefreshToken: () => localStorage.getItem('refreshToken'),
-  refreshFn: async (refreshToken) => {
-    // 调用刷新接口，返回新 access token
-    const { data } = await http.post('/auth/refresh', { refreshToken })
-    localStorage.setItem('token', data.token)
-    return data.token
-  },
-  onRefreshFail: () => {
-    // 刷新失败，跳转登录
-    localStorage.clear()
-    window.location.href = '/login'
-  },
-  isLoginUrl: (url) => url.includes('/auth/login'), // 可选，默认检测 /auth/login
-})
-```
-
----
-
-## storage — localStorage 封装
-
-```ts
-import { useStorage, storage } from '@danweiyuan/core'
-```
-
-### useStorage(key, defaultValue) — 响应式
-
-返回 Vue `Ref<T>`，自动 JSON 序列化，深度 watch 自动同步。设为 null/undefined 时自动 removeItem。
-
-```ts
-const token = useStorage<string>('token', '')
-const config = useStorage<{ theme: string }>('config', { theme: 'light' })
-```
-
-### storage — 静态工具对象
-
-| 方法 | 签名 | 说明 |
-|------|------|------|
-| get | `get<T>(key, defaultValue?): T \| undefined` | JSON 解析失败时返回原始字符串 |
-| set | `set(key, value): void` | JSON.stringify 后存储 |
-| remove | `remove(key): void` | 删除指定 key |
-| clear | `clear(): void` | 清空全部 |
-
----
-
-## validators — 校验函数
-
-```ts
-import { isPhone, isEmail, isIdCard, isUrl, isRequired, minLength, maxLength } from '@danweiyuan/core'
-```
-
-| 函数 | 签名 | 规则 |
-|------|------|------|
-| isPhone | `(value: string) => boolean` | 中国手机号 1[3-9]开头 11 位 |
-| isEmail | `(value: string) => boolean` | 基础邮箱格式 |
-| isIdCard | `(value: string) => boolean` | 18 位身份证（末位可为 X/x） |
-| isUrl | `(value: string) => boolean` | 使用 `new URL()` 校验 |
-| isRequired | `(value: any) => boolean` | 非 null/undefined/空字符串/空数组。0 和 false 视为有效 |
-| minLength | `(value: string, min: number) => boolean` | 最小长度 |
-| maxLength | `(value: string, max: number) => boolean` | 最大长度 |
-
----
-
-## date — 日期格式化
-
-```ts
-import { formatDate, formatDateTime, formatTime, formatRelativeTime } from '@danweiyuan/core'
-```
-
-所有函数接收 `string | number | Date` 类型输入。
-
-| 函数 | 输出格式 | 示例 |
-|------|---------|------|
-| formatDate | `YYYY-MM-DD` | `2025-03-15` |
-| formatDateTime | `YYYY-MM-DD HH:mm:ss` | `2025-03-15 14:30:00` |
-| formatTime | `HH:mm` | `14:30` |
-| formatRelativeTime | 中文相对时间 | `刚刚` / `5 分钟前` / `3 小时前` / `7 天前` / 超过 30 天返回 `toLocaleDateString('zh-CN')` |
-
----
-
-## hooks — Vue Composables
-
-```ts
-import { useDebounce, useClickOutside, useEventListener } from '@danweiyuan/core'
-```
-
-### useDebounce(value, delay?)
-
-```ts
-const search = ref('')
-const debouncedSearch = useDebounce(search, 300) // 默认 300ms
-```
-
-返回防抖后的 `Ref<T>`，仅在源值停止变化 delay 毫秒后更新。
-
-### useClickOutside(target, handler)
-
-```ts
-const popoverRef = ref<HTMLElement | null>(null)
-useClickOutside(popoverRef, () => { isOpen.value = false })
-```
-
-点击 target 元素外部时触发 handler。自动在 onMounted/onBeforeUnmount 绑定/解绑。
-
-### useEventListener(target, event, handler, options?)
-
-```ts
-useEventListener(window, 'resize', onResize)
-useEventListener(elementRef, 'scroll', onScroll, { passive: true })
-```
-
-target 可以是 `EventTarget` 或 `Ref<EventTarget>`。自动在 onMounted/onBeforeUnmount 绑定/解绑。

package/templates/project/web/.claude/commands/deploy.md

@@ -1,4 +0,0 @@
----
-description: Deploy the project
----
-Run `./deploy.sh` with the appropriate flag based on user intent.

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

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

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

@@ -1,113 +0,0 @@
-#!/bin/bash
-set -euo pipefail
-
-PROJECT_NAME="{{projectName}}"
-SSH_ALIAS="{{sshAlias}}"
-REMOTE_DIR="/opt/{{projectName}}"
-BACKEND_PORT={{backendPort}}
-HEALTH_CHECK_PATH="/api/health"
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-NC='\033[0m'
-
-log()  { echo -e "${GREEN}[DEPLOY]${NC} $1"; }
-warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
-err()  { echo -e "${RED}[ERROR]${NC} $1"; exit 1; }
-
-push_code() {
-    log "推送代码到 Gitee..."
-    git push origin master || err "git push 失败"
-}
-
-pull_remote() {
-    log "远程拉取代码..."
-    ssh $SSH_ALIAS "cd $REMOTE_DIR && git pull origin master" || err "远程 git pull 失败"
-}
-
-build_frontend() {
-    log "构建前端..."
-    cd frontend && pnpm build || err "前端构建失败"
-    cd ..
-}
-
-upload_frontend() {
-    log "上传前端构建产物..."
-    tar czf /tmp/frontend-dist.tar.gz -C frontend dist/
-    scp /tmp/frontend-dist.tar.gz $SSH_ALIAS:$REMOTE_DIR/ || err "上传失败"
-    ssh $SSH_ALIAS "cd $REMOTE_DIR && mkdir -p frontend && tar xzf frontend-dist.tar.gz -C frontend/ && rm frontend-dist.tar.gz"
-    rm /tmp/frontend-dist.tar.gz
-}
-
-run_migrations() {
-    log "执行数据库迁移..."
-    ssh $SSH_ALIAS "cd $REMOTE_DIR && docker compose -f docker-compose.prod.yml run --rm backend alembic upgrade head" || err "迁移失败"
-}
-
-restart_backend() {
-    log "重建后端容器..."
-    ssh $SSH_ALIAS "cd $REMOTE_DIR && docker compose -f docker-compose.prod.yml up -d --build backend"
-}
-
-verify() {
-    log "验证部署..."
-    sleep 3
-
-    HEALTH=$(ssh $SSH_ALIAS "curl -s http://localhost${HEALTH_CHECK_PATH}" 2>/dev/null)
-    if echo "$HEALTH" | grep -q '"ok"'; then
-        log "API 健康检查: ✅"
-    else
-        err "API 健康检查失败: $HEALTH"
-    fi
-
-    GIT_CODE=$(ssh $SSH_ALIAS "curl -s -o /dev/null -w '%{http_code}' http://localhost/.git/config" 2>/dev/null)
-    ENV_CODE=$(ssh $SSH_ALIAS "curl -s -o /dev/null -w '%{http_code}' http://localhost/.env" 2>/dev/null)
-    if [ "$GIT_CODE" = "404" ] && [ "$ENV_CODE" = "404" ]; then
-        log "安全检查: ✅ (.git/.env 已屏蔽)"
-    else
-        warn "安全检查: .git=$GIT_CODE .env=$ENV_CODE"
-    fi
-
-    log "部署完成!"
-}
-
-case "${1:-all}" in
-    --backend)
-        log "=== 仅部署后端 ==="
-        push_code
-        pull_remote
-        run_migrations
-        restart_backend
-        verify
-        ;;
-    --frontend)
-        log "=== 仅部署前端 ==="
-        build_frontend
-        upload_frontend
-        verify
-        ;;
-    --restart)
-        log "=== 仅重启容器 ==="
-        ssh $SSH_ALIAS "cd $REMOTE_DIR && docker compose -f docker-compose.prod.yml up -d --force-recreate"
-        verify
-        ;;
-    --check)
-        log "=== 安全检查 ==="
-        verify
-        ;;
-    all|"")
-        log "=== 全量部署 ==="
-        push_code
-        pull_remote
-        build_frontend
-        upload_frontend
-        run_migrations
-        restart_backend
-        verify
-        ;;
-    *)
-        echo "用法: ./deploy.sh [--backend|--frontend|--restart|--check]"
-        exit 1
-        ;;
-esac

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

@@ -1,3 +0,0 @@
-<template>
-  <router-view />
-</template>

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

@@ -1,13 +0,0 @@
-import axios from 'axios'
-
-const client = axios.create({ baseURL: '/api' })
-
-client.interceptors.request.use((config) => {
-  const token = localStorage.getItem('token')
-  if (token) {
-    config.headers.Authorization = `Bearer ${token}`
-  }
-  return config
-})
-
-export default client

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

@@ -1 +0,0 @@
-@import "tailwindcss";

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

@@ -1,5 +0,0 @@
-<template>
-  <div class="min-h-screen flex items-center justify-center">
-    <h1 class="text-3xl font-bold">Welcome</h1>
-  </div>
-</template>

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

@@ -1,14 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
-    "strict": true,
-    "jsx": "preserve",
-    "noEmit": true,
-    "paths": { "@/*": ["./src/*"] },
-    "baseUrl": "."
-  },
-  "include": ["src/**/*.ts", "src/**/*.vue"]
-}

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

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