docs: add badges, troubleshooting and changelog

CHANGELOG.md

@@ -0,0 +1,42 @@
+# Changelog
+
+All notable changes to AstraDeploy are documented here.
+
+## [v0.1.0] - 2026-05-31
+
+### Added
+- Initial release architecture and installer core (`install.sh`) with:
+  - argument parsing and lifecycle orchestration;
+  - centralized preflight/install/post steps;
+  - root/sudo guardrails and safety checks;
+  - logs to `/var/log/astra-deploy/`;
+  - report callback with `started/step/success/failed` statuses.
+- Interactive beginner flow (`--easy`) and non-interactive automation flow (`--yes`, `--non-interactive`).
+- Service support for `systemd`, `tmux-systemd`, `screen`, and `none`.
+- Firewall wiring and port validation flow.
+- License and EULA acceptance flow:
+  - `--accept-license` (`--license`)
+  - `--accept-eula` (`--eula`).
+- Core support matrix with separate handlers for:
+  - `pmmp`, `paper`, `purpur`, `velocity`, `powernukkitx`.
+- Localization architecture with Russian and English locale files:
+  - `[locales/ru.sh](locales/ru.sh)`
+  - `[locales/en.sh](locales/en.sh)`.
+- `NetherGamesMC` core installer:
+  - PHP build selection (`--build`)
+  - PocketMine-MCPE source workflow (`--mc-version`)
+  - Composer/runtime preparation and source clone path.
+
+### Changed
+- Added explicit safety modes for existing directories:
+  - `--allow-existing`, `--backup-existing`, `--force-clean`.
+- Added dry-run simulation mode and debug mode.
+- Added versioned command aliases for compatibility (`--core-version`, legacy `--version`).
+
+### Fixed
+- Initial hardening for cleanup and service behavior across supported flows.
+
+### Known limitations
+- Support matrix for OS/package-manager is intentionally MVP-focused (mainly Debian/Ubuntu family first, with extension points for others).
+- `--update` path is implemented per-core where available.
+