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

Крајње тачке присуства

Модул за присуство управља локацијама кампуса, службама, терминима служби, сесијама присуства, посетама и сесијама посета. Пружа инфраструктуру за праћење ко је присуствовао којој служби или састанку групе, подржава токове пријаве и нуди извештавање о трендовима и сумама присуства.

Основна путања: /attendance

Кампуси​

Основна путања: /attendance/campuses

Стандардни CRUD контролер (проширује GenericCrudController). Пружа руте getById, getAll, post и delete преко основне CRUD класе.

МетодПутањаАутентификацијаДозволаОпис
GET/JWT—Преглед свих кампуса за цркву
GET/:idJWT—Преглед кампуса по ID-у
POST/JWTServices.EditКреирање или ажурирање кампуса
DELETE/:idJWTServices.EditБрисање кампуса

Службе​

Основна путања: /attendance/services

Проширује GenericCrudController са CRUD рутама getById, getAll, post и delete. Крајње тачке getAll (GET /) и search замењене су прилагођеним имплементацијама.

МетодПутањаАутентификацијаДозволаОпис
GET/JWT—Преглед свих служби (укључује податке о кампусу)
GET/:idJWT—Преглед службе по ID-у
GET/search?campusId=JWT—Претрага служби по ID-у кампуса
POST/JWTServices.EditКреирање или ажурирање служби
DELETE/:idJWTServices.EditБрисање службе

Пример: претрага служби по кампусу​

GET /attendance/services/search?campusId=abc-123
Authorization: Bearer <token>
[
{
"id": "svc-001",
"churchId": "church-123",
"campusId": "abc-123",
"name": "Sunday Morning"
}
]

Termini službi​

Основна путања: /attendance/servicetimes

Проширује GenericCrudController са CRUD рутама getById, post и delete. Крајње тачке getAll и search су прилагођене имплементације.

МетодПутањаАутентификацијаДозволаОпис
GET/JWT—Преглед свих termina служби. Филтрирање путем ?serviceId=. Додајте ?include=groups за додавање података о групама. Сваки ред укључује израчунату логичку вредност checkinOpen (false само када termin службе има распоред пријаве чији је прозор тренутно затворен). Прозор се мери у временској зони кампуса службе, затим у временској зони цркве, затим у временској зони првог кампуса који је има, па онда America/New_York
GET/:idJWT—Преглед termina службе по ID-у
GET/search?campusId=&serviceId=JWT—Претрага termina служби по кампусу и служби
GET/public/:churchIdЈавно—Преглед стабла кампус → служба → termin за цркву. Покреће елемент serviceTimes у алату за градњу веб-сајта
POST/JWTServices.EditКреирање или ажурирање termina служби. Опционална поља распореда: dayOfWeek (0 = недеља … 6), startTime / endTime (HH:mm), checkinOpenMinutes (пре почетка), checkinCloseMinutes (после краја). Пријава је временски ограничена само када су постављени и dayOfWeek и startTime
DELETE/:idJWTServices.EditБрисање termina службе

Времена служби група​

Основна путања: /attendance/groupservicetimes

Повезује групе са одређеним терминима служби.

МетодПутањаАутентификацијаДозволаОпис
GET/JWT—Преглед свих веза група и termina служби. Филтрирање путем ?groupId= даје везе са називима служби
GET/:idJWT—Преглед везе групе и termina службе по ID-у
POST/JWTServices.EditКреирање или ажурирање веза група и termina служби
DELETE/:idJWTServices.EditБрисање везе групе и termina службе

Записи о присуству​

Основна путања: /attendance/attendancerecords

Пружа приказе збирних података о присуству само за читање, за извештавање и приказ.

МетодПутањаАутентификацијаДозволаОпис
GET/JWTAttendance.ViewУчитавање записа о присуству за особу. Потребан је ?personId=
GET/myJWT—Ограничено на корисника: сопствени записи о присуству пријављеног члана из последњих 12 месеци, од најновијих. Враћа 401 ако корисник није повезан са особом. Покреће одељак Моје присуство на страници B1 Me
GET/treeJWT—Учитавање комплетног стабла присуства (кампуси, службе, termini служби, групе)
GET/trend?campusId=&serviceId=&serviceTimeId=&groupId=JWTAttendance.View SummaryУчитавање података о трендовима присуства уз опционалне филтере
GET/groups?serviceId=&week=JWTAttendance.ViewУчитавање присуства група за службу у датој недељи
GET/sessionStatus?serviceTimeId=&date=JWTAttendance.ViewЗа сваку групу додељену terminu службе враћа { groupId, sessionId, attendanceCount } за тај датум (date је YYYY-MM-DD; sessionId је null када група nema сесију). Покреће дијалог Ко још треба да се евидентира у B1Admin-у
GET/search?campusId=&serviceId=&serviceTimeId=&groupId=&startDate=&endDate=JWTAttendance.ViewПретрага записа о присуству уз филтере (кампус, служба, termin службе, група, опсег датума)

Пример: тренд присуства​

GET /attendance/attendancerecords/trend?serviceId=svc-001
Authorization: Bearer <token>
[
{ "week": "2025-01-05", "count": 142 },
{ "week": "2025-01-12", "count": 156 },
{ "week": "2025-01-19", "count": 138 }
]

Сесије​

Основна путања: /attendance/sessions

Проширује GenericCrudController са CRUD рутама getById и delete. Крајње тачке getAll и save су прилагођене имплементације које такође омогућавају вођама група да управљају сесијама својих група.

МетодПутањаАутентификацијаДозволаОпис
GET/JWTAttendance.View или Вођа групеПреглед свих сесија. Филтрирање путем ?groupId= (укључује називе). Вође група могу прегледати сесије својих група
GET/:idJWTAttendance.ViewПреглед сесије по ID-у
POST/JWTAttendance.Edit или Вођа групеКреирање или ажурирање сесија. Вође група могу чувати сесије за своје групе
DELETE/:idJWTAttendance.EditБрисање сесије

Посете​

Основна путања: /attendance/visits

Управља појединачним записима о посетама (особа присутна на одређени датум) и пружа ток пријаве.

МетодПутањаАутентификацијаДозволаОпис
GET/JWTAttendance.ViewПреглед свих посета. Филтрирање путем ?personId=
GET/:idJWTAttendance.ViewПреглед посете по ID-у
GET/checkin?serviceId=&peopleIds=JWTAttendance.View или Attendance.CheckinУчитавање података за пријаву особа на служби. Враћа посете са сесијама посета из последњег забележеног датума
POST/JWTAttendance.EditКреирање или ажурирање посета
POST/checkin?serviceId=&peopleIds=JWTAttendance.Edit или Attendance.CheckinСлање података за пријаву. Креира или ажурира посете и сесије посета, уклања застареле записе
DELETE/:idJWTAttendance.EditБрисање посете

Пример: ток пријаве​

Корак 1 -- Учитајте постојеће податке за пријаву:

GET /attendance/visits/checkin?serviceId=svc-001&peopleIds=person-1,person-2
Authorization: Bearer <token>
[
{
"id": "visit-001",
"personId": "person-1",
"visitDate": "2025-01-19T00:00:00.000Z",
"visitSessions": [
{
"id": "vs-001",
"sessionId": "sess-001",
"visitId": "visit-001",
"session": {
"id": "sess-001",
"groupId": "group-001",
"serviceTimeId": "st-001",
"sessionDate": "2025-01-19T00:00:00.000Z"
}
}
]
}
]

Корак 2 -- Пошаљите пријаву:

POST /attendance/visits/checkin?serviceId=svc-001&peopleIds=person-1,person-2
Authorization: Bearer <token>

[
{
"personId": "person-1",
"visitSessions": [
{
"session": { "serviceTimeId": "st-001", "groupId": "group-001" }
}
]
}
]

Ако циљни termin службе има распоред пријаве и његов прозор је затворен (мерено истим редоследом временских зона са првенством кампуса као и checkinOpen), ништа се не чува и одговор је 409 { "error": "notOpen", "groups": [{ "groupId", "groupName", "reason": "notOpen" }] }. Прекорачења капацитета и односа волонтера такође враћају 409 (error: "capacity" или "ratio"). Сесије које особа већ има данас (поново послате са сваком пријавом) прескачу проверу прозора, тако да домаћинство може додати отворен termin службе након што је прозор ранијег термина већ затворен.

Сесије посета​

Основна путања: /attendance/visitsessions

Управља везом између посета и сесија (која конкретна сесија је особа похађала током посете). Такође пружа брзу крајњу тачку за евиденцију и крајњу тачку за преузимање/извоз.

МетодПутањаАутентификацијаДозволаОпис
GET/JWTAttendance.View или Вођа групеПреглед сесија посета. Филтрирање путем ?sessionId=. Вође група могу прегледати сесије посета својих група
GET/:idJWTAttendance.ViewПреглед сесије посете по ID-у
GET/download/:sessionIdJWTAttendance.ViewПреузимање присуства за сесију (враћа имена особа са статусом присутан/одсутан)
POST/JWTAttendance.EditКреирање или ажурирање сесија посета
POST/logJWTAttendance.Edit или Вођа групеБрза евиденција присуства особе на сесији. Аутоматски креира посету ако је потребно. Вође група могу евидентирати присуство за своје групе
DELETE/:idJWTAttendance.EditБрисање сесије посете по ID-у
DELETE/?personId=&sessionId=JWTAttendance.Edit или Вођа групеУклањање особе из сесије. Брише сесију посете и матичну посету ако не остане nijedna сесија. Вође група могу уклонити присуство за своје групе

Пример: брза евиденција присуства​

POST /attendance/visitsessions/log
Authorization: Bearer <token>

{
"personId": "person-001",
"visitSessions": [
{ "sessionId": "sess-001" }
]
}
{}

Пример: преузимање присуства за сесију​

GET /attendance/visitsessions/download/sess-001
Authorization: Bearer <token>
[
{
"id": "vs-001",
"personId": "person-001",
"visitId": "visit-001",
"sessionDate": "2025-01-19T00:00:00.000Z",
"personName": "John Smith",
"status": "present"
},
{
"id": "",
"personId": "person-002",
"visitId": "",
"sessionDate": "2025-01-19T00:00:00.000Z",
"personName": "Jane Doe",
"status": "absent"
}
]

Низови​

Основна путања: /attendance/streaks

Прати низове присуства појединаца — узастопне недеље у којима је особа присуствовала. Корисно за метрике ангажовања и гејмификацију.

МетодПутањаАутентификацијаДозволаОпис
GET/person/:personIdJWT—Учитавање низова присуства за особу

Повезане странице​