# 管理门户

FluxiQ PIX 管理门户是一个 Vue 3 单页应用程序，提供 PIX 运营、监控和配置的全面管理。

## 前提条件

- FluxiQ PIX 后端正在运行并可访问
- 管理员用户凭据（默认：admin / Admin@2026!）
- 现代 Web 浏览器（Chrome、Firefox、Safari、Edge）

## 概览

| 指标 | 值 |
|------|-----|
| 路由 | 82 |
| 视图 | 86 |
| Pinia Stores | 17 |
| 服务 | 27 |
| 组件 | 12 |
| 语言 | 5 (en, pt, es, zh, fr) |

## 认证

管理门户使用加固的认证流程：

1. **RSA-OAEP 加密**：登录凭据使用从 `/api/v1/auth/public-key` 获取的 2048 位 RSA 公钥加密
2. **HttpOnly JWT Cookie**：会话存储在 `pix_session` cookie 中（JavaScript 不可访问）
3. **CSRF 保护**：双重提交 cookie 模式
4. **MFA 支持**：可选的 TOTP 验证步骤

### 登录流程

```mermaid
sequenceDiagram
    浏览器->>+后端: GET /api/v1/auth/public-key
    后端-->>-浏览器: RSA 公钥
    浏览器->>浏览器: 加密凭据 (RSA-OAEP)
    浏览器->>+后端: POST /api/v1/auth/login
    后端-->>-浏览器: Set-Cookie: pix_session (HttpOnly)
    浏览器->>+后端: GET /api/v1/auth/me
    后端-->>-浏览器: 用户资料 + 权限
```

## 主要模块

### 仪表板
交易量、状态分布和系统健康的实时概览。

### 交易管理
- 交易列表，支持过滤（状态、E2E ID、日期范围、支付工具类型）
- 交易详情，带葡语 BCB 状态标签
- ANS 计时部分（在 1.6 秒阈值处显示 OK/EXCEEDED 标志）
- 状态历史时间线

### DICT 管理
- PIX 密钥列表和搜索
- 密钥创建和删除
- 认领管理
- CID 同步状态

### 清算
- 清算周期管理
- 净额计算
- 对账报告
- 余额查询

### MED 2.0（违规报告）
- 报告列表，支持 ISPB 和状态过滤
- 报告详情视图
- 操作：确认接收、分析（同意/不同意）、关闭

### 会计
- 会计科目表（44 个 COSIF 账户）
- 日记账分录，带复式记账滚动余额
- 会计事件
- 成本中心管理

### 监控（实时）
- 6 面板 WebSocket 仪表板
- 交易实时流
- 系统健康状态
- 清算状态
- DICT 操作
- BACEN 通道健康
- 队列深度监控

### 系统配置
- 系统参数（13 个可配置值）
- 安全设置
- 余额参数

### 用户与 RBAC
- 用户管理
- 组/角色分配
- 权限管理
- 审计日志

### BACEN 模拟器
- 模拟器状态和配置
- 场景执行（8 个预配置）
- 测试运行结果
- 交换监控

## 图表

三个可复用的 Chart.js 组件：
- `LineChart.vue` -- 时间序列（TPS、交易量）
- `BarChart.vue` -- 分类数据（状态分布）
- `DoughnutChart.vue` -- 比例数据（支付工具分布）

## 国际化

管理门户支持 5 种语言，每种 568 个翻译键：
- 英语 (en)
- 葡萄牙语 (pt)
- 西班牙语 (es)
- 中文 (zh)
- 法语 (fr)

通过头部的语言选择器切换语言。

## 预期结果

访问管理门户后：

- 仪表板显示实时交易指标
- 导航提供对所有 82 个路由的访问
- 通过 WebSocket 连接实时更新监控
- RBAC 根据用户权限控制可见性