# 数据知识库索引

> 公司数据结构文档，用于支撑数据分析、业务查询、报表生成等工作。
> 所有凭证存储在 `~/.hermes/.env`，本文档仅含脱敏引用。

## 数据基础设施总览

| 类型 | 环境 | 凭证前缀 | 用途 | 状态 |
|------|------|----------|------|------|
| MySQL 8.0 | 线上 | `VALA_MYSQL_ONLINE_*` | 用户/订单/配置 | ✅ |
| MySQL 8.0 | 测试 | `VALA_MYSQL_TEST_*` | 最新配置/开发测试 | ✅ |
| PostgreSQL 17 | 线上 | `VALA_PG_ONLINE_*` | 用户行为数据 | ✅ |
| PostgreSQL 17 | 测试 | `VALA_PG_TEST_*` | 测试行为数据 | ✅ |
| Elasticsearch 7.10 | 线上 | `VALA_ES_ONLINE_*` | 服务日志 | ✅ |
| Elasticsearch | 测试 | `VALA_ES_TEST_*` | 服务日志 | ⚠️ IP白名单限制 |

## 数据域

### MySQL — 业务数据库

| 库名 | 环境 | 说明 |
|------|------|------|
| `vala_user` | 线上/测试 | [账号 & 角色](data_dict/vala_user.md) |
| `vala` | 线上/测试 | 业务主库（配置、内容） |
| `vala_order` | 线上/测试 | 订单数据 |
| `vala_gray` | 线上 | 灰度发布配置 |
| `vala_dev` | 测试 | 开发配置 |
| `vala_bak` | 测试 | 备份数据 |

### PostgreSQL — 行为数据库

| 库名 | 环境 | 主要表（部分） |
|------|------|---------------|
| `vala` | 线上 | `user_chapter_play_record_*`, `user_lesson_handbook`, `gashapon_config`, `vala_pilot_explain_*` |
| `vala_test` | 测试 | `user_chapter_play_record_*`, `user_component_play_record_*`, `user_lesson_handbook`, `account_event_count` |

### Elasticsearch — 日志搜索

| 环境 | 版本 | 用途 |
|------|------|------|
| 线上 | 7.10.1 | 正式环境服务日志 |
| 测试 | - | ⚠️ 当前机器 IP 不在白名单 |

## 工具脚本

| 脚本 | 路径 | 说明 |
|------|------|------|
| phone_encrypt | `scripts/phone_encrypt.py` | 手机号 XXTEA 加解密、MD5 |

## 参考文档

| 文档 | 说明 |
|------|------|
| [references/手机号查询角色ID方法.md](references/手机号查询角色ID方法.md) | 手机号查询角色原始文档 |

---

*持续建设中。新增数据源时更新本索引。*
