# bigdata-uni-system

**Repository Path**: hongmei-bigdata/bigdata-uni-system

## Basic Information

- **Project Name**: bigdata-uni-system
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-17
- **Last Updated**: 2026-07-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 美菱产品大数据与AI应用中台

> Meiling Product Big Data & AI Application Platform — 统一入口的质量分析、专家系统、AI 智能监控平台，覆盖全品类家电。

[![license](https://img.shields.io/github/license/anncwb/vue-vben-admin.svg)](LICENSE)

[English](./README.md) | **中文**

## 概述

一个包含 **14+ 子系统** 的单体仓库（monorepo），覆盖**空调**、**冰箱**、**洗衣机**三大产品线：

- **品质分析系统（QAS）** — 全生命周期质量监控：开箱合格率、早期失效率、故障率等
- **专家系统（ES）** — IoT 设备管理与状态曲线诊断
- **AI 智控中枢（AI Hub）** — AI 节能、智能诊断、云端决策
- **智能调参系统** — 7×24 远程自动化调参与 AI 参数生成
- **智能诊断引擎** — 可配置的定时/临时/Webhook 触发诊断
- **耐久实验系统** — 204+ 工位实时远程监控
- **EAI 日志采集与分析** — 嵌入式 AI 日志平台

基于 [**Vue Vben Admin**](https://doc.vben.pro/)（Element Plus 版）构建，使用 Vue 3.5+、Vite 8、TypeScript、Tailwind CSS v4、pnpm 工作空间。

## 技术栈

| 层 | 技术 |
|-------|-----------|
| 框架 | [Vue 3.5](https://vuejs.org/) + [Vite 8](https://vite.dev/) + [TypeScript](https://www.typescriptlang.org/) |
| UI 组件库 | [Element Plus](https://element-plus.org/) + [Tailwind CSS v4](https://tailwindcss.com/) |
| 后台模板 | [Vue Vben Admin](https://doc.vben.pro/) (v5) |
| 状态管理 | Pinia |
| 图表 | ECharts + vue-echarts |
| 表格 | el-table + el-pagination（BaseTable 封装） |
| 后端认证 | sa-token（跨子域名 SSO Cookie 共享） |
| 包管理 | pnpm（monorepo + Turborepo） |

## 目录结构

```
bigdata-uni-system/
├── apps/                          # 可部署应用
│   ├── portal/                    # 统一导航入口（端口 5530）
│   ├── ac/expert/                 # 空调专家系统（端口 5531）
│   ├── web-ele/                   # Vben Admin 参考模板
│   └── backend-mock/              # Nitro Mock 服务（框架内置）
│
├── packages/
│   ├── @core/                     # Vben Admin 核心（布局、状态、请求）
│   ├── effects/                   # Vben Admin 效果层
│   ├── shared/                    # @bigdata/shared — 业务共享组件
│   ├── stores/                    # Pinia 状态
│   ├── locales/                   # 国际化
│   └── ...
│
├── internal/                      # 构建工具链
└── pnpm-workspace.yaml
```

### 子系统清单

子系统 URL 和元数据通过 JSON 文件管理：`apps/portal/src/config/env/systems.*.json`

| 分组 | 子系统 |
|-------|--------|
| ❄️ 空调 | 品质分析系统、专家系统 |
| 🧊 冰箱 | 品质分析、专家系统、智能调参、AI 智控中枢、智能诊断引擎 |
| 👕 洗衣机 | 品质分析、耐久实验系统、大数据分析系统 |
| 🔧 公共 | EAI 日志采集、设备运行状态、数据维护、账号管理 |

## 快速开始

```bash
# 环境要求：Node.js ^22.18、pnpm >=11

# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev:portal          # 门户（端口 5530）
pnpm dev:ac-expert       # 空调专家（端口 5531）

# 构建
pnpm build:portal
pnpm build:ac-expert

# 代码检查 & 类型检查
pnpm lint
pnpm check:type
```

## 核心功能

### SSO 单点登录
各子系统通过跨子域名 Cookie（`.sjb.homechiq.com`）共享登录状态，页面刷新时自动从 Cookie 恢复 Token。

### AI 聊天助手
门户内置 AI 智能聊天助手，支持 SSE 流式响应，保留最近 10 轮对话上下文。

### 暗色模式
支持通过 Vben Admin 偏好设置切换暗色/亮色主题。

## 环境变量

每个应用在 `.env.development` 中配置：

| 变量 | 说明 |
|----------|-------------|
| `VITE_GLOB_API_URL` | 后端 API 地址 |
| `VITE_AI_CHAT_URL` | AI 聊天接口地址（SSE 流式） |
| `VITE_COOKIE_NAME` | SSO Cookie 名称（默认 `sa-token`） |
| `VITE_COOKIE_DOMAIN` | SSO 跨域 Cookie 域名 |
| `VITE_NITRO_MOCK` | 是否启用 Nitro Mock 服务 |
| `VITE_APP_PLATFORM` | 平台标识（`portal`、`ac_expert`） |
| `VITE_APP_TITLE` | 应用标题 |

## 后端 API

OpenAPI 规范：`/Users/element/work_space/java/ac-qmfa-server/docs/openapi.yaml`

关键端点：
- `POST /auth/api/auth/login` — 登录
- `GET /auth/api/auth/userInfo` — 用户信息（含角色/权限）
- `GET /auth/api/auth/logout` — 登出
- `GET /auth/api/menu/selectList` — 菜单列表

## 框架参考

本项目基于 [Vue Vben Admin](https://doc.vben.pro/) v5 构建。框架级别的文档（布局、路由、Store 模式、偏好设置）请参考 [Vben Admin 官方文档](https://doc.vben.pro/)。

## 许可证

[MIT](./LICENSE)

---

### 版本信息

| 包名 | 版本 | 构建日期 |
|---------|---------|-------|
| @bigdata/portal | 0.0.5 | 2026-07-13 |
| @bigdata/ac-expert | 0.0.1 | 2026-07-13 |
| @bigdata/shared | 0.0.1 | 2026-07-13 |

> 通过 [Changesets](https://github.com/changesets/changesets) 管理版本。运行 `pnpm changeset` 创建新版本记录。