pdd-skills 3.0.1 → 3.0.2

package/README.md

@@ -1,10 +1,10 @@
 # PDD-Skills v3.0
 
-[!\[Version\](https://img.shields.io/badge/version-3.0.0-blue.svg null)](https://github.com/pdd-skills/pdd-skills)
-[!\[Node\](https://img.shields.io/badge/node-%3E%3D18.0.0-green.svg null)](https://nodejs.org/)
-[!\[License\](https://img.shields.io/badge/license-MIT-orange.svg null)](LICENSE)
-[!\[Tasks\](https://img.shields.io/badge/tasks-153%2F153-brightgreen.svg null)](docs/tasks.md)
-[!\[Milestones\](https://img.shields.io/badge/milestones-29%2F29-success.svg null)](docs/tasks.md)
+[![Version](https://img.shields.io/badge/version-3.0.1-blue.svg null)](https://github.com/pdd-skills/pdd-skills)
+[![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-green.svg null)](https://nodejs.org/)
+[![License](https://img.shields.io/badge/license-MIT-orange.svg null)](LICENSE)
+[![Tasks](https://img.shields.io/badge/tasks-153%2F153-brightgreen.svg null)](docs/tasks.md)
+[![Milestones](https://img.shields.io/badge/milestones-29%2F29-success.svg null)](docs/tasks.md)
 
 > **PRD 驱动的 AI 原生软件开发工作流框架**
 >
@@ -88,7 +88,7 @@
 │  │ • npx安装 │  │ • 11核心  │  │ • 安全   │  │ • CLI    │                        │
 │  │ • Linter  │  │   技能    │  │ • 性能   │  │ • API    │                        │
 │  │ • Hook    │  │ • i18n   │  │   专家   │  │ • MCP    │                        │
-│  │ • Evals   │  │ • CSO    │  │          │  │ • JS SDK │                        │
+│  │ • Evals  │  │ • CSO    │  │          │  │ • JS SDK │                        │
 │  │          │  │ • Token  │  │          │  │ • Python│                        │
 │  └──────────┘  │ • Evals  │  └──────────┘  │ • gRPC   │                        │
 │                └──────────┘                └──────────┘                        │
@@ -107,11 +107,129 @@
 └─────────────────────────────────────────────────────────────────────────────────┘
 ```
 
+### 🏗️ 脚手架系统
+
+> **PDD-Skills v3.0.1+ 新增内置脚手架系统**,提供生产级全栈项目模板,支持从零到一的快速项目初始化。
+
+#### 可用模板
+
+| 模板名称            | 技术栈                                    | 适用场景           | 状态    |
+| --------------- | --------------------------------------- | ------------- | ----- |
+| **python-fullstack** | FastAPI + Vue3 + TypeScript + TailwindCSS | 企业级全栈 Web 应用 | ✅ 稳定版 |
+
+#### 核心能力矩阵
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                    python-fullstack 模板能力矩阵                              │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│  ┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐             │
+│  │  data_permission │  │    oauth_sso     │  │ workflow_engine │             │
+│  │   数据权限引擎    │  │  OAuth2 六平台认证 │  │   工作流状态机引擎  │             │
+│  │                 │  │                 │  │                 │             │
+│  │ • 组织级数据隔离  │  │ • 企业微信       │  │ • 15种状态定义     │             │
+│  │ • 借调合并机制   │  │ • 钉钉          │  │ • 会签/或签      │             │
+│  │ • 行级权限控制   │  │ • 飞书          │  │ • 条件分支路由     │             │
+│  │                 │  │ • 微信公众号     │  │ • 回退/撤回      │             │
+│  │                 │  │ • OIDC 通用     │  │ • 定时任务触发     │             │
+│  └─────────────────┘  └─────────────────┘  └─────────────────┘             │
+│                                                                             │
+│  ┌─────────────────────────────────────────────────────────┐               │
+│  │                  responsive_ui                          │               │
+│  │                    响应式前端系统                          │               │
+│  │                                                         │               │
+│  │  PC端 (≥1280px) → 平板 (768-1279px) → 大屏手机 (≤767px)  │               │
+│  │  6档断点自适应 · 组件级响应式 · 暗色模式支持               │               │
+│  └─────────────────────────────────────────────────────────┘               │
+│                                                                             │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+#### 技术栈详情
+
+| 层面         | 技术选型                                   | 版本要求      |
+| ---------- | ---------------------------------------- | --------- |
+| **后端框架**   | Python FastAPI                           | 3.11+      |
+| **ORM**     | SQLAlchemy [asyncio]                      | 2.x+       |
+| **数据库**   | MySQL                                   | 8.0+       |
+| **前端框架**   | Vue3 + Vite + TypeScript                  | 3.x+       |
+| **UI 框架**  | TailwindCSS                             | 3.x+       |
+| **容器化**   | Docker + docker-compose                  | 最新稳定版     |
+| **CI/CD**   | GitHub Actions / GitLab CI               | -          |
+
+#### 快速使用
+
+```bash
+# 1️⃣ 使用脚手架创建全栈项目
+pdd scaffold init my-fullstack-app --template python-fullstack
+
+# 2️⃣ 进入项目目录
+cd my-fullstack-app
+
+# 3️⃣ 查看模板配置
+cat scaffolds/python-fullstack/template_config.yaml
+
+# 4️⃣ 一键启动开发环境（含数据库）
+docker-compose up -d
+
+# 5️⃣ 启动后端服务
+cd backend && uvicorn main:app --reload --port 8000
+
+# 6️⃣ 启动前端服务
+cd frontend && npm run dev
+```
+
+#### 模板目录结构预览
+
+```
+scaffolds/python-fullstack/
+├── template_config.yaml          # 模板元数据 & Hooks 配置
+├── README.md                     # 模板使用指南
+├── docs/
+│   ├── architecture-design.md    # 架构设计文档
+│   ├── database-design.md        # 数据库设计文档
+│   ├── api-design.md             # API 设计文档
+│   └── deployment-guide.md       # 部署指南
+├── backend/
+│   ├── app/
+│   │   ├── core/                # 核心模块 (data_permission/oauth_sso/workflow_engine)
+│   │   ├── api/                 # API 路由层
+│   │   ├── models/              # SQLAlchemy 数据模型
+│   │   ├── schemas/             # Pydantic 请求/响应模型
+│   │   └── services/            # 业务逻辑层
+│   ├── alembic/                 # 数据库迁移
+│   ├── tests/                   # 单元测试 & 集成测试
+│   └── requirements.txt
+├── frontend/
+│   ├── src/
+│   │   ├── views/               # 页面组件 (响应式布局)
+│   │   ├── components/          # UI 组件库
+│   │   ├── stores/              # Pinia 状态管理
+│   │   ├── api/                 # API 请求封装
+│   │   └── utils/               # 工具函数
+│   ├── tailwind.config.js       # 6档断点配置
+│   └── vite.config.ts
+├── docker-compose.yml           # 一键部署编排
+├── .github/workflows/           # CI 流水线
+└── config/                      # 环境配置文件
+```
+
+#### 质量保证
+
+✅ 已通过 **4 项代码质量修复验证**:
+- 数据库连接池配置优化
+- 安全异常处理完善
+- datetime 弃用 API 替换
+- SQLAlchemy 异步 API 正确性校验
+
+---
+
 ### 📊 关键数据
 
 | 指标          | 数值                                            |
 | ----------- | --------------------------------------------- |
-| **版本**      | v3.0.0                                        |
+| **版本**      | v3.0.2                                        |
 | **总任务数**    | 153 (**100% 完成**)                             |
 | **里程碑数**    | 29 (**100% 达成**)                              |
 | **核心技能**    | 11 个（全双语 🇨🇳🇺🇸）                            |
@@ -122,6 +240,7 @@
 | **示例插件**    | 3 个（hello-world / code-stats / custom-linter） |
 | **社区文档**    | 5 套（\~10,700 行）                               |
 | **VM 新增代码** | \~6000 行（Phase 7）                             |
+| **脚手架模板**   | 1 个（python-fullstack 全栈模板）                     |
 
 ***
 
@@ -229,6 +348,19 @@ pdd vm features            # 功能点列表
 pdd vm export --format csv # 导出数据
 ```
 
+### 🏗️ 脚手架命令（v3.0.1+）
+
+```bash
+# 初始化脚手架项目
+pdd scaffold init <project-name> --template <template-name>
+
+# 查看可用模板列表
+pdd scaffold list
+
+# 查看模板详情
+pdd scaffold info <template-name>
+```
+
 ### 服务端
 
 ```bash
@@ -480,11 +612,11 @@ PluginBase (抽象基类)
 
 | 文档                                                         | 内容                | 行数     |
 | ---------------------------------------------------------- | ----------------- | ------ |
-| [user-guide](docs/user-guide/user-guide.md)                | 快速开始 / 工作流 / FAQ  | \~1480 |
-| [developer-guide](docs/developer-guide/developer-guide.md) | 架构 / 规范 / 贡献流程    | \~2960 |
-| [api-reference](docs/api-reference/api-reference.md)       | 全模块 API / 错误码大全   | \~3948 |
-| [operations](docs/operations/operations-guide.md)          | 部署 / 调优 / 监控 / 安全 | \~2018 |
-| [plugin-market](docs/plugin-market/README.md)              | 发布流程 / 评分标准 / 审核  | \~400  |
+| [user-guide](docs/user-guide/user-guide.md)                | 快速开始 / 工作流 / FAQ  | ~1480 |
+| [developer-guide](docs/developer-guide/developer-guide.md) | 架构 / 规范 / 贡献流程    | ~2960 |
+| [api-reference](docs/api-reference/api-reference.md)       | 全模块 API / 错误码大全   | ~3948 |
+| [operations](docs/operations/operations-guide.md)          | 部署 / 调优 / 监控 / 安全 | ~2018 |
+| [plugin-market](docs/plugin-market/README.md)              | 发布流程 / 评分标准 / 审核  | ~400  |
 
 ***
 
@@ -540,18 +672,18 @@ PDD Visual Manager (PDD-VM) 是 Phase 7 的核心交付物，提供 **双形态
 │  │  │  ├─────────────────┤  │  │    │  │  ├───────────────────────┤  │   │   │
 │  │  │  │ app.js (SPA框架)│  │  │    │  │  │ input.js (键盘输入)    │  │   │   │
 │  │  │  └─────────────────┘  │  │    │  │  └───────────────────────┘  │   │   │
-│  │  │                       │  │    │  │  5 组件:                    │   │   │
-│  │  │  4 视图面板:           │  │    │  │  progress-bar / table /    │   │   │
-│  │  │  • Pipeline (流水线)   │  │    │  │  sparkline / status-light  │   │   │
-│  │  │  • Kanban (看板)       │  │    │  │  / card                    │   │   │
-│  │  │  • Quality (质量)      │  │    │  │                             │   │   │
-│  │  │  • System (系统)       │  │    │  │  4 屏幕 + 详情overlay:     │   │   │
-│  │  │                       │  │    │  │  overview / kanban /       │   │   │
-│  │  │  Canvas 图表引擎:       │  │    │  │  quality / system         │   │   │
-│  │  │  radar/histogram/      │  │    │  │                             │   │   │
-│  │  │  gauge/lineChart/      │  │    │  └─────────────────────────────┘   │   │
-│  │  │  horizontalBar         │  │    │                                     │   │
-│  │  └───────────────────────┘  │    └─────────────────────────────────────┘   │
+│  │  │                       │  │    │  │                             │   │   │
+│  │  │  4 视图面板:           │  │    │  │  5 组件:                    │   │   │
+│  │  │  • Pipeline (流水线)   │  │    │  │  progress-bar / table /    │   │   │
+│  │  │  • Kanban (看板)       │  │    │  │  sparkline / status-light  │   │   │
+│  │  │  • Quality (质量)      │  │    │  │  / card                    │   │   │
+│  │  │  • System (系统)       │  │    │  │                             │   │   │
+│  │  │                       │  │    │  │  4 屏幕 + 详情overlay:     │   │   │
+│  │  │  Canvas 图表引擎:       │  │    │  │  overview / kanban /       │   │   │
+│  │  │  radar/histogram/      │  │    │  │  quality / system         │   │   │
+│  │  │  gauge/lineChart/      │  │    │  │                             │   │   │
+│  │  │  horizontalBar         │  │    │  └─────────────────────────────┘   │   │
+│  │  └───────────────────────┘  │    │                                     │   │
 │  └─────────────────────────────┘                                             │
 │                                                                                 │
 └─────────────────────────────────────────────────────────────────────────────────┘
@@ -1347,6 +1479,32 @@ pdd-skills-v3/
 │               ├── on-phase-change.js
 │               └── on-quality-alert.js
 │
+├── scaffolds/                  # ★ 脚手架模板系统 (v3.0.1+ 新增)
+│   └── python-fullstack/      # Python 全栈模板 (FastAPI + Vue3)
+│       ├── template_config.yaml    # 模板元数据 & Hooks & 变量配置
+│       ├── README.md               # 模板使用指南
+│       ├── docs/                   # 4份架构设计文档
+│       │   ├── architecture-design.md
+│       │   ├── database-design.md
+│       │   ├── api-design.md
+│       │   └── deployment-guide.md
+│       ├── backend/                # 后端代码 (FastAPI + SQLAlchemy)
+│       │   ├── app/core/           # 核心模块 (权限/OAuth/工作流)
+│       │   ├── app/api/            # API 路由层
+│       │   ├── app/models/         # 数据模型
+│       │   ├── app/schemas/        # 请求/响应模型
+│       │   ├── app/services/       # 业务逻辑层
+│       │   ├── alembic/            # 数据库迁移
+│       │   └── tests/              # 单元 & 集成测试
+│       ├── frontend/               # 前端代码 (Vue3 + Vite + TS)
+│       │   ├── src/views/          # 页面组件 (响应式布局)
+│       │   ├── src/components/     # UI 组件库
+│       │   ├── src/stores/         # Pinia 状态管理
+│       │   ├── src/api/            # API 请求封装
+│       │   └── tailwind.config.js  # 6档断点配置
+│       ├── docker-compose.yml      # 一键部署编排
+│       └── .github/workflows/      # CI 流水线
+│
 ├── skills/                    # 技能文件
 │   ├── core/                   # 11 个核心技能
 │   ├── expert/                 # 2 个专家技能
@@ -1370,7 +1528,7 @@ pdd-skills-v3/
 ├── templates/                 # 项目模板
 ├── config/                    # 配置文件
 ├── hooks/                     # Hook 配置
-└── package.json               # v3.0.0
+└── package.json               # v3.0.1
 ```
 
 ***
@@ -1421,6 +1579,8 @@ CLI 参数 > 环境变量 > .pddrc.local > .pddrc > defaults
 | <br />    | vm.autoOpen           | true      | 自动打开浏览器           |
 | <br />    | vm.maxSSEConnections  | 100       | 最大SSE连接数          |
 | <br />    | vm.tuiRefreshInterval | 5         | TUI 刷新间隔(秒)       |
+| **★ 脚手架** | scaffold.defaultTemplate | python-fullstack | 默认模板名称      |
+| <br />    | scaffold.outputDir    | ./output  | 输出目录              |
 
 ***
 
@@ -1453,6 +1613,7 @@ CLI 参数 > 环境变量 > .pddrc.local > .pddrc > defaults
 
 | 版本         | 日期         | 重要变更                                                                                                                                            |
 | ---------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| **v3.0.2** | 2026-04-12 | **脚手架系统发布**: python-fullstack 全栈模板(FastAPI+Vue3), 数据权限引擎, OAuth2六平台认证, 工作流状态机引擎, 响应式前端, 4份架构设计文档, Docker一键部署, CI流水线 |
 | **v3.0.1** | 2026-04-07 | **PDD Visual Manager 发布**: Web Dashboard + Terminal TUI 双形态可视化监控, 11个REST API端点, SSE实时推送, Canvas图表引擎, ANSI TUI组件库 (59/59 任务 100%, 4/4 里程碑 100%) |
 | **v3.0.0** | 2026-04-05 | **正式发布版**: 6大Phase全部完成 + 插件系统 + OpenClaw + gRPC + Python SDK + 暂缓清零 (94/94 任务 100%)                                                             |
 | v2.x       | 2026-03    | 内部迭代版本: MCP/SDK/缓存/Token/质量/迭代                                                                                                                  |

package/package.json

@@ -1 +1,2 @@
-{"name": "pdd-skills", "version": "3.0.1", "description": "PRD Driven Development Skills - AI原生软件开发工作流", "type": "module", "main": "index.js", "bin": {"pdd": "./bin/pdd.js", "pdd-skills": "./bin/pdd.js"}, "files": ["bin/", "lib/", "skills/", "templates/", "scripts/", "config/", "hooks/", "index.js"], "scripts": {"start": "node bin/pdd.js", "list": "node bin/pdd.js list", "lint": "node bin/pdd.js linter --type code prd sql activiti", "generate": "node bin/pdd.js generate", "verify": "node bin/pdd.js verify", "report": "node bin/pdd.js report", "config": "node bin/pdd.js config --list", "api": "node bin/pdd.js api", "api:dev": "node bin/pdd.js api -p 3000 --cors", "init": "node bin/pdd.js init", "update": "node bin/pdd.js update", "cso": "node bin/pdd.js cso", "eval": "node bin/pdd.js eval", "token": "node bin/pdd.js token", "i18n": "node bin/pdd.js i18n"}, "keywords": ["pdd", "prd-driven-development", "ai", "claude", "skills", "tdd", "code-generation", "linter", "api-server", "cli"], "author": "PDD Team", "license": "MIT", "engines": {"node": ">=18.0.0"}, "dependencies": {"commander": "^12.0.0", "chalk": "^5.3.0", "fs-extra": "^11.2.0", "yaml": "^2.3.0"}}
+{"name": "pdd-skills",
+  "version": "3.0.2", "description": "PRD Driven Development Skills - AI原生软件开发工作流", "type": "module", "main": "index.js", "bin": {"pdd": "./bin/pdd.js", "pdd-skills": "./bin/pdd.js"}, "files": ["bin/", "lib/", "skills/", "templates/", "scaffolds/", "scripts/", "config/", "hooks/", "index.js"], "scripts": {"start": "node bin/pdd.js", "list": "node bin/pdd.js list", "lint": "node bin/pdd.js linter --type code prd sql activiti", "generate": "node bin/pdd.js generate", "verify": "node bin/pdd.js verify", "report": "node bin/pdd.js report", "config": "node bin/pdd.js config --list", "api": "node bin/pdd.js api", "api:dev": "node bin/pdd.js api -p 3000 --cors", "init": "node bin/pdd.js init", "update": "node bin/pdd.js update", "cso": "node bin/pdd.js cso", "eval": "node bin/pdd.js eval", "token": "node bin/pdd.js token", "i18n": "node bin/pdd.js i18n"}, "keywords": ["pdd", "prd-driven-development", "ai", "claude", "skills", "tdd", "code-generation", "linter", "api-server", "cli"], "author": "PDD Team", "license": "MIT", "engines": {"node": ">=18.0.0"}, "dependencies": {"commander": "^12.0.0", "chalk": "^5.3.0", "fs-extra": "^11.2.0", "yaml": "^2.3.0"}}

package/scaffolds/README.md

@@ -0,0 +1,26 @@
+# PDD Scaffold Templates Registry
+
+本目录存放所有 PDD 驱动的脚手架模板。
+
+## 可用模板
+
+| 模板 | 路径 | 技术栈 | 说明 |
+|------|------|--------|------|
+| python-fullstack | ./python-fullstack/ | FastAPI + Vue3 + MySQL | 全栈脚手架（含数据权限/OAuth/工作流） |
+
+## 使用方式
+
+```bash
+# 通过 PDD CLI 初始化项目并选择模板
+pdd init my-project --template python-fullstack
+
+# 或在 .pdd/config.yaml 中指定默认模板
+template: scaffolds/python-fullstack
+```
+
+## 添加新模板
+
+1. 在此目录下创建新文件夹：`scaffolds/<template-name>/`
+2. 添加 `template_config.yaml` 元数据文件
+3. 添加代码模板文件
+4. 更新此 README

package/scaffolds/python-fullstack/.github/workflows/ci.yml

@@ -0,0 +1,43 @@
+name: CI Pipeline
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test-backend:
+    runs-on: ubuntu-latest
+    services:
+      mysql:
+        image: mysql:8.0
+        env:
+          MYSQL_ROOT_PASSWORD: test_root
+          MYSQL_DATABASE: pdd_test
+          MYSQL_USER: test_user
+          MYSQL_PASSWORD: test_pass
+        ports: ['3306:3306']
+        options: >-
+          --health-cmd='mysqladmin ping'
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=5
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - run: pip install -r backend/requirements-dev.txt
+      - run: cd backend && pytest tests/ -v --cov=app
+
+  test-frontend:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: frontend/package-lock.json
+      - run: cd frontend && npm ci && npm run lint

package/scaffolds/python-fullstack/Dockerfile

@@ -0,0 +1,12 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+COPY backend/requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY backend/ .
+
+EXPOSE 8000
+
+CMD ["uvicorn", "app.main:create_app", "--host", "0.0.0.0", "--port", "8000"]

package/scaffolds/python-fullstack/README.md

@@ -0,0 +1,95 @@
+# PDD-Scaffold: Python Fullstack Template
+
+> PRD-Driven Development 全栈脚手架模板 — 基于 FastAPI + Vue3
+
+## 快速开始
+
+```bash
+# 1. 使用 PDD CLI 初始化项目
+pdd init my-project --template python-fullstack
+
+# 2. 或手动复制
+cp -r scaffolds/python-fullstack/ my-project/
+cd my-project
+
+# 3. 启动后端
+cd backend
+pip install -r requirements.txt
+uvicorn app.main:create_app --reload --port 8000
+
+# 4. 启动前端
+cd frontend
+npm install
+npm run dev
+```
+
+## Docker 一键启动
+
+```bash
+docker-compose up -d
+# 访问 http://localhost:3000 (前端)
+# 访问 http://localhost:8000 (后端API)
+```
+
+## 项目结构
+
+```
+python-fullstack/
+├── backend/                  # Python FastAPI 后端
+│   ├── app/
+│   │   ├── core/            # 核心模块
+│   │   │   ├── auth/        # JWT + 密码认证
+│   │   │   ├── data_permission/  # 数据权限引擎
+│   │   │   ├── oauth/       # OAuth2 统一认证 (6平台)
+│   │   │   └── workflow/    # 工作流状态机引擎
+│   │   ├── models/          # SQLAlchemy ORM 模型
+│   │   ├── schemas/         # Pydantic 数据校验
+│   │   └── api/v1/          # REST API 端点
+│   ├── pyproject.toml
+│   └── requirements.txt
+│
+├── frontend/                 # Vue3 + Vite 前端
+│   ├── src/
+│   │   ├── views/           # 页面组件
+│   │   ├── stores/          # Pinia 状态管理
+│   │   ├── composables/     # 组合式函数 (useResponsive等)
+│   │   └── api/             # Axios HTTP 客户端
+│   ├── tailwind.config.js   # 响应式断点配置
+│   └── postcss.config.js    # pxtorem 移动适配
+│
+├── Dockerfile                # 后端容器化
+├── docker-compose.yml        # MySQL + Backend + Frontend
+├── .github/workflows/ci.yml  # CI 流水线
+├── template_config.yaml      # PDD 模板元数据
+└── docs/                    # 设计文档 (4份)
+```
+
+## 核心能力
+
+| 模块 | 说明 | 关键文件 |
+|------|------|---------|
+| **数据权限** | 组织级隔离 + 借调合并 | `core/data_permission/engine.py` |
+| **OAuth2 SSO** | 企微/钉钉/飞书/微信/OIDC | `core/oauth/providers/*.py` |
+| **工作流** | 状态机 + 会签 + 条件分支 | `core/workflow/engine.py` |
+| **响应式UI** | PC/H5 自适应 6档断点 | `composables/useResponsive.ts` |
+
+## 设计文档
+
+1. [01-架构设计](docs/01-architecture.md) — 整体架构、目录规范、PDD集成方案
+2. [02-数据权限](docs/02-data-permission.md) — ER图、SQL拦截器、借调合并策略
+3. [03-工作流引擎](docs/03-workflow-engine.md) — 15状态枚举、TransitionRule、会签策略
+4. [04-OAuth+移动端](docs/04-mobile-oauth.md) — 6平台Provider、PKCE、响应式方案
+
+## 与 PDD 集成
+
+本脚手架作为 `pdd-skills-v3` 的模板输出目标，通过 `post_generate` hook 自动调用：
+
+```yaml
+# .pdd/hooks.yaml
+hooks:
+  post_generate:
+    - template: scaffolds/python-fullstack
+      output_dir: "{{project_name}}/"
+      variables:
+        project_name: "{{name}}"
+```

package/scaffolds/python-fullstack/backend/app/__init__.py

@@ -0,0 +1,4 @@
+"""
+PDD-Scaffold Backend Application Package
+"""
+__version__ = "0.1.0"

package/scaffolds/python-fullstack/backend/app/api/v1/__init__.py

@@ -0,0 +1,6 @@
+"""
+API v1 Package
+"""
+from .router import api_router
+
+__all__ = ["api_router"]