# moqui-solutionDesigner

**Repository Path**: hitscs/moqui-solutionDesigner

## Basic Information

- **Project Name**: moqui-solutionDesigner
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-28
- **Last Updated**: 2026-09-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 方案设计师组件（solution-designer）

## 简介

Moqui 组件，用于构建企业软硬件方案知识库，并基于 AI 为新客户生成组合方案。

## 核心功能

- 供应商管理：设备、软件、软硬件供应商信息录入与 CSV 导入。
- 产品管理：硬件/软件产品、能力描述（能做/不能做）、价格、适用范围。
- 产品规格：软件（数据库、开发语言、操作系统、部署方式、授权模式等）、硬件（性能、功耗、环境、维保等）。
- 行业与客户：行业字典、客户信息、客户需求与访谈记录。
- 历史方案库：项目方案、使用产品、项目成员、角色、工期、成本。
- AI 方案生成：基于知识库生成多套安全、稳定、成本合理、运维方便的方案。

## 目录结构

```
runtime/component/solution-designer/
├── component.xml
├── MoquiConf.xml
├── README.md
├── entity/SolutionDesigner_Entities.xml
├── service/                                # 实体自动 CRUD 服务
│   ├── SolutionDesignerServices.xml
│   └── solution/design/                    # 按包名映射目录（Moqui 服务路径规则）
│       ├── AiServices.xml                  # generate#SolutionProposals、generate#InterviewTemplate
│       └── SupplierServices.xml            # import#SupplierCsv
├── script/solution/design/
│   ├── AiServices.groovy                   # AI 方案生成实现
│   └── ImportServices.groovy               # 供应商 CSV 导入实现
├── data/
│   ├── SolutionDesignerSeedData.xml        # 枚举、AI 配置等种子数据
│   ├── SolutionDesignerDemoData.xml        # 演示/测试样例数据（供应商、产品、客户、方案等）
│   └── SolutionDesignerL10nZhData.xml      # 中文本地化消息
└── screen/SolutionDesigner/
    ├── SolutionDesigner_Screens.xml        # 顶层：基础数据 / 业务管理 / 系统设置 三分组
    ├── BasicData/                          # 供应商、产品、产品分类、行业
    ├── Business/                           # 客户、客户需求、历史方案、方案库、AI 生成
    └── System/                             # 系统配置
```

## 安装与运行

1. 确保 Moqui 框架已正确配置。
2. 加载种子数据：
   ```bash
   ./gradlew.bat load
   ```
3. 启动服务：
   ```bash
   ./gradlew.bat run
   ```
4. 登录后，在应用菜单中找到“方案设计师”即可使用。

## AI 服务配置

### 方式一：通过界面配置（推荐）

启动后进入菜单 **方案设计师 → AI 配置**，可直接修改：

- **接口 URL**：本地模型服务端点，例如 `http://localhost:11434/v1/chat/completions`（Ollama）
- **模型名称**：例如 `llama3.1`、`qwen2.5`、`deepseek-r1`
- **API Key**：本地模型通常留空；如需鉴权则填写
- **超时时间**：默认 120 秒

保存后立即生效，无需重启。

### 方式二：编辑种子数据

修改 `data/SolutionDesignerSeedData.xml` 中的 `SystemMessageRemote` 和 `AiSolutionConfig`：

```xml
<moqui.service.message.SystemMessageRemote systemMessageRemoteId="AI_SOLUTION_PROVIDER"
        description="方案生成 AI 服务商" systemMessageTypeId="AiSolutionProvider"
        sendUrl="http://localhost:11434/v1/chat/completions"/>
<solution.design.AiSolutionConfig aiSolutionConfigId="AI_SOLUTION_CONFIG"
        systemMessageRemoteId="AI_SOLUTION_PROVIDER"
        modelName="llama3.1"
        timeoutSeconds="120"/>
```

重新执行 `./gradlew.bat load` 后生效。

### 支持的本地模型服务

- Ollama：`http://localhost:11434/v1/chat/completions`
- vLLM：`http://localhost:8000/v1/chat/completions`
- Xinference：`http://localhost:9997/v1/chat/completions`

## 演示数据

`data/SolutionDesignerDemoData.xml` 提供一套完整连贯的演示数据（供应商 8 家、产品 12 个、客户 5 家、客户需求 5 条、历史方案 3 个、AI 生成方案 2 套含推荐产品与维度评分），供测试与演示：

```bash
./gradlew.bat load    # 会同时加载 demo 类型数据
```

服务器运行中时，也可通过 Tools → Entity → DataImport 页面导入。

## 中文本地化

form 字段标签通过 `moqui.basic.LocalizedMessage` 实体数据（`data/SolutionDesignerL10nZhData.xml`）实现中文化：字段名自动拆词后按用户 locale（zh_CN → zh → default）查找译文，页面 XML 无需逐个写 title。新增字段时在 L10n 数据文件补一条记录并重新导入即可。

## 访谈记录模板

在“客户需求”编辑页面点击“生成访谈模板”，系统会根据客户所属行业生成结构化访谈提纲。

## 注意事项

- 新增实体字段后需重启服务（`entity_add_missing_startup=true`）。
- 新增种子数据后需显式执行 `./gradlew.bat load`。