= Living space
:description: Documentation for the Living space
:sectanchors:
:url-repo: https://git.tammi.cc/housing.git

SVG and WGS84 https://www.w3.org/TR/SVG11/coords.html

The project consists of three parts:

1. Application (native web browser)
2. CouchDB and S3
3. Scraper (Golang)

The developments tools are listed in flake.nix. The development environment can be start with command:

[source,bash]
----
nix develop
----

== Application

There is a development server `server.js` that serves the app and static assets.
The application resides in app directory.

[%header,format=tsv]
|===
include::./app/requirements.tsv[]
|===

Run (the development server) with:

[source,bash]
----
node server.js
----

Static assets are deployed directly to a web server with Git.
Later it could be possible to download the assets to CounchDB.

== Scraper runner

Golang implementation fetches the data to CouchDB.
The runner resides in scrape directory.

[%header,format=tsv]
|===
include::./scrape/requirements.tsv[]
|===

The running will require some cookies to be gotten from a web browser. Run with:

[source,bash]
----
export OTA_TOKEN=...
export OTA_CUID=...
export OTA_LOADED=...
export PHPSESSID=...

go run main.go
----

== Next steps

- Implement additional map features, "metro", "pikaraitiotie", "koulut", "kaupat".
- Make the weight calculation work.
- Add links to house details on the service. Add additional images
- Images on modal open on click to a new window
- Visual programming? Value function description with Javascript?
- Notifications to user on new houses
- Sharing via URL

== Analysis Data processing

List of open WFS data sources are in:
https://kartta.hel.fi/avoindata/dokumentit/Aineistolista_wfs_avoindata.html

WFS Capabilities can be found from:
https://kartta.hel.fi/ws/geoserver/avoindata/wfs?version=2.0.0&request=GetCapabilities

The node.js script `download.js` downloads the material.

Description of the statistical data can be found from:
https://hri.fi/data/fi/dataset/helsingin-seudun-aluesarjat-tilastotietokannan-tiedot-paikkatietona

, and the description at:
https://www.hel.fi/static/avoindata/dokumentit/Aluesarjat_Avainluvut_2024.pdf
