# 智能星球计划 - 面向数据博弈的"智能软关基"态势感知系统

## 项目概述

**核心愿景：** 构建人类智能空间的"实时全景图"

在智能时代，人类认识宇宙的方式本身发生了变化。我们不再只生活在一个由物理空间、自然资源和地理边界所构成的现实层宇宙之中。我们同时生活在一个由信息流、传播结构与智能系统共同塑造的认知层宇宙里。这两个层级的宇宙相互叠加、持续耦合，通过智能系统不断重构人类对存在、秩序与意义的理解。

## 系统架构

```
┌─────────────────────────────────────────────────────────────────────────┐
│                           物理大屏展示层                                  │
│  ┌─────────────────────────────────────────────────────────────────┐    │
│  │         偏振片3D大屏 (2m×3m, 4K, 120Hz, 眼镜式)                 │    │
│  │  ┌─────────────────────────────────────────────────────────┐    │    │
│  │  │              虚幻引擎 UE5 客户端                          │    │    │
│  │  │  ├── 3D地球渲染 (Cesium for UE)                          │    │    │
│  │  │  ├── 算力点可视化 (GPU集群、智算中心)                     │    │    │
│  │  │  ├── 连接弧线 (光缆、路由、数据流向)                      │    │    │
│  │  │  ├── 粒子效果 (数据流动、告警提示)                        │    │    │
│  │  │  └── 自动巡航相机 + 交互控制                              │    │    │
│  │  └─────────────────────────────────────────────────────────┘    │    │
│  └─────────────────────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────────────────────┘
                                    ▲
                                    │ WebSocket (实时推送)
                                    │ 120Hz 心跳 / 数据帧同步
                                    ▼
┌─────────────────────────────────────────────────────────────────────────┐
│                           数据中台服务层 (FastAPI)                        │
│  ┌─────────────────────────────────────────────────────────────────┐    │
│  │                      API Gateway (Redis 限流)                    │    │
│  └─────────────────────────────────────────────────────────────────┘    │
│                                    │                                    │
│  ┌───────────────────┬──────────────────────────┬──────────────────┐   │
│  │    数据采集服务    │      核心业务服务         │    运维管理服务   │   │
│  │  ┌─────────────┐  │  ┌─────────────────┐    │  ┌─────────────┐ │   │
│  │  │ 调度中心    │  │  │ WebSocket 服务  │    │  │ 用户管理    │ │   │
│  │  │ (Celery)   │  │  │ (FastAPI)       │    │  │ (JWT Auth)  │ │   │
│  │  └─────────────┘  │  └─────────────────┘    │  └─────────────┘ │   │
│  │  ┌─────────────┐  │  ┌─────────────────┐    │  ┌─────────────┐ │   │
│  │  │ 采集器池    │  │  │ 数据查询 API    │    │  │ 数据源配置  │ │   │
│  │  │ (10+源)    │  │  │ (REST)          │    │  │ 监控告警    │ │   │
│  │  └─────────────┘  │  └─────────────────┘    │  └─────────────┘ │   │
│  │  ┌─────────────┐  │  ┌─────────────────┐    │  ┌─────────────┐ │   │
│  │  │ 消息队列    │  │  │ 态势分析引擎    │    │  │ 系统配置    │ │   │
│  │  │ (Kafka)    │  │  │ (计算/聚合)     │    │  │ 日志审计    │ │   │
│  │  └─────────────┘  │  └─────────────────┘    │  └─────────────┘ │   │
│  └───────────────────┴──────────────────────────┴──────────────────┘   │
└─────────────────────────────────────────────────────────────────────────┘
                                    ▲
                                    │ 内部 API 调用
                                    ▼
┌─────────────────────────────────────────────────────────────────────────┐
│                           Web管理端 (React Admin)                        │
│  ┌─────────────────────────────────────────────────────────────────┐    │
│  │  登录页 │ 仪表盘 │ 用户管理 │ 数据源配置 │ 任务监控 │ 系统配置   │    │
│  └─────────────────────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────────────────────┘
                                    ▲
                                    │ PostgreSQL / Redis
                                    ▼
┌─────────────────────────────────────────────────────────────────────────┐
│                           数据存储层                                      │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐    │
│  │ PostgreSQL  │  │ TimescaleDB │  │    Redis    │  │  MinIO      │    │
│  │ (用户/配置) │  │ (时序数据)  │  │ (缓存/会话) │  │ (文件存储) │    │
│  └─────────────┘  └─────────────┘  └─────────────┘  └─────────────┘    │
└─────────────────────────────────────────────────────────────────────────┘
```

## 四大核心要素

| 层级 | 要素 | 描述 |
|------|------|------|
| L1 | 新兴技术支撑 | AI算力、模型生态、云基础设施 |
| L2 | 关键基础设施 | 卫星、海底光缆、IXP、路由 |
| L3 | 组织制度资源 | 规则制定权、顶层设计 |
| L4 | 文化内容供给 | 新闻、社交视频、舆论情绪 |

## 技术栈

### 后端 (Python FastAPI)

| 组件 | 版本 | 用途 |
|------|------|------|
| FastAPI | 0.109+ | Web 框架 |
| SQLAlchemy | 2.0+ | ORM |
| Alembic | - | 数据库迁移 |
| Celery | 5.3+ | 任务队列 |
| Redis | 7.0+ | 缓存/消息 |
| Kafka | 3.0+ | 事件流 |
| PyJWT | - | 认证 |

### 前端 (React Admin)

| 组件 | 用途 |
|------|------|
| React 18 | UI 框架 |
| Ant Design Pro | 管理后台组件 |
| Axios | HTTP 客户端 |
| Socket.io-client | WebSocket 客户端 |
| ECharts | 统计图表 |

### 虚幻引擎客户端

| 组件 | 版本 | 用途 |
|------|------|------|
| Unreal Engine 5 | 5.3+ | 3D 渲染引擎 |
| Cesium for Unreal | 1.5+ | 地理可视化 |
| Niagara | - | 粒子系统 |

### 数据库

| 组件 | 用途 |
|------|------|
| PostgreSQL 15+ | 关系数据 |
| TimescaleDB | 时序数据扩展 |
| Redis 7+ | 缓存/会话 |
| MinIO | S3 兼容存储 |

### 部署

| 组件 | 用途 |
|------|------|
| Docker 24+ | 容器化 |
| Docker Compose | 本地部署 |
| Nginx | 反向代理 |

## 角色权限

| 角色 | 权限范围 |
|------|----------|
| **超级管理员** | 全部权限 |
| **管理员** | 除用户管理外的全部 |
| **操作员** | 查看 + 操作 |
| **只读用户** | 仅查看大屏和报表 |

## 数据采集策略

| 优先级 | 数据源 | 采集频率 |
|--------|--------|----------|
| P0 | TOP500 | 每 4 小时 |
| P0 | Epoch AI | 每小时 |
| P0 | Hugging Face | 每 2 小时 |
| P0 | GitHub | 每 4 小时 |
| P0 每日 |
| P0 | PeeringDB | 每 2 小时 |
| P1 | Cloudflare Radar | | TeleGeography | 每小时 |
| P1 | CAIDA BGPStream | 每 15 分钟 |

## 项目结构

```
├── backend/               # FastAPI 后端
│   ├── app/
│   │   ├── api/          # API 路由
│   │   ├── core/         # 核心配置
│   │   ├── models/       # 数据模型
│   │   ├── schemas/      # Pydantic 模型
│   │   ├── services/     # 业务逻辑
│   │   └── tasks/        # Celery 任务
│   └── tests/
├── frontend/              # React 管理后台
│   ├── src/
│   │   ├── components/   # 组件
│   │   ├── pages/        # 页面
│   │   ├── services/     # API 服务
│   │   └── store/        # 状态管理
│   └── tests/
├── unreal/                # UE5 大屏客户端
│   ├── Content/
│   ├── Source/
│   └── Plugins/
├── data/                  # 数据文件
├── docs/                  # 文档
├── scripts/               # 脚本
├── docker-compose.yml
├── AGENTS.md
└── README.md
```

## 快速启动

```bash
# 启动全部服务
docker-compose up -d

# 仅启动后端
cd backend && python -m uvicorn app.main:app --reload

# 仅启动前端
cd frontend && npm run dev
```

## API 文档

启动服务后访问: `http://localhost:8000/docs`

## License

待定