# lingda

**Repository Path**: jiangkun-13/lingda

## Basic Information

- **Project Name**: lingda
- **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-05-25
- **Last Updated**: 2026-05-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LingDa — AI 智能对话机器人平台

企业级 AI 知识库对话平台，对标百炼 / FastGPT / Dify 核心能力子集。

## 技术栈

| 层级 | 技术 |
|------|------|
| 后端 | Python 3.11、FastAPI、MySQL、Redis、Qdrant、LangChain |
| 前端 | React + Umi Max + Ant Design Pro + Ant Design Charts |
| 部署 | Docker Compose |

- **项目介绍（推荐先读）**：[docs/PROJECT-INTRO.md](docs/PROJECT-INTRO.md)  
- 开发与范围：[docs/DEV-REQUIREMENTS.md](docs/DEV-REQUIREMENTS.md)、[docs/MVP-SCOPE.md](docs/MVP-SCOPE.md)  
- 功能配置：[docs/FEATURES-GUIDE.md](docs/FEATURES-GUIDE.md)、[docs/CONFIG.md](docs/CONFIG.md)、[docs/DATABASE.md](docs/DATABASE.md)  
- 开放 API 联调：[docs/OPEN-API-CHECKLIST.md](docs/OPEN-API-CHECKLIST.md)

## 快速启动

> 终端报 `command not found: docker`？见 [docs/INSTALL-DOCKER.md](docs/INSTALL-DOCKER.md) 或 [docs/DEV-LOCAL.md](docs/DEV-LOCAL.md)。

### 1. 环境配置

```bash
cp .env.example .env
# 至少配置 LLM_API_KEY；可选 RERANK_*、HYBRID_*、SMTP_*、USAGE_ALERT_*
```

### 2. Docker 一键启动

```bash
./scripts/docker-up.sh
./scripts/docker-smoke.sh
```

- 前端：http://localhost:3000
- 后端：http://localhost:8000（文档 `/docs`）

### 3. 本地开发（本机 MySQL）

```bash
brew services start mysql
./scripts/setup-mysql-local.sh
./scripts/migrate-002-local.sh
./scripts/migrate-005-local.sh
./scripts/migrate-006-local.sh
./scripts/migrate-007-local.sh
./scripts/migrate-010-local.sh
./scripts/migrate-011-local.sh
./scripts/migrate-012-local.sh
./scripts/migrate-013-local.sh
./scripts/migrate-014-local.sh
./scripts/migrate-015-local.sh
./scripts/migrate-016-local.sh
./scripts/migrate-017-local.sh
./scripts/migrate-018-local.sh
./scripts/dev-deps.sh

Docker 全套开发时，对本机 **容器内** MySQL 执行迁移：

```bash
./scripts/migrate-017-docker.sh
docker compose restart backend
```
./scripts/dev-backend.sh --install
cd frontend && npm install && npm run dev
```

详见 [docs/DEV-LOCAL-MYSQL.md](docs/DEV-LOCAL-MYSQL.md)、[docs/RAG-WALKTHROUGH.md](docs/RAG-WALKTHROUGH.md)。

**上线前收尾（Phase 3）**：[docs/DEPLOY-PHASE3.md](docs/DEPLOY-PHASE3.md) · `./scripts/launch-prep.sh`  
**生产部署清单**：[docs/DEPLOY-PRODUCTION.md](docs/DEPLOY-PRODUCTION.md)（HTTPS、Webhook 队列、Qdrant 收紧、监控备份）

## 已实现能力（摘要）

| 模块 | 能力 |
|------|------|
| 账号 | 注册 / 登录（JWT）、**OIDC SSO**、头像、个人中心 |
| 工作区 | 多工作区、`X-Workspace-Id` 隔离、角色、邀请链接 + **邀请邮件**、**席位/账单雏形** |
| 协作 | 资源级 ACL、审计日志 + CSV、团队向量化配置 |
| 机器人 | CRUD、回复模式、RAG 参数/过滤/**切片标签白名单** |
| 知识库 | 文件/URL、**Playwright** 可选、切片管理、**批量打标签** |
| RAG | 混合检索、Rerank、召回评测 + 导出、**问句集保存** |
| 对话 | SSE、Markdown、RAG 来源 **跳转知识库** |
| 开放 API | 流式 + **非流式**、**CORS**、**Key 权限**、**对话结束 Webhook** |
| 团队 | 邀请**邮件状态**、**向量化引导**、开放集成配置、**成员离岗数据回收** |
| 运维 | `/health` 依赖检查、JSON 日志、可选 **OpenTelemetry** |
| 向量 | Qdrant 集合 **`ws_{workspace_id}_*` 前缀隔离**（可迁移旧集合） |
| 合规 | 敏感词、备份/导出、Key 轮换、用量告警 + **企微/邮件外发** |

## 暂缓

真实支付网关、Qdrant 向量级冷备、本地模型集群等 — 见 [docs/DEV-REQUIREMENTS.md](docs/DEV-REQUIREMENTS.md)。