Blog

De meest gevraagde functie in Monica (sinds de vorige) was de mogelijkheid een bestaand contact aan te wijzen als partner of kind. Met 0.6.3 kan dat.

Hoe werkt het

Als je een partner of een kind toevoegt, heb je nu twee nieuwe mogelijkheden:

• Je kunt bij het toevoegen van deze nieuwe persoon kiezen tussen een gedeeltelijk contact of een volwaardig contact. Een gedeeltelijk contact is de oude manier: die contacten staan niet in de contactenlijst en je kunt er geen eigen herinneringen of notities aan hangen. Bij een "echt" contact wordt er daadwerkelijk een nieuw contact aangemaakt voor deze persoon, en kun je daar weer eigen kinderen of partners aan toevoegen.

• In plaats van een nieuw contact aan te maken, kun je ook simpelweg een bestaand contact koppelen als kind of partner van dit contact.

Dit was tot nu toe de grootste verandering in de code, en degene die de meeste tijd kostte. Wie Monica zelf host: wees voorzichtig bij het bijwerken van je installatie en maak vooral een back-up van de database voordat je upgradet.

Andere belangrijke wijzigingen in deze release

• Voor wie van polygamie houdt: je kunt meer dan één partner per contact hebben.
• Nieuwe vertalingen toegevoegd: Italiaans en Duits. Dank aan de gemeenschap.
• Ondersteuning voor Markdown in notities en genoteerde telefoongesprekken. Daarmee kun je bijvoorbeeld lijsten gebruiken.
• We ondersteunen nu alle valuta ter wereld.
• Veel opgeloste fouten en een aantal beveiligingsfixes.
• We zijn begonnen Tachyons als nieuw CSS-framework te gebruiken. Dat gaat Bootstrap geleidelijk vervangen.

Tot slot

Versie 0.6.3 staat al in productie en je kunt hem, zoals altijd, installeren op een server die van jou is.

Veel plezier ermee.

We hebben zojuist een geweldige mijlpaal bereikt.

Dat is fantastisch en een mooie mijlpaal die ik graag met jullie allemaal deel. Gebruikers hebben tot nu toe meer dan 50 000 contacten in Monica gezet, en dat aantal groeit elke dag. Daar zitten de installaties die mensen op hun eigen server hebben gedownload en geïnstalleerd niet eens bij.

Persoonlijk sta ik versteld van de gemeenschap rond het project. Op GitHub hebben we meer dan 200 pull requests uit de gemeenschap ontvangen en mensen lijken het project overal op internet te delen om het goede nieuws te verspreiden.

Ik kan niet wachten om te zien waar we over een jaar staan. Bedankt allemaal voor het vertrouwen.

Als je Monica installeert op een server die van jou is, wil je waarschijnlijk weten wanneer er een nieuwe versie beschikbaar is. Met Monica 0.5.0 is dat precies wat je krijgt.

Hoe werkt dit

Kort gezegd stuurt je Monica-installatie dagelijks een ping naar https://version.monicahq.com. Die ping bevat drie gegevens:

• een UUID: de unieke, anonieme identificatie van je installatie.
• de huidige versie van je installatie
• het aantal contacten in je installatie.

Dat laatste gebruik ik om te weten hoe groot de installaties zijn van de mensen die Monica downloaden. Ik moet dat weten (en alleen dat) zodat ik verder kan met een beter beeld van hoe mensen Monica gebruiken. Er is bovendien geen enkele manier om te weten wie je bent: de UUID is willekeurig, uniek en anoniem.

De code van https://version.monicahq.com is open source en staat op GitHub, zoals alles wat we doen.

Als antwoord op die aanroep krijg je een JSON met:

• of er een nieuwe versie beschikbaar is, als booleaanse waarde,
• wat de nieuwste beschikbare versie is,
• alle releasenotes van elke release sinds de versie in de ping,
• het aantal versies dat er sinds de versie in de ping is verschenen.

Die informatie wordt in de interface gebruikt. In de voettekst verschijnt een nieuwe link als er een nieuwe versie is. Klik je erop, dan opent er een venster met de releasenotes van de nieuwe versie.

Hoe schakel je dit uit

Elke functie die iets fundamenteels aan Monica verandert kan worden uitgeschakeld, en deze is niet anders. Wil je voorkomen dat er informatie naar https://version.monicahq.com gaat, voeg dan het volgende toe aan je .env-bestand:

• CHECK_VERSION=false

Dat is alles. Er verlaat dan nooit informatie je server. Het nadeel is dat je niet automatisch bericht krijgt als er een nieuwe release is.

Zoeken in je contacten

Je kunt nu in je contacten zoeken met een nieuw zoekveld in de kop. De zoekactie kijkt naar de volgende gegevens van je contacten:

• Voor- en achternaam
• E-mail
• Straat
• Plaats
• Postcode
• Provincie
• Voorkeuren voor eten
• Beroep
• Bedrijf

Zoeken zou ook behoorlijk snel moeten zijn. We zijn erg blij met deze functie.

Tot slot

Versie 0.5.0 staat al in productie en je kunt hem, zoals altijd, installeren op een server die van jou is.

Veel plezier ermee.

Bijhouden wat je tegen de mensen die je dierbaar zijn hebt gezegd is belangrijk. Notities over je contacten bewaren kon al. Nu kun je ook een telefoongesprek noteren, wat heel handig is om te weten wanneer je iemand voor het laatst hebt gebeld en waar jullie het toen over hadden.

Versie 0.4.0 staat al in productie en je kunt hem, zoals altijd, installeren op een server die van jou is.

Veel plezier ermee.

Let op: dit is een technisch bericht.

Nadat ik Monica op Hacker News had gelanceerd, kreeg ik veel vragen over waarom ik het hulpmiddel in PHP en met name in Laravel heb geschreven. Ik was eerlijk gezegd verbaasd over zoveel vragen hierover, want ik vind dat een taal er niet toe doet: alleen wat je ermee doet telt.

In dit bericht vertel ik waarom ik voor PHP en Laravel heb gekozen en welke moeilijkheden ik moest overwinnen om de eerste versie van het product te bouwen. Dit bericht is niet bedoeld om een oorlog tussen talen te beginnen.

PHP heeft een interessante geschiedenis. Veel goede webontwikkelaars, die waarschijnlijk allang geen PHP meer gebruiken, hebben er de beginselen van het programmeren mee geleerd. Het was zo eenvoudig om te gebruiken en om mee te beginnen, en hoewel het geen elegante taal was, effende het de weg naar een carrière in webontwikkeling. Daarna werd PHP steeds minder geliefd, tot het punt dat het bijna gênant was om PHP te gebruiken of zelfs maar op meetups te zeggen dat je bedrijf het gebruikte. Andere talen, aantoonbaar eleganter, werden erg populair (Python, Ruby) dankzij prachtige frameworks die erop gebouwd werden. Tegelijkertijd verschenen er nieuwe PHP-frameworks. Symfony bijvoorbeeld. Maar Symfony was nog steeds lastig te leren en te gebruiken. En toen stierf PHP. Dat zeiden mensen althans, en ze negeerden daarbij blijkbaar dat heel veel bedrijven het nog steeds gebruikten en er dol op waren. Toen kwam PHP 5.5, gevolgd door PHP 7, en verscheen er een nieuw framework met een rare naam: Laravel. En het beeld dat mensen hadden veranderde volledig. PHP is nog steeds niet zo elegant als andere populaire talen, maar het is er veel op vooruitgegaan. En het werd ook snel.

Toch blijft PHP de taal die mensen graag haten, vooral op Hacker News. Ze zeggen dat PHP niet schaalt. Dat zal wel de reden zijn dat Facebook en Mailchimp, onder andere grote namen, PHP vandaag op enorme schaal gebruiken.

Waarom heb ik met die achtergrond voor PHP en Laravel gekozen?

• PHP is eenvoudig te leren en eenvoudig te gebruiken.
• Er zijn heel veel PHP-ontwikkelaars, en als mensen met mij aan het project willen werken is de vijver aan PHP-ontwikkelaars, in elk geval waar ik woon, groter dan die aan Ruby- of Python-ontwikkelaars. Bovendien gebruiken veel mensen op GitHub PHP, en als ik wilde dat dit open source project ergens zou aanslaan, moest ik het schrijven in een taal waarin mensen van heel verschillend niveau makkelijk konden bijdragen.
• Het belangrijkste bij het kiezen van een technische basis voor een nieuw project is hoe makkelijk het op de lange termijn te onderhouden zal zijn. PHP is eenvoudig. Het is makkelijk te debuggen (al kon dat beter) en makkelijk te schalen (al is dat op dit moment totaal mijn zorg niet).
• Laravel is verreweg het beste PHP-framework dat ik ooit heb gebruikt. Het maakt ingewikkelde dingen zo eenvoudig. Het is duidelijk dat het framework is gemaakt om heel snel nieuwe webapplicaties te beginnen, en het is echt een genot om mee te werken. Maar de sterkste eigenschap van Laravel is de kwaliteit van de documentatie, vergeleken met andere PHP-frameworks en zelfs met veel frameworks in andere talen. Alles is uitstekend gedocumenteerd. Ik kan niet genoeg benadrukken hoe belangrijk goede documentatie is (wat me eraan herinnert dat ik Monica nog beter zou moeten documenteren).
• Er is een enorme gemeenschap rond PHP en Laravel in het bijzonder: Laracasts, Forge, Envoyer en een sterke Slack-gemeenschap, om er een paar te noemen. Heb je hulp nodig, dan staan er veel mensen klaar om die te geven.

Welke uitdagingen kwam ik tegen tijdens dit project?

Al met al liep ik tijdens het bouwen van de huidige versie van Monica niet tegen zoveel uitdagingen aan. Het is geen ingewikkelde applicatie, en ik heb geen schaalproblemen omdat het aantal gebruikers nog vrij klein is (ongeveer 7800 gebruikers in totaal en 4300 actief). Maar er zijn wel wat implementatiekeuzes die ik verkeerd heb gemaakt, niet omdat het slechte programmeergewoontes waren, maar omdat mijn technische vaardigheden op dat moment niet goed genoeg waren om die problemen snel op te lossen. Hopelijk helpt het opsommen van die fouten anderen ze te vermijden, of sturen aardige mensen me een mail over hoe ik ze had kunnen oplossen.

• In eerdere versies gebruikte ik veel events en listeners. Het concept is prachtig, maar ik had er veel problemen mee bij het unittesten van de basisklassen. Bovendien gebeurde er, hoe meer ik ze gebruikte, hoe meer magie achter de schermen. Ik dacht dat mensen die in de code doken moeite zouden hebben te begrijpen waarom sommige dingen gebeurden zodra er bijvoorbeeld een object werd aangemaakt. In mijn hoofd maakten events en listeners de applicatie moeilijker te begrijpen, dus besloot ik ze allemaal te verwijderen (nou ja, 99% ervan, er zijn nog twee listeners waar ik vanaf moet).
• In het begin was de database volledig versleuteld. Om redenen die ik nog steeds niet begrijp gingen er af en toe dingen mis bij het ontsleutelen, wat leidde tot gegevens die ik niet kon herstellen. Omdat ik dat probleem in dit stadium niet wilde oplossen, besloot ik de versleuteling te verwijderen. Daar kwam bij dat versleutelde gegevens het onmogelijk maakten om in mijn queries te sorteren of te zoeken, wat op de lange termijn lastig had kunnen worden. Er zijn vast oplossingen voor deze twee problemen, maar ik wilde me richten op het maken van nieuwe functies in plaats van op dat ene probleem.
• Ik heb geen unittests geschreven voordat ik de applicatie lanceerde. Dat heeft me flink pijn gedaan. Ik denk niet dat we naar 100% testdekking moeten streven, maar zorg op zijn minst voor enige tests voor de belangrijkste functies van je site. Anders eindig je met een berg bugs waar je niet aan gedacht had, en terwijl je die probeert op te lossen raken andere delen van de applicatie beschadigd door je oplossing. Dat wordt al snel een nachtmerrie. Laravel maakt unittesten heel eenvoudig; ik had dat serieuzer moeten nemen. Vanaf de volgende versie van Laravel wordt geen enkele pull request samengevoegd zonder unittests en misschien zelfs functionele tests.

Conclusie

Dit zijn een paar redenen waarom ik voor Laravel heb gekozen. Zoals ik aan het begin van dit bericht zei: je project gaat niet over de taal. Tenzij je project juist bedoeld is om een nieuwe taal te leren, moet je geen weken besteden aan het kiezen van een taal of framework. Blijf bij wat je kent en maak gewoon iets. Je gebruikers zal het niets kunnen schelen dat je code lelijk is of dat je Python boven Ruby hebt gekozen.

Amper 5 dagen na v0.2.0 alweer een grote release. Zo groot dat er een nieuw versienummer voor nodig was.

Heb je veel contacten in je account, dan kun je ze nu indelen met labels. Labels lijken op mappen, maar je kunt meerdere labels aan één contact hangen. Dat geeft je maximale vrijheid om je contacten te ordenen zoals jij dat wilt.

Labels kun je invoeren direct onder de naam van het contact.

Zodra contacten labels hebben, zie je ze in de contactenlijst en kun je erop klikken om de lijst te filteren.

Tot slot kun je labels verwijderen, zowel vanuit het contact als in een nieuw instellingenscherm dat daarvoor is gemaakt.

Versie 0.3.0 staat al in productie en je kunt hem, zoals altijd, installeren op een server die van jou is.

Veel plezier ermee.

Een van de grootste wensen is de mogelijkheid contacten uit Google te importeren. Google laat je gegevens over je contacten exporteren in het vCard-formaat, de universele standaard om contactgegevens uit te wisselen. Monica 0.2.0 voegt de mogelijkheid toe je gegevens uit een vCard-bestand te importeren (.vcard of .vcf), zodat je je account met het grootste deel van je gegevens kunt vullen in plaats van je vrienden één voor één toe te voegen.

Zodra je contacten geïmporteerd zijn, kom je op een overzicht waar je de status van de import kunt zien. Omdat gebruikers duizenden contacten kunnen hebben, importeert Monica ze asynchroon. Je zult even moeten wachten voordat alle contacten binnen zijn.

Je kunt op een specifieke import klikken om te zien wat er gebeurd is.

We hebben ook een functie toegevoegd om je account leeg te maken, wat goed van pas komt als je duizenden contacten importeert en er iets misgaat. Een account leegmaken verwijdert alles, behalve jou.

Versie 0.2.0 staat al in productie en je kunt hem, zoals altijd, installeren op een server die van jou is.

Veel plezier ermee.

Veel mensen hebben me gemaild met de vraag waarom Monica open source is. Daar zijn allerlei redenen voor, en die wil ik hier uitgebreid beschrijven. Een consumentenproduct open source maken en er tegelijk geld mee proberen te verdienen komt (helaas) niet zo vaak voor, en misschien inspireert dit anderen om hetzelfde te doen. Zelf ben ik geïnspireerd door hoe Sentry, GitLab en veel anderen bedrijven hebben gebouwd rond open source producten, en ook al levert Monica nog geen enkele omzet op, ik wilde mijn eigen gedachten hierover delen.

De voordelen van je product open source maken

• Ik heb altijd al een open source product willen maken. Waarschijnlijk uit idealisme. Ik gebruik al zo lang als ik me kan herinneren open source producten en ik wilde daar in alle bescheidenheid iets voor terugdoen. Ik vond het ook wel mooi staan op mijn cv.
• Monica bevat veel persoonsgegevens. Ik zou zeggen dat die gegevens veel meer schade kunnen aanrichten dan wat mensen op Facebook zetten. Voor sommigen is dat een enorme zorg rond privacy. Door Monica open source te maken, en manieren te bieden om het zelf te installeren op iets wat jij bezit en beheert, is het aan jou om te beslissen of je het risico wilt lopen je gegevens door iemand anders te laten hosten, of dat je ze onder je eigen controle wilt houden.
• Vanwege de gevoelige aard van de gegevens in Monica, en omdat ik een enkele ontwikkelaar ben die het niet zo goed doet als de gemeenschap als geheel, moest ik het product wel open source maken, zodat honderden ogen de code kunnen bekijken en zoeken naar fouten, mogelijke lekken en verbeteringen. En dingen vinden die veel sneller opgelost of verbeterd moeten worden dan ik in mijn eentje zou kunnen.
• Als mensen toegang hebben tot je broncode en gebruiker van het platform worden, zul je versteld staan van hoeveel ze bijdragen. Ze sturen pull requests met geweldige ideeën en concepten, die je meteen in het product kunt zetten zodat iedereen ervan profiteert. Het is prachtig. Natuurlijk is niet elk idee goed en zul je af en toe om allerlei redenen een pull request afwijzen. Maar alles bij elkaar is het buitengewoon positief en krijg je er mooie nieuwe functies bij.
• In een tijd waarin sociale netwerken uiterst ondoorzichtig zijn over wat ze verzamelen en hoe ze die gegevens gebruiken, maken mensen zich steeds meer zorgen over hun privacy. En terecht. Monica toont geen advertenties en verkoopt geen gegevens door. Maar waarom zou je me op mijn woord geloven? Om één reden: de vrij beschikbare broncode is precies wat er in productie draait. Ik onderhoud geen tweede fork met privéaanpassingen. Alles wat ik doe is dus doorzichtig en gebruikers kunnen controleren dat ik geen rare dingen doe. Het draait allemaal om transparantie en het opbouwen van een relatie op basis van vertrouwen.
• Ontwikkelaars zijn het belangrijkste onderdeel van een ecosysteem. Als ontwikkelaars leuk vinden wat je doet, bouwen ze er een ecosysteem omheen en maken ze mooie dingen waar jij nooit aan gedacht zou hebben. Dat is een heel sterk, bijna magisch moment. Ontwikkelaars zijn ook invloedrijk en je beste ambassadeurs. Minder technische mensen kloppen vaak bij hen aan voor het nieuwste technische advies. En als ze Monica leuk vinden, praten ze erover met bijna hetzelfde bereik als een bericht over een Kardashian in een roddelblad.

De nadelen van je product open source maken

• Wat je licentie ook is, er bestaat een risico dat mensen je code nemen, er een bedrijf omheen bouwen en de markt pakken die jij wilde bedienen. Daar kun je niets aan doen. Een populaire uitspraak luidt dat een idee niets waard is en dat alleen de uitvoering telt. In het geval van Monica is het meer dan een idee: de code is er al en is al een uitvoering. Hoe volwassener het product wordt, hoe verleidelijker het voor anderen wordt de code te stelen. Ik kan daarmee leven, zolang de gemeenschap er profijt van heeft.
• Als je groot wordt, word je misschien minder aantrekkelijk voor durfkapitaal of mogelijke kopers. Maar weet je wat? In mijn geval is dat goed nieuws, want ik bouw niets voor hen, ik bouw iets voor gebruikers. Wat investeerders van het product vinden interesseert me niet.
• Omgaan met de gemeenschap kost tijd. Begrijp me niet verkeerd. Ik vind het heerlijk om met ze in gesprek te zijn, en ik voel me zeer bevoorrecht dat er nu al een bevlogen gemeenschap rond Monica bestaat. Maar terwijl ik probeer te bouwen aan wat er hierna komt, besteed ik elke dag veel tijd aan het nakijken van issues, het beoordelen van pull requests en het beantwoorden van e-mails. Een aanzienlijk deel van mijn tijd, eerlijk gezegd. Nogmaals, ik zeg niet dat het slecht is. Ik geniet er juist enorm van. Maar die tijd is wel iets om rekening mee te houden als je besluit je product open source te maken, en je moet bereid zijn mee te doen en voor je gemeenschap te zorgen.

Andere nadelen kan ik niet bedenken. Overweeg je volgende idee open source te maken.

De twee meest gevraagde functies in Monica zijn tot nu toe:

• de mogelijkheid contacten uit een externe bron te importeren,
• zoveel mogelijk automatiseren van het vastleggen van dingen over je relaties.

Ik begrijp heel goed waarom mensen dat willen. Monica draait om het vastleggen en documenteren van het sociale verkeer met de mensen die je dierbaar zijn. Alle namen van je contacten één voor één moeten invoeren wordt door veel mensen als een vervelende klus gezien. En na bijvoorbeeld een telefoongesprek alles handmatig moeten noteren is nog vervelender.

Maar denk hier eens over na. Monica is bedoeld om je te helpen betere relaties te hebben. Relaties opbouwen is niet iets wat we zouden moeten automatiseren en makkelijker maken. Relaties opbouwen is een bewuste inspanning. Het is niet makkelijk. Het kost wel degelijk moeite. Als je 500 contacten zou kunnen importeren, wat zou dat met je doen? Dan had je nu 500 mensen in Monica staan, klaar om gedocumenteerd te worden. Ga je echt de moeite nemen om voor al die 500 mensen alle informatie in te vullen? Kun je met zoveel mensen überhaupt bevriend zijn?

Ik vind het juist prettig dat ik mijn contacten één voor één moet invoeren, omdat het me dwingt na te denken over wie belangrijker voor me is. Bij iedereen die ik aan Monica toevoeg kies ik bewust of die persoon het op de een of andere manier verdient (het woord is veel te sterk, maar je begrijpt wat ik bedoel) dat ik de moeite neem onze relatie te documenteren. En bij iedereen die ik toevoeg moet ik allerlei informatie invullen waar ik actief naar op zoek moet gaan. Ik zou zelfs zover willen gaan te zeggen dat een massa-import, zonder de mogelijkheid te kiezen wat je meeneemt, het hele doel van de applicatie zou ondermijnen.

Maar zo zie ik het product persoonlijk. Hoe ik het zie is misschien niet hoe jij het ziet. Vandaar de behoefte aan een importfunctie. Die gaan we zeker bouwen. Maar denk hier voordat je je contacten importeert nog even over na. Moet je van zoveel mensen informatie bijhouden?

Monica is bedoeld om alle privé-informatie over je contacten te bewaren. Dat is van nature persoonlijk en privé. Toch zijn er gevallen waarin je die informatie met iemand anders wilt delen, met je partner bijvoorbeeld. Het is goed voor te stellen hoe Monica een stel als één geheel kan helpen de relaties met hun dierbaren te ordenen.

Voor die situatie introduceren we ondersteuning voor meerdere gebruikers in één account.

Gebruikers toevoegen gaat per e-mail. Als veiligheidsmaatregel moet de persoon die je per e-mail uitnodigt bij het aanmelden het e-mailadres invullen van de gebruiker die haar heeft uitgenodigd.

Je vindt het gebruikersbeheer als je in je account op het tabblad Instellingen klikt.

Abonnementen

Dit is de eerste betaalde functie. Het betaalde abonnement heet Chandler en kost 10 USD per maand. Dit abonnement is alleen beschikbaar op https://monicahq.com en heeft geen gevolgen voor installaties in eigen beheer. Draai je Monica op je eigen server, dan heb je gratis toegang tot de betaalde functies.

Bekijk de pull request als je er meer over wilt weten.