# nova-plus

**Repository Path**: baoyunli/nova-plus

## Basic Information

- **Project Name**: nova-plus
- **Description**: nova vibe coding 版本
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-23
- **Last Updated**: 2026-01-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: nova

## README

# Nova Plus 项目文档

## 项目简介

Nova Plus 是一个基于AI Agent的智能物流业务管理系统，为企业提供订舱、报关、跟踪等全流程的智能化服务。

### 核心特性

- 🤖 **AI Agent驱动**：基于LangChain4j和DeepSeek大模型
- 💬 **统一Chatbox**：智能对话入口，自动识别业务意图
- ✅ **人工审核**：关键环节人工监督AI决策（Human-in-the-Loop）
- 📦 **业务流程管理**：订舱、报关、在途跟踪、尾程调度

---

## 技术栈

| 类别      | 技术                                              |
|---------|-------------------------------------------------|
| **后端**  | JDK 25 + Spring Boot 4.0.1 + LangChain4j 1.10.0 |
| **数据库** | MySQL 8.0+ + Redis                              |
| **LLM** | DeepSeek (深度求索)                                 |
| **认证**  | JWT Token                                       |
| **前端**  | React 18 + TypeScript                           |
| **部署**  | 单体部署（前后端分离）                                     |

---

## 文档结构

```
docs/
├── guide/                        # 开发指南
│   ├── ARCHITECTURE.md           # 技术架构设计
│   ├── BACKEND_GUIDE.md          # 后端开发指南
│   ├── FRONTEND_GUIDE.md         # 前端开发指南
│   ├── ENV_SETUP.md              # 环境配置指南
│   └── MODULE_DOCS_GUIDE.md      # 模块文档规范
│
└── modules/                      # 模块需求文档（每个模块4个文件）
    ├── user/                     # 用户模块（已完成）
    │   ├── README.md             # 模块概述
    │   ├── requirements.md       # 产品需求文档（PRD）
    │   ├── database-design.md    # 数据库设计（DDL）
    │   └── api-design.md         # API接口文档
    │
    ├── chat/                     # 对话模块（待开发）
    ├── approval/                 # 审核模块（待开发）
    ├── tracking/                 # 跟踪模块（待开发）
    ├── booking/                  # 订舱模块（待开发）
    └── customs/                  # 报关模块（待开发）
```

**模块文档说明**：每个模块的需求、API设计、数据库设计都在 `docs/modules/[module-name]/` 下。

---

## 模块列表

### 基础模块

| 模块 | 状态   | 说明                |
|----|------|-------------------|
| 用户 | ✅ 完成 | 用户注册、登录、密码管理、信息维护、邮箱配置 |

### Agent模块

| 模块 | 状态    | 说明                          |
|----|-------|-----------------------------|
| Agent模板 | ✅ 完成 | Agent模板管理、用户实例配置、启用/禁用 |
| Email Agent | 🚧 规划 | 邮件沟通Agent、自动化协调上下游资源 |

### 业务模块（开发中）

| 模块 | 状态    | 说明                          |
|----|-------|-----------------------------|
| 对话 | 🚧 规划 | Chatbox、SupervisorAgent智能路由 |
| 审核 | 🚧 规划 | 人工审核AI决策                    |
| 跟踪 | 🚧 规划 | 货物状态跟踪、定时任务                 |
| 订舱 | 🚧 规划 | 运费报价                        |
| 报关 | 🚧 规划 | 材料检查、报关提交                   |

---