2gis-maps/vendors/firmcard/doc/Schedule.md

Interactive 2GIS maps API, based on Leaflet

### Цель

Облегчить работу пользователей с информацией о времени работы организаций. 

### Упрощение способа отображения времени работы

Сегодня мы отображаем время работы в виде таблицы. Такая форма отображения избыточна для наиболее распространённых расписаний организаций: когда организации имеют одинаковый график во все рабочие дни без обеда и фиксированные выходные. 

Примеры: 

![](./img/schedule-table.png "График работы в виде таблицы")

##### Правила отображения в кратком ("свёрнутом") виде

1.  Для случая, когда организация имеет одинаковый график во все дни недели без обеда: пишем "Ежедневно [время работы]", время работы не раскрывается по клику. 

 ![](./img/everyday.png "Ежедневно")

     2. Если организация работает круглосуточно: показываем строку "работает круглосуточно", время работы не раскрывается по клику.

![](./img/24x7.png "Круглосуточно")

     3. Если организация работает по разному расписанию в разные дни, имеет перерывы на обед или выходные  - время работы раскрывается по клику.

     ![](./img/today-dropdown.png "Сегодня,-раскрывающийся-список")

         3.1. Если у организации сегодня есть обед - говорим об этом в свёрнутом виде.

         ![](./img/today-dinner.png "Сегодня,-обед")

         3.2. Если у организации сегодня выходной.

          ![](./img/holiday.png "Сегодня выходной")

##### Правила отображения полного ("развёрнутого") вида

   По данным новосибирского каталога (общее кол-во фирм - 51 255):

      компаний, работающих ежедневно по одному графику - 15 203 (29,66%)

      компаний, имеющих не более трёх интервалов работы (пн-пт, сб, вс) - 49 923 (95,45%)

      компании, имеющих обеденный перерыв - 4 554 (8,88%)

   В развернутом виде заменяем табличное представление на строчное, для случаев  когда у организации два или три интервала работы:

![](./img/schedule-strings.png)

  При форматировании строчного представления используем следующие правила

    1. Если время работы одинаково с понедельника по пятницу - оформляем строкой "Будние дни"

    2. Если время работы одинаково, для двух дней подрят - оформляем строкой с перечислением каждого дня "понедельник, вторник"

    3. Если время работы одинаково для трёх и более дней - оформляем периодом "пятница - среда"

    4. Каждая группа должна начинаться с новой строки. 

   Несмотря на то, что компаний с большим количеством интервалов работы немного (менее 5%), как правило, это социально значимые организации. Например, УФМС в Москве - [http://go.2gis.ru/nzit](http://go.2gis.ru/nzit) . В случае, если у организации более трёх интервалов работы, необходимо оставить табличное представление. 

   ![](./img/table.png)

##### Отображения комментария ко времени работы

Если ко времени работы организации указан комментарий, отображаем его только в раскрытой карточке: 

![](./img/schedule-comment.png "Комментарий-ко-времени-работы")

В случае если время работы организации одинаково для всех дней недели или организация работает круглосуточно комментарий отображается после краткой записи

![](./img/24x7-comment.png "Круглосуточно,-коммент.") 

![](./img/everyday-comment.png "Коммент-ко-времени-работы,-свёрнутое-время-работы.png")

### Подсказки ко времени работы

В свёрнутом виде у времени работы появляются подсказки. Задача - помочь пользователю определить работает организация сейчас или нет.

Используется цветовое кодирование иконки (зеленая - если организация работает, серая - если организация закрыта) и тестовая подсказка.

**Финальные версии текстов для подсказок**
<table>
    <tr>
        <th>График работы </th>
        <th>Подсказка</th>
    </tr>
    <tr>
        <td>Сегодня 09:00 – 20:00 </td>
        <td><b>Открыто до 20:00</b></td>
    </tr>
    <tr>
        <td>Сегодня 09:00 – 20:00 </td>
        <td><b>Откроется завтра</b></td>
    </tr>
    <tr>
        <td>Сегодня 09:00 – 20:00 </td>
        <td><b>Закроется через 15 минут</b></td>
    </tr>
    <tr>
        <td>Сегодня 09:00 – 20:00 </td>
        <td><b>Открыто. Меньше 5 минут до закрытия</b></td>
    </tr>
    <tr>
        <td>Сегодня 09:00 – 20:00 </td>
        <td><b>Закроется через 5 минут</b></td>
    </tr>
    <tr>
        <td>Сегодня 09:00 – 20:00, обед 13:00 – 14:00 </td>
        <td><b>Закроется через 15 минут</b></td>
    </tr>
    <tr>
        <td>Сегодня 09:00 – 20:00, обед 13:00 – 14:00</td>
        <td><b>Откроется через 15 минут</b></td>
    </tr>
    <tr>
        <td>Сегодня 09:00 – 20:00 </td>
        <td><b>Откроется через 15 минут</b></td>
    </tr>
    <tr>
        <td>Сегодня выходной</td>
        <td><b>Откроется в понедельник</b></td>
    </tr>
</table>


##### Подсказки при использовании фильтра "Работает сейчас"

Если пользователь отфильтровал результаты поиска по "Работает сейчас" подсказка должна отображаться и для скрытой карточки предприятия.&nbsp;

![](./img/open-now.png "Работает-сейчас")

### Дополнительные требования и&nbsp;ограничения

1.  Время работы оцениваем по часовому поясу проекта в котором находится организация. Т.е. если человек из Новосибирска в просматривает профиль московской организации - время до закрытия должно считаться по московскому времени.&nbsp;
2.  Не учитываем переходы на летнее\зимнее время.
3.  Не учитываем праздники.

### Примеры карточек


![](./img/worktimescreen.png "worktimescreen.png")