Пријавите се на главни садржај

Сопствено складиште (BYOS)

Црквама се додељује око 100MB бесплатног хостованог простора за датотеке (површине /content/files: датотеке веб-сајта и ресурси група). BYOS омогућава цркви да повеже сопствено облачно складиште, било Google Drive, Dropbox, OneDrive или било који S3-компатибилни бакет (AWS S3, Cloudflare R2, Backblaze B2), тако да се нове отпремљене датотеке чувају на налогу цркве, без ограничења платформе. ChurchApps остаје бесплатан, а ограничење је налог саме цркве.

Слој провајдера складишта​

BYOS поново користи слој складишта направљен за MinistryStuff: IStorageProvider (Packages/apihelper), који за сваку цркву разрешава StorageResolver на основу табеле content.storageProviders. За разлику од јединствених провајдера churchapps и ministrystuff, BYOS провајдери чувају креденцијале за сваку цркву, па StorageResolver.forChurch при сваком захтеву прави инстанцу на основу реда те цркве. Имплементације се налазе поред резолвера у Api/src/modules/content/helpers/: GoogleDriveStorageProvider, DropboxStorageProvider, OneDriveStorageProvider, S3CompatibleStorageProvider и ByosAuth (размена OAuth токена и освежавање у једном кораку; Dropbox ротира refresh токене, па се освежавања дедупликују на исти начин као у ProviderProxyController).

storageProviders чува креденцијале: accessToken/refreshToken/tokenExpiresAt (шифровани, OAuth трио) или apiKey/apiSecret и settings JSON ({endpoint, region, bucket, publicBase}, за S3). Токени никада не стижу до клијента. GET /content/storage/providers маскира тајне и враћа логичку вредност connected.

Ток отпремања​

Исти троетапни уговор као и раније, са проширеним обликом потписаног захтева. POST /content/files/postUrl враћа PresignedPostData, који сада опционо садржи method, rawBody, headers, chunkSize и externalIdField:

ПровајдерПотписивањеКлијент шаље бајтове
churchapps (подразумевано)S3 потписани POSTмултипарт форма (застарело)
Google Driveсесија отпремања која се може наставити (обим drive.file)један PUT на URI сесије
Dropboxfiles/get_temporary_upload_link (4 сата)сирови POST
OneDrivecreateUploadSession (approot)PUT по деловима (20MiB, умножак од 320KiB за Graph)
S3-компатибилнипотписани PUT (B2 nema POST политике)сирови PUT

FileHelper.uploadPresignedFile (@churchapps/helpers) обрађује све облике и враћа ид датотеке код провајдера када одговор садржи један (Drive). Клијент га прослеђује као externalId у регистрацији POST /content/files. files.provider и files.externalId бележе где се бајтови налазе (ид Drive датотеке, а за остале путању). Провера квоте од 100MB примењује се само када је разрешени провајдер churchapps.

Јавна преузимања​

Потрошачки облаци не могу да се користе као директни линкови (Drive линкови се гасе када се потроши квота, а Dropbox и OneDrive линкови истичу), па за OAuth трио contentPath указује на стабилну Api руту: GET /content/files/download/:id (анонимно). Ова рута учитава ред датотеке, преко провајдеровог getDownloadUrl (webContentLink / get_temporary_link / @microsoft.graph.downloadUrl) добија кратковечни директни линк, кешира га у меморији 30 минута и преусмерава са 302 и Cache-Control: max-age=300. Саобраћај тече између прегледача и провајдера, никада кроз Api. S3-компатибилни провајдери потпуно прескачу преусмеравање: contentPath је стабилан URL publicBase + key (бакет мора да дозвољава јавно читање и CORS PUT).

Брисања и преузимања се усмеравају према files.provider (StorageResolver.forFile). Старији редови без тог поља враћају се на усмеравање по префиксу URL-а. Преименовања за BYOS датотеке раде само у бази, јер се бајтовима приступа преко externalId, а не преко имена. Када се провајдер искључи, а и даље има датотеке, ред се меко онемогућава: токени се задржавају да би преузимања и брисања и даље радила. Ред се не брише.

Повезивање (B1Admin → Подешавања → Складиште датотека)​

OAuth трио користи исти релеј-ток као и провајдери садржаја: искачући прозор → сагласност провајдера → {membershipApi}/oauth/relay/callback → B1Admin проверава сесију релеја → POST /content/storage/exchange извршава размену кода за токен на серверу. Тајне клијента никада не напуштају сервер: Google користи GOOGLE_DRIVE_CLIENT_SECRET, OneDrive ONEDRIVE_CLIENT_SECRET, а Dropbox је PKCE јавни клијент. Идентификатори клијента налазе се у B1Admin/src/settings/components/byosProviders.ts и Api .../ByosAuth.ts. Обими су намерно минимални: Google drive.file (само датотеке које је направила апликација, без верификације ограничених обима), OneDrive Files.ReadWrite.AppFolder и Dropbox приступ фасцикли апликације. S3 користи једноставан образац за креденцијале.

Напомена о обиму: BYOS покрива само површине /content/files. Слике из галерије, сличице, логотипи и фотографије особа остају на подразумеваном провајдеру, јер су мале, послужује их CDN и оптимизоване су за слике. Клијент може у тело postUrl захтева такође проследити platformStorage: true да би отпремање било везано за подразумевани провајдер churchapps, без обзира на BYOS подешавање цркве. FreeShow ово користи за стање синхронизације files/group/{teamId}/current.zip. То стање се чита директно са јавног хоста садржаја и никада се не региструје као ред датотеке.