endo 0.3.0__tar.gz

endo-0.3.0/.gitignore

@@ -0,0 +1,55 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+venv/
+env/
+
+# 数据库与运行时
+*.db
+*.sqlite
+*.sqlite3
+backend/uploads/
+
+# 前端
+node_modules/
+.vite
+frontend/dist/
+frontend/.vite/
+*.tsbuildinfo
+backend/endo/static/
+
+# 测试与覆盖率
+.pytest_cache/
+.coverage
+coverage.xml
+htmlcov/
+.tox/
+coverage/
+
+# IDE
+.idea/
+*.swp
+*.swo
+.DS_Store
+Thumbs.db
+
+# CI 产物
+release-assets/
+assets/
+RELEASE_NOTES.md
+
+# 环境变量
+.env
+.env.local
+.env.*.local
+
+# 日志
+*.log
+logs/

endo-0.3.0/.pre-commit-config.yaml

@@ -0,0 +1,22 @@
+# prek compatible configuration
+# See https://pre-commit.com for more information
+repos:
+  - repo: https://gitcode.com/gh_mirrors/ru/ruff-pre-commit.git
+    # Ruff version - keep in sync with pyproject.toml
+    rev: v0.15.4
+    hooks:
+      # Run the linter
+      - id: ruff
+        args: [ --fix, --exit-non-zero-on-fix ]
+      # Run the formatter
+      - id: ruff-format
+        args: [ --config=pyproject.toml]
+  - repo: https://gitcode.com/gh_mirrors/pr/pre-commit-hooks.git
+    rev: v5.0.0
+    hooks:
+      - id: check-merge-conflict
+      - id: debug-statements
+      - id: fix-byte-order-marker
+      - id: trailing-whitespace
+        args: [ --markdown-linebreak-ext=md ]
+      - id: end-of-file-fixer

endo-0.3.0/.python-version

@@ -0,0 +1 @@
+3.13

endo-0.3.0/.vscode/settings.json

@@ -0,0 +1,36 @@
+{
+    "[python]": {
+        "editor.codeActionsOnSave": {
+            "source.fixAll.ruff": "always",
+            "source.organizeImports.ruff": "always",
+            "source.sort.json": "always"
+        },
+        "editor.defaultFormatter": "charliermarsh.ruff",
+        "editor.formatOnSave": true
+    },
+    "[toml]": {
+        "editor.defaultFormatter": "tamasfe.even-better-toml",
+        "editor.formatOnSave": true
+    },
+    "evenBetterToml.formatter.alignComments": true,
+    "evenBetterToml.formatter.alignEntries": true,
+    "evenBetterToml.formatter.allowedBlankLines": 1,
+    "evenBetterToml.formatter.arrayAutoCollapse": true,
+    "evenBetterToml.formatter.arrayAutoExpand": true,
+    "evenBetterToml.formatter.arrayTrailingComma": true,
+    "evenBetterToml.formatter.columnWidth": 120,
+    "evenBetterToml.formatter.compactEntries": false,
+    "evenBetterToml.formatter.indentEntries": false,
+    "evenBetterToml.formatter.indentTables": false,
+    "evenBetterToml.formatter.reorderArrays": true,
+    "evenBetterToml.formatter.reorderInlineTables": true,
+    "evenBetterToml.formatter.reorderKeys": true,
+    "python.languageServer": "None",
+    "python.testing.pytestArgs": [
+        "src",
+        "tests",
+    ],
+    "python.testing.pytestEnabled": true,
+    "python.testing.unittestEnabled": false,
+    "ruff.importStrategy": "fromEnvironment"
+}

endo-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 endo Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

endo-0.3.0/PKG-INFO

@@ -0,0 +1,169 @@
+Metadata-Version: 2.4
+Name: endo
+Version: 0.3.0
+Summary: Integrated Product Development Platform for Structural Design
+Project-URL: Changelog, https://github.com/endo/endo/releases
+Project-URL: Documentation, https://github.com/endo/endo#readme
+Project-URL: Homepage, https://github.com/endo/endo
+Project-URL: Issues, https://github.com/endo/endo/issues
+Project-URL: Repository, https://github.com/endo/endo
+Author-email: endo Team <dev@endo.example.com>
+Maintainer-email: endo Team <dev@endo.example.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: fastapi,ipd,product-development,requirements,traceability
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business
+Classifier: Topic :: Software Development
+Requires-Python: >=3.9
+Requires-Dist: alembic>=1.14.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: openpyxl>=3.1.0
+Requires-Dist: pdfplumber>=0.11.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-docx>=1.1.0
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: sqlalchemy>=2.0.0
+Requires-Dist: uvicorn[standard]>=0.34.0
+Provides-Extra: dev
+Requires-Dist: hatch>=1.14.2; extra == 'dev'
+Requires-Dist: httpx>=0.28.0; extra == 'dev'
+Requires-Dist: prek>=0.4.5; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest-html>=4.1.1; extra == 'dev'
+Requires-Dist: pytest-mock>=3.14.0; extra == 'dev'
+Requires-Dist: pytest-xdist>=3.6.1; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Requires-Dist: tox-uv>=1.13.1; extra == 'dev'
+Requires-Dist: tox>=4.25.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# endo
+
+**Integrated Product Development Platform for Structural Design**
+
+endo 是一个面向结构设计领域的集成产品开发平台，提供需求管理、追溯矩阵、测试管理与文档导出能力。
+
+## 功能特性
+
+- **需求管理**：层级需求树、版本控制、评审流程
+- **追溯矩阵**：需求间双向追溯关系（衍生/依赖/验证/满足）
+- **测试管理**：测试用例库、执行记录、缺陷跟踪
+- **附件管理**：多态关联文件上传/下载（项目/需求/测试用例）
+- **文档导出**：需求规格书 PDF、追溯矩阵 Excel、测试报告 PDF
+- **插件架构**：模块化设计，按需启用功能插件
+- **影响分析**：需求变更影响范围分析
+
+## 快速开始
+
+### 安装
+
+```bash
+pip install endo
+```
+
+### 启动服务
+
+```bash
+# 启动后端 API 服务（默认 127.0.0.1:8000）
+ipd
+
+# 指定监听地址和端口
+ipd serve --host 0.0.0.0 --port 8080
+
+# 开发模式（自动重载）
+ipd serve --reload
+```
+
+访问 API 文档：http://127.0.0.1:8000/docs
+
+### 开发模式（前后端联调）
+
+在源码仓库内执行：
+
+```bash
+ipd dev    # 同时启动后端(8000)和前端(5173)
+```
+
+## 技术栈
+
+**后端**
+- FastAPI + Uvicorn（异步 Web 框架）
+- SQLAlchemy 2.0 + Alembic（ORM 与迁移）
+- Pydantic v2（数据校验）
+- ReportLab / OpenPyXL（PDF / Excel 生成）
+
+**前端**
+- React 18 + TypeScript
+- Ant Design 5（UI 组件库）
+- Vite（构建工具）
+
+## 项目结构
+
+```
+endo/
+├── backend/
+│   └── endo/
+│       ├── api/v1/          # REST API 端点
+│       ├── core/            # 配置、数据库、插件注册
+│       ├── models/          # SQLAlchemy 数据模型
+│       ├── schemas/         # Pydantic 校验模型
+│       ├── services/        # 业务逻辑（导出、解析）
+│       ├── plugins/         # 功能插件
+│       └── main.py          # 应用入口
+├── frontend/                # React 前端
+├── tests/                   # 测试
+└── pyproject.toml
+```
+
+## 插件体系
+
+endo 采用插件架构，核心功能以插件形式注册：
+
+| 插件 | 功能 |
+|------|------|
+| `project` | 项目管理 |
+| `requirement` | 需求管理 + 追溯关系 |
+| `test` | 测试用例 + 执行记录 |
+| `analysis` | 影响分析 |
+| `attachment` | 文件附件管理 |
+| `export` | 文档导出（PDF/Excel） |
+
+## 开发
+
+```bash
+# 安装开发依赖
+uv sync --extra dev
+
+# 运行测试
+ipd test
+
+# 代码检查
+ipd lint
+
+# 构建前后端
+ipd build
+```
+
+## 系统要求
+
+- **操作系统**：Windows 10+ / macOS 10.15+ / Linux
+- **Python**：3.9+
+- **Node.js**：20+（仅开发前端时需要）
+
+## 许可证
+
+[MIT](LICENSE)

endo-0.3.0/README.md

@@ -0,0 +1,116 @@
+# endo
+
+**Integrated Product Development Platform for Structural Design**
+
+endo 是一个面向结构设计领域的集成产品开发平台，提供需求管理、追溯矩阵、测试管理与文档导出能力。
+
+## 功能特性
+
+- **需求管理**：层级需求树、版本控制、评审流程
+- **追溯矩阵**：需求间双向追溯关系（衍生/依赖/验证/满足）
+- **测试管理**：测试用例库、执行记录、缺陷跟踪
+- **附件管理**：多态关联文件上传/下载（项目/需求/测试用例）
+- **文档导出**：需求规格书 PDF、追溯矩阵 Excel、测试报告 PDF
+- **插件架构**：模块化设计，按需启用功能插件
+- **影响分析**：需求变更影响范围分析
+
+## 快速开始
+
+### 安装
+
+```bash
+pip install endo
+```
+
+### 启动服务
+
+```bash
+# 启动后端 API 服务（默认 127.0.0.1:8000）
+ipd
+
+# 指定监听地址和端口
+ipd serve --host 0.0.0.0 --port 8080
+
+# 开发模式（自动重载）
+ipd serve --reload
+```
+
+访问 API 文档：http://127.0.0.1:8000/docs
+
+### 开发模式（前后端联调）
+
+在源码仓库内执行：
+
+```bash
+ipd dev    # 同时启动后端(8000)和前端(5173)
+```
+
+## 技术栈
+
+**后端**
+- FastAPI + Uvicorn（异步 Web 框架）
+- SQLAlchemy 2.0 + Alembic（ORM 与迁移）
+- Pydantic v2（数据校验）
+- ReportLab / OpenPyXL（PDF / Excel 生成）
+
+**前端**
+- React 18 + TypeScript
+- Ant Design 5（UI 组件库）
+- Vite（构建工具）
+
+## 项目结构
+
+```
+endo/
+├── backend/
+│   └── endo/
+│       ├── api/v1/          # REST API 端点
+│       ├── core/            # 配置、数据库、插件注册
+│       ├── models/          # SQLAlchemy 数据模型
+│       ├── schemas/         # Pydantic 校验模型
+│       ├── services/        # 业务逻辑（导出、解析）
+│       ├── plugins/         # 功能插件
+│       └── main.py          # 应用入口
+├── frontend/                # React 前端
+├── tests/                   # 测试
+└── pyproject.toml
+```
+
+## 插件体系
+
+endo 采用插件架构，核心功能以插件形式注册：
+
+| 插件 | 功能 |
+|------|------|
+| `project` | 项目管理 |
+| `requirement` | 需求管理 + 追溯关系 |
+| `test` | 测试用例 + 执行记录 |
+| `analysis` | 影响分析 |
+| `attachment` | 文件附件管理 |
+| `export` | 文档导出（PDF/Excel） |
+
+## 开发
+
+```bash
+# 安装开发依赖
+uv sync --extra dev
+
+# 运行测试
+ipd test
+
+# 代码检查
+ipd lint
+
+# 构建前后端
+ipd build
+```
+
+## 系统要求
+
+- **操作系统**：Windows 10+ / macOS 10.15+ / Linux
+- **Python**：3.9+
+- **Node.js**：20+（仅开发前端时需要）
+
+## 许可证
+
+[MIT](LICENSE)

endo-0.3.0/backend/endo/api/deps.py

@@ -0,0 +1,5 @@
+"""API 依赖注入"""
+
+from endo.core.database import get_db
+
+__all__ = ["get_db"]

endo-0.3.0/backend/endo/api/v1/analysis.py

@@ -0,0 +1,82 @@
+"""文档解析 API 路由"""
+
+import io
+
+from fastapi import APIRouter, Depends, File, HTTPException, UploadFile
+from sqlalchemy.orm import Session
+
+from endo.api.deps import get_db
+from endo.models.requirement import Requirement
+from endo.schemas.analysis import (
+    ImportResult,
+    ImportToRequirementRequest,
+    ParseResultResponse,
+)
+from endo.services.document_parser import parse_document
+
+router = APIRouter()
+
+
+@router.post("/parse", response_model=ParseResultResponse)
+async def parse_file(file: UploadFile = File(...)):
+    """上传文件并解析出结构化技术要求"""
+    if not file.filename:
+        raise HTTPException(status_code=400, detail="文件名不能为空")
+
+    content = await file.read()
+    if not content:
+        raise HTTPException(status_code=400, detail="文件内容为空")
+
+    # 限制文件大小 20MB
+    if len(content) > 20 * 1024 * 1024:
+        raise HTTPException(status_code=413, detail="文件过大，限制 20MB")
+
+    try:
+        result = parse_document(
+            io.BytesIO(content),
+            file.filename,
+            file.content_type or "",
+        )
+    except ValueError as e:
+        raise HTTPException(status_code=400, detail=str(e)) from e
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=f"解析失败: {e}") from e
+
+    return result.to_dict()
+
+
+@router.post("/import", response_model=ImportResult, status_code=201)
+def import_to_requirements(
+    data: ImportToRequirementRequest,
+    db: Session = Depends(get_db),
+):
+    """将解析结果导入为需求条目"""
+    if not data.items:
+        raise HTTPException(status_code=400, detail="没有可导入的条目")
+
+    created: list[dict] = []
+    for item in data.items:
+        params = [p.model_dump() for p in item.parameters]
+        # 参数摘要追加到描述
+        param_summary = ""
+        if params:
+            param_summary = "\n\n关键参数:\n" + "\n".join(
+                f"- {p['name']} {p['operator']} {p['value']} {p['unit']}".strip() for p in params
+            )
+
+        req = Requirement(
+            project_id=data.project_id,
+            req_code=item.raw_code or f"REQ-{item.index:03d}",
+            title=item.title or f"导入条目 {item.index}",
+            description=item.content + param_summary,
+            category=item.category,
+            priority=data.default_priority,
+            source=data.default_source or "文档解析导入",
+            created_by=data.created_by,
+            structural_constraints={"parameters": params} if params else None,
+        )
+        db.add(req)
+        created.append({"req_code": req.req_code, "title": req.title})
+
+    db.commit()
+    return ImportResult(imported=len(created), items=created)