На этой странице
- Запуск отчёта
- Типы подсчёта
- Группы отчётов
- Группа 1 — Общее количество консультаций
- Группа 2 — Разбивка по полу
- Группа 3 — Географический статус / статус ВПЛ
- Группа 4 — Разбивка по категории уязвимости
- Группа 5 — Текущий регион проживания
- Группа 6 — Разбивка по сфере помощи
- Группа 7 — Разбивка по офису
- Группа 8 — Разбивка по возрастной группе
- Группа 9 — Поиск по тегам
- Группа 10 — Семейные единицы
- Отчёты по животным
Отчёты
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 | Общее количество консультаций — по возрастной группе | События |
Возрастные группы:
| Значение | Возрастной диапазон |
|---|---|
infant | 0–1 |
toddler | 1–3 |
pre_school | 3–6 |
middle_childhood | 6–12 |
young_teen | 12–14 |
teenager | 14–18 |
young_adult | 18–25 |
early_adult | 25–35 |
middle_aged_adult | 35–55 |
old_adult | 55+ |
Когда birth_date задана и age_group равна null, приложение вычисляет группу автоматически.
Группа 9 — Поиск по тегам
| # | Отчёт | Тип |
|---|---|---|
| 35 | Записи помощи для людей с конкретными тегами | События |
| 36 | Люди, зарегистрированные с конкретными тегами | Люди |
Передайте один или несколько ID тегов в качестве параметров. Полезно для специальных донорских запросов.
Группа 10 — Семейные единицы
| # | Отчёт | Тип |
|---|---|---|
| 37 | Люди и члены семей, получившие юридические консультации | Люди + Единицы |
| 38 | Люди и члены семей, получившие социальные консультации | Люди + Единицы |
| 39 | Люди и члены семей, зарегистрированные за период | Люди + Единицы |
Семейная единица — одна запись домохозяйства. Подсчёты возвращаются как в виде общего числа лиц, так и уникальных единиц домохозяйств.
Отчёты по животным
Отчёты, связанные с животными, доступны отдельно по адресу:
GET /projects/:project_id/pet-reports/:report_typeОтчёты по животным охватывают разбивку по видам, статус вакцинации, статус стерилизации и соотношение животных к людям.