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

MinistryStuff (плаћено складиштење и слање порука)

MinistryStuff.org је посебна плаћена услуга која финансира две ствари које ChurchApps не може да поклони: масовно складиштење датотека (1TB+) и SMS кредите. Оба се naplaćuju као паушалне месечне претплате. ChurchApps сам по себи остаје 100% бесплатан. Ништа у B1 не захтева MinistryStuff претплату, а свака тачка интеграције је провајдерски оквир који би могла да имплементира и нека трећа страна.

Компоненте​

ДеоРепозиторијумУлога
MinistryStuffApiMinistryStuffApi/ (port 8097 dev)Наплата (Stripe), слање SMS порука и евиденција кредита (AWS End User Messaging), складиштење (S3 + обрачун квоте). Јединствена MySQL база ministrystuff.
MinistryStuffWebMinistryStuffWeb/ (port 3103 dev)ministrystuff.org: маркетинг, цене и портал за налог (планови, коришћење, преусмеравања на Stripe Checkout и Customer Portal).
Провајдер за слање порукаPackages/texting → MinistryStuffProviderРегистрован као ministrystuff уз Clearstream и TextInChurch.
Шав за складиштењеPackages/apihelper → IStorageProvider / StorageProviderFactoryChurchAppsStorageProvider (подразумевани, бесплатан) омотава оригинални S3/disk прекидач. FileStorageHelper прослеђује захтев подразумеваном провајдеру без измена.
Повезивање API-јаМодули Api/ за садржај и порукеMinistryStuffStorageProvider и StorageResolver (садржај), TextingConfigHelper за убацивање сервисног кључа (поруке), табела storageProviders, крајње тачке /content/storage/* и /messaging/texting/credits.

Идентитет и поверење​

  • Исти налози, исте цркве: MinistryStuffApi проверава ChurchApps JWT токене дељеним JWT_SECRET-ом (образац сестринских апликација, као B1Transfer). Портал се пријављује преко MembershipApi и прихвата предају сесије преко ?jwt=.
  • Сервер-на-сервер (основни Api → MinistryStuffApi): заглавље X-Service-Key (MINISTRYSTUFF_SERVICE_KEY, на обе стране) и експлицитан churchId. Право приступа се увек проверава према претплати те цркве. Цркве никада не чувају MinistryStuff акредитиве. Довољно је изабрати провајдера у B1Admin.

Ток слања порука​

B1Admin Send Text → Api TextingController → @churchapps/texting getProvider("ministrystuff") → MinistryStuffApi /sms/send|/sms/sendBulk → број сегмената се одузима од smsCreditGrants текућег периода → AWS End User Messaging (или smsMode: mock у развоју).

Кредити су чврсто ограничење. Када се кредити potroše, цела пошиљка се одбија (insufficient_credits, а у B1Admin се приказује пријатељска порука са позивом на надоградњу). Никада нема делимичних слања нити naplate прекорачења. Додела кредита је идемпотентна по периоду наплате и издаје се из Stripe invoice.paid webhook-ova. Одјаве (smsOptOuts) се филтрирају пре сваког слања.

Остали путеви долазе до истог провајдерског шава без TextingController-а: обавештења о пријави (check-in) (CheckinController → MessagingModuleGateway.sendBulkText) и корак тока рада Send Text (Api/src/modules/doing/helpers/StepActionHelper.ts sendText → MessagingModuleGateway.sendPersonText, који уписује редове у sentTexts и deliveryLogs са празним пошиљаоцем). Поља за спајање ({{firstName}}, {{lastName}}, {{displayName}}, {{churchName}}) за сваког примаоца разрешава MergeFieldHelper.resolve, а резултат је ограничен на 1.600 знакова. У TextingController-у се групна порука која садржи {{ шаље као један sendMessage по примаоцу, уместо једног sendBulk. Порука без поља за попуњавање и даље иде као једно масовно слање.

Ток складиштења​

Ред провајдера цркве (content.storageProviders, којим се управља у B1Admin → Settings → File Storage) одређује где иду нова отпремања. contentPath је апсолутан URL по датотеци, па провајдери могу да коегзистирају без икакве миграције: старе датотеке се и даље послужују са content.churchapps.org, а нове са content.ministrystuff.org.

Отпремања теку овако: Api → StorageResolver.forChurch → провајдер store / getUploadUrl (потписани POST са content-length-range у S3 режиму, base64 резерва у disk/dev режиму). Брисања се усмеравају према сачуваном URL-у (StorageResolver.forUrl).

Квота је једнака бајтовима плана и броји се из storageObjects (stored + pending резервације). Прекорачена квота блокира нова отпремања (storage_quota_exceeded). Ништа се никада не брише нити naplaćuje додатно. Бесплатни ChurchApps ниво није промењен: иста ограничења као раније, без квоте на нивоу целе цркве.

Напомена о обиму: избор провајдера обухвата ток датотека и ресурса садржаја, тј. место на којем се чувају велики медији. Отпремања галерије, логотипа и фотографија остају код подразумеваног провајдера. Она листају кључеве из складишта и градe URL-ове на клијенту, па усмеравање по цркви за сада не важи.

Исти шав омогућава и Сопствено складиште: цркве могу да повежу Google Drive, Dropbox, OneDrive или сопствени S3-компатибилан bucket уместо MinistryStuff плана.

Наплата​

Stripe Checkout (хостован) служи за претплату, а Stripe Customer Portal за ажурирање картице, отказивање и фактуре. MinistryStuffWeb нема обрасце за картице. Постоји по један ред subscriptions за сваку комбинацију (црква, производ). Планови и нивои живе у коду (MinistryStuffApi/src/helpers/Plans.ts), са Stripe ID-јевима цена из конфигурације. Webhook (/billing/webhook, верификација потписа над сировим телом, дедупликација путем webhookEvents) покреће животни циклус претплате: active → past_due (грејс период) → canceled.

Подешавање развојног окружења​

Покрените MinistryStuffApi (yarn dev, 8097; потребан је .env са дељеним JWT_SECRET и MINISTRYSTUFF_SERVICE_KEY) и поставите исти сервисни кључ у Api/.env. Api/config/dev.json већ упућује ministryStuffApi на localhost:8097. MinistryStuffWeb треба .env са VITE_STAGE=dev. Развој користи smsMode: mock и disk складиште, па AWS није потребан.