I developed this project in early 2023, as I was getting fed up of all the manual work that represents appartment search.

• Signing up alarms on different platforms (SeLoger, Jinka, to name a few).
• Reading through the mails.
• Calling / Sending out mails to agencies.
• Filling in (yet another) form with my personnal info.

Something had to be done.

This toolsuite benefits from the openness of the contact form on the french website "SeLoger". It makes it possible to contact an agency through a simple, unprotected POST request. As a result, there is no Puppeteer magic nor scrapping shenanigans happening there.

Here's the process:

• Sign up an email address to a bunch of alarms.
• Program a job that does a daily scrapping of all the SeLoger annonces in the mail, and contact agencies through the POST route aforementionned.
• Keep your phone nearby for when agency people call you, as they like your profile for the appartment.

As a result, RoofR inverts the power balance between appartment seekers and agencies.

From a tech perspective

This project was a good opportunity to work on 2 subjects:

1. Hexagonal Architecture. A subject I was deeply interested in at the time. It allows me to treat all the external depedencies (mail service provider, agency, cache system) through an abstract interface.

The core domain module is essentially a url scanner for mail content (plain text, html), which sends a contact demand for urls that are identified as agency annonces.