4d3b8b0673
Rename months_expired() to months_expired_at_return() and have the method return an integer representing the month count rather than an enum-like so that the API user has more flexibility with respect to what they then do with the result. Thanks to Brett for the review that suggested this, and for much of the clever math in this change. The results produced by returning_report.py (which is updated here to use the new API) are almost identical to the results produced before the change. In rare cases (about 2-5% of the time) a supporter's lapsed month count will fall into an adjacent bucket instead of the one it fell into before, usually because the previous result was wrong to begin with (due to the ugly days-per-3-months table that we used previously, which this change thankfully eliminates). |
||
---|---|---|
python | ||
scripts | ||
sql | ||
Supporters | ||
.gitignore | ||
AGPLv3 | ||
COPYRIGHT.md | ||
LICENSE.md | ||
README.md |
Mini Non-Profit Supporters and Donors Database
"Supporters" is a small donor database for non-profit fundraising that uses Ledger-CLI as a backend for accounting data.
While this system is used in production for Software Freedom Conservancy, the code is likely only appropriate if you plan to do a lot of work on the command-line. Eventually, the ideal would be to refactor CiviCRM to support the ideas and Ledger-CLI integration represented in this code.
Why Does This Exist?
Conservancy needed a simple donor database and could not invest the resources required to maintain a CiviCRM instance: most organizations that use CiviCRM either pay for hosting or devote some amount of staff time its maintenance. Conservancy could afford neither, but this weekend-hack version of a database suits our needs (at least for now).
License Information
See the file LICENSE.md for license information.
Common Tasks
These are recipes for some common tasks that one might want to complete on the command line with the Supporters database.
-
Add a Supporter from the command line: ./scripts/add-supporter.plx
-
Add an email address, or change the preferred email address: ./scripts/add-email-address.plx