# 数据仓库命名规范

## 一、表命名规范

### 1. 事实表 (Fact Table)
存储业务过程的度量数据，如消费、订单、挂号等

```
格式: [prefix_]业务含义
前缀: fact_ (可选)

示例:
- fact_patientconsumption  (患者消费)
- fact_cliniclog           (诊所日志)
- fact_order               (订单)
- fact_fee                 (费用)
```

### 2. 维度表 (Dim Table)
存储描述性信息，用于分析

```
格式: dim_业务含义

示例:
- dim_patient              (患者维度)
- dim_clinic              (诊所维度)
- dim_staff               (员工维度)
- dim_time                (时间维度)
```

### 3. 汇总表 (Agg Table)
预聚合的统计数据

```
格式: agg_业务含义_粒度

示例:
- agg_daily_revenue       (日收入汇总)
- agg_monthly_patient     (月患者汇总)
```

---

## 二、字段命名规范

### 1. 通用规则
- 全部小写
- 用下划线分隔
- 避免缩写，保持清晰

### 2. 常用字段

| 字段类型 | 命名 | 说明 |
|---------|------|------|
| 主键 | id | 自增ID |
| 业务ID | xxx_id | 如 clinic_id |
| 名称 | xxx_name | 如 patient_name |
| 金额 | xxx_amt | 如 total_amt |
| 数量 | xxx_cnt | 如 order_cnt |
| 日期 | xxx_date | 如 pay_date |
| 时间 | xxx_time | 如 create_time |
| 标识 | is_xxx | 如 is_valid |
| 类型 | xxx_type | 如 visit_type |
| 状态 | xxx_status | 如 order_status |

### 3. 时间字段

| 字段 | 说明 |
|------|------|
| create_time | 创建时间 |
| update_time | 更新时间 |
| come_time | 就诊时间 |
| pay_time | 支付时间 |
| come_date | 就诊日期 |
| pay_date | 支付日期 |

---

## 三、索引命名规范

```
格式: idx_字段名

示例:
- idx_clinic_id
- idx_pay_date
- idx_mobile
```

---

## 四、当前项目表

| 表名 | 说明 |
|------|------|
| fact_patientconsumption | 患者消费宽表 |
| fact_cliniclog | 诊所日志宽表 |