Kreator Instalacji w Przeglądarce (Web Wizard)

Kreator webowy umożliwia instalację systemu Ammonly poprzez nowoczesny interfejs graficzny krok po kroku.

---

Jak Uruchomić Kreator

Gdy system nie jest jeszcze zainstalowany (brak pliku storage/installed.lock), wejście na adres główny domeny automatycznie przekierowuje użytkownika do instalatora:

https://twoja-domena.pl/ -> https://twoja-domena.pl/install

NOTE

Kreator jest zabezpieczony przed przypadkowym ponownym uruchomieniem. Po zakończeniu instalacji w katalogu storage/ powstaje plik blokady installed.lock. Aby zresetować system do ponownej instalacji, wystarczy usunąć ten plik.

---

Przewodnik Krok po Kroku

Krok 1: Wybór Języka

Wybierz język interfejsu instalatora (Polski lub English). Wybór ten wpłynie na język komunikatów instalatora oraz domyślne ustawienia językowe platformy.

Krok 2: Akceptacja Licencji

Zapoznaj się z treścią licencji MIT i zaakceptuj warunki, zaznaczając pole wyboru. Tekst licencji jest pobierany dynamicznie z pliku LICENSE.md.

Krok 3: Wybór Instancji do Zainstalowania

Kreator umożliwia elastyczny wybór środowisk do wdrożenia:

• Wszystkie (Zalecane): Instaluje wszystkie 4 tiery (Panel, Helpdesk, CRM i Shop) na jednej wspólnej bazie danych.
• Panel: Instaluje wyłącznie centralną konsolę administracyjną.
• Helpdesk: Instaluje dedykowany portal obsługi klienta i zgłoszeń serwisowych.
• CRM: Instaluje aplikację operacyjną SaaS CRM dla pracowników.
• Shop: Instaluje sklep internetowy i moduł e-commerce storefront.

Dla każdego wybranego środowiska instalator sugeruje odpowiednie adresy URL (subdomeny lub ścieżki prefiksowe).

Krok 4: Weryfikacja Wymogów Środowiskowych

Instalator przeprowadza automatyczną weryfikację środowiska serwerowego:

• Wersja interpretera PHP (wymagane PHP 8.4 lub wyższe).
• Dostępność rozszerzeń: pdo_mysql, intl, mbstring, zip, gd, bcmath.
• Prawa do zapisu w katalogach roboczych storage/ oraz konfiguracyjnych database/config/.

Krok 5: Konfiguracja Bazy Danych i Kont Użytkowników

1. Parametry Bazy Danych MySQL

Wprowadź dane dostępowe do bazy danych:

• Host bazy: np. 127.0.0.1, localhost lub nazwa kontenera ammonly_mysql.
• Port bazy: domyślnie 3306.
• Nazwa bazy danych: np. ammonly_dev.
• Użytkownik i hasło: poświadczenia do serwera MySQL.

TIP

Przycisk „Sprawdź połączenie z bazą”: Przed uruchomieniem instalacji kliknij przycisk testowy. Kreator wyśle asynchroniczne zapytanie AJAX i natychmiast potwierdzi poprawność poświadczeń oraz dostępność bazy danych.

2. Dedykowane Konta dla Każdego Tieru

Instalator konfiguruje dedykowane konta:

• Konto Panel (Administratorzy): Login (domyślnie admin), e-mail (admin@ammonly.com) oraz hasło.
• Konto Helpdesk (Użytkownicy Helpdesk): Login (domyślnie helpdesk), e-mail (helpdesk@ammonly.com) oraz hasło.
• Konto CRM (Użytkownicy CRM): Login (domyślnie user), e-mail (user@ammonly.com) oraz hasło.
• Konto Shop (Storefront Manager): Login (domyślnie shopmanager), e-mail (shop@ammonly.com) oraz hasło.

3. Wprowadzanie i Generowanie Haseł

W kreatorze Ammonly żadne hasło nie jest na stałe narzucone w kodzie. Dostępne są elastyczne opcje:

• Wprowadzenie własnego hasła: Możesz wpisać dowolne bezpieczne hasło do każdego konta.
• Przycisk z kostką 🎲 (Losuj hasło): Przy każdym polu hasła znajduje się przycisk generujący 16-znakowe, kryptograficznie bezpieczne hasło (crypto.getRandomValues) zawierające litery, cyfry i znaki specjalne.
• Przycisk z okiem 👁️ (Pokaż / Ukryj): Umożliwia szybki podgląd wygenerowanego lub wpisanego hasła.
• Przycisk globalny 🎲 „Wygeneruj losowe hasła dla wszystkich kont”: Jednym kliknięciem wypełnia wszystkie pola kont nowo wygenerowanymi hasłami.
• Automatyczne losowanie: Jeżeli pozostawisz którekolwiek pole hasła puste, instalator automatycznie wylosuje silne hasło podczas instalacji i wyświetli je w podsumowaniu.

4. Opcje Dodatkowe

• Słowniki opcjonalne: Instaluje rozszerzone zestawy słowników (kraje, waluty, branże).
• Dane demonstracyjne: Zasilenie systemu przykładowymi danymi biznesowymi (kontakty, firmy, transakcje, produkty).

Krok 6: Pasek Postępu Instalacji

Po kliknięciu „Rozpocznij instalację” system w czasie rzeczywistym wykonuje operacje wdrożeniowe:

1. Inicjalizacja połączenia z bazą i tworzenie bazy danych w kodowaniu utf8mb4_unicode_ci.
2. Aplikowanie definicji DDL tabel i widoków SQL (01_schema, 02_system_core).
3. Rejestracja modułów biznesowych w rejestrze {tier}_core_module_records (p_, h_, c_, s_) oraz instalacja widżetów.
4. Zastosowanie schematów profilowych (profiles/panel, profiles/helpdesk, profiles/crm, profiles/shop).
5. Utworzenie kont użytkowników z hashowaniem haseł algorytmem Argon2id / Bcrypt.
6. Inicjalizacja klucza szyfrowania aplikacji (storage/app.key) i systemowego tokenu API.
7. Zapisanie konfiguracji lokalnej database/config/installer.local.php i blokady storage/installed.lock.

Krok 7: Podsumowanie i Dostęp do Aplikacji

Po pomyślnej instalacji kreator prezentuje kompletne podsumowanie wdrożenia:

Tabela Poświadczeń Logowania

Przejrzysta tabela z danymi dostępowymi do wszystkich środowisk:

Środowisko	Rola	Login	E-mail	Hasło
Panel	Administratorzy	admin	admin@ammonly.com	Ukryte / Przycisk Kopiuj 📋
Helpdesk	Użytkownicy Helpdesk	helpdesk	helpdesk@ammonly.com	Ukryte / Przycisk Kopiuj 📋
CRM	Użytkownicy CRM	user	user@ammonly.com	Ukryte / Przycisk Kopiuj 📋
Shop	Storefront Manager	shopmanager	shop@ammonly.com	Ukryte / Przycisk Kopiuj 📋

Każde pole hasła wyposażone jest w przycisk Kopiuj do schowka 📋 oraz przycisk podglądu 👁️.

Kafelki Bezpośredniego Logowania

Pod tabelą znajdują się cztery duże kafelki szybkiego logowania:

• 🔵 Ammonly Panel: Zarządzanie platformą, audyt, uprawnienia (/panel).
• 🟣 Ammonly Helpdesk: Portal obsługi klienta i zgłoszeń serwisowych (/helpdesk).
• 🟢 Ammonly CRM: Codzienna praca z systemem CRM, sprzedażą i pocztą (/crm).
• 🟡 Ammonly Shop: Sklep internetowy, katalog produktów, zamówienia (/shop).

---

Bezpieczeństwo Poinstalacyjne

Po zakończeniu pracy kreatora:

1. Plik storage/installed.lock blokuje ponowne wywołanie kreatora oraz punktów końcowych API instalatora.
2. Wrażliwe poświadczenia bazy danych zostają zapisane wyłącznie w pliku database/config/installer.local.php, który jest ignorowany przez system kontroli wersji (.gitignore).
3. Z poziomu panelu administracyjnego zaleca się niezwłoczne skonfigurowanie uwierzytelniania dwuskładnikowego (2FA).