# Принцип расчета индекса

**1. Индекс** - о<span style="font-weight: 400;">тношение число посетителей к коммерческой площади объектов за N-периодичность, где N может принимать значения: день, неделя, месяц, квартал и год. Индекс всегда разбивается на N-периодичность.</span>

<span style="font-weight: 400;">Правила выбора периода каждой N-периодичности:  
</span>

- <span style="font-weight: 400;">день - календарный день</span>
- <span style="font-weight: 400;">неделя - календарная неделя (с понедельника по воскресенье)</span>
- <span style="font-weight: 400;">месяц - календарный месяц (с первого дня месяца по последний день месяца)</span>
- <span style="font-weight: 400;">квартал - календарный квартал (с первого дня квартала по последний день квартала)</span>
- <span style="font-weight: 400;">год - календарный год (с первого дня года по последний день года)</span>

**Общая формула расчета индекса:**

[![image-1695146709412.png](https://rzn-wb-02.1c-hosting.com/uploads/images/gallery/2023-09/scaled-1680-/image-1695146709412.png) ](https://rzn-wb-02.1c-hosting.com/uploads/images/gallery/2023-09/image-1695146709412.png), где [![image-1695146736914.png](https://rzn-wb-02.1c-hosting.com/uploads/images/gallery/2023-09/scaled-1680-/image-1695146736914.png) -](https://rzn-wb-02.1c-hosting.com/uploads/images/gallery/2023-09/image-1695146736914.png) посещаемость объекта за m-день по счету периодичности, N - количество календарных дней в периодичности, S - площадь объекта. Например:

**Объект:** ТЦ "Солнышко"  
**Площадь:** 136000 м^2.  
**Посещаемость**:

<table border="1" cellpadding="0" cellspacing="0" dir="ltr" id="bkmrk-04.09.2023-460-792-0" style="width: 230px;"><colgroup><col width="100"></col><col width="100"></col></colgroup><tbody><tr><td style="width: 114.5px;">День</td><td style="width: 114.5px;">Посещаемость</td></tr><tr><td data-sheets-numberformat="{"1":5,"2":"dd.mm.yyyy","3":1}" data-sheets-value="{"1":3,"3":45173}" style="width: 114.5px;">04.09.2023</td><td data-sheets-value="{"1":2,"2":"460 792"}" style="width: 114.5px;">460 792</td></tr><tr><td data-sheets-numberformat="{"1":5,"2":"dd.mm.yyyy","3":1}" data-sheets-value="{"1":3,"3":45174}" style="width: 114.5px;">05.09.2023</td><td data-sheets-value="{"1":2,"2":"349 621"}" style="width: 114.5px;">349 621</td></tr><tr><td data-sheets-numberformat="{"1":5,"2":"dd.mm.yyyy","3":1}" data-sheets-value="{"1":3,"3":45175}" style="width: 114.5px;">06.09.2023</td><td data-sheets-value="{"1":2,"2":"347 337"}" style="width: 114.5px;">347 337</td></tr><tr><td data-sheets-numberformat="{"1":5,"2":"dd.mm.yyyy","3":1}" data-sheets-value="{"1":3,"3":45176}" style="width: 114.5px;">07.09.2023</td><td data-sheets-value="{"1":2,"2":"339 815"}" style="width: 114.5px;">339 815</td></tr><tr><td data-sheets-numberformat="{"1":5,"2":"dd.mm.yyyy","3":1}" data-sheets-value="{"1":3,"3":45177}" style="width: 114.5px;">08.09.2023</td><td data-sheets-value="{"1":2,"2":"340 794"}" style="width: 114.5px;">340 794</td></tr><tr><td data-sheets-numberformat="{"1":5,"2":"dd.mm.yyyy","3":1}" data-sheets-value="{"1":3,"3":45178}" style="width: 114.5px;">09.09.2023</td><td data-sheets-value="{"1":2,"2":"341 773"}" style="width: 114.5px;">341 773</td></tr><tr><td data-sheets-numberformat="{"1":5,"2":"dd.mm.yyyy","3":1}" data-sheets-value="{"1":3,"3":45179}" style="width: 114.5px;">10.09.2023</td><td data-sheets-value="{"1":2,"2":"350 024"}" style="width: 114.5px;">350 024</td></tr><tr><td data-sheets-numberformat="{"1":5,"2":"dd.mm.yyyy","3":1}" data-sheets-value="{"1":3,"3":45180}" style="width: 114.5px;">11.09.2023</td><td data-sheets-value="{"1":2,"2":"395 949"}" style="width: 114.5px;">395 949</td></tr><tr><td data-sheets-numberformat="{"1":5,"2":"dd.mm.yyyy","3":1}" data-sheets-value="{"1":3,"3":45181}" style="width: 114.5px;">12.09.2023</td><td data-sheets-value="{"1":2,"2":"354 614"}" style="width: 114.5px;">354 614</td></tr><tr><td data-sheets-numberformat="{"1":5,"2":"dd.mm.yyyy","3":1}" data-sheets-value="{"1":3,"3":45182}" style="width: 114.5px;">13.09.2023</td><td data-sheets-value="{"1":2,"2":"404 033"}" style="width: 114.5px;">404 033</td></tr><tr><td data-sheets-numberformat="{"1":5,"2":"dd.mm.yyyy","3":1}" data-sheets-value="{"1":3,"3":45183}" style="width: 114.5px;">14.09.2023</td><td data-sheets-value="{"1":2,"2":"363 209"}" style="width: 114.5px;">363 209</td></tr><tr><td data-sheets-numberformat="{"1":5,"2":"dd.mm.yyyy","3":1}" data-sheets-value="{"1":3,"3":45184}" style="width: 114.5px;">15.09.2023</td><td data-sheets-value="{"1":2,"2":"369 375"}" style="width: 114.5px;">369 375</td></tr><tr><td data-sheets-numberformat="{"1":5,"2":"dd.mm.yyyy","3":1}" data-sheets-value="{"1":3,"3":45185}" style="width: 114.5px;">16.09.2023</td><td data-sheets-value="{"1":2,"2":"351 758"}" style="width: 114.5px;">351 758</td></tr><tr><td data-sheets-numberformat="{"1":5,"2":"dd.mm.yyyy","3":1}" data-sheets-value="{"1":3,"3":45186}" style="width: 114.5px;">17.09.2023</td><td data-sheets-value="{"1":2,"2":"365 543"}" style="width: 114.5px;">365 543</td></tr></tbody></table>

Период построения: 04.09.2023 - 17.09.2023  
Периодичность: Неделя

**Индекс за 04.09-10.09**: (460792+349621+347337+339815+340794+341773+350024)/136000 = **18,60**  
**Индекс за 11.09-17.09**: (395949+354614+404033+363209+369375+351758+365543)/136000 = **19,15**

**2. Шаблоны** - сохраненные фильтры по атрибутам объекта для формирования индекса. У шаблона может быть указан период фиксации в виде даты начала и даты окончания (либо должна быть функция фиксации индекса за период по шаблону).

Пример шаблона:

```JSON
{
    "template": {
        "address": [
            {
                "fias_ids": [
                    "123123",
                    "123123",
                    "123213"
                ],
                "representation": "Россия; Рязань; Глазань"
            }
        ],
        "area": [
            {
                "value": 45000,
                "operator": "gte"
            },
            {
                "value": 90000,
                "operator": "lte"
            }
        ],
        "is_mall": true,
        "props": [
            {	
              	"id": "uid",
                "prop_name": "1706532045",
                "values": [{
              		"id": 2,
              		"value": "Одежда"	
            	}],
                "operator": "eq",
              	"group": false
            },
  			 {
              	"id": "uid2",
                "operator": "or",
              	"group": true,
  				"children": [
  					{	
                      "id": "uid3",
                      "prop_name": "1706532045",
                      "values": [{
                          "id": 4,
                          "value": "Женская одежда"
                      }],
                      "operator": "neq",
                      "group": false
                  },
                    {	
                      "id": "uid4",
                      "prop_name": "1706105749",
                      "values": [
                          {
                            "id": 42,
                            "value": 1	
                          },
                          {
                            "id": 45,
                            "value": 3	
                          }
                      ],
                      "operator": "in",
                      "group": false
                    },
  				]
            }
        ]
    }
}
```

eq — равно  
neq — не равно  
lt — меньше  
lte — меньше или равно  
gt — больше  
gte — больше или равно  
in - находит объекты со свойством, значение которого равно одному из значений из списка  
nin - находит объекты со свойством, значение которого не равно ни одному из значений из списка

is\_mall принимает значения - true, false, none. none отменяет применение фильтра

**3. Фиксация индекса**

По существующим шаблонам должен быть предусмотрен механизм фиксации индекса работающий следующим образом: строится индекс по указанным фильтрам шаблона и сохраняется за указанный период фиксации шаблона.

Фиксировать значение индекса рекомендуется в разрезе дня.

Значения индекса для фиксации строятся на основе данных посещаемости по объектам с учетом основных принципов расчета и формулы расчета индекса.

В случае если за определенный период нет данных для расчета индекса, то такой индекс заполняется в разрезе дня со значением равным 0 (нулю).

**4. Расчет индекса**

Пример запроса индекса доступен [по ссылке](https://rzn-wb-02.1c-hosting.com/books/razrabotka-3ug/page/primer-zaprosa-polucheniya-indeksa).

**Основные принципы расчета индекса:**

- Данные по объектам берутся только за период работы с объектом (атрибуты объекта: дата начала работы, дата окончания работы с объектом).
- Данные по объекту не берутся в случае если по объекту отсутствуют данные за полную N-периодичность, в ином случае данные по объекту участвуют в расчете индекса.
- В случае построение индекса по шаблону (запрос по "template" из примера запроса): 
  - Период построение отчета попадает в период фиксации по шаблону: 
    - Данные по индексу строятся из фиксированного индекса по шаблону
  - Период отчета не попадает в период фиксации по шаблону: 
    - Данные по индексу строятся на основании данных посещаемости объектов
  - Период отчета по индексу частично попадает в период фиксации по шаблону: 
    - За период который попадает в период фиксации данные строятся из фиксированного индекса по шаблону
    - За период который не попадает в период фиксации данные на основании данных посещаемости объектов
- В случае построение индекса по объектом (запрос по "objects" из примера запроса): 
  - Данные строятся на основании посещаемости объектов

[Пример расчета индекса в google-таблице](https://docs.google.com/spreadsheets/d/1pDqcJS5Mw-tQOWBjtIUdc1aqNQFJ78xf7tTrG8o480k/edit?usp=sharing)