new: dev: hardening the registration process with removing the not activated registrations #14

docs/README.md

@@ -57,6 +57,9 @@ Quick command reference for testing:
 
 ## CI/CD & Deployment
 
+### [Scheduled Tasks](./SCHEDULER.md)
+Symfony Scheduler tasks and the Docker worker that runs them.
+
 ### [CI/CD Integration Guide](./CI_CD.md)
 Comprehensive guide for continuous integration and deployment:
 - Gitea Actions workflows (CI and CD pipelines)

docs/SCHEDULER.md

@@ -0,0 +1,31 @@
+# Scheduled Tasks
+
+MineSeeker uses Symfony Scheduler for recurring maintenance work. The Docker
+Compose `scheduler` service runs the Scheduler worker continuously and is
+restarted automatically if it exits.
+
+## Pending-account cleanup
+
+`PurgeExpiredPendingUsersCommand` is scheduled every hour. It deletes only
+unverified users whose activation-token expiry has passed.
+
+To inspect the registered schedule locally:
+
+```bash
+php bin/console debug:scheduler
+```
+
+To run the cleanup manually without deleting data:
+
+```bash
+php bin/console app:users:purge-expired-pending --dry-run
+```
+
+The production worker is started by Docker Compose:
+
+```bash
+docker compose up -d scheduler
+docker compose logs -f scheduler
+```
+
+No host-level cron entry is required.