super-dev 2.0.0__py3-none-any.whl

super_dev/config/manager.py

@@ -0,0 +1,281 @@
+"""
+开发：Excellent（11964948@qq.com）
+功能：配置管理器 - 管理项目配置
+作用：读取、验证、持久化 super-dev.yaml 配置
+创建时间：2025-12-30
+最后修改：2025-12-30
+"""
+
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any, cast
+
+import yaml  # type: ignore[import-untyped]
+
+
+@dataclass
+class ProjectConfig:
+    """项目配置"""
+
+    name: str
+    description: str = ""
+    version: str = "2.0.0"
+    author: str = ""
+    license: str = "MIT"
+
+    # 技术栈
+    platform: str = "web"  # web, mobile, wechat, desktop
+    frontend: str = "next"  # 扩展支持：next, remix, react-vite, gatsby, nuxt, vue-vite, angular, sveltekit, astro, solid, qwik
+    backend: str = "node"  # node, python, go, java
+    database: str = "postgresql"  # postgresql, mysql, mongodb, redis
+
+    # 前端配置 (扩展)
+    ui_library: str | None = None  # UI 组件库
+    style_solution: str | None = None  # 样式方案
+    state_management: list[str] = field(default_factory=list)  # 状态管理
+    testing_frameworks: list[str] = field(default_factory=list)  # 测试框架
+
+    # 领域知识
+    domain: str = ""  # fintech, ecommerce, medical, social, iot, education
+
+    # 工作流配置
+    phases: list[str] = field(default_factory=lambda: [
+        "discovery", "intelligence", "drafting",
+        "redteam", "qa", "delivery", "deployment"
+    ])
+
+    # 专家配置
+    experts: list[str] = field(default_factory=lambda: [
+        "PM", "ARCHITECT", "UI", "UX", "SECURITY", "CODE"
+    ])
+
+    # 质量门禁
+    quality_gate: int = 80
+
+    # 输出目录
+    output_dir: str = "output"
+
+    # CLI 设置
+    cli: dict[str, Any] = field(default_factory=dict)
+
+
+class ConfigManager:
+    """配置管理器"""
+
+    CONFIG_FILENAME = "super-dev.yaml"
+    DEFAULT_CONFIG: dict[str, Any] = {
+        "name": "my-project",
+        "description": "A Super Dev project",
+        "version": "2.0.0",
+        "platform": "web",
+        "frontend": "next",  # 默认使用 Next.js
+        "backend": "node",
+        "database": "postgresql",
+        "domain": "",
+        "quality_gate": 80,
+        "output_dir": "output",
+        # 前端配置
+        "ui_library": None,
+        "style_solution": None,
+        "state_management": [],
+        "testing_frameworks": [],
+    }
+
+    def __init__(self, project_dir: Path | None = None):
+        """
+        初始化配置管理器
+
+        Args:
+            project_dir: 项目目录，默认为当前目录
+        """
+        self.project_dir = Path.cwd() if project_dir is None else project_dir
+        self.config_path = self.project_dir / self.CONFIG_FILENAME
+        self._config: ProjectConfig | None = None
+
+    @property
+    def config(self) -> ProjectConfig:
+        """获取配置（延迟加载）"""
+        if self._config is None:
+            self._config = self.load()
+        return self._config
+
+    def exists(self) -> bool:
+        """检查配置文件是否存在"""
+        return self.config_path.exists()
+
+    def load(self) -> ProjectConfig:
+        """
+        加载配置文件
+
+        Returns:
+            ProjectConfig: 项目配置对象
+        """
+        if not self.exists():
+            # 返回默认配置
+            return ProjectConfig(**cast(dict[str, Any], self.DEFAULT_CONFIG.copy()))
+
+        with open(self.config_path, encoding="utf-8") as f:
+            loaded = yaml.safe_load(f)
+        data = loaded if isinstance(loaded, dict) else {}
+
+        # 合并默认配置
+        config_data: dict[str, Any] = {**self.DEFAULT_CONFIG, **data}
+
+        return ProjectConfig(**cast(dict[str, Any], config_data))
+
+    def save(self, config: ProjectConfig | None = None) -> None:
+        """
+        保存配置文件
+
+        Args:
+            config: 要保存的配置，默认使用当前配置
+        """
+        config_to_save = config or self._config
+        if config_to_save is None:
+            raise ValueError("No config to save")
+
+        # 转换为字典（排除 None 值）
+        data = {
+            k: v for k, v in config_to_save.__dict__.items()
+            if v is not None and not k.startswith("_")
+        }
+
+        with open(self.config_path, "w", encoding="utf-8") as f:
+            yaml.dump(data, f, allow_unicode=True, default_flow_style=False)
+
+        self._config = config_to_save
+
+    def create(self, **kwargs: Any) -> ProjectConfig:
+        """
+        创建新配置
+
+        Args:
+            **kwargs: 配置参数
+
+        Returns:
+            ProjectConfig: 新创建的配置对象
+        """
+        config_data: dict[str, Any] = {**self.DEFAULT_CONFIG, **kwargs}
+        self._config = ProjectConfig(**cast(dict[str, Any], config_data))
+        self.save()
+        return self._config
+
+    def update(self, **kwargs: Any) -> ProjectConfig:
+        """
+        更新配置
+
+        Args:
+            **kwargs: 要更新的配置参数
+
+        Returns:
+            ProjectConfig: 更新后的配置对象
+        """
+        if not self.exists():
+            return self.create(**kwargs)
+
+        # 类型转换映射
+        type_converters: dict[str, type[int]] = {
+            "quality_gate": int,  # 质量门禁必须是整数
+        }
+
+        # 转换类型
+        converted_kwargs: dict[str, Any] = {}
+        for key, value in kwargs.items():
+            if key in type_converters and isinstance(value, str):
+                try:
+                    converted_kwargs[key] = type_converters[key](value)
+                except (ValueError, TypeError):
+                    converted_kwargs[key] = value
+            else:
+                converted_kwargs[key] = value
+
+        # 合并现有配置
+        current_data: dict[str, Any] = dict(self.config.__dict__)
+        updated_data: dict[str, Any] = {**current_data, **converted_kwargs}
+
+        self._config = ProjectConfig(**cast(dict[str, Any], updated_data))
+        self.save()
+        return self._config
+
+    def get(self, key: str, default: Any = None) -> Any:
+        """
+        获取配置值
+
+        Args:
+            key: 配置键（支持点号分隔的嵌套键）
+            default: 默认值
+
+        Returns:
+            配置值
+        """
+        value = self.config
+        for part in key.split("."):
+            if hasattr(value, part):
+                value = getattr(value, part)
+            else:
+                return default
+        return value
+
+    def validate(self) -> tuple[bool, list[str]]:
+        """
+        验证配置
+
+        Returns:
+            (是否有效, 错误列表)
+        """
+        errors: list[str] = []
+
+        # 验证必需字段
+        if not self.config.name:
+            errors.append("项目名称不能为空")
+
+        # 验证平台
+        valid_platforms = ["web", "mobile", "wechat", "desktop"]
+        if self.config.platform not in valid_platforms:
+            errors.append(f"平台必须是: {', '.join(valid_platforms)}")
+
+        # 验证前端框架
+        valid_frontends = [
+            "next", "remix", "react-vite", "gatsby",
+            "nuxt", "vue-vite",
+            "angular",
+            "sveltekit",
+            "astro", "solid", "qwik",
+            "react", "vue", "svelte",
+            "none",
+        ]
+        if self.config.frontend not in valid_frontends:
+            errors.append(f"前端框架必须是: {', '.join(valid_frontends)}")
+
+        # 验证后端框架
+        valid_backends = ["node", "python", "go", "java", "none"]
+        if self.config.backend not in valid_backends:
+            errors.append(f"后端框架必须是: {', '.join(valid_backends)}")
+
+        # 验证质量门禁
+        if not 0 <= self.config.quality_gate <= 100:
+            errors.append("质量门禁必须在 0-100 之间")
+
+        return len(errors) == 0, errors
+
+
+# 全局配置管理器缓存（按项目目录隔离）
+_global_config_managers: dict[Path, ConfigManager] = {}
+
+
+def get_config_manager(project_dir: Path | None = None) -> ConfigManager:
+    """
+    获取全局配置管理器实例
+
+    Args:
+        project_dir: 项目目录
+
+    Returns:
+        ConfigManager: 配置管理器实例
+    """
+    project_root = (Path.cwd() if project_dir is None else Path(project_dir)).resolve()
+    manager = _global_config_managers.get(project_root)
+    if manager is None:
+        manager = ConfigManager(project_root)
+        _global_config_managers[project_root] = manager
+    return manager

super_dev/creators/__init__.py

@@ -0,0 +1,26 @@
+"""
+Super Dev 项目创建器
+
+开发：Excellent（11964948@qq.com）
+功能：从一句话描述自动生成完整的项目文档和 Spec
+作用：一键启动项目，从想法到可执行的规范
+创建时间：2025-12-30
+"""
+
+from .creator import ProjectCreator
+from .document_generator import DocumentGenerator
+from .frontend_builder import FrontendScaffoldBuilder
+from .implementation_builder import ImplementationScaffoldBuilder
+from .prompt_generator import AIPromptGenerator
+from .requirement_parser import RequirementParser
+from .spec_builder import SpecBuilder
+
+__all__ = [
+    "ProjectCreator",
+    "DocumentGenerator",
+    "FrontendScaffoldBuilder",
+    "ImplementationScaffoldBuilder",
+    "SpecBuilder",
+    "AIPromptGenerator",
+    "RequirementParser",
+]

super_dev/creators/creator.py

@@ -0,0 +1,134 @@
+"""
+项目创建器 - 核心协调器
+
+开发：Excellent（11964948@qq.com）
+功能：从一句话描述到完整项目规范
+作用：协调文档生成、Spec 创建和 AI 提示词生成
+创建时间：2025-12-30
+"""
+
+from pathlib import Path
+
+from .document_generator import DocumentGenerator
+from .prompt_generator import AIPromptGenerator
+from .spec_builder import SpecBuilder
+
+
+class ProjectCreator:
+    """项目创建器 - 一键从想法到规范"""
+
+    def __init__(
+        self,
+        project_dir: Path,
+        name: str,
+        description: str,
+        platform: str = "web",
+        frontend: str = "next",
+        backend: str = "node",
+        domain: str = "",
+        ui_library: str | None = None,
+        style_solution: str | None = None,
+        state_management: list[str] | None = None,
+        testing_frameworks: list[str] | None = None,
+    ):
+        """初始化项目创建器"""
+        self.project_dir = Path(project_dir).resolve()
+        self.name = name
+        self.description = description
+        self.platform = platform
+        self.frontend = frontend
+        self.backend = backend
+        self.domain = domain
+        self.ui_library = ui_library
+        self.style_solution = style_solution
+        self.state_management = state_management or []
+        self.testing_frameworks = testing_frameworks or []
+
+        # 确保输出目录存在
+        self.output_dir = self.project_dir / "output"
+        self.output_dir.mkdir(exist_ok=True)
+
+        # 初始化子模块
+        self.doc_generator = DocumentGenerator(
+            name=name,
+            description=description,
+            platform=platform,
+            frontend=frontend,
+            backend=backend,
+            domain=domain,
+            ui_library=ui_library,
+            style_solution=style_solution,
+            state_management=state_management,
+            testing_frameworks=testing_frameworks,
+        )
+        self.spec_builder = SpecBuilder(
+            project_dir=self.project_dir,
+            name=name,
+            description=description
+        )
+        self.prompt_generator = AIPromptGenerator(
+            project_dir=self.project_dir,
+            name=name
+        )
+
+    def generate_documents(self) -> dict:
+        """生成所有文档 (PRD, 架构, UI/UX)"""
+        docs = {}
+
+        # 1. PRD
+        prd_path = self.output_dir / f"{self.name}-prd.md"
+        prd_content = self.doc_generator.generate_prd()
+        prd_path.write_text(prd_content, encoding="utf-8")
+        docs['prd'] = str(prd_path)
+
+        # 2. 架构文档
+        arch_path = self.output_dir / f"{self.name}-architecture.md"
+        arch_content = self.doc_generator.generate_architecture()
+        arch_path.write_text(arch_content, encoding="utf-8")
+        docs['architecture'] = str(arch_path)
+
+        # 3. UI/UX 文档
+        uiux_path = self.output_dir / f"{self.name}-uiux.md"
+        uiux_content = self.doc_generator.generate_uiux()
+        uiux_path.write_text(uiux_content, encoding="utf-8")
+        docs['uiux'] = str(uiux_path)
+
+        # 4. 执行路线图
+        scenario = self.doc_generator.requirement_parser.detect_scenario(self.project_dir)
+        plan_path = self.output_dir / f"{self.name}-execution-plan.md"
+        plan_content = self.doc_generator.generate_execution_plan(scenario=scenario)
+        plan_path.write_text(plan_content, encoding="utf-8")
+        docs['plan'] = str(plan_path)
+
+        # 5. 前端蓝图
+        frontend_blueprint_path = self.output_dir / f"{self.name}-frontend-blueprint.md"
+        frontend_blueprint_content = self.doc_generator.generate_frontend_blueprint()
+        frontend_blueprint_path.write_text(frontend_blueprint_content, encoding="utf-8")
+        docs['frontend_blueprint'] = str(frontend_blueprint_path)
+
+        return docs
+
+    def create_spec(self) -> str:
+        """创建 Spec 规范"""
+        # 生成需求列表
+        requirements = self.doc_generator.extract_requirements()
+
+        # 创建 Spec 变更提案
+        change_id = self.spec_builder.create_change(
+            requirements=requirements,
+            tech_stack={
+                'platform': self.platform,
+                'frontend': self.frontend,
+                'backend': self.backend,
+                'domain': self.domain
+            }
+        )
+
+        return change_id
+
+    def generate_ai_prompt(self) -> str:
+        """生成 AI 提示词"""
+        prompt_file = self.output_dir / f"{self.name}-ai-prompt.md"
+        prompt_content = self.prompt_generator.generate()
+        prompt_file.write_text(prompt_content, encoding="utf-8")
+        return str(prompt_file)