Хелп при миграция на YS Board
Ръководство за версия 15. Пример: стар адрес https://board-old.example.com, нов адрес https://board-new.example.com. Смяната само на домейна и преместването на нов физически сървър са различни операции. Нов домейн не означава нов Google проект, нов Firebase app или нова таблица.
1. Общи стъпки за YS Board
- Изпратете чакащите съобщения от локалната опашка. Уточнете новия постоянен HTTPS адрес и настройте DNS/проксито и доверения сертификат. Отворете новия адрес от телефон и компютър преди окончателното прехвърляне.
- Направете бекъп на PostgreSQL, файловете в data и конфигурацията. При нова машина пренесете базата и цялата директория за данни със същите права за услугата. Запазете точно
secret.keyиvapid.pem: първият отключва шифрованите настройки/OAuth токени, а вторият е ключът за web push. - В конфигурационния файл
ysboard_config.jsonна действащата инсталация променетеpublic_urlна новия основен адрес, напримерhttps://board-new.example.com. Без път /admin, без query, без fragment. При нов сървър коригирайте и database/data_dir/pg_dump и локалните мрежи според инсталацията. Не заменяйте целия файл с примерен файл от чист релийз. - Рестартирайте само услугата YS Board след запис на конфигурацията.
public_urlсе използва при стартиране за произхода на заявките, push връзките и OAuth callback адресите. Проверете, че приложението е отворено през същия адрес, който е записан там. - Влезте в новия адрес и отворете Администраторски достъп. Добавете новите Google callback адреси, описани по-долу. Дръжте старите разрешени адреси до успешната проба, ако старият домейн остава ваш и е защитен. Не оставяйте стар домейн, който вече не контролирате.
- Не пускайте две активни инстанции с независими възстановени бази за една и съща миграция. Определете момента, след който новите съобщения и Google операции минават през новия сървър.
Темите, размерите на шрифта, настройката за клавиатурата, черновите и уеб кешът са отделни за акаунт/браузър/устройство/origin. При нов домейн тези браузърни данни не се прехвърлят автоматично. Данните в PostgreSQL и файловете се пренасят с бекъпа. Съществуващите cookies от стария домейн не се изпращат на новия — влезте отново.
2. Google Calendar API
Тук се използва Web application OAuth и точният callback адрес зависи от домейна. Подробната първоначална настройка е в Google Calendar API за Gmail.
- Отворете новия YS Board адрес → Администраторски достъп → Календар. Копирайте показания Redirect URI. За примера той е
https://board-new.example.com/api/admin/calendar/google/callback. - Влезте в Google Cloud Console с управителя на проекта. Изберете правилния проект → Google Auth Platform → Clients. В някои изгледи същото е APIs & Services → Credentials → OAuth 2.0 Client IDs.
- Отворете същия Web application client, чийто JSON е запазен в Board. В Authorized redirect URIs добавете точния нов callback. Съвпадат HTTPS, домейн, порт и път. Не въвеждайте само началната страница, wildcard или допълнителна наклонена черта. Натиснете Save.
- В Google Auth Platform → Branding прегледайте App domain/Home page/Privacy policy/Terms, ако сте ги попълнили със стария домейн. Обновете ги към действащи адреси. При изискване за Authorized domains добавете собствеността върху новия домейн според Google; там се въвежда домейн, не callback URL. YS Board използва сървърен OAuth и не се нуждае от JavaScript OAuth origin за този поток.
- Ако client ID/secret са същите и пренесените токени се разшифроват, смяната на URL сама по себе си не изисква нов JSON. Не натискайте „Запази ключовете“ със същия JSON без причина — това действие прекратява локалната връзка. Ако е нужно повторно съгласие, натиснете „Свържи с Google“ от обикновен браузър на новия адрес, извън APK.
- Проверете избрания календар и че Календар е включен в правилния Google API режим. Отворете Днес/Утре и месечния календар. За write проба използвайте изрично тестово събитие и проверете правилата за покани преди запис.
redirect_uri_mismatch означава разминаване между показания callback и разрешените URI в избрания Web client. oauth=expired може да е изтекъл 10-минутен опит, admin idle, logout или промяна на конфигурацията; започнете нов опит от новия адрес. Не променяйте fixed Google token/auth endpoints и не изключвайте TLS проверката.
3. Google Sheets API
Графикът има отделна OAuth връзка с право само за четене. Първоначална настройка и правила за графика.
- Новият адрес → Администраторски достъп → Работен график. Копирайте показания callback:
https://board-new.example.com/api/admin/work-schedule/google/callback. - Google Cloud Console → правилния проект → Google Auth Platform → Clients → Web application client за графика → Authorized redirect URIs → добавете новия точен URI → Save.
- Ако Calendar и Sheets използват един Web client, добавете и двата нови callback адреса в него. Ако са различни clients/проекти, обновете всеки отделно. Успешно свързан Calendar не означава автоматично свързан Sheets.
- Актуализирайте Branding/App domain страниците, когато съдържат стария домейн, както в календарния раздел. Запазете същия OAuth client, ID на документа и разрешението
spreadsheets.readonly. Таблицата не трябва да става публична и не се променят gid или месечните заглавия заради домейна. - При пренесени settings и secret.key връзката може да продължи с наличните токени. При нужда свържете собственика отново от обикновен браузър на новия адрес. Проверете адреса/ID на документа, отметката за показване и натиснете общото „Запази“ само ако променяте настройка.
- Разгънете „На работа днес“, натиснете имената и проверете месеца и „Обновено“. Часът е последното успешно прочитане от Google, а не отварянето в браузъра. Общото копие се обновява през 2 часа; след рестарт първият достъп изтегля първото копие.
Нов домейн на Board не е нов адрес на Google документа. Ако получавате 403, проверете дали Google Sheets API е включен, дали свързаният акаунт има достъп до документа и дали е разрешен read-only scope. Сменяйте JSON само ако действително сте сменили Web client/secret.
4. Google FCM за Android
FCM използва Android Firebase app + service account, а не OAuth callback към Board. Подробното ръководство е FCM за Android.
- При запазени Firebase проект, Android пакет
bg.ysboard, app ID и подпис няма FCM callback URL за редактиране в Google Cloud. Не създавайте нов Firebase проект само заради домейна на Board. - При нов сървър пренесете settings и secret.key. В Администраторски достъп → FCM известия проверете, че FCM е включен и четирите публични полета са от същия проект като частния service account: project_id, app_id, api_key, sender_id. JSON ключът не се показва след запис; наличието му се проверява по статуса.
- На всеки Android клиент: Настройки → Android: FCM / UnifiedPush / FETCH → Адрес на сървъра → въведете новия основен HTTPS адрес → Отвори. Смяната на адреса прекратява стария локален вход; влезте отново и изберете FCM.
- Проверете Google Play services и Android разрешението за известия. Изпратете разрешено тестово съобщение от друг акаунт, когато приложението е на заден план; после натиснете известието и проверете, че отваря правилния чат на новия сървър.
- Промяна в Google Cloud е нужна, ако се сменя Firebase проект/app/service account или съответните ограничения на API ключа. За Android ограниченията са по package/certificate, а не по Board домейн. Не добавяйте OAuth redirect URI за FCM и не заменяйте сървърния service account с Web application JSON.
Само за тази FCM настройка не се използва Firebase Authentication; неговият списък Authorized domains не е списък с позволени FCM сървъри. web push за браузър/PWA е отделен и е разгледан по-долу. Официална Android FCM настройка · FCM HTTP v1.
5. Google Places API (New)
Точните адреси се търсят от YS Board сървъра. Подробна настройка на Places.
- При смяна само на Board домейна и запазен изходящ публичен IP обикновено няма URL за промяна в Places ключа. Тук не се използват Maps JavaScript API и Website/HTTP referrer restrictions.
- При нов сървър/интернет връзка установете неговия изходящ публичен IP. Това не е локалният LAN адрес, адресът на телефона или адресът на Cloudflare проксито. Ако IP се е сменил, Google Cloud Console → APIs & Services → Credentials → ключа за YS Board Places Server → Application restrictions → IP addresses → добавете новия изходящ адрес → Save.
- Пазете API restrictions → Restrict key → само Places API (New). При статичен изходящ IP може временно да оставите и стария ваш IP до успешната проба; след прехвърлянето премахнете вече неизползвания. При динамичен IP той може да изисква последваща актуализация.
- Пренесете шифрованите settings и secret.key. Нов домейн не налага нов Places ключ. При реална смяна на ключа го запазете в Администраторски достъп → Календар → Google Maps / Places. Проверете също настройката Офис YS.
- Проба без запис на събитие: отворете форма за събитие → адрес → напишете адрес → изберете предложение. Проверете точния адрес и Maps линка; после Откажи. При REQUEST_DENIED/403 проверете правилния проект, API, billing, изходящ IP и restrictions.
Официални правила за ограниченията на Maps/Places ключовете. Не въвеждайте клиентски IP адреси в настройките на сървърния ключ и не изключвайте TLS проверката.
6. Браузър, PWA, APK и web push
Отворете новия HTTPS адрес и влезте отново. За PWA добавете новия адрес на началния екран; старата инсталация може да остане вързана към стария origin. web push registration, service worker и разрешението за известия са по origin: включете известията за новия адрес от самото устройство. Не използвайте автоматично web push reset за всички акаунти като заместител на тази стъпка. В APK сменете адреса чрез неговото меню, а не чрез външно отваряне на новия домейн в стария WebView.
7. Финална проба и връщане
Проверете вход, чат/прикачване, админ достъп, Calendar, работен график с точния „Обновено“, адресни предложения и избрания push транспорт. Поддържайте стария адрес/бекъп, докато приемете резултата. Ако връщате URL, върнете съответния public_url и рестартирайте услугата; старите Google callback URI трябва още да са разрешени. Връщането на стара база след реални нови записи изисква решение как да се запазят тези записи — не презаписвайте новите данни със стар бекъп без проверка.