RevBank - Revision history

Juerd: /* Gebruikers */

2026-03-30T19:54:02Z

Gebruikers

← Older revision		Revision as of 19:54, 30 March 2026
Line 41:		Line 41:
	* Sinds 2025: FAFO		* Sinds 2025: FAFO

	Voormalig gebruikers: Hack42, Sk1llz, Hackerspace Gent, Frack.		Voormalig gebruikers: Hack42, Sk1llz, Hackerspace Gent, Frack, 57North Hacklab.

	== FAQ ==		== FAQ ==

Juerd: s/github/codeberg/g

2025-09-04T23:20:16Z

s/github/codeberg/g

← Older revision		Revision as of 23:20, 4 September 2025
Line 2:		Line 2:
	"Banking in the Netherlands does correspond to Dutch stereotypes — which is a great thing. You can always split a check in a restaurant and they have some slick mobile apps to keep track of who paid for what during trips and outings that also provide ways for everyone to be reimbursed easily. So it’s no surprise to learn that a Dutch hackerspace has developed their own accounting and funds transfer system to help members pay and get paid. And that would be RevBank.		"Banking in the Netherlands does correspond to Dutch stereotypes — which is a great thing. You can always split a check in a restaurant and they have some slick mobile apps to keep track of who paid for what during trips and outings that also provide ways for everyone to be reimbursed easily. So it’s no surprise to learn that a Dutch hackerspace has developed their own accounting and funds transfer system to help members pay and get paid. And that would be RevBank.

	The public-facing part of RevBank is a terminal sitting right next to the fridge and the snacks, with a barcode scanner attached so you can scan your item, then scan or type your name, and you’re done. The source is [https://~~github~~.~~com~~/revspace/revbank here]. It’s written in .. uhm, perl. Have fun with that.		The public-facing part of RevBank is a terminal sitting right next to the fridge and the snacks, with a barcode scanner attached so you can scan your item, then scan or type your name, and you’re done. The source is [https://codeberg.org/revspace/revbank here]. It’s written in .. uhm, perl. Have fun with that.

	I gave it a whirl while I was there, and was able to top up my account with a bank transfer (this statement makes sense in Europe — you can also do cash instead). And then I used it to pay for all my snacks that day. Worked great, quite efficient."		I gave it a whirl while I was there, and was able to top up my account with a bank transfer (this statement makes sense in Europe — you can also do cash instead). And then I used it to pay for all my snacks that day. Worked great, quite efficient."
Line 11:		Line 11:
	== Source ==		== Source ==

	https://~~github~~.~~com~~/revspace/revbank		https://codeberg.org/revspace/revbank

	== Implementatie bij RevSpace ==		== Implementatie bij RevSpace ==
Line 52:		Line 52:
	: Touchscreens zijn bij hackerspaces in het algemeen "apparaat zoekt project". Als je een bank-GUI maakt ligt een touchscreen voor de hand, maar RevBank is nu eenmaal CLI-gebaseerd.		: Touchscreens zijn bij hackerspaces in het algemeen "apparaat zoekt project". Als je een bank-GUI maakt ligt een touchscreen voor de hand, maar RevBank is nu eenmaal CLI-gebaseerd.
	; Hoe installeer/upgrade je RevBank?		; Hoe installeer/upgrade je RevBank?
	: Staat allemaal in de [https://~~github~~.~~com~~/revspace/revbank README].		: Staat allemaal in de [https://codeberg.org/revspace/revbank README].
	; Kun je meerdere RevBanks tegelijk draaien op dezelfde databestanden?		; Kun je meerdere RevBanks tegelijk draaien op dezelfde databestanden?
	: Ja, RevBank gebruikt een globale lockfile, en schrijft nieuwe dingen met een atomische rename voor de zekerheid.		: Ja, RevBank gebruikt een globale lockfile, en schrijft nieuwe dingen met een atomische rename voor de zekerheid.
Line 206:		Line 206:
	Daarom doen we sinds 2021 online betalingen via iDeal. Daarvoor is er een [https://deposit.revspace.nl/ backend website] waarop mensen de betaling doen en daarna een barcode krijgen, die ze dan in revbank kunnen scannen. Minder foutgevoelig en ook makkelijker in gebruik. Het enige dat nu nog fout kan gaan, is dat mensen dat vergeten te scannen, maar daar komen ze snel genoeg zelf achter doordat hun revbank-saldo laag blijft.		Daarom doen we sinds 2021 online betalingen via iDeal. Daarvoor is er een [https://deposit.revspace.nl/ backend website] waarop mensen de betaling doen en daarna een barcode krijgen, die ze dan in revbank kunnen scannen. Minder foutgevoelig en ook makkelijker in gebruik. Het enige dat nu nog fout kan gaan, is dat mensen dat vergeten te scannen, maar daar komen ze snel genoeg zelf achter doordat hun revbank-saldo laag blijft.

	In revbank is het geimplementeerd als de [https://~~github~~.~~com~~/revspace/revbank/~~blob~~/master/plugins/~~revspace_mollie~~ plugin ~~revspace_mollie~~], de source van de betaalsite staat op https://~~github~~.~~com~~/revspace/revbank-mollie-deposit en is geschreven in een paarhonderd regels PHP omdat we toch al PHP moeten draaien voor de wiki. De betaalsite is volledig stateless, althans, alle state wordt bij Mollie opgeslagen. De barcode is dan ook gewoon de transactie-id van de molliebetaling.		In revbank is het geimplementeerd als de [https://codeberg.org/revspace/revbank/src/branch/master/plugins/mollie plugin mollie], de source van de betaalsite staat op https://codeberg.org/revspace/revbank-mollie-deposit en is geschreven in een paarhonderd regels PHP omdat we toch al PHP moeten draaien voor de wiki. De betaalsite is volledig stateless, althans, alle state wordt bij Mollie opgeslagen. De barcode is dan ook gewoon de transactie-id van de molliebetaling.

	Af en toe sluit een gebruiker de site te snel, en heeft die wel betaald maar de code niet afgewacht. In dat geval kan een bestuurslid makkelijk via het dashboard van Mollie de code opzoeken.		Af en toe sluit een gebruiker de site te snel, en heeft die wel betaald maar de code niet afgewacht. In dat geval kan een bestuurslid makkelijk via het dashboard van Mollie de code opzoeken.
Line 213:		Line 213:

	Een andere space die dit ook wil gebruiken, zou dit kunnen doen:		Een andere space die dit ook wil gebruiken, zou dit kunnen doen:
	* https://~~github~~.~~com~~/revspace/revbank-mollie-deposit (PHP) forken en aanpassen voor eigen gebruik		* https://codeberg.org/revspace/revbank-mollie-deposit (PHP) forken en aanpassen voor eigen gebruik
	* Aanmelden bij Mollie		* Aanmelden bij Mollie
	* Test API-key van Mollie in de config zetten		* Test API-key van Mollie in de config zetten

Juerd: /* Gebruikers */

2025-07-16T11:24:05Z

Gebruikers

← Older revision		Revision as of 11:24, 16 July 2025
Line 39:		Line 39:
	* Sinds 2023: Edinburgh Hacklab		* Sinds 2023: Edinburgh Hacklab
	* Sinds 2025: HSBXL		* Sinds 2025: HSBXL
			* Sinds 2025: FAFO

	Voormalig gebruikers: Hack42, Sk1llz, Hackerspace Gent, Frack.		Voormalig gebruikers: Hack42, Sk1llz, Hackerspace Gent, Frack.

Juerd: /* Gebruikers */

2025-05-13T00:38:24Z

Gebruikers

← Older revision		Revision as of 00:38, 13 May 2025
Line 37:		Line 37:
	* Sinds 2022: UmeHack		* Sinds 2022: UmeHack
	* Sinds 2023: PI4DEC		* Sinds 2023: PI4DEC
			* Sinds 2023: Edinburgh Hacklab
	* Sinds 2025: HSBXL		* Sinds 2025: HSBXL

Juerd: /* Gebruikers */

2025-04-01T22:02:51Z

Gebruikers

← Older revision		Revision as of 22:02, 1 April 2025
Line 32:		Line 32:
	* Sinds 2017: Hackalot		* Sinds 2017: Hackalot
	* Sinds 2018: Hackerspace Nijmegen		* Sinds 2018: Hackerspace Nijmegen
	* Sinds 2019: Frack
	* Sinds 2019: Coredump		* Sinds 2019: Coredump
	* Sinds 2020: TDvenlo		* Sinds 2020: TDvenlo
Line 40:		Line 39:
	* Sinds 2025: HSBXL		* Sinds 2025: HSBXL

	Voormalig gebruikers: Hack42, Sk1llz, Hackerspace Gent.		Voormalig gebruikers: Hack42, Sk1llz, Hackerspace Gent, Frack.

	== FAQ ==		== FAQ ==

Juerd: /* Gebruikers */

2025-04-01T21:58:10Z

Gebruikers

← Older revision		Revision as of 21:58, 1 April 2025
Line 38:		Line 38:
	* Sinds 2022: UmeHack		* Sinds 2022: UmeHack
	* Sinds 2023: PI4DEC		* Sinds 2023: PI4DEC
			* Sinds 2025: HSBXL

	Voormalig gebruikers: Hack42, Sk1llz, Hackerspace Gent.		Voormalig gebruikers: Hack42, Sk1llz, Hackerspace Gent.

Juerd: /* Geschiedenis */

2023-12-31T02:26:21Z

Geschiedenis

← Older revision		Revision as of 02:26, 31 December 2023
Line 246:		Line 246:
	* november 2023: '''Versie 4.1.0''' en '''4.2.0''': <tt>adduser</tt> wordt wat strikter, en verbiedt voortaan allerlei usernames die problemen kunnen geven. Commando's, producten, en gebruikersnamen delen immers by design allemaal dezelfde namespace. Garanties tegen clashes kunnen niet gegeven worden, maar sommige clashes kun je wel herkennen. Ook is er nu een speciaal accounttype voor accounts die uitgesloten moeten worden van het totaal generaal (grand total). Die accounts komen in beeld met een <tt>*</tt> aan het begin.		* november 2023: '''Versie 4.1.0''' en '''4.2.0''': <tt>adduser</tt> wordt wat strikter, en verbiedt voortaan allerlei usernames die problemen kunnen geven. Commando's, producten, en gebruikersnamen delen immers by design allemaal dezelfde namespace. Garanties tegen clashes kunnen niet gegeven worden, maar sommige clashes kun je wel herkennen. Ook is er nu een speciaal accounttype voor accounts die uitgesloten moeten worden van het totaal generaal (grand total). Die accounts komen in beeld met een <tt>*</tt> aan het begin.
	* november 2023: '''Versie 4.2.2''': Bij PI4DEC hebben ze een interessante situatie ontdekt vanwege een custom plugin die stierf tijdens het afrekenen van een gegenereerd barcode-pasje. Ik vind het niet echt een bug in RevBank, want die plugin had fouten natuurlijk moeten afvangen, maar de manier waarop in RevBank de transactie wel gelogd, maar niet uitgevoerd werd, werkt natuurlijk wel erg verwarrend. Enfin, RevBank vangt nu uitzonderingen op die de plugin laat liggen.		* november 2023: '''Versie 4.2.2''': Bij PI4DEC hebben ze een interessante situatie ontdekt vanwege een custom plugin die stierf tijdens het afrekenen van een gegenereerd barcode-pasje. Ik vind het niet echt een bug in RevBank, want die plugin had fouten natuurlijk moeten afvangen, maar de manier waarop in RevBank de transactie wel gelogd, maar niet uitgevoerd werd, werkt natuurlijk wel erg verwarrend. Enfin, RevBank vangt nu uitzonderingen op die de plugin laat liggen.
	* december 2023: '''Versie 4.3.0''' en '''5.0.0''': Twee features waar regelmatig om gevraagd is, zijn nu eindelijk ingevoerd. Het heeft lang geduurd omdat het backwards incompatible zou zijn, en ik jarenlang geen goede manier kon bedenken om sierlijk om te gaan met invoer van gebruikers die een oudere versie gewend zijn. Je kunt nu op de plaats van een bedrag een simpele rekensom met <tt>+</tt> en <tt>-</tt> geven, en in de "geavanceerde modus" dingen tussen aanhalingstekens zetten, waardoor je bijvoorbeeld een spatie in een omschrijving kan ~~zetten~~. En je kunt met een puntkomma opdrachten van elkaar scheiden, en in sommige gevallen moet dat voortaan zelfs, waardoor diverse bedieningsfouten kunnen worden gedetecteerd voordat ze een definitieve transactie veroorzaken - dit zou een aantal keren <tt>undo</tt> per jaar moeten schelen. Je kunt zelfs voor het eerst sinds het bestaan van RevBank "abort" als letterlijke tekst opgeven als invoer voor een plugin, namelijk door er aanhalingstekens omheen te zetten. Nuttig? Nauwelijks, behalve dat je nu eindelijk een barcode-print-plugin kunt gebruiken om een abort-barcode te maken :P		* december 2023: '''Versie 4.3.0''' en '''5.0.0''': Twee features waar regelmatig om gevraagd is, zijn nu eindelijk ingevoerd. Het heeft lang geduurd omdat het backwards incompatible zou zijn, en ik jarenlang geen goede manier kon bedenken om sierlijk om te gaan met invoer van gebruikers die een oudere versie gewend zijn. Je kunt nu op de plaats van een bedrag een simpele rekensom met <tt>+</tt> en <tt>-</tt> geven, en in de "geavanceerde modus" dingen tussen aanhalingstekens zetten, waardoor er bijvoorbeeld een spatie in een omschrijving kan (voorheen kon dat alleen in de "simpele modus"). En je kunt met een puntkomma opdrachten van elkaar scheiden, en in sommige gevallen moet dat voortaan zelfs, waardoor diverse bedieningsfouten kunnen worden gedetecteerd voordat ze een definitieve transactie veroorzaken - dit zou een aantal keren <tt>undo</tt> per jaar moeten schelen. Je kunt zelfs voor het eerst sinds het bestaan van RevBank "abort" als letterlijke tekst opgeven als invoer voor een plugin, namelijk door er aanhalingstekens omheen te zetten. Nuttig? Nauwelijks, behalve dat je nu eindelijk een barcode-print-plugin kunt gebruiken om een abort-barcode te maken :P

	Voor veel meer detail, zie de git commit log...		Voor veel meer detail, zie de git commit log...

Juerd: /* Geschiedenis */

2023-12-31T02:24:16Z

Geschiedenis

← Older revision		Revision as of 02:24, 31 December 2023
Line 244:		Line 244:
	* (Versies 3.5 t/m 3.9 zijn niet zo heel interessant)		* (Versies 3.5 t/m 3.9 zijn niet zo heel interessant)
	* september 2023: '''Versie 4.0.0''': Een poging om semantic versioning te gebruiken, dus nu twee puntjes in het versienummer. Transactienummers waren altijd eigenlijk stiekem timestamps (unix time minus 1.3e9), maar het is gangbaar om facturen e.d. doorlopend te nummeren zodat je kunt zien als er iets in je log ontbreekt. Kleine wijziging, maar bij upgrades wel een ding waar beheerders een keuze moeten maken welk schema ze voortaan willen aanhouden. Intussen heeft RevBank overigens ondersteuning voor BTW-administratie, sommige GS1-barcodes, en het bijhouden en teruggeven van statiegeld.		* september 2023: '''Versie 4.0.0''': Een poging om semantic versioning te gebruiken, dus nu twee puntjes in het versienummer. Transactienummers waren altijd eigenlijk stiekem timestamps (unix time minus 1.3e9), maar het is gangbaar om facturen e.d. doorlopend te nummeren zodat je kunt zien als er iets in je log ontbreekt. Kleine wijziging, maar bij upgrades wel een ding waar beheerders een keuze moeten maken welk schema ze voortaan willen aanhouden. Intussen heeft RevBank overigens ondersteuning voor BTW-administratie, sommige GS1-barcodes, en het bijhouden en teruggeven van statiegeld.
			* november 2023: '''Versie 4.1.0''' en '''4.2.0''': <tt>adduser</tt> wordt wat strikter, en verbiedt voortaan allerlei usernames die problemen kunnen geven. Commando's, producten, en gebruikersnamen delen immers by design allemaal dezelfde namespace. Garanties tegen clashes kunnen niet gegeven worden, maar sommige clashes kun je wel herkennen. Ook is er nu een speciaal accounttype voor accounts die uitgesloten moeten worden van het totaal generaal (grand total). Die accounts komen in beeld met een <tt>*</tt> aan het begin.
			* november 2023: '''Versie 4.2.2''': Bij PI4DEC hebben ze een interessante situatie ontdekt vanwege een custom plugin die stierf tijdens het afrekenen van een gegenereerd barcode-pasje. Ik vind het niet echt een bug in RevBank, want die plugin had fouten natuurlijk moeten afvangen, maar de manier waarop in RevBank de transactie wel gelogd, maar niet uitgevoerd werd, werkt natuurlijk wel erg verwarrend. Enfin, RevBank vangt nu uitzonderingen op die de plugin laat liggen.
			* december 2023: '''Versie 4.3.0''' en '''5.0.0''': Twee features waar regelmatig om gevraagd is, zijn nu eindelijk ingevoerd. Het heeft lang geduurd omdat het backwards incompatible zou zijn, en ik jarenlang geen goede manier kon bedenken om sierlijk om te gaan met invoer van gebruikers die een oudere versie gewend zijn. Je kunt nu op de plaats van een bedrag een simpele rekensom met <tt>+</tt> en <tt>-</tt> geven, en in de "geavanceerde modus" dingen tussen aanhalingstekens zetten, waardoor je bijvoorbeeld een spatie in een omschrijving kan zetten. En je kunt met een puntkomma opdrachten van elkaar scheiden, en in sommige gevallen moet dat voortaan zelfs, waardoor diverse bedieningsfouten kunnen worden gedetecteerd voordat ze een definitieve transactie veroorzaken - dit zou een aantal keren <tt>undo</tt> per jaar moeten schelen. Je kunt zelfs voor het eerst sinds het bestaan van RevBank "abort" als letterlijke tekst opgeven als invoer voor een plugin, namelijk door er aanhalingstekens omheen te zetten. Nuttig? Nauwelijks, behalve dat je nu eindelijk een barcode-print-plugin kunt gebruiken om een abort-barcode te maken :P

	Voor veel meer detail, zie de git commit log...		Voor veel meer detail, zie de git commit log...

Juerd: /* Geschiedenis */

2023-09-21T00:55:26Z

Geschiedenis

← Older revision		Revision as of 00:55, 21 September 2023
Line 242:		Line 242:
	* juni 2022: '''Versie 3.4''': In versie 3 was het al voorbereid met de mogelijkheid om tegenrekeningen aan een transactie toe te voegen, maar de volgende stap is gezet richting "dubbel boekhouden": ALLES krijgt een tegenrekening (maar (nog) niet verplicht voor custom plugins). Om gebruikers te beschermen tegen informatie-overload, zijn de tegenrekeningen verborgen uit de user interface. Wel weet het systeem nu dus magisch hoeveel geld er in het geldkistje zou moeten zitten, en wordt dat bij een "undo" ook keurig teruggedraaid. Dit zou kascontrole een stuk makkelijker moeten maken. De codebase is nu net iets onder de 3000 regels, dus 10× zo groot als versie 1.		* juni 2022: '''Versie 3.4''': In versie 3 was het al voorbereid met de mogelijkheid om tegenrekeningen aan een transactie toe te voegen, maar de volgende stap is gezet richting "dubbel boekhouden": ALLES krijgt een tegenrekening (maar (nog) niet verplicht voor custom plugins). Om gebruikers te beschermen tegen informatie-overload, zijn de tegenrekeningen verborgen uit de user interface. Wel weet het systeem nu dus magisch hoeveel geld er in het geldkistje zou moeten zitten, en wordt dat bij een "undo" ook keurig teruggedraaid. Dit zou kascontrole een stuk makkelijker moeten maken. De codebase is nu net iets onder de 3000 regels, dus 10× zo groot als versie 1.
	* augustus 2022: '''Versie 3.5''': Tot nu toe startte revbank vim voor het aanpassen van de productenlijsten, maar lang niet iedereen snapt vim. In tegenstelling tot wat veel mensen denken, is een editor zoals nano ook niet per se zonder hulp te gebruiken door newbies (je moet maar net weten dat ^ betekent dat je ctrl moet indrukken), en er bleek geen enkele editor te zijn die volledig zelfverklarend is én goed werkt op echte oude terminals zoals de IBM 3151 die we bij RevSpace voor RevBank gebruiken. Dus moest RevBank maar een eigen interne editor krijgen die wel aan alle wensen voldoet.		* augustus 2022: '''Versie 3.5''': Tot nu toe startte revbank vim voor het aanpassen van de productenlijsten, maar lang niet iedereen snapt vim. In tegenstelling tot wat veel mensen denken, is een editor zoals nano ook niet per se zonder hulp te gebruiken door newbies (je moet maar net weten dat ^ betekent dat je ctrl moet indrukken), en er bleek geen enkele editor te zijn die volledig zelfverklarend is én goed werkt op echte oude terminals zoals de IBM 3151 die we bij RevSpace voor RevBank gebruiken. Dus moest RevBank maar een eigen interne editor krijgen die wel aan alle wensen voldoet.
			* (Versies 3.5 t/m 3.9 zijn niet zo heel interessant)
			* september 2023: '''Versie 4.0.0''': Een poging om semantic versioning te gebruiken, dus nu twee puntjes in het versienummer. Transactienummers waren altijd eigenlijk stiekem timestamps (unix time minus 1.3e9), maar het is gangbaar om facturen e.d. doorlopend te nummeren zodat je kunt zien als er iets in je log ontbreekt. Kleine wijziging, maar bij upgrades wel een ding waar beheerders een keuze moeten maken welk schema ze voortaan willen aanhouden. Intussen heeft RevBank overigens ondersteuning voor BTW-administratie, sommige GS1-barcodes, en het bijhouden en teruggeven van statiegeld.

	Voor veel meer detail, zie de git commit log...		Voor veel meer detail, zie de git commit log...

Juerd: /* FAQ */

2023-09-21T00:46:04Z

FAQ

← Older revision		Revision as of 00:46, 21 September 2023
Line 49:		Line 49:
	; Maar touchscreens!!!1		; Maar touchscreens!!!1
	: Touchscreens zijn bij hackerspaces in het algemeen "apparaat zoekt project". Als je een bank-GUI maakt ligt een touchscreen voor de hand, maar RevBank is nu eenmaal CLI-gebaseerd.		: Touchscreens zijn bij hackerspaces in het algemeen "apparaat zoekt project". Als je een bank-GUI maakt ligt een touchscreen voor de hand, maar RevBank is nu eenmaal CLI-gebaseerd.
	; ~~Wat heb~~ je ~~nodig om~~ RevBank ~~te kunnen draaien~~?		; Hoe installeer/upgrade je RevBank?
	: ~~Een Linuxcomputer met toetsenbord en scherm, liefst ook met een barcodescanner. Qua software heb je Perl en~~ de ~~modules Term~~:~~:ReadLine::Gnu en Curses::UI (Debian: apt install libterm-readline-gnu-perl libcurses-ui-perl) nodig, en liefst ook BusyBox~~.		: Staat allemaal in de [https://github.com/revspace/revbank README].
	; Kun je meerdere RevBanks tegelijk draaien op dezelfde databestanden?		; Kun je meerdere RevBanks tegelijk draaien op dezelfde databestanden?
	: Ja, RevBank gebruikt een globale lockfile, en schrijft nieuwe dingen met een atomische rename voor de zekerheid.		: Ja, RevBank gebruikt een globale lockfile, en schrijft nieuwe dingen met een atomische rename voor de zekerheid.