docs: reorganize documentation structure and update references to environment variables, added dashboard page

Author: jeboehm

.env.dist

@@ -1,4 +1,4 @@
-# Documentation available in docs/environment-variables.md
+# Documentation available in docs/configuration/environment-variables.md
 #
 
 # Database credentials

.mkdocs.yaml

@@ -19,27 +19,28 @@ nav:
       - installation.md
       - upgrade.md
   - Configuration:
-      - environment-variables.md
-      - dns-configuration.md
-      - external-mysql.md
-      - relayhost.md
-      - local-address-extension.md
-      - php-sessions.md
-      - reverse-proxy.md
-      - roundcube.md
-      - tls.md
+      - configuration/environment-variables.md
+      - configuration/dns-configuration.md
+      - configuration/external-mysql.md
+      - configuration/relayhost.md
+      - configuration/local-address-extension.md
+      - configuration/php-sessions.md
+      - configuration/reverse-proxy.md
+      - configuration/roundcube.md
+      - configuration/tls.md
   - Administration:
-      - manage-domains.md
-      - manage-users.md
-      - manage-aliases.md
-      - manage-fetchmail.md
-      - dkim-signing.md
+      - administration/dashboard.md
+      - administration/manage-domains.md
+      - administration/manage-users.md
+      - administration/manage-aliases.md
+      - administration/manage-fetchmail.md
+      - administration/dkim-signing.md
   - Recipes:
       - Docker:
           - Traefik Reverse Proxy: https://github.com/jeboehm/docker-mailserver/tree/main/docs/example-configs/compose/traefik-reverse-proxy
       - Kubernetes:
           - External Database and HTTPS Ingress: https://github.com/jeboehm/docker-mailserver/tree/main/docs/example-configs/kustomize/external-db-and-https-ingress
   - Development:
-      - architecture.md
-      - development.md
+      - development/architecture.md
+      - development/development.md
   - Issues: https://github.com/jeboehm/docker-mailserver/issues

Pipfile

@@ -0,0 +1,14 @@
+[[source]]
+url = "https://pypi.org/simple"
+verify_ssl = true
+name = "pypi"
+
+[packages]
+mkdocs = "==1.6.1"
+pygments = "==2.19.2"
+pymdown-extensions = "==10.19"
+
+[dev-packages]
+
+[requires]
+python_version = "3.14"

Pipfile.lock

@@ -43,17 +43,18 @@ For detailed installation instructions, see the [Installation Guide](https://jeb
 
 ## Screenshots
 
-### Manage users
+### Dashboard
 
-![User overview](https://raw.githubusercontent.com/jeboehm/mailserver-admin/master/.github/screenshots/user.png)
+![Dashboard](docs/images/admin/dashboard.png)
 
-### Manage aliases
+### User management
 
-![Alias overview](https://raw.githubusercontent.com/jeboehm/mailserver-admin/master/.github/screenshots/alias.png)
+![User List](docs/images/admin/user_list.png)
+![User Edit](docs/images/admin/user_edit.png)
 
 ### DKIM setup
 
-![DKIM setup](https://raw.githubusercontent.com/jeboehm/mailserver-admin/master/.github/screenshots/dkim_edit.png)
+![DKIM setup](docs/images/admin/dkim_edit.png)
 
 ## Links
 

README.md

@@ -45,7 +45,7 @@ The mailserver consists of multiple microservices:
 - **Unbound** - DNS resolver for the filter service
 - **Fetchmail** - External mail retrieval (optional)
 
-See [Architecture Documentation](architecture.md) for detailed information.
+See [Architecture Documentation](development/architecture.md) for detailed information.
 
 ## Getting Help
 

docs/README.md

@@ -0,0 +1,5 @@
+# Dashboard
+
+The dashboard is the main page of the administration tool. It provides a quick overview of the mailserver and the most important information.
+
+![Dashboard](../images/admin/dashboard.png)

docs/administration/dashboard.md

@@ -20,7 +20,7 @@ Configure DKIM through the management interface:
 6. Verify the DNS record through the management interface
 7. Enable DKIM signing for the domain
 
-![DKIM Edit](images/admin/dkim_edit.png)
+![DKIM Edit](../images/admin/dkim_edit.png)
 
 ## DNS Record
 

docs/dkim-signing.md docs/administration/dkim-signing.mddocs/dkim-signing.md renamed to docs/administration/dkim-signing.md

@@ -30,7 +30,7 @@ Email aliases provide flexible email routing without requiring separate user acc
    - **Destination Address(es)**: An email address to forward emails to
 5. Save the alias
 
-![Alias Create](images/admin/alias_create.png)
+![Alias Create](../images/admin/alias_create.png)
 
 The source address must belong to a domain that exists in the system. Destination addresses can be:
 

docs/manage-aliases.md docs/administration/manage-aliases.mddocs/manage-aliases.md renamed to docs/administration/manage-aliases.md

@@ -16,7 +16,7 @@ Domain management is restricted to users with **Admin** role. Domain administrat
 
 The domain list shows all configured domains in the system:
 
-![Domain List](images/admin/domain_list.png)
+![Domain List](../images/admin/domain_list.png)
 
 ### Adding a Domain