first commit

docs/MIGRATION.md

@@ -0,0 +1,14 @@
+# Migracja PHP PostfixAdmin -> PostfixAdmin-RS
+
+1. Backup DB oraz konfiguracji PostfixAdmin/Postfix/Dovecot.
+2. Skopiuj `config.from-user.toml` jako `/etc/postfixadmin-rs/config.toml`.
+3. Ustaw haslo DB w pliku env z prawami `0600`.
+4. Zbuduj przez `./scripts/build-release.sh` na Rust 1.99.1.
+5. Uruchom `POSTFIXADMIN_RS_CONFIG=/etc/postfixadmin-rs/config.toml postfixadmin-rs --check-config`.
+6. Wystartuj panel tylko na localhost i wykonaj testy read-only.
+7. Utworz testowa skrzynke/alias i sprawdz logowanie SMTP/IMAP oraz dostarczanie.
+8. Sprawdz reset hasla, jezeli korzystasz z `email_other`/tokenow.
+9. Przelacz reverse proxy z PHP/FPM na binarke Rust.
+10. Zachowaj rollback do PHP do czasu przejscia testow produkcyjnych; dopiero potem usun PHP/FPM.
+
+Nie uruchamiaj automatycznych migracji hasel w trakcie tej zmiany.