Content Commons — Заједничка библиотека ресурса и модерација
Кориснички садржај који се дели између производа (песме WorshipCommons, лекције Lessons.church, FreeShow шаблони, шаблони B1 веб-сајта) пролази кроз један ред за модерацију, а не кроз засебан ток прегледа за сваки производ. Ова страница описује животни циклус слања и одобравања, модел података заједничких ресурса и место где се налази модерација.
Основа ресурса
Две табеле носе сваку ставку заједничке библиотеке, без обзира на производ:
assets— јавни идентитетски ред.status:pending|published|unpublished|removed. Подаци specifični за тип (детаљи о песмама, аутори) налазе се у сателитским табелама повезаним прекоassetId.assetFiles— сваки фајл приложен ресурсу (аудио, слике, документи), који замењује старије колонеpathиfilesса zarezom između појединачних табела садржаја.submissions— јединица модерације. Животни циклус:draft → pending → approved | rejected | withdrawn(нацрт → на чекању → одобрено | одбијено | повучено). Поднесак може бити потпуно нови ресурс или измена постојећег објављеног ресурса (од стране оригиналног аутора или треће стране).
Одобравање поднеска покреће хук за објављивање специфичан за производ (Api/src/modules/commons/helpers/publishHooks/, нпр. song.ts), који поднесак претвара у сопствене записе тог производа.
Ток слања
CommonsSubmissionController (Api/src/modules/commons/) је API намењен крајњим корисницима: креира нацрт, отпрема и прилаже фајлове, подноси на преглед или повлачи поднесак. Његови стварни клијенти су спољни сајтови произвођача (сајт WorshipCommons, Lessons.church, FreeShow, галерија шаблона B1 веб-сајта), а не B1Admin.
Коришћење за цркве
Осим модерације, B1Admin такође директно чита из заједничке основе. Претрага „Add Song" у одељку Serving → Songs упућује GET /songs?sundayReady=true поред постојеће спољне базе песама и приказује објављене песме WorshipCommons које је особље označilo као спремне за недељу (видите listen gate испод), уз значку лиценце. Избор песме повезује нови SongDetail са изворном песмом преко songDetailLinks. Ово је једини пут на којем B1Admin једне цркве директно додирује податке заједнице, а не преко алата Server Admin намењених искључиво особљу. За опис намењен црквама погледајте одељак Бесплатне песме из WorshipCommons у документацији за подршку.
Ред за модерацију
Ред се налази у B1Admin → Server Admin → Commons (B1Admin/src/serverAdmin/components/CommonsTab.tsx), а приступ му је ограничен дозволом Permissions.server.admin, истом оном која ограничава Churches, Impersonate и Jobs на тој страници. Ово је интерни алат само за особље ChurchApps; цркве га не виде.
Три подкартице:
- Queue: сваки поднесак на чекању из свих производа, који се може филтрирати по производу или типу ресурса. Сваки ред приказује значку (нови ресурс, измена од аутора или измена од треће стране), историју одобравања подносиоца, сажетак разлика у пољима и фајловима и старост (истакнуто ако је старије од 72 сата). Review отвара панел са разликама по пољима, прегледима фајлова и уграђеним прегледом производа само за читање. Approve/Reject подржавају пречице на тастатури (j/k за кретање, a/r за радњу).
- Reports: извештаји о ауторским правима и политици/квалитету за објављене ресурсе, подељени у два реда и историју решених извештаја. Члан особља преузима извештај, а затим га решава одређивањем резолуције (потврђено, одбачено или дупликат) и радње (ништа, повлачење из објаве или уклањање).
- Assets: претраживи приказ објављеног садржаја са радњама за сваки ресурс: истицање, повлачење из објаве или поновно објављивање, или уклањање (разлог: ауторска права или политика). За песме, listen gate овде је оно што песму чини спремном за недељу (Sunday-ready): особље је означава када је прослушало сваки објављени тон и потврдило да су партитура, акорди и слајдови сви присутни.
Свaka крајња тачка под /commons/admin/* (CommonsAdminController.ts) независно поново проверава дозволу сервер-администратора.
Овај дизајн намерно има један ред: сопствени интерфејс за модерацију WorshipCommons на путањи /admin је укинут у корист усмеравања поднесака свих производа кроз алате Server Admin у B1Admin-у.
Обухват
Api (модул commons), B1Admin (Server Admin) и спољни сајтови произвођача: WorshipCommons, Lessons.church, FreeShow и шаблони за изградњу B1 веб-сајта.