---
# System prepended metadata

title: Поддерживаемые запросы и ответы REST API (отчеты)

---

# Поддерживаемые запросы и ответы REST API (отчеты)

| Адрес                           | Метод  | Описание метода                                                                                                                                                                                                                                                                                                                                                                                                                                   | Пример тела запроса (JSON)                                                             | Пример тела ответа (JSON)                                                                                                   |
|---------------------------------|--------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------|
| /api/vehicles/telemetry         | GET    | Обрабатывает GET-запрос на получение телеметрии всех машин в формате карты, где ключи - Id машин, значения - карты с телеметрией.                                                                                                                                                                                                                                                                                                                 |                                                                                        | См. пример структуры «Телеметрия»                                                                                           |
| /api/vehicles/{vehid}/telemetry | GET    | Обрабатывает GET-запрос на получение телеметрии конкретной машины по ее Id.                                                                                                                                                                                                                                                                                                                                                                       |                                                                                        | См. пример структуры «Телеметрия»                                                                                           |
| /api/telemetry                  | POST   | Обрабатывает GET-запрос на получение всех значений телеметрии и соответствующих временных меток (временного ряда) для указанной скважины (задания). В теле запроса передаются названия полей телеметрии, которые интересуют клиента, величина временного шага (с), и id целевой скважины.                                                                                                                                                         | {"hole_id": 113, "period": 0.5, "fields": ["drill_rotation_pressure", "air_pressure"]} | См. пример структуры «Телеметрия скважины (временной ряд)»                                                                  |
| /api/history/report             | GET    | Обрабатывает GET-запрос на получение отчета (JSON-данных или CSV-файла) с историей выполненных заданий.                                                                                                                                                                                                                                                                                                                                           |                                                                                        |                                                                                                                             |
| /api/history/report-v2          | GET    | Обрабатывает GET-запрос на получение отчета (JSON-данных или CSV-файла) с историей выполненных заданий в формате Hudbay.                                                                                                                                                                                                                                                                                                                          |                                                                                        |                                                                                                                             |
| /api/history/shift-summary      | GET    | Обрабатывает GET-запрос на получение краткого отчета о работе за смену.                                                                                                                                                                                                                                                                                                                                                                           |                                                                                        |                                                                                                                             |

### Пример структуры «История»

#### Запрос
Пример:
```
http://127.0.0.1:8083/api/history?veh=2&project=100&period_start=2022-11-18 14:41:01&period_end=2022-11-18 23:00:00
```

Параметры:
- project: id проекта (из списка api/plans)
- vehid: id станка
- period_start: время начала периода для фильтрации по start_ts, формат `%Y-%m-%d %H:%M:%S` или `%Y-%m-%d` 
  - (где %d - день месяца в виде десятичной дроби с нулями, %m - месяц как десятичное число с нулями, %Y - год со столетием в виде десятичного числа, %H - час (в 24-часовом формате) как десятичное число с нулями, %M - минута в виде десятичного числа с нулями, %S - секунды — десятичное число с нулями)
- period_end: время окончания периода для фильтрации по start_ts, формат `%Y-%m-%d %H:%M:%S` или `%Y-%m-%d` 

#### Ответ

<details>
<summary>Пример ответа в формате json</summary>

```json
[
   {
      "hole_id":246,
      "start_ts":"2022-11-18 14:44:02",
      "finish_ts":"2022-11-18 14:49:13",
      "vehid":"2",
      "start_depth":1.96924,
      "real_depth":1.24641,
      "orig_x":5.0,
      "orig_y":-20.0,
      "real_z":4252.02,
      "real_azimuth":7.88728,
      "last_state":"moving",
      "last_state_change":"2022-11-18 14:49:13",
      "move_duration":151.0,
      "level_duration":32.0,
      "drill_duration":64.0,
      "tower_tilt_duration":0.0,
      "failure_duration":0.0,
      "remote_duration":63.0,
      "moving_start_ts":"2022-11-18 14:44:02",
      "leveling_start_ts":"2022-11-18 14:46:37",
      "drilling_start_ts":"2022-11-18 14:46:55",
      "rot_speed_avg":7.24431,
      "rot_press_avg":6.75213,
      "feed_press_avg":8.61005,
      "air_press_avg":1.85905,
      "drilling_stats":"{\"idle\": 172, \"null\": 0, \"raise\": 18, \"pullup\": 5, \"remote\": 63, \"failure\": 0, \"drilling\": 0, \"hard_rot\": 0, \"pass_soft\": 0, \"touchdown\": 7, \"after_pullup\": 18, \"unstuck_down\": 0, \"unstuck_spin\": 0, \"overburden_pass\": 8, \"wait_after_drill\": 7}"
   },
   {
      "hole_id":328,
      "start_ts":"2022-11-18 14:49:13",
      "finish_ts":"2022-11-18 14:53:45",
      "vehid":"2",
      "start_depth":1.46943,
      "real_depth":1.65969,
      "orig_x":25.0,
      "orig_y":-10.0,
      "real_z":4251.82,
      "real_azimuth":7.76094,
      "last_state":"moving",
      "last_state_change":"2022-11-18 21:43:11",
      "move_duration":176.0,
      "level_duration":32.0,
      "drill_duration":63.0,
      "tower_tilt_duration":0.0,
      "failure_duration":0.0,
      "remote_duration":0.0,
      "moving_start_ts":"2022-11-18 14:49:13",
      "leveling_start_ts":"2022-11-18 14:52:13",
      "drilling_start_ts":"2022-11-18 14:52:31",
      "rot_speed_avg":53.5951,
      "rot_press_avg":0.811275,
      "feed_press_avg":1.03917,
      "air_press_avg":2.93079,
      "drilling_stats":"{\"idle\": 198, \"null\": 0, \"raise\": 16, \"pullup\": 4, \"failure\": 0, \"drilling\": 0, \"hard_rot\": 0, \"pass_soft\": 0, \"touchdown\": 8, \"after_pullup\": 20, \"unstuck_down\": 0, \"unstuck_spin\": 0, \"overburden_pass\": 9, \"wait_after_drill\": 7}"
   },
   {
      "hole_id":169,
      "start_ts":"2022-11-18 22:07:51",
      "finish_ts":"2022-11-18 23:35:22",
      "vehid":"2",
      "start_depth":1.60688,
      "real_depth":1.65268,
      "orig_x":-15.0,
      "orig_y":-5.0,
      "real_z":4251.86,
      "real_azimuth":1.20982,
      "last_state":"moving",
      "last_state_change":"2022-11-18 23:35:22",
      "move_duration":133.0,
      "level_duration":37.0,
      "drill_duration":66.0,
      "tower_tilt_duration":0.0,
      "failure_duration":0.0,
      "remote_duration":0.0,
      "moving_start_ts":"2022-11-18 23:31:26",
      "leveling_start_ts":"2022-11-18 23:33:42",
      "drilling_start_ts":"2022-11-18 23:34:03",
      "rot_speed_avg":58.8239,
      "rot_press_avg":1.21122,
      "feed_press_avg":1.53672,
      "air_press_avg":3.03881,
      "drilling_stats":"{\"idle\": 157, \"null\": 0, \"raise\": 19, \"pullup\": 4, \"failure\": 0, \"drilling\": 0, \"hard_rot\": 0, \"pass_soft\": 0, \"touchdown\": 7, \"after_pullup\": 19, \"unstuck_down\": 0, \"unstuck_spin\": 0, \"overburden_pass\": 11, \"wait_after_drill\": 7}"
   }
]
```

</details>


### Пример структуры «Телеметрия»
```json
{
    "4694": {
        "veh_polygon": [
            {
                "y": -1.54,
                "x": 6.11
            },
            {
                "y": -1.54,
                "x": 2.66
            },
            {
                "y": -2.13,
                "x": 2.06
            },
            {
                "y": -2.13,
                "x": -5.71
            },
            {
                "y": 2.13,
                "x": -5.71
            },
            {
                "y": 2.13,
                "x": 1.42
            },
            {
                "y": 3.5,
                "x": 1.42
            },
            {
                "y": 3.5,
                "x": 6.11
            }
        ],
        "tower_angle": 0.0,
        "driller_status": "idle",
        "rear_jack_pulled": true,
        "platform_roll": 1.5079576969146729,
        "drill_rotation_pressure": 140.801025390625,
        "drill_rotation_speed": 0.0,
        "drill_angular_pose": 2.040383815765381,
        "platform_pitch": 2.359905242919922,
        "spindle_depth": 1.0,
        "right_jack_pulled": true,
        "air_pressure": 0.0,
        "drill_feed_pressure": 0.0,
        "left_jack_pulled": true,
        "position": {
            "y": 0.0,
            "x": 0.0,
            "z": 0.0,
            "azimuth": 0.0
        },
        "speed": 0.0,
        "drill_feed_speed": 0.0,
        "last_finished_holeid": "None"
    }
}
```

### Пример структуры «Телеметрия скважины (временной ряд)»
```json
{
    "metrics": {
        "air_pressure": {
            "time_series": [
                [
                    1632830586.0,
                    4.02562952041626
                ],
                [
                    1632830587.0,
                    4.02562952041626
                ],
                [
                    1632830588.0,
                    4.02562952041626
                ]
            ]
        },
        "drill_rotation_pressure": {
            "time_series": [
                [
                    1632830586.0,
                    90.81175231933594
                ],
                [
                    1632830587.0,
                    148.48634338378906
                ],
                [
                    1632830588.0,
                    68.78199768066406
                ],
                [
                    1632830589.0,
                    77.4718246459961
                ]
            ]
        }
    },
    "vehicle_id": "4694"
}
```
### Содержимое получаемой телеметрии: *

```
Полигон, описывающий габариты машины
Текущая скорость
Положение (X, Y, Z, Azimuth)
Положение вращателя в метрах, относительно крайнего верхнего
Скорость вращения (rpm)
Скорость подачи (м/с)
Угловое положение вращателя (градусы)
Давление вращение (бар)
Давление на забой (бар)
Давление воздуха (бар)
Спектр вибраций (набор пар частота — амплитуда)
Флаги концевых датчиков домкратов
Наклон платформы (крен, тангаж — градусы)
Наклон мачты от вертикали (градусы)
Id последней пробуренной скважины
```
**Данный перечень содержит неполный набор параметров, отслеживаемых бортовой системой управления и может быть расширен при необходимости. Телеметрия принимается от СУ бурового станка в формате JSON.*


### Описание полей _отчета_ api/history/report
#### Запрос
Пример:
```
http://127.0.0.1:8083/api/history/report?veh=2&project=PV&period_start=2022-11-18 21:01:01&period_end=2022-11-18 23:00:00&format=json
```

Параметры:
- project: имя проекта
- vehid: id станка
- period_start: время начала периода для фильтрации по start_ts, формат `%Y-%m-%d %H:%M:%S` или `%Y-%m-%d` 
  - (где %d - день месяца в виде десятичной дроби с нулями, %m - месяц как десятичное число с нулями, %Y - год со столетием в виде десятичного числа, %H - час (в 24-часовом формате) как десятичное число с нулями, %M - минута в виде десятичного числа с нулями, %S - секунды — десятичное число с нулями)
- period_end: время окончания периода для фильтрации по start_ts, формат `%Y-%m-%d %H:%M:%S` или `%Y-%m-%d` 
- format: если задан json, то возвращается JSON-объект, иначе - CSV-файл

#### Ответ

| #   | Имя поля                           | тип    | ед. изм.            | Описание                                                                | Примечание                                                                                                    |
|-----|------------------------------------|--------|---------------------|-------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------|
| 1   | start_ts                           | время  | ГГГГ-ММ-ДД ЧЧ:ММ:СС | Время начала выполнения задания для данной скважины                     | Часовой пояс местный, как настроено в системе, формат тоже может меняться в зависимости от системных настроек |
| 2   | finish_ts                          | время  | ГГГГ-ММ-ДД ЧЧ:ММ:СС | Время окончания выполнения задания для данной скважины                  | то же                                                                                                         |
| 3   | vehid                              | int    | -                   | Идентификатор машины (бурового станка)                                  |                                                                                                               |
| 4   | orig_depth                         | float  | m                   | Заданная глубина                                                        | из плана                                                                                                      |
| 5   | orig_x                             | float  | m                   | Заданная координата x                                                   | из плана                                                                                                      |
| 6   | orig_y                             | float  | m                   | Заданная координата y                                                   | из плана                                                                                                      |
| 7   | orig_z                             | float  | m                   | Заданная координата z                                                   | из плана                                                                                                      |
| 8   | orig_azimuth_deg                   | float  | degrees             | Заданный азимут                                                         | из плана                                                                                                      |
| 9   | real_depth                         | float  | m                   | Реальная глубина в результате бурения                                   |                                                                                                               |
| 10  | start_depth                        | float  | m                   | Расстояние от вилки до земли (определяется в момент касания)            |                                                                                                               |
| 11  | real_x                             | float  | m                   | Реальная координата x в результате бурения                              |                                                                                                               |
| 12  | real_y                             | float  | m                   | Реальная координата y в результате бурения                              |                                                                                                               |
| 13  | real_z                             | float  | m                   | Реальная координата z в результате бурения                              |                                                                                                               |
| 14  | real_azimuth_deg                   | float  | degrees             | Реальный азимут при бурении                                             |                                                                                                               |
| 15  | hole_name                          | int    | -                   | Идентификатор скважины из проекта                                       |                                                                                                               |
| 16  | project_name                       | string | -                   | Имя проекта                                                             |                                                                                                               |
| 17  | move_duration                      | int    | s                   | Длительность движения                                                   |                                                                                                               |
| 18  | level_duration                     | int    | s                   | Длительность горизонтирования                                           |                                                                                                               |
| 19  | drill_duration                     | int    | s                   | Длительность бурения                                                    |                                                                                                               |
| 20  | remote_duration                    | int    | s                   | Длительность работы в режиме телеуправления                             |                                                                                                               |
| 21  | failure_duration                   | int    | s                   | Длительность состояния отказа                                           |                                                                                                               |
| 22  | moving_start_ts                    | время  | ГГГГ-ММ-ДД ЧЧ:ММ:СС | Время начала движения                                                   |                                                                                                               |
| 23  | leveling_start_ts                  | время  | ГГГГ-ММ-ДД ЧЧ:ММ:СС | Время начала горизонтирования                                           |                                                                                                               |
| 24  | drilling_start_ts                  | время  | ГГГГ-ММ-ДД ЧЧ:ММ:СС | Время начала бурения                                                    |                                                                                                               |
| 25  | rot_speed_avg_rpm                  | float  | rpm                 | Среднее значение скорости вращения бура при бурении данной скважины     | среднее берется в режимах overburden_pass, drilling, hard_rot, pass_soft, либо при дистанционном управлении   |
| 26  | rot_torque_avg_klb_ft              | float  | klb_ft              | Среднее значение момента вращения при бурении данной скважины           | то же                                                                                                         |
| 27  | feed_press_avg_klbf                | float  | klbf                | Среднее значение давления на забой при бурении данной скважины          | то же                                                                                                         |
| 28  | air_press_avg_psi                  | float  | psi                 | Среднее значение давления воздуха при бурении данной скважины           | то же + в режимах pullup, after_pullup                                                                        |
| 29  | avg_drilling_speed_mph             | float  | mph                 | Средняя скорость бурения (глубина скважины / все время бурения)         | время включает все подрежимы бурения                                                                          |
| 30  | depth_err_m                        | float  | m                   | Оценка ошибки глубины бурения                                           |                                                                                                               |
| 31  | xy_err_m                           | float  | m                   | Отклонение реальных горизонтальных координат скважины от заданных       |                                                                                                               |
| 32  | drilling_touchdown_duration        | int    | s                   | Время внутреннего состояния режима бурения: касание земли               |                                                                                                               |
| 33  | drilling_overburden_pass_duration  | int    | s                   | Время внутреннего состояния режима бурения: прохождение вскрышных пород |                                                                                                               |
| 34  | drilling_drilling_duration         | int    | s                   | Время внутреннего состояния режима бурения: бурение                     |                                                                                                               |
| 35  | drilling_hard_rot_duration         | int    | s                   | Время внутреннего состояния режима бурения: тяжелое вращение            |                                                                                                               |
| 36  | drilling_pullup_duration           | int    | s                   | Время внутреннего состояния режима бурения: протяжка                    |                                                                                                               |
| 37  | drilling_after_pullup_duration     | int    | s                   | Время внутреннего состояния режима бурения: после протяжки              |                                                                                                               |
| 38  | drilling_raise_duration            | int    | s                   | Время внутреннего состояния режима бурения: поднятие става              |                                                                                                               |
| 39  | drilling_wait_after_drill_duration | int    | s                   | Время внутреннего состояния режима бурения: после бурения               |                                                                                                               |
| 40  | drilling_pass_soft_duration        | int    | s                   | Время внутреннего состояния режима бурения: прохождение мягких пород    |                                                                                                               |
| 41  | drilling_remote_duration           | int    | s                   | Время внутреннего состояния режима бурения: телеуправление              |                                                                                                               |


<details>
<summary>Пример ответа в формате json</summary>

```json
[
   {
      "start_ts":"2022-11-18 14:44:02",
      "finish_ts":"2022-11-18 14:49:13",
      "vehid":"2",
      "orig_depth":1.6,
      "orig_x":201126.97328812693,
      "orig_y":8398938.30163772,
      "orig_z":4252.0,
      "orig_azimuth_deg":90.00020741015327,
      "real_depth":1.24641,
      "start_depth":1.96924,
      "real_x":201127.15364812693,
      "real_y":8398938.24813772,
      "real_z":4250.93077958107,
      "real_azimuth_deg":451.9078551123047,
      "hole_name":"5627",
      "project_name":"PV_4236_001_F5",
      "move_duration":151.0,
      "level_duration":32.0,
      "drill_duration":64.0,
      "remote_duration":63.0,
      "failure_duration":0.0,
      "moving_start_ts":"2022-11-18 14:44:02",
      "leveling_start_ts":"2022-11-18 14:46:37",
      "drilling_start_ts":"2022-11-18 14:46:55",
      "rot_speed_avg_rpm":7.24431,
      "rot_torque_avg_klb_ft":0.2093160309791565,
      "feed_press_avg_klbf":1.9356162849572718,
      "air_press_avg_psi":26.963289904546738,
      "avg_drilling_speed_mph":17.391767612723417,
      "depth_err_m":-0.7156304073332649,
      "xy_err_m":0.1881271877215148,
      "drilling_touchdown_duration":"7",
      "drilling_overburden_pass_duration":"8",
      "drilling_drilling_duration":"0",
      "drilling_hard_rot_duration":"0",
      "drilling_pullup_duration":"5",
      "drilling_after_pullup_duration":"18",
      "drilling_raise_duration":"18",
      "drilling_wait_after_drill_duration":"7",
      "drilling_pass_soft_duration":"0",
      "drilling_remote_duration":"63"
   },
   {
      "start_ts":"2022-11-18 14:49:13",
      "finish_ts":"2022-11-18 14:53:45",
      "vehid":"2",
      "orig_depth":1.6,
      "orig_x":201146.97328812693,
      "orig_y":8398948.30163772,
      "orig_z":4252.0,
      "orig_azimuth_deg":90.00020741015327,
      "real_depth":1.65969,
      "start_depth":1.46943,
      "real_x":201146.90958812693,
      "real_y":8398948.174337719,
      "real_z":4251.2303942489625,
      "real_azimuth_deg":444.66911134689843,
      "hole_name":"5709",
      "project_name":"PV_4236_001_F5",
      "move_duration":176.0,
      "level_duration":32.0,
      "drill_duration":63.0,
      "remote_duration":0.0,
      "failure_duration":0.0,
      "moving_start_ts":"2022-11-18 14:49:13",
      "leveling_start_ts":"2022-11-18 14:52:13",
      "drilling_start_ts":"2022-11-18 14:52:31",
      "rot_speed_avg_rpm":53.5951,
      "rot_torque_avg_klb_ft":0.02514952516555786,
      "feed_press_avg_klbf":0.233614715317508,
      "air_press_avg_psi":42.507591240692136,
      "avg_drilling_speed_mph":52.41126386742843,
      "depth_err_m":-0.8292957496641975,
      "xy_err_m":0.14234820490601677,
      "drilling_touchdown_duration":"8",
      "drilling_overburden_pass_duration":"9",
      "drilling_drilling_duration":"0",
      "drilling_hard_rot_duration":"0",
      "drilling_pullup_duration":"4",
      "drilling_after_pullup_duration":"20",
      "drilling_raise_duration":"16",
      "drilling_wait_after_drill_duration":"7",
      "drilling_pass_soft_duration":"0",
      "drilling_remote_duration":null
   },
   {
      "start_ts":"2022-11-18 22:07:51",
      "finish_ts":"2022-11-18 23:35:22",
      "vehid":"2",
      "orig_depth":1.6,
      "orig_x":201106.97328812693,
      "orig_y":8398953.30163772,
      "orig_z":4252.0,
      "orig_azimuth_deg":90.00020741015327,
      "real_depth":1.65268,
      "start_depth":1.60688,
      "real_x":201107.20108812692,
      "real_y":8398953.12362772,
      "real_z":4251.13298333168,
      "real_azimuth_deg":69.31758181084342,
      "hole_name":"5550",
      "project_name":"PV_4236_001_F5",
      "move_duration":133.0,
      "level_duration":37.0,
      "drill_duration":66.0,
      "remote_duration":0.0,
      "failure_duration":0.0,
      "moving_start_ts":"2022-11-18 23:31:26",
      "leveling_start_ts":"2022-11-18 23:33:42",
      "drilling_start_ts":"2022-11-18 23:34:03",
      "rot_speed_avg_rpm":58.8239,
      "rot_torque_avg_klb_ft":0.0375478208065033,
      "feed_press_avg_klbf":0.3454684073083766,
      "air_press_avg_psi":44.07429269156456,
      "avg_drilling_speed_mph":49.99704320891565,
      "depth_err_m":-0.9196966838835579,
      "xy_err_m":0.2891030329559467,
      "drilling_touchdown_duration":"7",
      "drilling_overburden_pass_duration":"11",
      "drilling_drilling_duration":"0",
      "drilling_hard_rot_duration":"0",
      "drilling_pullup_duration":"4",
      "drilling_after_pullup_duration":"19",
      "drilling_raise_duration":"19",
      "drilling_wait_after_drill_duration":"7",
      "drilling_pass_soft_duration":"0",
      "drilling_remote_duration":null
   }
]
```

</details>

### Описание полей _отчета_ api/history/report-v2

#### Запрос
Пример:
```
http://127.0.0.1:8083/api/history/report-v2?veh=2&project=PV&period_start=2022-11-18 21:01:01&period_end=2022-11-18 23:00:00&format=json
```

Параметры:
- project: имя проекта
- vehid: id станка
- period_start: время начала периода для фильтрации по start_ts, формат `%Y-%m-%d %H:%M:%S` или `%Y-%m-%d` 
  - (где %d - день месяца в виде десятичной дроби с нулями, %m - месяц как десятичное число с нулями, %Y - год со столетием в виде десятичного числа, %H - час (в 24-часовом формате) как десятичное число с нулями, %M - минута в виде десятичного числа с нулями, %S - секунды — десятичное число с нулями)
- period_end: время окончания периода для фильтрации по start_ts, формат `%Y-%m-%d %H:%M:%S` или `%Y-%m-%d` 
- format: если задан json, то возвращается JSON-объект, иначе - CSV-файл

#### Ответ
| #   | Field name, en            | Field name, es                 | Description                                                                                                                                                                               | Examples of values                 | units | type | Notes                         | Status                |
|-----|---------------------------|--------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------|-------|------|-------------------------------|-----------------------|
| 1   | hole_inner_id             | perforacion id                 | ?                                                                                                                                                                                         | 232005                             |       |      |                               | ок                    |
| 2   | start_ts                  | Nuevo Fecha fin                | Дата и время начала работы со скважиной (движения)                                                                                                                                        | 10/07/2022 08:24:59                |       |      | finish_ts                     | ок                    |
| 4   | finish_ts                 | Turno                          | Смена, бывает только «А» - дневная смена с 07:00 по 19:00 и «B» ночная смена с 19:00 по 07:00                                                                                             | A, B                               |       |      |                               | ок                    |
| 5   | shift                     | Hora inicio                    | Время начала работы со скважиной (движения), просто часы:минуты:секунды без даты                                                                                                          | 08:04:08 AM                        |       |      |                               | ок                    |
| 6   | start_hr                  | nuevo Hora fin                 | Время начала работы со скважиной (движения), просто часы:минуты:секунды без даты                                                                                                          | 08:24:59 AM                        |       |      |                               | ок                    |
| 7   | guardia                   | Guardia                        | Вахта                                                                                                                                                                                     | Guardia A                          |       |      |                               | нужно проверить       |
| 8   | supervisor                | Supervisor                     | Супервайзер                                                                                                                                                                               | Pedro Gandarillas или Frank Hualla |       |      |                               | нужно проверить       |
| 9   | vehid                     | Equipo                         | Идентификатор станка, можно написать 2                                                                                                                                                    | PE02                               |       |      | vehid                         | ок                    |
| 10  | robot_operator            | Operador - Autonomo            | Оператор робота, кто нажал старт в интерфейсе диспетчера, ФИО                                                                                                                             | Aaron Saul Pardave Travezaño       |       |      |                               | нужно проверить       |
| 11  | project_mine              | tajo                           | Разрез, Zona Constancia, Zona Pampacancha, можно определить по названию проекта, PA – Pampacancha и PV – Constancia                                                                       | Zona Constancia, Zon Pampacancha   |       |      |                               | нужно проверить       |
| 12  | project_number            | proyecto                       | Проект, можно определить по названию проекта                                                                                                                                              | 19                                 |       |      |                               | ок                    |
| 13  | project_place             | fase                           | Место на разрезе, можно определить по названию проекта                                                                                                                                    | F1                                 |       |      |                               | ок                    |
| 14  | project_z                 | cota perforacion               | Плановая высота поверхности (гусениц)                                                                                                                                                     | 4275                               |       |      | orig_z                        | ок                    |
| 15  | real_z_ground             | cota oruga                     | Фактическая высота поверхности (гусениц)                                                                                                                                                  | 4274.53                            |       |      | real_z                        | ок                    |
| 16  | project_altitude          | cota esperado                  | Ожидаемая высота забоя Из плана можно брать, в названии файла или в соответствующем столбце (для txt)                                                                                     | 4260                               |       |      |                               | ок                    |
| 17  | hole_real_bottom_altitude | cota final perforacion         | Реальная высота забоя                                                                                                                                                                     | 4258.66                            |       |      |                               | ок                    |
| 18  | project_name              | malla nombre                   | Имя проекта (в заданном формате)                                                                                                                                                          | PA_4260_019_F1                     |       |      | project_name                  | ок                    |
| 19  | project_altitude_name     | banco                          | Название высоты проекта                                                                                                                                                                   | BANCO 4260                         |       |      |                               | ок                    |
| 20  | hole_name                 | taladro                        | Имя скважины                                                                                                                                                                              | 7744                               |       |      | hole_name                     | ок                    |
| 21  | holes_cnt                 | taladro cantidad               | Количество скважин, всегда 1                                                                                                                                                              | 1                                  |       |      |                               | ок                    |
| 22  | hole_type                 | tipo taladro                   | Тип скважины, см. описание txt-формата проекта                                                                                                                                            | Produccion                         |       |      |                               | нужно проверить       |
| 23  | hole_category             | Categoria de taladro           | ? Может быть, выше код, а здесь буквами ?                                                                                                                                                 | PRODUCCION                         |       |      |                               | не хватает информации |
| 24  | holes_x_dist              | burden                         | Расстояние между скважинами на оси Х, используется для оценки плотности скважин и подбора бура                                                                                            | 7                                  |       |      |                               | нужно проверить       |
| 25  | holes_y_dist              | espaciamiento                  | Расстояние между скважинами на оси Y, используется для оценки плотности скважин и подбора бура                                                                                            | 7                                  |       |      |                               | нужно проверить       |
| 26  | project_target_depth      | perforacion banco              | Плановая глубина                                                                                                                                                                          | 15                                 |       |      | plan_depth                    | ок                    |
| 27  | project_depth_with_added  | Nuevo_profundidad programada   | Добавочная глубина бурения, берется из проекта в txt-формате, 9й столбец, Sobre Perforacion                                                                                               | 0                                  |       |      | project_holes_add.added_depth | нужно проверить       |
| 28  | robot_estimated_depth     | Perforacion de diseno          | Рассчитанная роботом глубина, сколько нужно бурить, от поверхности (уровень гусениц)                                                                                                      | 15.53                              |       |      |                               | todo                  |
| 29  | real_depth                | Peforacion profunidad real     | Пробуренная глубина по факту, от поверхности (уровень гусениц)                                                                                                                            | 15.87                              |       |      | real_depth                    | нужно проверить       |
| 30  | density                   | perforacion densidad           | Плотность                                                                                                                                                                                 | 2.5                                |       |      |                               | нет информации        |
| 31  | mass                      | toneladas taladro              | ? Тон/скважина, Тонны = Burden * espacionamiento * плотность * факт глубина                                                                                                               | 1944.08                            |       |      |                               | не хватает информации |
| 32  | drill_diameter            | diametro broca                 | Диаметр шарошки, из проекта в txt-формате                                                                                                                                                 | 270                                |       |      |                               | нужно проверить       |
| 33  | air_press_avg_psi         | presion aire                   | Среднее давление воздуха                                                                                                                                                                  | 25.61                              |       |      | air_press_avg_psi             | ок                    |
| 34  | rot_speed_avg_rpm         | rpm                            | Средние обороты вращения бура                                                                                                                                                             | 70.94                              |       |      | rot_speed_avg_rpm             | ок                    |
| 35  | feed_press_avg_klbf       | pull down                      | Среднее давление подачи бура                                                                                                                                                              | ? 23091.11 или 40.39               |       |      | feed_press_avg_klbf           | ок                    |
| 36  | hardness                  | dureza                         | Твердость, определяется по времени бурения “Duration_drill”: 0мин – 10мин мягкая Blanco; 11мин – 16 мин средняя Medio; 17мин -30мин твердая Duro; 31 мин – больше  очень твердая Muy duro | Duro, Medio                        |       |      |                               | ок                    |
| 37  | water                     | presencia agua                 | ? Содержание воды (да/нет)                                                                                                                                                                | NO                                 |       |      |                               | нет информации        |
| 38  | move_duration_min         | nuevo_duracion de traslado     | длительность движения                                                                                                                                                                     | 2                                  | min   |      | move_duration                 | ок                    |
| 39  | level_duration_min        | nuevo_duracion de niv y desniv | Продолжительность горизонтирования                                                                                                                                                        | 1                                  | min   |      | level_duration                | ок                    |
| 40  | drill_duration_min        | duracion de penetracion        | Продолжительность бурения                                                                                                                                                                 | 10                                 | min   |      | drill_duration                | ок                    |
| 41  | remote_duration_min       | nuevo_duracion tele-remoto     | Время в режиме ДУ                                                                                                                                                                         | 0                                  | min   |      | remote_duration               | ок                    |
| 42  | hole_duration_full_min    | tiempo de perforacion ready    | Время бурения, сумма перемещение + левелинг + бурение + ДУ                                                                                                                                | 23                                 | min   |      |                               | ок                    |
| 43  | xy_err_m                  | Nuevo_delta xy                 | Ошибка по горизонтальным координатам                                                                                                                                                      | 0.13                               |       |      | xy_err_m                      | ок                    |
| 44  | depth_err_m               | Nuevo_delta altura             | Ошибка по глубине                                                                                                                                                                         | 0.18                               |       |      | depth_err_m                   | нужно проверить       |
| 45  |                           | Top Sub                        | ? из БД диспы MS4M                                                                                                                                                                        | EPIROC 40687-1                     |       |      | пока не делаем                | пока не делаем        |
| 46  |                           | Barra 1                        | ? Штанг 1, из БД диспы MS4M                                                                                                                                                               | AGECOMET 13869-1                   |       |      | пока не делаем                | пока не делаем        |
| 47  |                           | Barra 2                        | ? Штанг 2, из БД диспы MS4M                                                                                                                                                               | AGECOMET 13869-2                   |       |      | пока не делаем                | пока не делаем        |
| 48  |                           | Broca                          | ? Шарошка, из БД диспы MS4M                                                                                                                                                               | 7104249                            |       |      | пока не делаем                | пока не делаем        |
| 49  |                           | Adaptador 8 pies               | ? Переходник 8 футов, из БД диспы MS4M                                                                                                                                                    | SANDVIK S-4563603                  |       |      | пока не делаем                | пока не делаем        |
| 50  |                           | Bit Sub                        | ? из БД диспы MS4M                                                                                                                                                                        | SANDVIK S-4600302                  |       |      | пока не делаем                | пока не делаем        |
| 51  |                           | Deck Bushing                   | ? из БД диспы MS4M                                                                                                                                                                        | AGECOMET 14640-2                   |       |      | пока не делаем                | пока не делаем        |

<details>
<summary>Пример ответа в формате json</summary>

```json
[
   {
      "hole_inner_id":246,
      "start_ts":"2022-11-18 14:44:02",
      "finish_ts":"2022-11-18 14:49:13",
      "shift":"A",
      "start_hr":null,
      "finish_hr":null,
      "guardia":"admin_group",
      "supervisor":"admin_name admin_lastname",
      "vehid":"2",
      "robot_operator":"admin_name admin_lastname",
      "project_mine":"Zona Constancia",
      "project_number":"001",
      "project_place":"F5",
      "project_z":4252.0,
      "real_z_ground":4250.93077958107,
      "project_altitude":"4236",
      "hole_real_bottom_altitude":4249.684369568825,
      "project_name":"PV_4236_001_F5",
      "project_altitude_name":"BANCO 4236",
      "hole_name":"5627",
      "holes_cnt":1,
      "hole_type":"PRODUCCION",
      "hole_category":"23",
      "holes_x_dist":650.0,
      "holes_y_dist":650.0,
      "project_target_depth":1.6,
      "project_depth_with_added":1.600000023841858,
      "robot_estimated_depth":"field28",
      "real_depth":1.24641,
      "density":"field30",
      "mass":"mass31",
      "drill_diameter":270.0,
      "air_press_avg_psi":26.963289904546738,
      "rot_speed_avg_rpm":7.24431,
      "feed_press_avg_klbf":1.9356162849572718,
      "hardness":"Blanco",
      "water":"field37",
      "move_duration_min":2.5166666666666666,
      "level_duration_min":0.5333333333333333,
      "drill_duration_min":1.0666666666666667,
      "remote_duration_min":1.05,
      "hole_duration_full_min":5.166666666666667,
      "xy_err_m":0.1881271877215148,
      "depth_err_m":-0.7156304073332649
   },
   {
      "hole_inner_id":246,
      "start_ts":"2022-11-18 14:44:02",
      "finish_ts":"2022-11-18 14:49:13",
      "shift":"A",
      "start_hr":null,
      "finish_hr":null,
      "guardia":"admin_group",
      "supervisor":"admin_name admin_lastname",
      "vehid":"2",
      "robot_operator":"admin_name admin_lastname",
      "project_mine":"Zona Constancia",
      "project_number":"001",
      "project_place":"F5",
      "project_z":4252.0,
      "real_z_ground":4250.93077958107,
      "project_altitude":"4236",
      "hole_real_bottom_altitude":4249.684369568825,
      "project_name":"PV_4236_001_F5",
      "project_altitude_name":"BANCO 4236",
      "hole_name":"5627",
      "holes_cnt":1,
      "hole_type":"PRODUCCION",
      "hole_category":"23",
      "holes_x_dist":650.0,
      "holes_y_dist":650.0,
      "project_target_depth":16.0,
      "project_depth_with_added":16.0,
      "robot_estimated_depth":"field28",
      "real_depth":1.24641,
      "density":"field30",
      "mass":"mass31",
      "drill_diameter":270.0,
      "air_press_avg_psi":26.963289904546738,
      "rot_speed_avg_rpm":7.24431,
      "feed_press_avg_klbf":1.9356162849572718,
      "hardness":"Blanco",
      "water":"field37",
      "move_duration_min":2.5166666666666666,
      "level_duration_min":0.5333333333333333,
      "drill_duration_min":1.0666666666666667,
      "remote_duration_min":1.05,
      "hole_duration_full_min":5.166666666666667,
      "xy_err_m":0.1881271877215148,
      "depth_err_m":-0.7156304073332649
   },
   {
      "hole_inner_id":328,
      "start_ts":"2022-11-18 14:49:13",
      "finish_ts":"2022-11-18 14:53:45",
      "shift":"A",
      "start_hr":null,
      "finish_hr":null,
      "guardia":"admin_group",
      "supervisor":"admin_name admin_lastname",
      "vehid":"2",
      "robot_operator":"admin_name admin_lastname",
      "project_mine":"Zona Constancia",
      "project_number":"001",
      "project_place":"F5",
      "project_z":4252.0,
      "real_z_ground":4251.2303942489625,
      "project_altitude":"4236",
      "hole_real_bottom_altitude":4249.570704226494,
      "project_name":"PV_4236_001_F5",
      "project_altitude_name":"BANCO 4236",
      "hole_name":"5709",
      "holes_cnt":1,
      "hole_type":"PRODUCCION",
      "hole_category":"23",
      "holes_x_dist":650.0,
      "holes_y_dist":650.0,
      "project_target_depth":1.6,
      "project_depth_with_added":1.600000023841858,
      "robot_estimated_depth":"field28",
      "real_depth":1.65969,
      "density":"field30",
      "mass":"mass31",
      "drill_diameter":270.0,
      "air_press_avg_psi":42.507591240692136,
      "rot_speed_avg_rpm":53.5951,
      "feed_press_avg_klbf":0.233614715317508,
      "hardness":"Blanco",
      "water":"field37",
      "move_duration_min":2.933333333333333,
      "level_duration_min":0.5333333333333333,
      "drill_duration_min":1.05,
      "remote_duration_min":0.0,
      "hole_duration_full_min":4.516666666666667,
      "xy_err_m":0.14234820490601677,
      "depth_err_m":-0.8292957496641975
   },
   {
      "hole_inner_id":328,
      "start_ts":"2022-11-18 14:49:13",
      "finish_ts":"2022-11-18 14:53:45",
      "shift":"A",
      "start_hr":null,
      "finish_hr":null,
      "guardia":"admin_group",
      "supervisor":"admin_name admin_lastname",
      "vehid":"2",
      "robot_operator":"admin_name admin_lastname",
      "project_mine":"Zona Constancia",
      "project_number":"001",
      "project_place":"F5",
      "project_z":4252.0,
      "real_z_ground":4251.2303942489625,
      "project_altitude":"4236",
      "hole_real_bottom_altitude":4249.570704226494,
      "project_name":"PV_4236_001_F5",
      "project_altitude_name":"BANCO 4236",
      "hole_name":"5709",
      "holes_cnt":1,
      "hole_type":"PRODUCCION",
      "hole_category":"23",
      "holes_x_dist":650.0,
      "holes_y_dist":650.0,
      "project_target_depth":16.0,
      "project_depth_with_added":16.0,
      "robot_estimated_depth":"field28",
      "real_depth":1.65969,
      "density":"field30",
      "mass":"mass31",
      "drill_diameter":270.0,
      "air_press_avg_psi":42.507591240692136,
      "rot_speed_avg_rpm":53.5951,
      "feed_press_avg_klbf":0.233614715317508,
      "hardness":"Blanco",
      "water":"field37",
      "move_duration_min":2.933333333333333,
      "level_duration_min":0.5333333333333333,
      "drill_duration_min":1.05,
      "remote_duration_min":0.0,
      "hole_duration_full_min":4.516666666666667,
      "xy_err_m":0.14234820490601677,
      "depth_err_m":-0.8292957496641975
   },
   {
      "hole_inner_id":328,
      "start_ts":"2022-11-18 14:49:13",
      "finish_ts":"2022-11-18 14:53:45",
      "shift":"A",
      "start_hr":null,
      "finish_hr":null,
      "guardia":"admin_group",
      "supervisor":"admin_name admin_lastname",
      "vehid":"2",
      "robot_operator":"admin_name admin_lastname",
      "project_mine":"Zona Constancia",
      "project_number":"001",
      "project_place":"F5",
      "project_z":4252.0,
      "real_z_ground":4251.2303942489625,
      "project_altitude":"4236",
      "hole_real_bottom_altitude":4249.570704226494,
      "project_name":"PV_4236_001_F5",
      "project_altitude_name":"BANCO 4236",
      "hole_name":"5709",
      "holes_cnt":1,
      "hole_type":"PRODUCCION",
      "hole_category":"23",
      "holes_x_dist":650.0,
      "holes_y_dist":650.0,
      "project_target_depth":15.0,
      "project_depth_with_added":15.0,
      "robot_estimated_depth":"field28",
      "real_depth":1.65969,
      "density":"field30",
      "mass":"mass31",
      "drill_diameter":270.0,
      "air_press_avg_psi":42.507591240692136,
      "rot_speed_avg_rpm":53.5951,
      "feed_press_avg_klbf":0.233614715317508,
      "hardness":"Blanco",
      "water":"field37",
      "move_duration_min":2.933333333333333,
      "level_duration_min":0.5333333333333333,
      "drill_duration_min":1.05,
      "remote_duration_min":0.0,
      "hole_duration_full_min":4.516666666666667,
      "xy_err_m":0.14234820490601677,
      "depth_err_m":-0.8292957496641975
   },
   {
      "hole_inner_id":169,
      "start_ts":"2022-11-18 22:07:51",
      "finish_ts":"2022-11-18 23:35:22",
      "shift":"B",
      "start_hr":null,
      "finish_hr":null,
      "guardia":"vah of test user",
      "supervisor":"manual_superviso1 manual_supervisor2",
      "vehid":"2",
      "robot_operator":"name_tu1 name_tu2",
      "project_mine":"Zona Constancia",
      "project_number":"001",
      "project_place":"F5",
      "project_z":4252.0,
      "real_z_ground":4251.13298333168,
      "project_altitude":"4236",
      "hole_real_bottom_altitude":4249.480303292275,
      "project_name":"PV_4236_001_F5",
      "project_altitude_name":"BANCO 4236",
      "hole_name":"5550",
      "holes_cnt":1,
      "hole_type":"PRODUCCION",
      "hole_category":"23",
      "holes_x_dist":650.0,
      "holes_y_dist":650.0,
      "project_target_depth":1.6,
      "project_depth_with_added":1.600000023841858,
      "robot_estimated_depth":"field28",
      "real_depth":1.65268,
      "density":"field30",
      "mass":"mass31",
      "drill_diameter":270.0,
      "air_press_avg_psi":44.07429269156456,
      "rot_speed_avg_rpm":58.8239,
      "feed_press_avg_klbf":0.3454684073083766,
      "hardness":"Blanco",
      "water":"field37",
      "move_duration_min":2.216666666666667,
      "level_duration_min":0.6166666666666667,
      "drill_duration_min":1.1,
      "remote_duration_min":0.0,
      "hole_duration_full_min":3.933333333333333,
      "xy_err_m":0.2891030329559467,
      "depth_err_m":-0.9196966838835579
   },
   {
      "hole_inner_id":169,
      "start_ts":"2022-11-18 22:07:51",
      "finish_ts":"2022-11-18 23:35:22",
      "shift":"B",
      "start_hr":null,
      "finish_hr":null,
      "guardia":"vah of test user",
      "supervisor":"manual_superviso1 manual_supervisor2",
      "vehid":"2",
      "robot_operator":"name_tu1 name_tu2",
      "project_mine":"Zona Constancia",
      "project_number":"001",
      "project_place":"F5",
      "project_z":4252.0,
      "real_z_ground":4251.13298333168,
      "project_altitude":"4236",
      "hole_real_bottom_altitude":4249.480303292275,
      "project_name":"PV_4236_001_F5",
      "project_altitude_name":"BANCO 4236",
      "hole_name":"5550",
      "holes_cnt":1,
      "hole_type":"PRODUCCION",
      "hole_category":"23",
      "holes_x_dist":650.0,
      "holes_y_dist":650.0,
      "project_target_depth":16.0,
      "project_depth_with_added":16.0,
      "robot_estimated_depth":"field28",
      "real_depth":1.65268,
      "density":"field30",
      "mass":"mass31",
      "drill_diameter":270.0,
      "air_press_avg_psi":44.07429269156456,
      "rot_speed_avg_rpm":58.8239,
      "feed_press_avg_klbf":0.3454684073083766,
      "hardness":"Blanco",
      "water":"field37",
      "move_duration_min":2.216666666666667,
      "level_duration_min":0.6166666666666667,
      "drill_duration_min":1.1,
      "remote_duration_min":0.0,
      "hole_duration_full_min":3.933333333333333,
      "xy_err_m":0.2891030329559467,
      "depth_err_m":-0.9196966838835579
   }
]
```

</details>

### Описание краткого отчета shift-summary

#### Запрос
Пример:
```
http://127.0.0.1:8083/api/history/shift-summary?veh=2&date=2022-11-18&shift=A
```

Параметры:
- veh
- date время начала периода для фильтрации по start_ts, формат `%Y-%m-%d` 
  - (где %d - день месяца в виде десятичной дроби с нулями, %m - месяц как десятичное число с нулями, %Y - год со столетием в виде десятичного числа)
- shift - смена A c 7:00 до 19:00, B - с 19:00 до 07:00 следующего дня

#### Ответ
Пример ответа
```
Shift A (2022-11-18)
Holes: 5
Meters 8.1
Hours 0.4

5613 14:20 ‐ 14:23 1.7
5533 14:34 ‐ 14:38 1.7
5528 14:38 ‐ 14:44 1.8
5627 14:44 ‐ 14:49 1.2
5709 14:49 ‐ 14:53 1.7
```




