Observer генерирует 39 структурированных типов отчётов, разработанных в соответствии с реальными донорскими обязательствами украинских НКО по отчётности. Все отчёты привязаны к одному проекту и фильтруются по диапазону дат.

Запуск отчёта

Все отчёты доступны по адресу:

GET /projects/:project_id/reports/:report_type?start=2024-01-01&end=2024-12-31

Замените :report_type одним из идентификаторов из таблиц ниже.

Типы подсчёта

Каждый отчёт использует один из трёх методов подсчёта:

ТипЗначение
СобытияСтроки в support_records — один человек с тремя консультациями считается как 3
ЛюдиУникальные люди — один и тот же человек считается один раз, независимо от количества записей
ЕдиницыУникальные семейные единицы (одно домохозяйство = одна единица)

Фильтрация по дате использует support_records.provided_at для консультаций и people.registered_at для отчётов о регистрации — не created_at.

Группы отчётов

Группа 1 — Общее количество консультаций

#ОтчётТип
1Всего консультаций всех типовСобытия
2Всего юридических консультацийСобытия
3Всего социальных консультацийСобытия

Группа 2 — Разбивка по полу

#ОтчётТип
12Мужчины, зарегистрированные за периодЛюди
13Женщины, зарегистрированные за периодЛюди
14Женщины, получившие юридические консультацииЛюди
15Женщины, получившие социальные консультацииЛюди
16Мужчины, получившие юридические консультацииЛюди
17Мужчины, получившие социальные консультацииЛюди

Отчёты 14–17 считают уникальных людей, а не события консультаций.

Группа 3 — Географический статус / статус ВПЛ

#ОтчётТип
4Всего зарегистрированных людейЛюди
5–6Люди из зоны конфликта, зарегистрированныеЛюди
7–10Люди из зоны конфликта, получившие юридические/социальные консультацииЛюди
11Не-ВПЛ, зарегистрированныеЛюди

Статус ВПЛ определяется автоматически: origin_place_id → places → states.conflict_zone. Отчёты 5–6 и 7–10 параметризованы меткой зоны конфликта.

Группа 4 — Разбивка по категории уязвимости

#ОтчётТип
18Зарегистрированные люди — по категории уязвимостиЛюди
19Люди, получившие социальные консультации — по категорииЛюди
20Люди, получившие юридические консультации — по категорииЛюди

Люди без назначенной категории попадают в группу «без категории».

Группа 5 — Текущий регион проживания

#ОтчётТип
21Зарегистрированные люди — по текущему регионуЛюди
22Люди, получившие юридические консультации — по регионуЛюди
23Люди, получившие социальные консультации — по регионуЛюди

Группа 6 — Разбивка по сфере помощи

#ОтчётТип
24Количество юридических консультаций — по сфереСобытия
25Люди, получившие юридические консультации — по сфереЛюди
29Количество социальных консультаций — по сфереСобытия
30Люди, получившие социальные консультации — по сфереЛюди

Сферы помощи:

ЗначениеОписание
housing_assistanceЖилищные права, выселение, социальное жильё
document_recoveryПаспорта, свидетельства о рождении, документы на имущество
social_benefitsРегистрация ВПЛ, социальные выплаты
property_rightsИмущество, оставшееся на оккупированных территориях
employment_rightsТрудовое право, увольнение, трудоустройство
family_lawРазвод, опека, алименты
healthcare_accessМедицинское покрытие, документы об инвалидности
education_accessЗачисление в школу, образовательные права
financial_aidЭкстренная финансовая помощь
psychological_supportНаправления к специалистам по психическому здоровью, консультирование
otherНе указанные или межотраслевые темы

Группа 7 — Разбивка по офису

#ОтчётТип
28Количество юридических консультаций — по офисуСобытия
32Количество социальных консультаций — по офисуСобытия
33Общее количество консультаций — по офисуСобытия

Группа 8 — Разбивка по возрастной группе

#ОтчётТип
26Количество юридических консультаций — по возрастной группеСобытия
27Люди, получившие юридические консультации — по возрастной группеЛюди
31aКоличество социальных консультаций — по возрастной группеСобытия
31bЛюди, получившие социальные консультации — по возрастной группеЛюди
34Общее количество консультаций — по возрастной группеСобытия

Возрастные группы:

ЗначениеВозрастной диапазон
infant0–1
toddler1–3
pre_school3–6
middle_childhood6–12
young_teen12–14
teenager14–18
young_adult18–25
early_adult25–35
middle_aged_adult35–55
old_adult55+

Когда birth_date задана и age_group равна null, приложение вычисляет группу автоматически.

Группа 9 — Поиск по тегам

#ОтчётТип
35Записи помощи для людей с конкретными тегамиСобытия
36Люди, зарегистрированные с конкретными тегамиЛюди

Передайте один или несколько ID тегов в качестве параметров. Полезно для специальных донорских запросов.

Группа 10 — Семейные единицы

#ОтчётТип
37Люди и члены семей, получившие юридические консультацииЛюди + Единицы
38Люди и члены семей, получившие социальные консультацииЛюди + Единицы
39Люди и члены семей, зарегистрированные за периодЛюди + Единицы

Семейная единица — одна запись домохозяйства. Подсчёты возвращаются как в виде общего числа лиц, так и уникальных единиц домохозяйств.

Отчёты по животным

Отчёты, связанные с животными, доступны отдельно по адресу:

GET /projects/:project_id/pet-reports/:report_type

Отчёты по животным охватывают разбивку по видам, статус вакцинации, статус стерилизации и соотношение животных к людям.