Skip to content

docs(issues): close EPIC #1525 persistence overhaul#1725

Merged
josecelano merged 1 commit intotorrust:developfrom
josecelano:1525-close-epic-overhaul-persistence
May 1, 2026
Merged

docs(issues): close EPIC #1525 persistence overhaul#1725
josecelano merged 1 commit intotorrust:developfrom
josecelano:1525-close-epic-overhaul-persistence

Conversation

@josecelano
Copy link
Copy Markdown
Member

Summary

This PR closes the EPIC by moving completed issue documents into the closed issues folder:

  • docs/issues/1525-overhaul-persistence.md -> docs/issues/closed/1525-overhaul-persistence.md
  • docs/issues/1723-1525-08-add-postgresql-driver.md -> docs/issues/closed/1723-1525-08-add-postgresql-driver.md

EPIC History

The EPIC was created months ago when we identified that adding PostgreSQL support was not straightforward with the previous persistence crate. The work required migrating persistence to sqlx.

A community contributor, DamnCrab, opened PR #1684. After review feedback, they opened a follow-up PR #1695. To help address the requested changes, additional reviewer guidance and code was provided in PR #1700.

The final implementation was then completed through the incremental plan documented in issue comment:

That plan is now complete, and Torrust Tracker supports PostgreSQL.

Acknowledgement

Thanks to DamnCrab for valuable contributions and ideas retained in the final implementation:

  1. A DB compatibility matrix script to validate tracker compatibility across database versions.
  2. End-to-end tests using a real BitTorrent client (containerized qBittorrent).
  3. Basic database benchmarking to compare persistence performance before/after the sqlx migration and across database engines.

Closes #1525

Close EPIC torrust#1525 by moving the EPIC issue document and the final PostgreSQL sub-issue document to docs/issues/closed after finishing the incremental implementation plan.

History:
- The EPIC started months ago when we identified that adding PostgreSQL support was not straightforward with the previous persistence crate and required migration to sqlx.
- DamnCrab opened PR torrust#1684, followed by PR torrust#1695 after review feedback.
- Additional reviewer guidance was provided through PR torrust#1700 to help address change requests.
- The final implementation was completed through the incremental plan documented in issue comment #4294475557 on issue torrust#1525.
- The tracker now supports PostgreSQL.

Ideas initially introduced in DamnCrab's PRs and retained in the final implementation:
- Matrix DB compatibility script to validate tracker compatibility across database versions.
- End-to-end tracker tests using a real BitTorrent client (containerized qBittorrent).
- Basic database benchmarking to compare persistence performance before/after migration to sqlx and across database engines.

Thanks to DamnCrab for valuable contributions and ideas that improved the final result.

Co-authored-by: DamnCrab <42539593+DamnCrab@users.noreply.github.com>
@josecelano
Copy link
Copy Markdown
Member Author

ACK 9101e76

@codecov
Copy link
Copy Markdown

codecov Bot commented May 1, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 79.73%. Comparing base (b5051ef) to head (9101e76).
⚠️ Report is 2 commits behind head on develop.

Additional details and impacted files
@@           Coverage Diff            @@
##           develop    #1725   +/-   ##
========================================
  Coverage    79.73%   79.73%           
========================================
  Files          354      354           
  Lines        25597    25597           
  Branches     25597    25597           
========================================
+ Hits         20409    20410    +1     
  Misses        4958     4958           
+ Partials       230      229    -1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@josecelano josecelano merged commit 5c8b5c8 into torrust:develop May 1, 2026
26 checks passed
@josecelano josecelano deleted the 1525-close-epic-overhaul-persistence branch May 1, 2026 16:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Overhaul persistence

1 participant