first commit

.env.example

@@ -0,0 +1,57 @@
+# PostfixAdmin RS development environment
+# Copy this file to .env and edit the values marked CHANGE_ME.
+# The real .env is ignored by git and excluded from release ZIP files.
+#
+#   cp .env.example .env
+#   $EDITOR .env
+#   bash dev.sh
+
+# -----------------------------------------------------------------------------
+# Development database mode
+# -----------------------------------------------------------------------------
+# mock = local SQLite mock database
+# ssh  = connect to the real PostfixAdmin DB through an SSH tunnel
+POSTFIXADMIN_RS_DEV_DB_MODE=ssh
+
+# -----------------------------------------------------------------------------
+# SSH tunnel -> host.linuxiarz.pl
+# -----------------------------------------------------------------------------
+POSTFIXADMIN_RS_SSH_HOST=host.linuxiarz.pl
+POSTFIXADMIN_RS_SSH_USER=CHANGE_ME
+POSTFIXADMIN_RS_SSH_PORT=22
+
+# Optional: use an explicit SSH private key instead of ssh-agent/default key.
+# POSTFIXADMIN_RS_SSH_IDENTITY=/home/mg/.ssh/id_ed25519
+
+# Optional: explicit known_hosts file. Normal SSH host-key verification remains enabled.
+# POSTFIXADMIN_RS_SSH_KNOWN_HOSTS=/home/mg/.ssh/known_hosts
+
+# -----------------------------------------------------------------------------
+# Production PostfixAdmin database behind the SSH server
+# Values below match the PostfixAdmin config supplied for this project.
+# -----------------------------------------------------------------------------
+POSTFIXADMIN_RS_DEV_DB_BACKEND=mysql
+POSTFIXADMIN_RS_DEV_DB_HOST=127.0.0.1
+POSTFIXADMIN_RS_DEV_DB_PORT=3306
+POSTFIXADMIN_RS_SSH_LOCAL_PORT=13306
+POSTFIXADMIN_RS_DEV_DB_USER=postfix
+POSTFIXADMIN_RS_DEV_DB_NAME=postfix
+POSTFIXADMIN_RS_DEV_DB_PASSWORD=CHANGE_ME
+
+# dev.sh forces read-only access in SSH mode by default.
+# Do NOT enable this for initial tests.
+# POSTFIXADMIN_RS_DEV_DB_WRITES=1
+
+# Keep Rspamd filesystem integration disabled while the app is running locally.
+# Enabling it would affect the machine running PostfixAdmin RS, not the SSH host.
+POSTFIXADMIN_RS_DEV_RSPAMD_ENABLED=false
+
+# Optional logging: trace | debug | info or a regular RUST_LOG filter.
+RUST_LOG=debug
+
+# -----------------------------------------------------------------------------
+# Application overrides (normally not needed for SSH development mode)
+# -----------------------------------------------------------------------------
+# POSTFIXADMIN_RS__DATABASE__PASSWORD=CHANGE_ME
+# POSTFIXADMIN_RS__SMTP__PASSWORD=
+# POSTFIXADMIN_RS__SECURITY__COOKIE_SECURE=false