Підключіть Jira до таймшитів: досить вводити години двічі

Проблема подвійного введення

У більшості сервісних IT-компаній години вже існують. Інженери логують роботу в Jira — на тікеті, поки все свіже, бо саме там живе робота. Далі фінансам потрібні години під інвойс у розрізі людина × проєкт — і кожен доступний шлях поганий:

• Попросити інженерів логувати вдруге в інструменті таймшитів. Вони не будуть — або в п’ятницю вгадають одним махом увесь тиждень, і цифри будуть вигадкою.
• Експортувати CSV із Jira і місити їх у таблиці. Години бухгалтерського часу щомісяця, з ручними з’єднаннями між проєктами Jira і білінговими проєктами.
• Виставляти інвойси за планом, а не за фактом — і тихо втрачати різницю між тим, що заалоковано, і тим, що відпрацьовано.

Подвійне введення — це не лише змарновані хвилини. Дві системи обліку тих самих годин гарантовано розійдуться, і розбіжність спливе в найгірший момент: в інвойсі, який клієнт ставить під сумнів.

Односторонній синк — здорова модель

Інтеграція Helia з Jira свідомо одностороння: Jira → Helia. Залогована робота тече з Jira в таймшити Helia. Назад не тече нічого.

Двосторонній синк звучить привабливіше, поки не спитати, хто виграє конфлікт. Менеджер виправляє години перед інвойсингом — чи має правка переписати ворклог інженера в Jira? Якщо так — ваш білінговий інструмент тихцем редагує інженерну історію. Якщо ні — системи знову розходяться, і ви відтворили вихідну проблему з додатковими рухомими частинами.

Односторонність тримає межі відповідальності чистими:

• Jira лишається джерелом правди про те, що залогували інженери. Жоден інструмент не редагує їхні ворклоги за їхніми спинами.
• Helia — джерело правди про те, що ви виставляєте клієнту. Виправлення — це білінгове рішення: воно відбувається на білінговому боці й там і лишається.
• Інженери не змінюють нічого. Жодного нового інструмента, жодного розширення для браузера, жодних повідомлень «заповни, будь ласка, ще й таймшит». Якщо на тікеті є залогована робота — у таймшиті є години.

Налаштування: підключити, змапити, синкнути

Налаштування живе в Налаштування → Інтеграції → Jira і займає кілька хвилин:

1. Підключіть свій сайт Jira Cloud. Увійдіть через Atlassian і оберіть сайт. Helia приймає лише сайти на офіційному хмарному домені Atlassian (серверний allowlist) і запитує read-only-скоупи для ворклогів — вона не може писати у вашу Jira навіть у принципі.
2. Змапте проєкти. Зв’яжіть кожен проєкт Jira, за який ви виставляєте інвойси, з проєктом Helia — тими самими проєктами, на яких тримаються планування завантаження та інвойсинг. Незмаплені проєкти Jira ігноруються, тож внутрішні пісочниці ніколи не засмічують таймшити.
3. Змапте людей. Спаруйте акаунти Jira з працівниками Helia, щоб години падали на правильну людину. Ворклог потрапляє в таймшити, лише коли змаплено обидва — і його проєкт, і його автора; жодного вгадування.
4. Запустіть перший синк. Далі він ходить щоночі сам (з кнопкою ручного синку для нетерплячих тижнів). Залогована робота прибуває в таймшити Helia як чернеткові записи — години, підсумовані на людину, на проєкт, на день.

Перевірити, виправити, закрити

Синкнуті години — це чернетки, а не істина в останній інстанції. Тижневий ритм:

• Інженери далі логують у Jira. Їхні години з’являються в Helia з позначкою джерела, тож синкнуті записи завжди можна відрізнити від введених вручну.
• Менеджер переглядає тиждень. Двічі залогований тікет, мітинг, залогований не на той проєкт, 10-годинний день, який насправді був 6, — виправлення відбуваються тут. Щойно людина відредагувала запис — запис її: він позначається як виправлений вручну, і синк ніколи його не перезапише — ні цієї ночі, ні будь-коли.
• Менеджер закриває тиждень. Закриті години незмінні: синк їх не чіпає, працівники їх не редагують, а зміни в Jira на них більше не впливають. Що закрито — те й сталося.

Саме цей шлюз «перевір, потім закрий» робить дані придатними для інвойсів. Ви ніколи не виставляєте клієнту «те, що синк записав останнім» — ви виставляєте те, що людина переглянула й підтвердила.

Від закритих годин до клієнтського інвойсу

Закриті години — це вхід для білінгу. Наприкінці місяця генерація інвойсів читає закриті години таймшитів по кожному проєкту — години × ставка на time-and-materials-проєктах, факт проти фіксованої суми на ретейнерах — і формує чернетки інвойсів з того, що сталося насправді, а не із застарілого плану алокацій.

Ланцюжок від краю до краю: інженер логує тікет у Jira → години з’являються в Helia → менеджер переглядає і закриває тиждень → інвойс сам збирається чернеткою із закритих годин. Одна точка введення, один шлюз перевірки, нуль передруковування.

Білінгова половина цього ланцюжка — моделі, де течуть години, одногодинний ритуал кінця місяця — це окремий гайд: від таймшитів до клієнтських інвойсів.

Обмеження і чесні примітки

• Наразі лише Jira Cloud. Інтеграція розмовляє з хмарним API Atlassian; self-hosted Jira Server / Data Center не підтримується.
• Tempo вам не потрібен. Синк читає нативні ворклоги Jira — вбудоване «Log work» на кожному тікеті. Жодного плагіна для тайм-трекінгу не треба.
• Односторонній означає односторонній. Виправлення, зроблені в Helia, ніколи не з’являються в Jira. Jira відповідає на «що залогувала інженерія», Helia — на «що ми виставляємо клієнту»; цим відповідям дозволено різнитися, а позначка джерела показує, де саме.
• Ручні правки завжди виграють. Синкнутий запис, який відредагувала людина, наступний синк ніколи не перезаписує. Закритий тиждень не чіпається взагалі.
• Видалені ворклоги шануються — поки ви не закрили тиждень. Якщо ворклог видалили в Jira, відповідні чернеткові години зникають із наступним синком. Щойно тиждень закрито, видалення в Jira його більше не змінюють.
• Часові пояси. Часові мітки ворклогів Jira нормалізуються до дня воркспейсу — запис лягає на той календарний день, коли його розпочато за міткою самого ворклога. Командам, розкиданим по часових поясах, варто вибірково перевірити перший синкнутий тиждень і домовитися, куди мають падати випадки «близько опівночі».

FAQ

Чи мусять інженери входити в Helia, щоб їхні години синкалися?

Ні. Їхній акаунт Jira має бути змаплений на працівника Helia — і все. Вони далі логують роботу в Jira точнісінько як раніше; у їхньому дні не змінюється нічого.

Частина наших людей взагалі не користується Jira. Це щось ламає?

Ні — змішані команди це нормальний випадок. Введені вручну і синкнуті години живуть в одному таймшиті й розрізняються позначкою джерела. Дизайнери вводять свої години руками, інженери синкають свої, а менеджер в обох випадках переглядає один тиждень.

Чи може нічний синк перезаписати виправлення менеджера?

Ні. Редагування запису позначає його як виправлений вручну, і синк назавжди оминає такі записи. Закриті тижні незмінні для синку незалежно від джерела.

Деякі проєкти в нас із фіксованою ціною. Чи варто все одно синкати їхні години?

Так. На fixed-price-роботі години не визначають інвойс — вони кажуть, чи фіксована ціна досі прибуткова. Це інше питання, але без годин ви й на нього не відповісте.

Яку частину нашої Jira бачить інтеграція?

Вона використовує read-only-скоупи і торкається ворклогів плюс мінімальних метаданих тікетів і проєктів, потрібних, щоб їх розкласти. Вона ніколи не пише в Jira і синкає лише з проєктів, які ви явно змапили.