# 云美企业知识库

> 西安云美电子科技有限公司 - 基于 Dify + DeepSeek 的企业内部知识库

## 项目简介

本项目为云美电子科技搭建企业内部知识库系统，员工可通过对话式 AI 快速检索公司文档、获取智能问答。基于 **Dify 社区版（Docker 自部署）** + **DeepSeek 大模型** 构建。

## 技术栈

| 组件 | 说明 |
|------|------|
| Dify | AI 应用开发平台（社区版 Docker 部署） |
| DeepSeek | 大语言模型（deepseek-chat） |
| PostgreSQL | 关系数据库 |
| Redis | 缓存与消息队列 |
| Qdrant | 向量数据库 |
| Nginx | 反向代理 |

## 项目结构

```
dify-app/
├── docker/                      # Docker 部署配置
│   ├── docker-compose.yml       # 服务编排
│   ├── .env.example             # 环境变量模板
│   └── README.md                # Docker 部署说明
│
├── docs/                        # 项目文档
│   ├── knowledge-base-structure.md   # 知识库结构设计
│   ├── performance-baseline.md      # 性能基线指标
│   ├── api-integration.md           # API 集成指南
│   └── deployment-guide.md          # 完整部署指南
│
├── prompts/                     # 提示词
│   └── system-prompt.md        # 系统提示词与对话策略
│
├── tests/                       # 测试
│   └── test-cases.md            # 功能/安全测试用例
│
├── dsl/                         # Dify 应用配置
│   └── app-config.yaml          # 应用 DSL 配置模板
│
├── tasks.md                     # 任务清单
├── .gitignore                   # Git 忽略规则
└── README.md                    # 本文件
```

## 快速开始

```bash
# 1. 克隆项目
git clone http://git.xayunmei.com/yunmei/dify-app.git
cd dify-app
git checkout feature/dev

# 2. 配置环境变量
cd docker
cp .env.example .env
# 编辑 .env 填写 SECRET_KEY、数据库密码、DeepSeek API Key

# 3. 启动服务
docker compose up -d

# 4. 访问
# 浏览器打开 http://<服务器IP>:80
```

详细部署步骤请参考 [部署指南](docs/deployment-guide.md)。

## 知识库分类

| 分类 | 内容 |
|------|------|
| 📋 公司概况 | 公司简介、组织架构、联系方式 |
| 🔧 产品技术 | 产品手册、技术规范、技术方案 |
| ✅ 质量管理 | 质量体系、检测标准、计量规程 |
| 📄 制度流程 | 管理制度、审批流程、操作规程 |
| 📚 培训学习 | 培训材料、学习资源 |
| 📁 项目档案 | 项目文档、合同模板 |
| ❓ 常见问题 | IT支持、行政事务、售后FAQ |

## API 文档

知识库对话、文档管理等 API 接口文档：[API 集成指南](docs/api-integration.md)

## 测试

功能测试用例（37 个）：[测试用例](tests/test-cases.md)

## Git 分支策略

| 分支 | 用途 |
|------|------|
| `main` | 生产发布分支 |
| `feature/dev` | 开发分支（日常开发在此分支） |

## 相关文档

| 文档 | 说明 |
|------|------|
| [知识库结构设计](docs/knowledge-base-structure.md) | 分类体系、分段策略、维护规范 |
| [性能基线指标](docs/performance-baseline.md) | 响应时间、准确率、并发指标 |
| [API 集成指南](docs/api-integration.md) | RESTful API、代码示例 |
| [完整部署指南](docs/deployment-guide.md) | 从服务器到上线的全流程 |
| [系统提示词设计](prompts/system-prompt.md) | 角色定义、回答规范、推荐问题 |
| [Dify 应用配置](dsl/app-config.yaml) | DSL 模板（可导入 Dify） |

---

**西安云美电子科技有限公司** © 2026