package as reusable app

Author: enricofer

.env

@@ -1,5 +1,6 @@
 SCHEME_EXTERNAL=http
-HOST_EXTERNAL=172.20.0.1
+#HOST_EXTERNAL=172.20.0.1
+HOST_EXTERNAL=localhost
 POSTGRES_PORT_EXTERNAL=5435
 WEBAPP_PORT_EXTERNAL=9889
 POSTGRES_SERVER_EXTERNAL=${HOST_EXTERNAL}:${POSTGRES_PORT_EXTERNAL}

MANIFEST.in

@@ -0,0 +1,25 @@
+include LICENSE
+include README.md
+recursive-include djakart/static *
+recursive-include djakart/templates *
+recursive-include djakart/migrations *
+recursive-include djakart/static *
+recursive-include doc *
+recursive-exclude build_qgis *
+recursive-exclude build_webapp *
+recursive-exclude data *
+recursive-exclude djakart_admin *
+recursive-exclude djakart_admin *
+recursive-exclude main_app *
+include djakart/admin.py
+include djakart/aggiorna_privilegi_pg.py
+include djakart/apps.py
+include djakart/importa_template.py
+include djakart/kart_api.py
+include djakart/__init__.py
+include djakart/prototipo.gpkg
+include djakart/QGS_project_macro.py
+include djakart/models.py
+include djakart/tests.py
+include djakart/urls.py
+include djakart/views.py

dist/djakart-0.1-py3-none-any.whl

@@ -0,0 +1,164 @@
+Metadata-Version: 2.2
+Name: djakart
+Version: 0.1
+Summary: A django wrapper to kart geospatial versioning tool 
+Author-email: Enrico Ferreguti <[email protected]>
+Project-URL: Homepage, https://github.com/enricofer/djakart
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.0
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GPL2 License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: django>=4.0
+Requires-Dist: asgiref
+Requires-Dist: certifi
+Requires-Dist: charset-normalizer
+Requires-Dist: django-object-actions
+Requires-Dist: GDAL>=3.4.3
+Requires-Dist: idna
+Requires-Dist: numpy
+Requires-Dist: psycopg2-binary
+Requires-Dist: requests
+Requires-Dist: sqlparse
+Requires-Dist: urllib3
+
+# Djakart
+
+A django app for multiuser [kart versioning](https://kartproject.org/) in QGIS
+
+## Deployment
+
+1. clone the repository and enter djakart folder
+
+```
+$ git clone [email protected]:enricofer/djakart.git
+$ cd djakart
+```
+
+2. build the images
+
+```
+$ docker build -t enricofer/qgis-server:latest ./build_qgis
+$ docker build --build-context webapp_root=./webapp -t enricofer/djakart:latest ./build_webapp
+```
+
+3. start the containers
+
+```
+$ docker compose up -d
+```
+
+3. collect necessary static files
+
+```
+$ docker compose exec webapp_djakart /usr/bin/python3 manage.py collectstatic --no-input
+```
+
+4. create the superuser
+
+```
+$ docker compose exec webapp_djakart /usr/bin/python3 manage.py createsuperuser --no-input
+```
+
+5. for custom deployment .env environment file should be edited
+
+6. login to [http://localhost:9889/admin](http://localhost:9889/admin)
+
+```
+login: djakart-admin
+password: letmein
+```
+
+![](doc/screenshot01.png)
+
+Now you you can create a new Kart repository adding a new version
+
+![](doc/screenshot02.png)
+
+7. A sample dataset can be downloaded and installed overwriting data folder to quickly test the application (stop docker containers before install)
+
+```
+$ docker compose down 
+$ wget https://github.com/enricofer/djakart/releases/download/0.2/test_data02.tar.gz
+$ sudo tar --same-owner -xvf test_data01.tar.gz data/
+$ docker compose up -d
+```
+
+Now you should have 4 new test repositories:
+
+![](doc/screenshot03.png)
+
+- REPO_TEST is the base kart repository 
+- ADD_TWO AND ADD_THREE are edited clone branches of REPO_TEST
+- ADD_FOUR is an edited clone of ADD_THREE repository
+
+the repositories are store in data/kart_versions folder:
+
+```
+$ ll data/kart_versions
+drwxrwxr-x 6 enrico enrico   4096 giu 24 20:47 ./
+drwxrwxr-x 7 root   enrico   4096 giu 24 18:37 ../
+drwxr-xr-x 3 root   root     4096 giu 24 20:11 ADD_FOUR/
+-rw-r--r-- 1 root   root     2599 giu 24 20:47 ADD_FOUR.json
+-rw-r--r-- 1 root   root   124315 giu 24 20:47 ADD_FOUR.qgs
+drwxr-xr-x 3 root   root     4096 giu 24 20:04 ADD_THREE/
+-rw-r--r-- 1 root   root     2157 giu 24 20:11 ADD_THREE.json
+-rw-r--r-- 1 root   root   124322 giu 24 20:05 ADD_THREE.qgs
+drwxr-xr-x 3 root   root     4096 giu 24 19:21 ADD_TWO/
+-rw-r--r-- 1 root   root     2051 giu 24 20:02 ADD_TWO.json
+-rw-r--r-- 1 root   root   124308 giu 24 19:50 ADD_TWO.qgs
+drwxr-xr-x 3 root   root     4096 giu 24 18:43 REPO_TEST/
+-rw-r--r-- 1 root   root     1604 giu 24 19:50 REPO_TEST.json
+-rw-r--r-- 1 root   root   115007 giu 24 19:50 REPO_TEST_pub.qgs
+```
+
+Each kart version has a control form where can be configured custom features and user permissions (based on django user model), can be performed repository operation such commits, merge, etc.., and can be visually tracked edits on map ad on commit log
+
+![](doc/screenshot04.png)
+
+In the Version form can be downloaded  a custom QGIS project preloaded with internal postgis kart working copy of the repository. 
+
+The default connection to postgis kart working copy are performed as `kart-user` a simple predefined user allowed only to read data fron db. To allow edits QGIS macros have to be allowed (project macros can be always allowed in Settings/options/General/Enable macros slot) When macros are allowed a credential form appears and can be inserted the read and write default user (from .env file): 
+
+```
+login: kart-admin
+password: ch1appalaCH!APPAL4
+```
+
+![](doc/screenshot05.png)
+
+All edits will be visible in djakart application as a custom kart diff window clicking on log items
+
+![](doc/screenshot06.png)
+
+now to fully test the application:
+
+- commit the pending edits on the version "ADD_TWO" 
+
+  ![](doc/screenshot07.png)
+
+- merge the version "ADD_TWO" on "REPO_TEST"
+
+- merge the version "ADD_FOUR" on "ADD_THREE"
+
+- and now merge the version "ADD_THREE" on "REPO_TEST"
+
+at this point the last merge results conflicting with the main repo and the conflicts have to be reconciled with "RECONCILE CONFLICTS"action
+
+![](doc/screenshot08.png)
+
+for each conflict you have now to choice the winning edit from ours and theirs concurrent merging versions
+
+![](doc/screenshot09.png)

dist/djakart-0.1.tar.gz

@@ -0,0 +1,49 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+djakart/QGS_project_macro.py
+djakart/__init__.py
+djakart/admin.py
+djakart/aggiorna_privilegi_pg.py
+djakart/apps.py
+djakart/importa_template.py
+djakart/kart_api.py
+djakart/models.py
+djakart/prototipo.gpkg
+djakart/tests.py
+djakart/urls.py
+djakart/views.py
+djakart.egg-info/PKG-INFO
+djakart.egg-info/SOURCES.txt
+djakart.egg-info/dependency_links.txt
+djakart.egg-info/requires.txt
+djakart.egg-info/top_level.txt
+djakart/migrations/0001_initial.py
+djakart/migrations/0002_basemap.py
+djakart/migrations/0003_basemap_depth_basemap_srid.py
+djakart/migrations/0004_alter_modelli_options_version_extent_and_more.py
+djakart/migrations/0005_version_crs_alter_basemap_request_params_and_more.py
+djakart/migrations/0006_version_reserved_ids_alter_version_crs_and_more.py
+djakart/migrations/__init__.py
+djakart/static/favicon.ico
+djakart/static/djakart/generate_diff.js
+djakart/static/djakart/versioni_finestramappa.css
+djakart/static/djakart/versioni_finestramappa.js
+djakart/templates/diff-view.html
+djakart/templates/log.html
+djakart/templates/tutte_le_versioni.js
+djakart/templates/admin/action_confirmation.html
+djakart/templates/admin/action_file.html
+djakart/templates/admin/action_parameter.html
+djakart/templates/admin/resolve_conflicts.html
+djakart/templates/admin/djakart/change_form.html
+doc/screenshot01.png
+doc/screenshot02.png
+doc/screenshot03.png
+doc/screenshot04.png
+doc/screenshot05.png
+doc/screenshot06.png
+doc/screenshot07.png
+doc/screenshot08.png
+doc/screenshot09.png

djakart.egg-info/PKG-INFO

@@ -0,0 +1 @@
+

djakart.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+django>=4.0
+asgiref
+certifi
+charset-normalizer
+django-object-actions
+GDAL>=3.4.3
+idna
+numpy
+psycopg2-binary
+requests
+sqlparse
+urllib3

djakart.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+djakart

djakart.egg-info/requires.txt

@@ -36,10 +36,8 @@
     pull_versione,
     kart_cmd
 )
-#SRID = os.environ.get("REPO_CRS")
-#SRID_CODE = SRID.split(":")[1]
 
-SITE_SUBPATH = os.environ.get("SITE_SUBPATH","")
+SITE_SUBPATH = settings.DJAKART_SITE_SUBPATH
 
 class importForm(forms.Form):
     nuovo_dataset = forms.FileField()
@@ -184,7 +182,7 @@ def wrapper(modeladmin, request, obj, **kwargs):
                         "conflicts":  json.dumps(conflicts), 
                         "crs": obj.crs,
                         "crscode": obj.crs.split(":")[-1],
-                        "root_wms":os.environ.get("QGIS_SERVER_EXTERNAL","qgis_server_external") + '?MAP=/kart_versions/', 
+                        "root_wms":settings.DJAKART_QGIS_SERVER_EXTERNAL + '?MAP=/kart_versions/', 
                         "base_name":obj.nome,
                         "version_name":version_name,
                         "version_id": obj.pk,

djakart.egg-info/top_level.txt

@@ -11,34 +11,36 @@
 import sys
 import psycopg2
 
-KART_EXE = "/opt/kart/kart_cli"
+KART_EXE = settings.DJAKART_KART_EXE
 
-PG_SU = os.environ.get("POSTGRES_USER", "blabla")
-PG_PWD = os.environ.get("POSTGRES_PASSWORD", "blabla")
+PG_HOST = settings.DJAKART_POSTGRES_SERVER
+PG_PORT = settings.DJAKART_POSTGRES_PORT
+PG_DB = settings.DJAKART_VERSION_DB
+PG_SU = settings.DJAKART_POSTGRES_USER
+PG_PWD = settings.DJAKART_POSTGRES_PASSWORD
 
-KART_SU = os.environ.get("VERSION_ADMIN", "blabla")
-KART_SU_PWD = os.environ.get("VERSION_ADMIN_PASSWORD", "blabla")
+KART_SU = settings.DJAKART_VERSION_ADMIN
+KART_SU_PWD = settings.DJAKART_VERSION_ADMIN_PASSWORD
 
-KART_PGUSER = os.environ.get("VERSION_VIEWER", "blabla")
-KART_PGUSER_PWD = os.environ.get("VERSION_VIEWER_PASSWORD", "blabla")
+KART_PGUSER = settings.DJAKART_VERSION_VIEWER
+KART_PGUSER_PWD = settings.DJAKART_VERSION_VIEWER_PASSWORD
 
-SITE_SUBPATH = os.environ.get("SITE_SUBPATH", "")
+SITE_SUBPATH = settings.DJAKART_SITE_SUBPATH
 
-SRID = os.environ.get("REPO_CRS")
+SRID = settings.DJAKART_SRID
 SRID_CODE = SRID.split(":")[1]
 
 
 def get_pg_versions_connection():
     connection = psycopg2.connect(
-        database=os.environ.get("VERSION_DB", "blabla"),
-        user=os.environ.get("POSTGRES_USER", "blabla"),
-        password=os.environ.get("POSTGRES_PASSWORD", "blabla"),
-        host=os.environ.get("POSTGRES_SERVER", "blabla"),
-        port=os.environ.get("POSTGRES_PORT", "blabla")
+        database = settings.DJAKART_VERSION_DB,
+        user = PG_SU,
+        password = PG_PWD,
+        host = settings.DJAKART_POSTGRES_SERVER,
+        port = settings.DJAKART_POSTGRES_PORT,
     )
     return connection
 
-
 class KartException(Exception):
     pass
 
@@ -225,9 +227,9 @@ def crea_nuovo_repository(repo_name,bare=True,readonly_workingcopy=None):
         cmds.append("postgresql://{user}:{password}@{host}:{port}/{db}/{schema}".format(
             user=PG_SU,
             password=PG_PWD,
-            host=os.environ.get("POSTGRES_SERVER",'pgserver'),
-            port=os.environ.get("POSTGRES_PORT",'pgport'),
-            db=os.environ.get("VERSION_DB",'pgdb'),
+            host=PG_HOST,
+            port=PG_PORT,
+            db=PG_DB,
             schema=readonly_workingcopy
         ))
     if bare:
@@ -268,9 +270,9 @@ def get_pg_uri(v):
     return "postgresql://{user}:{password}@{host}:{port}/{db}/{schema}".format(
             user=PG_SU,
             password=PG_PWD,
-            host=os.environ.get("POSTGRES_SERVER",'pgserver'),
-            port=os.environ.get("POSTGRES_PORT",'pgport'),
-            db=os.environ.get("VERSION_DB",'pgdb'),
+            host=PG_HOST,
+            port=PG_PORT,
+            db=PG_DB,
             schema=v
         )