Loyalty Analysis

Оновлено: 2026-04-14

GitHub

https://github.com/serhiivereschak/loyalty-analysis (private)

Overview

Аналіз лояльності клієнтів Delta Medical — обробка даних вікторин і форм. Сегментує аудиторію (GP/Pediatric), будує воронку (надіслано → доставлено → прочитано → заповнено) і гео-аналіз.

Stack

Runtime: Node.js
Libs: csv-parser, iconv-lite (кирилиця/cp1251), xlsx
Статус: ✅ завершено (аналітична задача виконана)

Architecture

analysis.js / analysis_ua.js → основний аналіз
  ├── читає data/*.csv (UTF-8/CP1251)
  ├── segments: GP | Pediatric
  ├── funnel: sent → delivered → read → form_submitted
  └── виводить report.md

geo_analysis.js / geo_analysis_ua.js → геоаналіз
  ├── check_geo.js → перевірка геоданих
  └── виводить geo_report.md

Вхідні файли (не в git — великі):
  відправленні_повідомлення_на_вікторини.xlsx
  заполненная_веб_форма_17_03_2026_13_27.xlsx

Key Files

Файл	Опис
`analysis.js`	Основний аналіз лояльності
`analysis_ua.js`	Укр версія з локалізацією
`geo_analysis.js`	Геоаналіз
`report.md`	Результат аналізу
`geo_report.md`	Геозвіт
`sample.csv`	Приклад даних

Env / Secrets

Немає env змінних — локальний аналіз CSV/XLSX файлів.

Вхідні файли з даними клієнтів — не в git (приватні дані).

Current Status

✅ Аналіз воронки виконаний
✅ Гео-аналіз виконаний
✅ Звіти згенеровані (report.md, geo_report.md)
Проект є завершеною аналітичною задачею

TODO

Архівувати або перенести в папку reports/
Якщо потрібен повторний аналіз — оновити вхідні CSV файли