Competition Analysis Gizmo

Repozytorium analiz konkurencji dla Wellysa — zautomatyzowane narzędzia do monitoringu i analizy rynku ubezpieczeń zdrowotnych oraz platform diagnostyki medycznej.

Opis projektu

Competition Analysis Gizmo to zestaw narzędzi do zbierania, przetwarzania i prezentacji danych konkurencyjnych w sektorze healthtech. Główny focus: polisy onkologiczne (NN, ERGO), platformy diagnostyki krwi (BloodGPT, MARSI, Smart Blood Analytics) oraz automatyzacja raportowania.

Projekt składa się z trzech głównych komponentów:

• Scrapers — automatyczne pobieranie danych z serwisów konkurencji
• Worker — przetwarzanie, storage i search engine dla zebranych danych
• Analysis Pages — statyczne raporty HTML z wizualizacjami i tabelami porównawczymi

Struktura repozytorium

.
├── onko-scraper/          # TypeScript scraper dla polis onkologicznych
│   ├── src/
│   │   ├── scrapers/      # Implementacje dla NN, ERGO, base class
│   │   ├── types/         # TypeScript definitions
│   │   ├── index.ts       # Entry point
│   │   ├── scrape-sales.ts
│   │   └── export-csv.ts  # Eksport do CSV
│   └── output/            # JSON/CSV output z timestampami
│
├── worker/                # Backend worker (unverified — confirm architecture)
│   └── src/
│       ├── processors/    # Data processing modules
│       ├── scraper/       # Scraping orchestration
│       ├── search/        # Search functionality
│       ├── storage/       # Data persistence layer
│       ├── config/        # Worker configuration
│       └── utils/         # Helper functions
│
├── _1spec/                # Dokumentacja techniczna (PL)
│   ├── POLISY_ONKOLOGICZNE_DOKUMENTACJA.md
│   ├── POLISY_ONKOLOGICZNE_PROMPTS.md
│   ├── POLISY_ONKOLOGICZNE_RAPORT_FINAL.md
│   ├── SCRAPING_DOCUMENTATION.md
│   ├── SPECYFIKACJA_TECHNICZNA.md
│   └── [Interna] Benchmarking cen.xlsx
│
├── _2pages/               # Raporty HTML/MD z analizami
│   ├── blood-gpt-analiza-rynku.html
│   ├── blood-gpt-platforms-comparison-table.html
│   ├── marsi-analysis.html
│   ├── polisy-onkologiczne.html
│   ├── smart-blood-analytics-due-diligence.html
│   └── index.html         # Landing page
│
├── build-docs-no-impl.js  # Builder dla stron dokumentacyjnych
├── QUICK_SETUP.md         # Quick start guide
└── package.json           # Root dependencies (marked)

Tech Stack

• Runtime: Node.js + TypeScript
• Scrapers: Custom TypeScript implementations (Puppeteer/Playwright/Axios — unverified)
• Doc Generation: Marked (Markdown → HTML)
• Output Formats: JSON, CSV, HTML
• Languages: TypeScript (main), HTML (reports), JavaScript (build scripts)

Moduły

1. onko-scraper

Dedykowany scraper dla polis onkologicznych dostępnych na polskim rynku.

Wspierane ubezpieczyciele:

• NN (nn-scraper.ts)
• ERGO Hestia (ergo-scraper.ts)

Features:

• Automatyczne pobieranie aktualnych ofert
• Timestamped JSON output (output/onko-polisy-YYYY-MM-DDTHH-mm-ss.json)
• Export do CSV dla analiz w Excel (output/onko-polisy-export.csv)
• Symlink do najnowszego scrape (output/onko-polisy-latest.json)

Setup (unverified — confirm with team):

cd onko-scraper
npm install
npm run scrape          # Run all scrapers
npm run export:csv      # Export latest to CSV

2. worker

Backend worker do orchestracji scraping jobs, przetwarzania danych i storage (unverified — confirm deployment model).

Komponenty:

• processors/ — transformacje i normalizacja danych
• scraper/ — unified scraping interface
• search/ — search/query engine over collected data
• storage/ — persistence layer (JSON/DB — unverified)
• config/ — worker configuration management

Setup (unverified — confirm with team):

cd worker
npm install
npm run dev             # Development mode
npm run build           # Production build

3. Analysis Pages (_2pages/)

Statyczne raporty HTML z deep-dive analizami konkurencji:

• blood-gpt-analiza-rynku.html — analiza platformy BloodGPT (funkcje, pricing, target)
• blood-gpt-platforms-comparison-table.html — porównanie platform diagnostyki AI
• marsi-analysis.html — MARSI competitive intelligence
• polisy-onkologiczne.html — raport z porównania polis onkologicznych
• smart-blood-analytics-due-diligence.html — due diligence Smart Blood Analytics
• index.html — landing page z linkami do wszystkich analiz

Build:

node build-docs-no-impl.js    # Generate HTML from MD sources

Quick Start (unverified — confirm with team)

1. Clone repo:

   git clone https://github.com/Wellysa/competition-analysis-gizmo.git
   cd competition-analysis-gizmo

2. Install root dependencies:

   npm install

3. Run onko-scraper:

   cd onko-scraper
   npm install
   npm run scrape

4. View analysis pages:

   open _2pages/index.html    # macOS
   # lub
   xdg-open _2pages/index.html    # Linux

Pełna instrukcja: QUICK_SETUP.md (jeśli dostępny w repo).

Output

• JSON: onko-scraper/output/onko-polisy-*.json — timestamped snapshots
• CSV: onko-scraper/output/onko-polisy-export.csv — tabela do Excel
• HTML Reports: _2pages/*.html — raporty konkurencji ready do review

Dokumentacja

Szczegółowa dokumentacja techniczna i business context w katalogu _1spec/:

• SPECYFIKACJA_TECHNICZNA.md — architektura i tech requirements
• SCRAPING_DOCUMENTATION.md — dokumentacja scraperów
• POLISY_ONKOLOGICZNE_DOKUMENTACJA.md — specyfikacja domain logic dla polis
• POLISY_ONKOLOGICZNE_PROMPTS.md — prompty AI użyte w analizie
• POLISY_ONKOLOGICZNE_RAPORT_FINAL.md — final report z findings

Roadmap / Status (unverified — confirm with team)

• [x] Onko-scraper: NN + ERGO
• [ ] Dodatkowi ubezpieczyciele (PZU, Warta, Allianz)
• [ ] Worker: automated scheduling (cron/queue)
• [ ] Real-time price alerts
• [ ] Dashboard UI dla non-technical stakeholders
• [ ] API endpoint dla innych internal tools Wellysa

Contributing

Internal tool dla Wellysa. Przed zmianami sprawdź aktualną specyfikację w _1spec/.

License

Proprietary — Wellysa internal use only.

---

Maintainer: Wellysa Team
Last updated: 2026-05-10
Questions: Sprawdź _1spec/ lub kontakt z team lead