create-dwy 0.9.1 → 0.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-dwy",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "description": "项目脚手架与 Claude Code 配置同步工具",
   "type": "module",
   "bin": {

package/src/create.js

@@ -154,11 +154,14 @@ export async function createProject(name) {
   }
 
   if (context.template === 'fullstack-monorepo') {
-    console.log(chalk.gray('  cp .env.example .env'))
+    console.log(chalk.gray('  cp backend/.env.example backend/.env'))
+    if (context.includeFrontend) {
+      console.log(chalk.gray('  cp frontend/.env.example frontend/.env'))
+    }
     console.log(chalk.gray('  cd backend && uv sync --dev && cd ..'))
     if (context.includeFrontend) {
       console.log(chalk.gray('  cd frontend && pnpm install && cd ..'))
     }
-    console.log(chalk.gray('  ./dev.sh'))
+    console.log(chalk.gray('  ./scripts/dev.sh'))
   }
 }

package/templates/claude-global/rules/dwy-vue-core.md

@@ -2,6 +2,7 @@
 description: Vue 3 + TS + Vite + Tailwind 应用层规范（强制使用 eui/ekit、业务聚合结构、组件 / TS / 路由 / API / 模板 / 样式 / 错误处理 / 注释）
 paths:
   - "**/*.vue"
+  - "**/*.ts"
   - "**/vite.config.*"
 ---
 
@@ -108,12 +109,6 @@ src/
 - 单文件超过约 400 行时再考虑拆分，**禁止**未到规模就预拆分
 - 模块间引用通过明确 import，**禁止**循环依赖
 
-### 例外
-
-- 小型项目（< 3 个业务模块）允许扁平结构（`src/views/` + `src/components/`），但**不得**长大后保持扁平
-
----
-
 ## 二、组件规范
 
 ### 强制使用 Composition API + `<script setup>`
@@ -550,43 +545,7 @@ export function formatMoney(value: number, currency = '¥'): string {
 
 ---
 
-## 十四、代码简约原则
-
-代码只写**必要的逻辑**，不写"以防万一"的冗余代码。信任 TypeScript 类型系统与框架保证，只在系统边界（用户输入、外部 API）做校验。
-
-### 禁止的冗余模式
-
-```typescript
-// 反例：类型已保证非空，多余 fallback
-const name = props.title ?? ''       // props.title: string
-
-// 正例
-const name = props.title
-
-// 反例：值一定存在
-const id = user?.id                  // user 来自必传 prop
-
-// 正例
-const id = user.id
-
-// 反例：空 catch 吞异常
-try { await api.getUsers() } catch {}
-
-// 正例：让异常暴露或给用户反馈
-try { await api.getUsers() } catch { toast.error('加载失败') }
-```
-
-### 判断标准
-
-写每行防御代码前自问：**这个情况在当前上下文真的会发生吗？**
-
-- 会 → 写防御，注释说明触发条件
-- 不会 → 不写，信任上游保证
-- 不确定 → 查类型定义与调用链确认
-
----
-
-## 十五、违规检测清单
+## 十四、违规检测清单
 
 AI 编写或审查 Vue 代码时，**必须**检查以下违规模式：
 

package/templates/claude-global/skills/dwy-fullstack-scaffold/SKILL.md

@@ -37,7 +37,8 @@ description: "调用 dwy create CLI 生成全栈 Vue 3 + FastAPI monorepo 骨架
    **推荐做法**：让用户在终端跑 `dwy create <project_name>` 自己回答交互（每次脚手架问题需要人 review），然后 skill 介入做 post-action。
     ↓
 4. 安装依赖（在 <target_parent_dir>/<project_name> 下）:
-   - cp .env.example .env (如未存在)
+   - cp backend/.env.example backend/.env (如未存在)
+   - cp frontend/.env.example frontend/.env (仅当 include_frontend=true 且未存在)
    - cd backend && uv sync --dev
    - cd frontend && pnpm install (仅当 include_frontend=true)
     ↓
@@ -62,14 +63,17 @@ description: "调用 dwy create CLI 生成全栈 Vue 3 + FastAPI monorepo 骨架
 ```
 <project_name>/
 ├── CLAUDE.md                            # 项目级总入口
-├── dev.sh                               # 一键启动: 杀端口 + Docker + backend + frontend
-├── docker-compose.dev.yml               # PG + Redis（端口前缀 <port_prefix>xxxx）
-├── .env.example
+├── scripts/
+│   └── dev.sh                           # 一键启动: 杀端口 + Docker + backend + frontend
+├── docs/                                # 设计文档占位
+├── docker-compose.dev.yml               # dev: PG + Redis(端口前缀 <port_prefix>xxxx)
+├── docker-compose.prod.yml              # prod: backend + db + redis(资源限制 + 日志轮转)
 ├── .gitignore
 ├── backend/
 │   ├── CLAUDE.md                        # 后端约束（域分包 / Provider / dwyeapi 优先）
+│   ├── .env.example                     # backend 环境变量样例
 │   ├── pyproject.toml                   # uv workspace + 双 index + 版本中心
-│   ├── Dockerfile.dev
+│   ├── Dockerfile.dev / Dockerfile.prod
 │   ├── alembic.ini + alembic/env.py
 │   ├── src/app/                         # 装配层
 │   │   ├── main.py                      # FastAPI lifespan + register 业务包
@@ -91,6 +95,7 @@ description: "调用 dwy create CLI 生成全栈 Vue 3 + FastAPI monorepo 骨架
 │   └── tests/conftest.py
 └── frontend/                            # 仅当 include_frontend=true
     ├── CLAUDE.md                        # 前端约束（eui 优先 / catalog / features 域分包）
+    ├── .env.example                     # Vite VITE_* 变量样例
     ├── package.json
     ├── pnpm-workspace.yaml              # catalog 统一版本
     ├── tsconfig.base.json
@@ -157,8 +162,9 @@ description: "调用 dwy create CLI 生成全栈 Vue 3 + FastAPI monorepo 骨架
 
 🚀 下一步:
   cd /Users/chances/WebstormProjects/<project_name>
-  cp .env.example .env  # 修改 DATABASE_URL / SECRET_KEY 等
-  ./dev.sh
+  cp backend/.env.example backend/.env       # dev 默认值可直接用,prod 改 DATABASE_URL/SECRET_KEY
+  cp frontend/.env.example frontend/.env     # Vite 变量(仅 include_frontend=true 时)
+  ./scripts/dev.sh
 
 🛠 业务开发起点:
   - backend: backend/src/app/main.py 装载 packages/<scope>-<domain>/

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

@@ -8,11 +8,15 @@ Monorepo 全栈骨架：
 
 ```
 {{projectName}}/
-├── backend/                # FastAPI 后端（uv workspace + 域分包）
-├── frontend/               # Vue 3 前端（pnpm workspace + catalog）
-├── docker-compose.dev.yml  # PostgreSQL + Redis 基础设施
-├── dev.sh                  # 一键启动脚本
-└── .env.example
+├── backend/                  # FastAPI 后端（uv workspace + 域分包）
+│   └── .env.example          # backend 自己的环境变量样例
+├── frontend/                 # Vue 3 前端（pnpm workspace + catalog）
+│   └── .env.example          # Vite VITE_* 变量样例
+├── scripts/                  # 项目脚本
+│   └── dev.sh                # 一键启动 (Docker + backend + frontend)
+├── docs/                     # 设计文档占位
+├── docker-compose.dev.yml    # dev: PostgreSQL + Redis（端口前缀 {{portPrefix}}xxxx）
+└── docker-compose.prod.yml   # prod: backend + db + redis（含资源限制 + 日志轮转）
 ```
 
 详细约束见各子目录的 `CLAUDE.md`。
@@ -31,17 +35,25 @@ Monorepo 全栈骨架：
 ## 启动
 
 ```bash
-# 1. 复制环境变量
-cp .env.example .env
+# 1. 复制环境变量（dev 环境通常不需要改默认值）
+cp backend/.env.example backend/.env
+cp frontend/.env.example frontend/.env
 
 # 2. 安装依赖
 cd backend && uv sync --dev && cd ..
 cd frontend && pnpm install && cd ..
 
 # 3. 一键启动（Docker + backend + frontend）
-./dev.sh
+./scripts/dev.sh
 ```
 
+dev 数据库默认 `postgres / postgres` 密码,docker-compose.dev.yml 内硬编码,
+backend 通过 `DATABASE_URL` 连入(见 `backend/.env.example`)。
+
+生产部署:`docker compose -f docker-compose.prod.yml up -d --build`,
+凭据从 `backend/.env`(env_file)+ 根级 `POSTGRES_PASSWORD` / `REDIS_PASSWORD`
+环境变量传入。
+
 ## 常用命令
 
 ```bash
@@ -55,7 +67,7 @@ uv run ruff check src/ && uv run ruff format src/
 # Frontend
 cd frontend
 pnpm install
-pnpm dev                                    # 单独启 frontend
+pnpm dev                                    # 单独启 frontend (端口 {{portPrefix}}5173)
 pnpm build
 pnpm typecheck
 

package/templates/project/fullstack-monorepo/backend/Dockerfile.prod

@@ -0,0 +1,40 @@
+FROM python:3.11.15-slim AS builder
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    UV_LINK_MODE=copy \
+    UV_COMPILE_BYTECODE=1
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# 安装 uv
+COPY --from=ghcr.io/astral-sh/uv:0.4 /uv /usr/local/bin/uv
+
+WORKDIR /app
+COPY pyproject.toml uv.lock* ./
+COPY packages ./packages
+COPY src ./src
+RUN uv sync --frozen --no-dev
+
+
+FROM python:3.11.15-slim AS runtime
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PATH="/app/.venv/bin:$PATH" \
+    PYTHONPATH=/app/src
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    libpq5 \
+    && rm -rf /var/lib/apt/lists/* \
+    && groupadd -r app && useradd -r -g app -d /app -s /usr/sbin/nologin app
+
+WORKDIR /app
+COPY --from=builder --chown=app:app /app /app
+
+USER app
+EXPOSE 8000
+
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000", "--workers", "2"]

package/templates/project/fullstack-monorepo/backend/_env.example.hbs

@@ -0,0 +1,26 @@
+# ============================================================
+# {{projectName}} backend — 环境变量样例
+# ============================================================
+# 复制为 backend/.env 并填入真实值。.env 已 gitignored。
+# dev 环境直接走 docker-compose.dev.yml(密码硬编码 postgres/postgres),
+# 此文件主要供 prod 部署(docker-compose.prod.yml 的 backend env_file)。
+
+# ── 基础 ──
+ENVIRONMENT=prod
+SECRET_KEY=change-me-in-production
+LOG_LEVEL=INFO
+
+# ── PostgreSQL ──
+# dev: 默认连本地 docker-compose.dev.yml(127.0.0.1:{{portPrefix}}5432/{{projectName}}, postgres/postgres)
+# prod: db 容器 service 名为 db(同 compose 网络下),端口仍是 5432
+DATABASE_URL=postgresql+asyncpg://app_user:CHANGE_ME@db:5432/{{projectName}}
+
+# ── Redis ──
+REDIS_URL=redis://:CHANGE_ME@redis:6379/0
+
+# ── 跨域 ──
+ALLOWED_ORIGINS=https://example.com
+
+# ── 服务端口 ──
+# 容器内固定 8000,docker-compose.prod.yml 映射到宿主 127.0.0.1:{{portPrefix}}8002
+BACKEND_PORT=8000

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

@@ -6,14 +6,14 @@ services:
     environment:
       TZ: Asia/Shanghai
       PGTZ: Asia/Shanghai
-      POSTGRES_DB: ${POSTGRES_DB}
-      POSTGRES_USER: ${POSTGRES_USER}
-      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+      POSTGRES_DB: {{projectName}}
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
     command: ["postgres", "-c", "timezone=Asia/Shanghai"]
     volumes:
       - pgdata:/var/lib/postgresql/data
     healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER}"]
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
       interval: 5s
       timeout: 5s
       retries: 5

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

@@ -0,0 +1,116 @@
+# {{projectName}} 生产 compose -- 三服务（backend + db + redis）+ 资源限制 + 日志轮转
+#
+# 部署假设:
+#   - 前端由宿主机全局 nginx 托管(静态文件在 /var/www/{{projectName}}/dist),
+#     配置见 deploy/nginx/{{projectName}}.conf(用户自维护)。
+#   - backend 仅绑定 127.0.0.1:{{portPrefix}}8002,由宿主 nginx 反代上游。
+#   - 敏感凭据来自 backend/.env(env_file 引用),不要在 yml 硬编码。
+
+x-logging: &default-logging
+  driver: json-file
+  options:
+    max-size: "10m"
+    max-file: "5"
+    compress: "true"
+
+services:
+  backend:
+    image: {{projectName}}-backend:${BACKEND_TAG:-prod}
+    build:
+      context: ./backend
+      dockerfile: Dockerfile.prod
+    ports:
+      - "127.0.0.1:{{portPrefix}}8002:8000"
+    env_file:
+      - ./backend/.env
+    depends_on:
+      db:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD-SHELL", "python -c 'import httpx; httpx.get(\"http://127.0.0.1:8000/api/health\")'"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 10s
+    read_only: true
+    tmpfs:
+      - /tmp
+    mem_limit: 1g
+    logging: *default-logging
+    restart: unless-stopped
+
+  db:
+    image: postgres:16.12-alpine3.23
+    shm_size: 256m
+    environment:
+      TZ: Asia/Shanghai
+      PGTZ: Asia/Shanghai
+      POSTGRES_DB: {{projectName}}
+      POSTGRES_USER: ${POSTGRES_USER:-app_user}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?POSTGRES_PASSWORD required}
+    # 1G 容器: shared_buffers=25%, effective_cache_size=75%
+    command:
+      - "postgres"
+      - "-c"
+      - "timezone=Asia/Shanghai"
+      - "-c"
+      - "max_connections=100"
+      - "-c"
+      - "shared_buffers=256MB"
+      - "-c"
+      - "effective_cache_size=768MB"
+      - "-c"
+      - "work_mem=4MB"
+      - "-c"
+      - "maintenance_work_mem=64MB"
+      - "-c"
+      - "log_min_duration_statement=500"
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-app_user} -d {{projectName}}"]
+      interval: 5s
+      timeout: 3s
+      retries: 5
+    mem_limit: 1g
+    logging:
+      driver: json-file
+      options:
+        max-size: "20m"
+        max-file: "10"
+        compress: "true"
+    # 生产环境不暴露端口
+    restart: unless-stopped
+
+  redis:
+    image: redis:7.4.9-alpine3.21
+    # maxmemory 256mb 是 Redis 进程自管上限;mem_limit 384m 给 RDB/AOF fork
+    # 的 COW 留 buffer,避免被宿主 OOM-killer 杀掉。
+    # AOF + RDB 双持久化:重启不丢业务数据(验证码/nonce/限流计数等)。
+    command: [
+      "redis-server",
+      "--requirepass", "${REDIS_PASSWORD:?REDIS_PASSWORD required}",
+      "--maxmemory", "256mb",
+      "--maxmemory-policy", "allkeys-lru",
+      "--appendonly", "yes",
+      "--appendfsync", "everysec",
+      "--save", "900 1",
+      "--save", "300 10"
+    ]
+    volumes:
+      - redisdata:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "-a", "${REDIS_PASSWORD}", "--no-auth-warning", "ping"]
+      interval: 5s
+      timeout: 3s
+      retries: 5
+    mem_limit: 384m
+    logging: *default-logging
+    # 生产环境不暴露端口
+    restart: unless-stopped
+
+volumes:
+  pgdata:
+  redisdata:

package/templates/project/fullstack-monorepo/frontend/_env.example.hbs

@@ -0,0 +1,19 @@
+# ============================================================
+# {{projectName}} frontend — Vite 环境变量样例
+# ============================================================
+# 复制为 frontend/.env 并按需调整。.env 已 gitignored。
+# Vite 约定:只有 VITE_ 前缀的变量会暴露给客户端 bundle。
+#
+# 多环境覆盖:
+#   .env                     所有模式
+#   .env.local               所有模式(本地,gitignored)
+#   .env.development         dev 模式
+#   .env.production          prod 模式
+
+# ── API 基础路径 ──
+# dev: '/api'(走 vite.config.ts 的 proxy → http://127.0.0.1:{{portPrefix}}8001)
+# prod: '/api' 或 'https://api.example.com'(由宿主 nginx 反代)
+VITE_API_BASE_URL=/api
+
+# ── 站点元信息 ──
+VITE_APP_TITLE={{projectName}}

package/templates/project/fullstack-monorepo/{dev.sh.hbs → scripts/dev.sh.hbs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+SCRIPT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
 BACKEND_PORT={{portPrefix}}8001
 FRONTEND_PORT={{portPrefix}}5173
 BACKEND_PID=""
@@ -42,7 +42,7 @@ 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
+until docker compose -f "$SCRIPT_DIR/docker-compose.dev.yml" exec -T db pg_isready -U postgres > /dev/null 2>&1; do
   sleep 1
 done
 

package/templates/project/fullstack-monorepo/_env.example.hbs

@@ -1,24 +0,0 @@
-# ============================================================
-# {{projectName}} — 环境变量样例
-# ============================================================
-# 复制为 .env 并填入真实值。.env 已 gitignored。
-# 端口前缀策略：本项目用 {{portPrefix}}xxxx 万位前缀避免与其他项目冲突。
-
-# ── 基础 ──
-ENVIRONMENT=dev
-SECRET_KEY=change-me-in-production
-
-# ── PostgreSQL ──
-# docker-compose.dev.yml 默认本地端口：127.0.0.1:{{portPrefix}}5432
-POSTGRES_DB={{projectName}}
-POSTGRES_USER=postgres
-POSTGRES_PASSWORD=postgres
-DATABASE_URL=postgresql+asyncpg://postgres:postgres@127.0.0.1:{{portPrefix}}5432/{{projectName}}
-
-# ── Redis ──
-# docker-compose.dev.yml 默认本地端口：127.0.0.1:{{portPrefix}}6379
-REDIS_URL=redis://127.0.0.1:{{portPrefix}}6379/0
-
-# ── 服务端口（dev.sh 读取） ──
-BACKEND_PORT={{portPrefix}}8001
-FRONTEND_PORT={{portPrefix}}5173