deichman-stack.md

 Main Services:
 ==
 
+Koha
+===
+
+Koha is an open source, community driven Integrated Library System Deichman uses this mainly for circulation of items and bookeeping item and patron data, as well as statistics on circulation. It is maintained as a "fork" from community edition with a bunch of local 
+patches on top.
+
 ```
-Koha:
   Responsibilities:
     - circulation
     - patron and staff users
@@ -36,8 +41,12 @@ Koha:
     - https://gitlab.deichman.no/digibib/koha-docker
 ```
 
+Patron-Client
+===
+A WebApp driving the Personal profile page for patrons, and a frontend for the 
+    search in our catalogue, and for placing and managing holds and loans.
+
 ```
-Patron-Client:
   Responsibilities:
     - patron profile
     - search
@@ -57,8 +66,32 @@ Patron-Client:
     - https://gitlab.deichman.no/digibib/ls.ext/redef/patron-client
 ```
 
+Catalinker
+===
+The metadata production WebApp for maintaining and producing new work and publication records in the RDF format. Connects to various sources (through services) to collect information on items.
+
+```
+  Responsibilities:
+    - metadata production
+  Description:
+    The metadata production WebApp
+ Technologies:
+    - nodejs (backend)
+    - ractivejs (frontend)
+    - docker
+  Ports:
+    - 8010
+  Docker:
+    Image: digibib/catalinker:<gitref>
+  Sources:
+    - https://gitlab.deichman.no/digibib/ls.ext/redef/catalinker
+```
+
+Services
+==
+A metadata transformation and extraction service, serving as an api between Catalinker - the frontend for metadata editing, and Fuseki - the RDF triplestore and the ES search engine
+
 ```
-Services:
   Responsibilities:
     - metadata
     - search indexing
@@ -77,29 +110,14 @@ Services:
     - https://gitlab.deichman.no/digibib/ls.ext/redef/services
 ```
 
-```
-Catalinker
-  Responsibilities:
-    - metadata production
-  Description:
-    The metadata production WebApp
- Technologies:
-    - nodejs (backend)
-    - ractivejs (frontend)
-    - docker
-  Ports:
-    - 8010
-  Docker:
-    Image: digibib/catalinker:<gitref>
-  Sources:
-    - https://gitlab.deichman.no/digibib/ls.ext/redef/catalinker
-```
-
 Intermediate Services (Inhouse made)
 ==
 
+These are services built and maintained by Deichman for various needs. Preferred technologies are decided by actual need.
+
+Rfidhub
+===
 ```
-Rfidhub:
   Responsibilities:
     - RFID and SIP integration
     - interaction with staff interface
@@ -120,8 +138,11 @@ Rfidhub:
     - https://gitlab.deichman.no/digibib/rfidhub2
 ```
 
+Sip_proxy
+===
+A transformation and relay service for SIP transactions. Mainly used to fix shortcomings in the protocol and communication, as well as a "session" which the protocol doesn't support.
+
 ```
-Sip_proxy:
   Responsibilities:
     - SIP relaying
     - translation of messages
@@ -140,8 +161,24 @@ Sip_proxy:
     - https://gitlab.deichman.no/digibib/sip2proxy
 ```
 
+Koha_indexer
+===
+```
+  Responsibilities:
+    - indexing items and availability
+  Technologies:
+    - go
+    - docker
+  Ports:
+    - 8009
+  Volumes:
+    - koha_state
+```
+
+Sms_proxy
+===
+
 ```
-Sms_proxy:
   Responsibilities:
     - SMS message relaying
   Technologies:
@@ -156,8 +193,9 @@ Sms_proxy:
 Intermediate Services (Open source)
 ==
 
+Elasticsearch
+===
 ```
-Elasticsearch:
   Responsibilities:
     - search index
   Technologies:
@@ -171,8 +209,9 @@ Elasticsearch:
     Image: digibib/elasticsearch:<gitref>
 ```
 
+Fuseki
+===
 ```
-Fuseki:
   Responsibilities:
     - metadata store
   Technologies:
@@ -185,19 +224,6 @@ Fuseki:
     - fuseki_data
 ```
 
-```
-Koha_indexer:
-  Responsibilities:
-    - indexing items
-  Technologies:
-    - go
-    - docker
-  Ports:
-    - 8009
-  Volumes:
-    - koha_state
-```
-
 TESTING
 ==