Metadata-Version: 2.4
Name: PanoramaBase
Version: 0.0.1
Summary: PanoramaBase is a multi-language scaffold generator with AI pair programming
Project-URL: Homepage, https://github.com/PanoramaBase/PanoramaBase
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
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: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development
Requires-Python: <3.15,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: aiohappyeyeballs==2.6.1
Requires-Dist: aiohttp==3.13.3
Requires-Dist: aiosignal==1.4.0
Requires-Dist: annotated-doc==0.0.4
Requires-Dist: annotated-types==0.7.0
Requires-Dist: anyio==4.12.1
Requires-Dist: asgiref==3.11.1
Requires-Dist: attrs==25.4.0
Requires-Dist: backoff==2.2.1
Requires-Dist: beautifulsoup4==4.14.3
Requires-Dist: certifi==2026.2.25
Requires-Dist: cffi==2.0.0
Requires-Dist: charset-normalizer==3.4.6
Requires-Dist: click==8.3.1
Requires-Dist: configargparse==1.7.5
Requires-Dist: diff-match-patch==20241021
Requires-Dist: diskcache==5.6.3
Requires-Dist: distro==1.9.0
Requires-Dist: fastapi==0.135.1
Requires-Dist: fastuuid==0.14.0
Requires-Dist: filelock==3.25.2
Requires-Dist: flake8==7.3.0
Requires-Dist: frozenlist==1.8.0
Requires-Dist: fsspec==2026.2.0
Requires-Dist: gitdb==4.0.12
Requires-Dist: gitpython==3.1.46
Requires-Dist: grep-ast==0.9.0
Requires-Dist: h11==0.16.0
Requires-Dist: hf-xet==1.4.2
Requires-Dist: httpcore==1.0.9
Requires-Dist: httpx==0.28.1
Requires-Dist: huggingface-hub==1.7.1
Requires-Dist: idna==3.11
Requires-Dist: importlib-metadata==7.2.1
Requires-Dist: importlib-resources==6.5.2
Requires-Dist: jinja2==3.1.6
Requires-Dist: jiter==0.13.0
Requires-Dist: json5==0.13.0
Requires-Dist: jsonschema==4.26.0
Requires-Dist: jsonschema-specifications==2025.9.1
Requires-Dist: litellm==1.82.3
Requires-Dist: markdown-it-py==4.0.0
Requires-Dist: markupsafe==3.0.3
Requires-Dist: mccabe==0.7.0
Requires-Dist: mdurl==0.1.2
Requires-Dist: mslex==1.3.0
Requires-Dist: multidict==6.7.1
Requires-Dist: networkx==3.4.2
Requires-Dist: openai==2.28.0
Requires-Dist: orjson==3.11.7
Requires-Dist: oslex==0.1.3
Requires-Dist: packaging==26.0
Requires-Dist: pathspec==1.0.4
Requires-Dist: pexpect==4.9.0
Requires-Dist: pillow==12.1.1
Requires-Dist: prompt-toolkit==3.0.52
Requires-Dist: propcache==0.4.1
Requires-Dist: psutil==7.2.2
Requires-Dist: ptyprocess==0.7.0
Requires-Dist: pycodestyle==2.14.0
Requires-Dist: pycparser==3.0
Requires-Dist: pydantic==2.12.5
Requires-Dist: pydantic-core==2.41.5
Requires-Dist: pyflakes==3.4.0
Requires-Dist: pygments==2.19.2
Requires-Dist: pyperclip==1.11.0
Requires-Dist: python-dateutil==2.9.0.post0
Requires-Dist: python-dotenv==1.2.2
Requires-Dist: pyyaml==6.0.3
Requires-Dist: referencing==0.37.0
Requires-Dist: regex==2026.2.28
Requires-Dist: requests==2.32.5
Requires-Dist: rich==14.3.3
Requires-Dist: rpds-py==0.30.0
Requires-Dist: shellingham==1.5.4
Requires-Dist: shtab==1.8.0
Requires-Dist: six==1.17.0
Requires-Dist: smmap==5.0.3
Requires-Dist: sniffio==1.3.1
Requires-Dist: socksio==1.0.0
Requires-Dist: soupsieve==2.8.3
Requires-Dist: starlette==0.52.1
Requires-Dist: tiktoken==0.12.0
Requires-Dist: tokenizers==0.22.2
Requires-Dist: tqdm==4.67.3
Requires-Dist: tree-sitter-c-sharp==0.23.1
Requires-Dist: tree-sitter-embedded-template==0.25.0
Requires-Dist: tree-sitter-language-pack==0.13.0
Requires-Dist: tree-sitter-yaml==0.7.2
Requires-Dist: typer==0.24.1
Requires-Dist: typing-extensions==4.15.0
Requires-Dist: typing-inspection==0.4.2
Requires-Dist: urllib3==2.6.3
Requires-Dist: watchfiles==1.1.1
Requires-Dist: wcwidth==0.6.0
Requires-Dist: yarl==1.23.0
Requires-Dist: zipp==3.23.0
Requires-Dist: tree-sitter==0.23.2; python_version < "3.10"
Requires-Dist: tree-sitter==0.25.2; python_version >= "3.10"
Requires-Dist: numpy<2; python_version < "3.11"
Requires-Dist: numpy<2.5,>=2.3; python_version >= "3.11"
Requires-Dist: scipy<1.16; python_version < "3.11"
Requires-Dist: scipy<1.18,>=1.16.1; python_version >= "3.11"
Provides-Extra: dev
Requires-Dist: annotated-doc==0.0.4; extra == "dev"
Requires-Dist: build==1.4.0; extra == "dev"
Requires-Dist: certifi==2026.2.25; extra == "dev"
Requires-Dist: cffi==2.0.0; extra == "dev"
Requires-Dist: cfgv==3.5.0; extra == "dev"
Requires-Dist: charset-normalizer==3.4.6; extra == "dev"
Requires-Dist: click==8.3.1; extra == "dev"
Requires-Dist: codespell==2.4.2; extra == "dev"
Requires-Dist: cogapp==3.6.0; extra == "dev"
Requires-Dist: contourpy==1.3.3; extra == "dev"
Requires-Dist: coverage[toml]==7.13.4; extra == "dev"
Requires-Dist: cryptography==46.0.5; extra == "dev"
Requires-Dist: cycler==0.12.1; extra == "dev"
Requires-Dist: distlib==0.4.0; extra == "dev"
Requires-Dist: filelock==3.25.2; extra == "dev"
Requires-Dist: fonttools==4.62.1; extra == "dev"
Requires-Dist: google-api-core[grpc]==2.30.0; extra == "dev"
Requires-Dist: google-auth==2.49.1; extra == "dev"
Requires-Dist: google-cloud-bigquery==3.40.1; extra == "dev"
Requires-Dist: google-cloud-core==2.5.0; extra == "dev"
Requires-Dist: google-crc32c==1.8.0; extra == "dev"
Requires-Dist: google-resumable-media==2.8.0; extra == "dev"
Requires-Dist: googleapis-common-protos==1.73.0; extra == "dev"
Requires-Dist: grpcio==1.78.0; extra == "dev"
Requires-Dist: grpcio-status==1.78.0; extra == "dev"
Requires-Dist: identify==2.6.18; extra == "dev"
Requires-Dist: idna==3.11; extra == "dev"
Requires-Dist: imgcat==0.6.0; extra == "dev"
Requires-Dist: iniconfig==2.3.0; extra == "dev"
Requires-Dist: kiwisolver==1.5.0; extra == "dev"
Requires-Dist: lox==1.0.0; extra == "dev"
Requires-Dist: markdown-it-py==4.0.0; extra == "dev"
Requires-Dist: matplotlib==3.10.8; extra == "dev"
Requires-Dist: mdurl==0.1.2; extra == "dev"
Requires-Dist: nodeenv==1.10.0; extra == "dev"
Requires-Dist: numpy==2.4.3; extra == "dev"
Requires-Dist: packaging==26.0; extra == "dev"
Requires-Dist: pandas==2.3.3; extra == "dev"
Requires-Dist: pillow==12.1.1; extra == "dev"
Requires-Dist: pip==26.0.1; extra == "dev"
Requires-Dist: pip-tools==7.5.3; extra == "dev"
Requires-Dist: platformdirs==4.9.4; extra == "dev"
Requires-Dist: pluggy==1.6.0; extra == "dev"
Requires-Dist: pre-commit==4.5.1; extra == "dev"
Requires-Dist: proto-plus==1.27.1; extra == "dev"
Requires-Dist: protobuf==6.33.5; extra == "dev"
Requires-Dist: pyasn1==0.6.2; extra == "dev"
Requires-Dist: pyasn1-modules==0.4.2; extra == "dev"
Requires-Dist: pycparser==3.0; extra == "dev"
Requires-Dist: pygments==2.19.2; extra == "dev"
Requires-Dist: pyparsing==3.3.2; extra == "dev"
Requires-Dist: pyproject-hooks==1.2.0; extra == "dev"
Requires-Dist: pytest==9.0.2; extra == "dev"
Requires-Dist: pytest-cov==7.0.0; extra == "dev"
Requires-Dist: pytest-env==1.6.0; extra == "dev"
Requires-Dist: python-dateutil==2.9.0.post0; extra == "dev"
Requires-Dist: python-discovery==1.1.3; extra == "dev"
Requires-Dist: python-dotenv==1.2.2; extra == "dev"
Requires-Dist: pytz==2026.1.post1; extra == "dev"
Requires-Dist: pyyaml==6.0.3; extra == "dev"
Requires-Dist: requests==2.32.5; extra == "dev"
Requires-Dist: rich==14.3.3; extra == "dev"
Requires-Dist: semver==3.0.4; extra == "dev"
Requires-Dist: setuptools==82.0.1; extra == "dev"
Requires-Dist: shellingham==1.5.4; extra == "dev"
Requires-Dist: six==1.17.0; extra == "dev"
Requires-Dist: typer==0.24.1; extra == "dev"
Requires-Dist: typing-extensions==4.15.0; extra == "dev"
Requires-Dist: tzdata==2025.3; extra == "dev"
Requires-Dist: urllib3==2.6.3; extra == "dev"
Requires-Dist: uv==0.10.11; extra == "dev"
Requires-Dist: virtualenv==21.2.0; extra == "dev"
Requires-Dist: wheel==0.46.3; extra == "dev"
Dynamic: license-file

# PanoramaBase

PanoramaBase 是一个多语言脚手架生成器，支持 Java、Python、JavaScript、Nuxt3、Mastra 等语言的快速项目初始化，内置场景推荐引擎和 AI 辅助的交互式确认流程。

## 功能特性

- **多语言支持**: Java (Spring Boot)、Python (FastAPI)、JavaScript (Node ESM)、**Nuxt3 (Vue SSR)**、**Mastra (AI 编排)**
- **业务簇分类**:
  - **簇 A 电商**: Java SpringBoot（交易、订单、营销）
  - **簇 B Digital**: Nuxt3 Vue SSR（内部后台、门户）
  - **簇 C AI**: Mastra 编排 + Python FastAPI 推理
- **类型矩阵**: web-admin-api、agent、miniapp-api、data-sync、rest-aggregator、rag、**internal-admin**、**digital-portal**、**ai-orchestrator**、**ai-workflow**、**ai-inference**、**cv-service**、**nlp-service**
- **版本选择**: 每语言三档版本（如 Java 8/17/21，Python 3.11/3.12/3.13，Node 20/22/24）
- **中间件**: 数据库 (MySQL/PostgreSQL/SQLite/MongoDB)、缓存 (Redis)、消息队列 (RocketMQ/Kafka/Disruptor)
- **场景推荐**: 根据业务簇和项目类型自动推荐版本和中间件组合
- **交互确认**: `scaffold plan` 预览 → 确认 → 生成

## 快速开始

```bash
# 预览推荐配置
panoramabase scaffold plan "做一个 java 管理后台项目"

# 确认生成
panoramabase scaffold nl "做一个 python agent 项目，目录 my-agent" --yes

# 查看可用语言包
panoramabase scaffold list
```

## 业务簇分类

| 业务簇 | 技术栈 | 典型场景 | SLA |
|--------|--------|---------|-----|
| **A 电商** | Java SpringBoot | 交易、订单、营销、结算 | 99.99% |
| **B Digital** | Nuxt3 Vue SSR | 内部后台、门户、表单 | 99.5% |
| **C AI 编排** | Mastra (TS) | Agent 编排、RAG、Workflow | 99.9% |
| **C AI 推理** | Python FastAPI | CV、OCR、NLP、Embedding | 99.9% |

## 底座门面清单

### 基础门面（16 个）

| 门面 | 功能 | Java | Python | JS | Nuxt3 | Mastra |
|------|------|------|--------|-----|-------|--------|
| **LoginFacade** | 统一登录（钉钉/Office365/双因子） | ✅ | ✅ | ✅ | ✅ | ✅ |
| **PermissionFacade** | 权限控制（角色/资源/数据/API） | ✅ | ✅ | ✅ | ✅ | ✅ |
| **FileUploadFacade** | 文件上传（OSS/分片/断点续传） | ✅ | ✅ | ✅ | ✅ | ✅ |
| GatewayFacade | 网关路由、限流 | ✅ | ✅ | ✅ | ✅ | ✅ |
| DiscoveryFacade | 注册发现 | ✅ | ✅ | ✅ | ✅ | ✅ |
| ConfigFacade | 配置中心 | ✅ | ✅ | ✅ | ✅ | ✅ |
| SecretFacade | 密钥管理 | ✅ | ✅ | ✅ | ✅ | ✅ |
| SSOFacade | 身份 SSO | ✅ | ✅ | ✅ | ✅ | ✅ |
| CacheFacade | 缓存 Redis | ✅ | ✅ | ✅ | ✅ | ✅ |
| MQFacade | 消息队列 | ✅ | ✅ | ✅ | ✅ | ✅ |
| LockFacade | 分布式锁 | ✅ | ✅ | ✅ | ✅ | ✅ |
| IDFacade | 分布式 ID | ✅ | ✅ | ✅ | ✅ | ✅ |
| ScheduleFacade | 定时任务 | ✅ | ✅ | ✅ | ✅ | ✅ |
| OSSFacade | 对象存储 | ✅ | ✅ | ✅ | ✅ | ✅ |
| AuditFacade | 审计日志 | ✅ | ✅ | ✅ | ✅ | ✅ |
| DataPermissionFacade | 行级数据权限 | ✅ | ✅ | ✅ | ✅ | ✅ |

### AI 门面（6 个）

| 门面 | 功能 | Java | Python | JS | Nuxt3 | Mastra |
|------|------|------|--------|-----|-------|--------|
| RAGFacade | RAG 检索增强 | ✅ | ✅ | ✅ | ✅ | ✅ |
| ImageAIFacade | 图像 AI | ✅ | ✅ | ✅ | ✅ | ✅ |
| TextAIFacade | 文本 AI | ✅ | ✅ | ✅ | ✅ | ✅ |
| AudioAIFacade | 音频 AI | ✅ | ✅ | ✅ | ✅ | ✅ |
| VectorFacade | 向量操作 | ✅ | ✅ | ✅ | ✅ | ✅ |
| ModelInvokeFacade | 模型调用 | ✅ | ✅ | ✅ | ✅ | ✅ |

## 架构

```
panoramabase/scaffold/
  engine.py      # 渲染管线 (Jinja2 + 条件剪枝)
  manifest.py    # manifest 校验与参数收集
  recommend.py   # 场景推荐引擎（按业务簇推荐）
  intent.py      # 自然语言意图解析
  cli.py         # CLI 入口
  packs/         # 语言包
    java/        # 簇 A 电商
    nuxt3/       # 簇 B Digital
    mastra/      # 簇 C AI 编排
    python/      # 簇 C AI 推理
    js/          # 通用 Node
```

## 开发

```bash
# 安装依赖
pip install -e .

# 运行测试
pytest tests/basic/ -k scaffold -q
```

## 许可证

Apache-2.0
