На работа днес · Google Sheets
Версия 20 използва един избран частен Google Sheets документ чрез Google вход и съгласие на собственика. Прегледът е достъпен за всички вписани; редактирането изисква отделно право в YS Board и Google разрешение за запис. Всеки вписан потребител вижда резултата в разгъваемото „На работа днес“ под „Всички събития“. Графикът може да работи и при изключен календар.
1. Разрешете Google Sheets API
- Отворете Google Cloud Console с акаунта на собственика и изберете проект.
- APIs & Services → Library → Google Sheets API → Enable.
- В Google Auth Platform настройте Branding, Audience и Data Access. За обикновен Gmail изберете External. При Testing добавете собственика в Test users.
- Разрешението е
https://www.googleapis.com/auth/spreadsheets— четене и редактиране на Google таблици. YS Board използва само въведения документ и няма Google Drive API интеграция. Старо разрешениеspreadsheets.readonlyпозволява преглед, но не запис.
2. Web application OAuth client
- В YS Board от обикновен браузър отворете публичния HTTPS адрес → Администраторски достъп → Работен график.
- Копирайте показания точен Authorized redirect URI. Той завършва с
/api/admin/work-schedule/google/callback. - В Google Cloud → Google Auth Platform → Clients създайте OAuth client с тип Web application. Добавете този URI в Authorized redirect URIs и изтеглете JSON.
- Може да използвате съществуващия Web client за календара, като добавите и новия URI. Връзката и правото за графика се запазват отделно от календарните.
- Поставете JSON в YS Board и натиснете „Запази ключовете“. Ключът се шифрова в settings, полето се изчиства и секретите не се връщат към клиента.
3. Свържете собственика и изберете таблицата
- Натиснете „Свържи с Google“, влезте със собственика или акаунт с достъп за редактиране на документа и разрешете четенето и редактирането. Служителите не свързват собствени Google акаунти.
- След връщане в YS Board поставете адреса на целия документ от вида
https://docs.google.com/spreadsheets/d/…/editили неговия ID. Частта gid не се използва за избор на месец. - Отметнете „Показвай На работа днес“ и натиснете „Запази“. Самото свързване не включва графика.
Свързването се стартира от обикновен браузър, извън Android WebView. След настройването всички клиенти, включително PWA и съществуващото APK, използват същия уеб интерфейс. В режим External/Testing refresh token с тези права обичайно изтича след 7 дни; за постоянна работа настройте подходящ Production режим според правилата на Google. При отнето разрешение свържете отново. „Премахни връзката“ изтрива локалните токени и изключва графика; запазва OAuth client и адреса на документа, без Google revoke и без промяна на таблицата.
Редактиране на клетки и достъп
- В Google Auth Platform → Data Access добавете разрешението
https://www.googleapis.com/auth/spreadsheets, ако липсва. - В YS Board → Администраторски достъп → Работен график натиснете „Свържи с Google“ отново и дайте разрешението за редактиране. Съществуващият OAuth JSON и callback остават валидни. Не прекъсвайте старата връзка предварително: тя продължава да позволява четене.
- Всички администратори имат достъп за редакция. За служител отворете достъпите му и включете „Редактира работния график“. По подразбиране това право не е дадено. Служителят използва YS Board входа си, без собствен Google вход.
- Натиснете имената в „На работа днес“, изберете месец, включете „Редактиране“ и натиснете клетка. Формата прочита актуалната стойност от Google, включително формулата, ако има такава.
- Въведете стойност или формула и натиснете „Запази“. Празно поле изчиства клетката. Google обработва въведеното като USER_ENTERED според настройките на таблицата. За отказ използвайте „Отказ“ или ×.
Преди запис се проверяват отново сесията, правото, връзката и текущият ред. Ако редът е променен след отварянето, записът се отказва с предупреждение и въведеният текст остава във формата. Отворете клетката отново. Външна едновременна редакция в тесния момент между проверката и записа не може да бъде заключена чрез Sheets values API.
Автоматичното общо изтегляне остава през два часа. Отварянето на клетка чете актуалния ред; изричното записване прави Google заявка за запис и обновява само засегнатия месец. Другите месеци запазват точните си времена „Обновено“ и общия срок за обновяване. Ако записът успее, а обновяването на копието се провали, YS Board изрично показва, че вече е записано в Google. Последните две колони остават редактируеми — изключени са само от изчисляването на смените.
Как се разчита графикът
Всеки месец е отделен лист. Заглавие като „НОЕМВРИ 2026“ или „Ноември 2026“ се търси във всички клетки на първите два реда, без значение на регистъра и излишните интервали. Името на таба и неговият gid не определят месеца. Нов лист в същия документ се открива автоматично.
Днес се определя по Europe/Sofia. В избрания лист денят се търси като число в колона A, независимо от номера на реда. На намерения ред са имената и двете клетки непосредствено преди всяко име. Имената се показват така, както са в таблицата; не е необходимо да съвпадат с логините в YS Board. Еднобуквените означения за отсъствие не са имена.
| Лява клетка | Дясна клетка | Показване |
|---|---|---|
| 8 | празна | Редовни |
| 11 | празна | Целодневни |
| 8 | 4 | Редовни и Вечерна |
| 11 | 4 | Целодневни и Вечерна |
| празна | 4 | Вечерна |
| друго число, например 6.5 / 7 / 7,5 | празна или 4 | Редовни (!) и Вечерна при 4 |
| Буква в която и да е от двете клетки, например Б или И | Служителят не е на работа и не се показва в групите | |
| празна | празна | Не се показва |
Десетичните числа могат да са с точка или запетая. Тире (-, – или —) се приема за празна клетка. Знакът (!) е само след името в Редовни при час, различен от 8 и 11. Един човек може да присъства в две групи.
Пълен месечен график
От версия 21 началният мащаб е 70%. Първите два реда и колона A са фиксирани при превъртане. Обединените клетки остават цели. Всеки надпис „Няма“ също отваря текущия месец. Сървърът обновява графика във фонов режим независимо от посетителите, през общия двучасов кеш. Презареждането на страницата не подменя „Обновено“ с клиентски час.
Натиснете самите имена в Редовни, Целодневни или Вечерна. Отваря се целият използван диапазон на текущия месечен лист, с хоризонтално/вертикално превъртане, стрелки за предишен/следващ календарен месец и × горе вдясно. На телефон изгледът е на цял екран, в рамката и темата на календара. Запазват се текстовете/форматираните стойности, основните цветове, удебеляването, подчертаването, границите, размерите и обединенията на клетки. Изгледът не изпълнява формули в браузъра и не зарежда външни изображения. Разрешените потребители могат да редактират стойности и формули в съществуващите клетки; това не е пълният Google редактор за структура, форматиране, коментари и графики.
Над листа преди × стои например Обновено: 14.11 10:35ч, по Europe/Sofia, без година. Това е точният момент на последното успешно изтегляне на показвания месечен лист от Google от YS Board сървъра, включително след изрично записване. При четене от кеша, отваряне на друг месец или временна грешка този час не се подменя с текущия. При липса на успешно изтегляне се показва „няма данни“.
Обновяване и грешки
От версия 19 последните две колони на използваната месечна таблица се игнорират при определяне на смените. Те съдържат друга информация: текстът им не е име на служител за днес, а числата не са часове за смените. В пълния месечен изглед всички колони остават видими. Изключването е по цялата използвана ширина на листа, така че празна крайна клетка в конкретен ден не мести границата.
От версия 18 днешният ден се търси по стойност в колона A, отгоре надолу. Използва се първият съвпадащ ред, дори денят да се повтаря в друга част на листа. Не е нужно да местите редове или да премахвате повторения. Не се предполага номер на реда ден+1/ден+2.
Допускат се заглавия като НОЕМВРИ 2026г., Ноември 2026 г. и без „г.“. След версия 17 месечните стойности/обединения се групират до 40 диапазона с ограничение 6000 символа за кодираните диапазони. Общ бюджет от 50 начални Sheets заявки в подвижни 60 секунди пази от прекалено бързо изтегляне на много архивни месеци. Първото зареждане на голям документ може да изчака за този бюджет; останалите потребители споделят същия цикъл и двучасовото копие. Няма автоматичен нов Google опит на всеки клик.
От версия 16 сървърът първо чете само свойствата на листовете, после само първите два реда за месец/година. Съдържание се изтегля само за разпознатите месечни листове, а форматирането — само за използваната област, на части до 4000 клетки на заявка. Така голям немесечен лист или празни форматирани крайни редове не се изтеглят с целия си формат. Това са няколко ограничени заявки в един общ двучасов цикъл, а не нов цикъл за всеки потребител или клик.
Съобщението за отговор над 8 MB означава, че една от ограничените заявки все пак е върнала прекалено много съдържание. Съобщението за бавно четене/изчакване означава временен мрежов или Google проблем; допустимото последно успешно копие се запазва. Мрежовото изчакване е до 30 секунди, а поточното тяло — до 45 секунди. Непълен или променен лист по време на изтеглянето не се публикува като успешно обновяване. Поправката не изисква нов OAuth JSON или повторно свързване.
Едно общо копие на Google документа на сървъра се запазва за 2 часа. Списъкът за днес и всички месечни изгледи използват същото копие. След изтичане на 2 часа първата заявка обновява копието; без потребители няма ненужни периодични Google заявки. Клиентът може да проверява Board веднъж на минута само когато е видим — това не означава Google заявка всяка минута. Стрелките и нов ден не заобикалят двучасовия срок. При грешка повторен Google опит също е след 2 часа. След рестарт на сървъра първият достъп зарежда копието отново.
При временен проблем последното успешно копие може да се използва до 24 часа с ясен статус и непроменено „Обновено“. За нов ден се изчисляват съответните смени от реда за тази дата в запазения лист. При отказан достъп се изчистват данните. Липсващ ден или липсващ/повторен месец дава обяснение. При повторение на днешния ден в колона A се използва първият съвпадащ ред отгоре надолу; невярна стойност на часовете в него не се заобикаля с по-късен ред. Дясната клетка допуска 4 или празна стойност; друга числова стойност изисква поправка.
Ограничения за Raspberry Pi: Google отговор до 8 MB; до 240 листа; месечен лист до 2000 реда/1000 колони; използван правоъгълник до 100 000 клетки, общо до 240 000 за всички месечни листове. Празните крайни редове/колони без съдържание не се показват. Листове без месец/година в първите два реда не се предават за преглед. Секретите, OAuth токените и суровият Google отговор не се изпращат към клиентите. Публикуват се само нужните данни за деня или избрания месец. Четенията не се записват в лог.
OAuth опитът е еднократен, 10 минути, с PKCE и HttpOnly/Secure/Lax nonce cookie, обвързан с нормалната и административната сесия. Отнемане на сесия, изтичане на административния достъп или промяна на настройките отказва свързването. Четенето на графика не удължава административния срок.
Хелп при миграция на YS Board
Графикът има собствен callback. Calendar и Sheets могат да използват един и същ Web client, но двата callback URI са отделни и трябва да бъдат разрешени.
- Новият Board адрес → Администраторски достъп → Работен график → копирайте callback URI.
- Google Cloud Console → правилния проект → Google Auth Platform → Clients → Web application client за графика → Authorized redirect URIs.
- Добавете
https://НОВИЯТ-ДОМЕЙН/api/admin/work-schedule/google/callbackи Save. При общ client добавете и Calendar callback адреса; не заменяйте единия с другия. - Променете public_url в конфигурацията на Board и рестартирайте. Прегледайте Branding/App domain за стари домейни. Пазете settings + secret.key, същия client и ID на Google документа.
- Повторно Google съгласие се дава само ако е нужно, от обикновен браузър на новия адрес. Смяната на Board URL не изисква промяна на таблицата, месечните заглавия или gid.
- Проверете „На работа днес“ и пълния лист чрез имената. „Обновено“ е последното успешно изтегляне от Google; обикновено отваряне и стрелките не сменят този час.
Пълното ръководство за миграция, общите Board стъпки и проверките за тази услуга.