← Помощ за YS Board

Хелп при миграция на YS Board

Ръководство за версия 15. Пример: стар адрес https://board-old.example.com, нов адрес https://board-new.example.com. Смяната само на домейна и преместването на нов физически сървър са различни операции. Нов домейн не означава нов Google проект, нов Firebase app или нова таблица.

1. Общи стъпки за YS Board

  1. Изпратете чакащите съобщения от локалната опашка. Уточнете новия постоянен HTTPS адрес и настройте DNS/проксито и доверения сертификат. Отворете новия адрес от телефон и компютър преди окончателното прехвърляне.
  2. Направете бекъп на PostgreSQL, файловете в data и конфигурацията. При нова машина пренесете базата и цялата директория за данни със същите права за услугата. Запазете точно secret.key и vapid.pem: първият отключва шифрованите настройки/OAuth токени, а вторият е ключът за web push.
  3. В конфигурационния файл ysboard_config.json на действащата инсталация променете public_url на новия основен адрес, например https://board-new.example.com. Без път /admin, без query, без fragment. При нов сървър коригирайте и database/data_dir/pg_dump и локалните мрежи според инсталацията. Не заменяйте целия файл с примерен файл от чист релийз.
  4. Рестартирайте само услугата YS Board след запис на конфигурацията. public_url се използва при стартиране за произхода на заявките, push връзките и OAuth callback адресите. Проверете, че приложението е отворено през същия адрес, който е записан там.
  5. Влезте в новия адрес и отворете Администраторски достъп. Добавете новите Google callback адреси, описани по-долу. Дръжте старите разрешени адреси до успешната проба, ако старият домейн остава ваш и е защитен. Не оставяйте стар домейн, който вече не контролирате.
  6. Не пускайте две активни инстанции с независими възстановени бази за една и съща миграция. Определете момента, след който новите съобщения и Google операции минават през новия сървър.

Темите, размерите на шрифта, настройката за клавиатурата, черновите и уеб кешът са отделни за акаунт/браузър/устройство/origin. При нов домейн тези браузърни данни не се прехвърлят автоматично. Данните в PostgreSQL и файловете се пренасят с бекъпа. Съществуващите cookies от стария домейн не се изпращат на новия — влезте отново.

2. Google Calendar API

Тук се използва Web application OAuth и точният callback адрес зависи от домейна. Подробната първоначална настройка е в Google Calendar API за Gmail.

  1. Отворете новия YS Board адрес → Администраторски достъп → Календар. Копирайте показания Redirect URI. За примера той е https://board-new.example.com/api/admin/calendar/google/callback.
  2. Влезте в Google Cloud Console с управителя на проекта. Изберете правилния проект → Google Auth Platform → Clients. В някои изгледи същото е APIs & Services → Credentials → OAuth 2.0 Client IDs.
  3. Отворете същия Web application client, чийто JSON е запазен в Board. В Authorized redirect URIs добавете точния нов callback. Съвпадат HTTPS, домейн, порт и път. Не въвеждайте само началната страница, wildcard или допълнителна наклонена черта. Натиснете Save.
  4. В Google Auth Platform → Branding прегледайте App domain/Home page/Privacy policy/Terms, ако сте ги попълнили със стария домейн. Обновете ги към действащи адреси. При изискване за Authorized domains добавете собствеността върху новия домейн според Google; там се въвежда домейн, не callback URL. YS Board използва сървърен OAuth и не се нуждае от JavaScript OAuth origin за този поток.
  5. Ако client ID/secret са същите и пренесените токени се разшифроват, смяната на URL сама по себе си не изисква нов JSON. Не натискайте „Запази ключовете“ със същия JSON без причина — това действие прекратява локалната връзка. Ако е нужно повторно съгласие, натиснете „Свържи с Google“ от обикновен браузър на новия адрес, извън APK.
  6. Проверете избрания календар и че Календар е включен в правилния 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 връзка с право само за четене. Първоначална настройка и правила за графика.

  1. Новият адрес → Администраторски достъп → Работен график. Копирайте показания callback: https://board-new.example.com/api/admin/work-schedule/google/callback.
  2. Google Cloud Console → правилния проект → Google Auth Platform → Clients → Web application client за графика → Authorized redirect URIs → добавете новия точен URI → Save.
  3. Ако Calendar и Sheets използват един Web client, добавете и двата нови callback адреса в него. Ако са различни clients/проекти, обновете всеки отделно. Успешно свързан Calendar не означава автоматично свързан Sheets.
  4. Актуализирайте Branding/App domain страниците, когато съдържат стария домейн, както в календарния раздел. Запазете същия OAuth client, ID на документа и разрешението spreadsheets.readonly. Таблицата не трябва да става публична и не се променят gid или месечните заглавия заради домейна.
  5. При пренесени settings и secret.key връзката може да продължи с наличните токени. При нужда свържете собственика отново от обикновен браузър на новия адрес. Проверете адреса/ID на документа, отметката за показване и натиснете общото „Запази“ само ако променяте настройка.
  6. Разгънете „На работа днес“, натиснете имената и проверете месеца и „Обновено“. Часът е последното успешно прочитане от 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.

  1. При запазени Firebase проект, Android пакет bg.ysboard, app ID и подпис няма FCM callback URL за редактиране в Google Cloud. Не създавайте нов Firebase проект само заради домейна на Board.
  2. При нов сървър пренесете settings и secret.key. В Администраторски достъп → FCM известия проверете, че FCM е включен и четирите публични полета са от същия проект като частния service account: project_id, app_id, api_key, sender_id. JSON ключът не се показва след запис; наличието му се проверява по статуса.
  3. На всеки Android клиент: Настройки → Android: FCM / UnifiedPush / FETCH → Адрес на сървъра → въведете новия основен HTTPS адрес → Отвори. Смяната на адреса прекратява стария локален вход; влезте отново и изберете FCM.
  4. Проверете Google Play services и Android разрешението за известия. Изпратете разрешено тестово съобщение от друг акаунт, когато приложението е на заден план; после натиснете известието и проверете, че отваря правилния чат на новия сървър.
  5. Промяна в 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.

  1. При смяна само на Board домейна и запазен изходящ публичен IP обикновено няма URL за промяна в Places ключа. Тук не се използват Maps JavaScript API и Website/HTTP referrer restrictions.
  2. При нов сървър/интернет връзка установете неговия изходящ публичен IP. Това не е локалният LAN адрес, адресът на телефона или адресът на Cloudflare проксито. Ако IP се е сменил, Google Cloud Console → APIs & Services → Credentials → ключа за YS Board Places Server → Application restrictions → IP addresses → добавете новия изходящ адрес → Save.
  3. Пазете API restrictions → Restrict key → само Places API (New). При статичен изходящ IP може временно да оставите и стария ваш IP до успешната проба; след прехвърлянето премахнете вече неизползвания. При динамичен IP той може да изисква последваща актуализация.
  4. Пренесете шифрованите settings и secret.key. Нов домейн не налага нов Places ключ. При реална смяна на ключа го запазете в Администраторски достъп → Календар → Google Maps / Places. Проверете също настройката Офис YS.
  5. Проба без запис на събитие: отворете форма за събитие → адрес → напишете адрес → изберете предложение. Проверете точния адрес и 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 трябва още да са разрешени. Връщането на стара база след реални нови записи изисква решение как да се запазят тези записи — не презаписвайте новите данни със стар бекъп без проверка.