Genogram Wellysa

Aplikacja webowa SaaS do tworzenia i zarządzania genogramami (drzewami genealogicznymi). Frontend zbudowany na Cloudflare Pages, konsumujący dedykowany silnik backend do przetwarzania danych genogramów.

🏗️ Tech Stack (unverified — confirm with team)

• Frontend Framework: React / Next.js / Nuxt.js (potwierdź w package.json)
• Hosting: Cloudflare Pages
• Styling: Tailwind CSS / CSS Modules (potwierdź w dependencies)
• Build Tool: Vite / Webpack / Next.js bundler
• API Client: Fetch API / Axios
• Backend Integration: REST API / GraphQL endpoint (potwierdź w kodzie)

📋 Wymagania wstępne

• Node.js >= 16.x (potwierdź minimalną wersję w package.json)
• npm / yarn / pnpm
• Konto Cloudflare (dla deploymentu produkcyjnego)
• Dostęp do backend API (URL endpointu do weryfikacji z zespołem)

🚀 Setup i uruchomienie

Instalacja zależności

npm install
# lub
yarn install
# lub
pnpm install

Konfiguracja środowiska

Stwórz plik .env.local z wymaganymi zmiennymi (unverified — sprawdź .env.example jeśli istnieje):

# API endpoint do silnika genogramów
NEXT_PUBLIC_API_URL=https://api.wellysa.com/genogram
# Cloudflare account ID (dla deploymentu)
CF_ACCOUNT_ID=your_account_id
# Inne zmienne środowiskowe (potwierdź z zespołem)

Development server

npm run dev
# lub
yarn dev
# lub
pnpm dev

Aplikacja będzie dostępna pod http://localhost:3000 (potwierdź port w konfiguracji)

Build produkcyjny

npm run build
npm run start

🏛️ Architektura (unverified — confirm with team)

genogram.wellysa.com/
├── src/
│   ├── components/          # Komponenty UI (drzewo, węzły, relacje)
│   ├── pages/              # Routing aplikacji
│   ├── api/                # API client / integration layer
│   ├── hooks/              # Custom React hooks
│   ├── utils/              # Funkcje pomocnicze
│   └── styles/             # Style globalne i moduły
├── public/                 # Pliki statyczne
├── .env.example           # Template zmiennych środowiskowych
└── package.json           # Dependencies i scripts

Główne funkcjonalności (potwierdź dostępność w kodzie)

• ✅ Tworzenie i edycja genogramów
• ✅ Wizualizacja relacji rodzinnych
• ✅ Eksport drzew do różnych formatów (PDF, PNG, JSON)
• ✅ Współdzielenie genogramów (public links)
• ✅ Integracja z silnikiem backend Wellysa
• ⚠️ Autentykacja użytkowników (potwierdź implementację)
• ⚠️ Zarządzanie wieloma projektami (potwierdź implementację)

🌐 Deployment

Cloudflare Pages

Aplikacja deployowana automatycznie na Cloudflare Pages przy każdym pushu do brancha main (potwierdź konfigurację CI/CD):

1. Production: https://genogram.wellysa.com
2. Preview deployments: automatyczne dla PR-ów (jeśli skonfigurowane)

Konfiguracja Cloudflare (unverified)

Build settings w Cloudflare Dashboard:

• Build command: npm run build (potwierdź w wrangler.toml lub CF dashboard)
• Build output directory: dist lub out (zależy od frameworka)
• Node version: 18.x (potwierdź)

🔗 Integracja z Backend API (unverified — confirm endpoints)

Aplikacja komunikuje się z dedykowanym silnikiem genogramów. Przykładowe endpointy:

GET    /api/genograms           # Lista genogramów użytkownika
POST   /api/genograms           # Tworzenie nowego genogramu
GET    /api/genograms/:id       # Szczegóły genogramu
PUT    /api/genograms/:id       # Aktualizacja genogramu
DELETE /api/genograms/:id       # Usunięcie genogramu
POST   /api/genograms/:id/export # Eksport do pliku

Dokumentacja API: potwierdź z zespołem backend lub sprawdź w Swagger/OpenAPI schema

🧪 Testing (unverified)

# Unit tests
npm run test

# E2E tests (jeśli skonfigurowane)
npm run test:e2e

# Linting
npm run lint

📦 Dependencies (potwierdź w package.json)

Sprawdź plik package.json dla pełnej listy zależności. Kluczowe biblioteki mogą obejmować:

• React/Vue/Svelte dla UI
• D3.js / Cytoscape.js dla wizualizacji grafów (potencjalnie używane do renderowania drzew)
• React Query / SWR dla zarządzania stanem API

🛠️ Development Workflow

1. Stwórz feature branch: git checkout -b feature/nowa-funkcjonalnosc
2. Wprowadź zmiany i commituj: git commit -m "feat: opis zmian"
3. Push branch: git push origin feature/nowa-funkcjonalnosc
4. Otwórz Pull Request do main
5. Po review i CI/CD checks → merge do main
6. Automatyczny deployment na produkcję

📞 Kontakt i Support

• Zespół: Wellysa
• Repo: https://github.com/Wellysa/genogram.wellysa.com
• Issues: Zgłaszaj błędy i feature requesty przez GitHub Issues

⚠️ Uwaga

Znaczna część tego README wymaga weryfikacji z rzeczywistym kodem projektu. Sekcje oznaczone jako (unverified) lub (confirm with team) powinny zostać zaktualizowane po przeanalizowaniu:

• package.json — dla dokładnego tech stacku i skryptów
• Struktury katalogów — dla architektury projektu
• Plików konfiguracyjnych (.env.example, wrangler.toml, next.config.js) — dla setup instructions
• Kodu źródłowego — dla listy features i API endpoints