Version 1.0.0

.flake8

@@ -0,0 +1,9 @@
+[flake8]
+exclude = */docs/*,*/.tox/*,*/.venv/*,.pycharm_helpers/*,*/migrations/*,docs/*,*/__init__.py,scripts/*,deployment/*,django_project/initialize.py
+max-line-length = 79
+
+# E12x continuation line indentation
+# E251 no spaces around keyword / parameter equals
+# E303 too many blank lines (3)
+# F405 name may be undefined, or defined from star imports: module
+ignore = E125,E126,E251,E303,F405,W504,W605,F901,D105

.github/ISSUE_TEMPLATE/bug-report--alcis-azure-.md

@@ -0,0 +1,52 @@
+[//]: # "GeoSight is UNICEF's geospatial web-based business intelligence platform."
+[//]: # 
+[//]: # "Contact : [email protected]"
+[//]: # 
+[//]: # ".. note:: This program is free software; you can redistribute it and/or modify"
+[//]: # " it under the terms of the GNU Affero General Public License as published by"
+[//]: # " the Free Software Foundation; either version 3 of the License, or"
+[//]: # " (at your option) any later version."
+[//]: # 
+[//]: # "__author__ = '[email protected]'"
+[//]: # "__date__ = '13/06/2023'"
+[//]: # "__copyright__ = ('Copyright 2023, Unicef')"
+[//]: # "__copyright__ = ('Copyright 2023, Unicef')"
+
+---
+name: Bug report (Alcis Azure)
+about: Create a report to help us improve
+title: "[ALCIS AZURE] "
+labels: ALCIS AZURE
+assignees: AhmedSGIS, meomancer
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,52 @@
+[//]: # "GeoSight is UNICEF's geospatial web-based business intelligence platform."
+[//]: # 
+[//]: # "Contact : [email protected]"
+[//]: # 
+[//]: # ".. note:: This program is free software; you can redistribute it and/or modify"
+[//]: # " it under the terms of the GNU Affero General Public License as published by"
+[//]: # " the Free Software Foundation; either version 3 of the License, or"
+[//]: # " (at your option) any later version."
+[//]: # 
+[//]: # "__author__ = '[email protected]'"
+[//]: # "__date__ = '13/06/2023'"
+[//]: # "__copyright__ = ('Copyright 2023, Unicef')"
+[//]: # "__copyright__ = ('Copyright 2023, Unicef')"
+
+---
+name: Bug report
+about: Create a report to help us improve
+title: "[BUG] "
+labels: ":bug: bug"
+assignees: meomancer
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,34 @@
+[//]: # "GeoSight is UNICEF's geospatial web-based business intelligence platform."
+[//]: # 
+[//]: # "Contact : [email protected]"
+[//]: # 
+[//]: # ".. note:: This program is free software; you can redistribute it and/or modify"
+[//]: # " it under the terms of the GNU Affero General Public License as published by"
+[//]: # " the Free Software Foundation; either version 3 of the License, or"
+[//]: # " (at your option) any later version."
+[//]: # 
+[//]: # "__author__ = '[email protected]'"
+[//]: # "__date__ = '13/06/2023'"
+[//]: # "__copyright__ = ('Copyright 2023, Unicef')"
+[//]: # "__copyright__ = ('Copyright 2023, Unicef')"
+
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/dependabot.yml

@@ -0,0 +1,30 @@
+# GeoSight is UNICEF's geospatial web-based business intelligence platform.
+#
+# Contact : [email protected]
+#
+# .. note:: This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# __author__ = '[email protected]'
+# __date__ = '13/06/2023'
+# __copyright__ = ('Copyright 2023, Unicef')
+
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+- package-ecosystem: pip
+ directory: "deployment"
+ schedule:
+ interval: "daily"
+ labels:
+ - dependencies
+ ignore:
+ - dependency-name: Django
+ versions:
+ - ">= 3.2.13"

.github/workflows/BuildMKDocsAndPublishToGithubPages.yml

@@ -0,0 +1,53 @@
+# GeoSight is UNICEF's geospatial web-based business intelligence platform.
+#
+# Contact : [email protected]
+#
+# .. note:: This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# __author__ = '[email protected]'
+# __date__ = '13/06/2023'
+# __copyright__ = ('Copyright 2023, Unicef')
+
+name: 📖 Build MKDocs And Publish To Github Pages.yml
+on:
+ push:
+ branches:
+ - main
+ # Paths can be used to only trigger actions when you have edited certain files, such as a file within the /docs directory
+ paths:
+ - ".github/workflows/BuildMKDocsAndPublishToGithubPages.yml"
+ - "docs/**.md"
+ - "docs/assets/**"
+ # Allow manually running in the actions tab
+ workflow_dispatch:
+
+jobs:
+ build:
+ name: Deploy docs
+ runs-on: ubuntu-latest
+ steps:
+ - name: Install dependencies
+ uses: BSFishy/pip-action@v1
+ with:
+ packages: |
+ mkdocs-material 
+ qrcode
+ - name: Checkout main from github
+ uses: actions/checkout@v1
+ - name: Create Mkdocs Config 🚀
+ working-directory: ./docs
+ run: ./create-mkdocs-html-config.sh
+ - name: Deploy docs to github pages
+ # This is where we get the material theme from
+ uses: mhausenblas/mkdocs-deploy-gh-pages@master
+ # Wrong
+ #uses: timlinux/QGISAnimationWorkbench@main
+ env:
+ # Read this carefully:
+ # https://github.com/marketplace/actions/deploy-mkdocs#building-with-github_token
+ # The token is automatically generated by the GH Action
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+ CONFIG_FILE: docs/mkdocs.yml

.github/workflows/CompileMKDocsToPDF.yml

@@ -0,0 +1,50 @@
+# GeoSight is UNICEF's geospatial web-based business intelligence platform.
+#
+# Contact : [email protected]
+#
+# .. note:: This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# __author__ = '[email protected]'
+# __date__ = '13/06/2023'
+# __copyright__ = ('Copyright 2023, Unicef')
+
+name: 📔 Compile MKDocs to PDF
+# This workflow is triggered on pushes to the repository.
+on:
+ push:
+ branches:
+ - main
+ # Paths can be used to only trigger actions when you have edited certain files, such as a file within the /docs directory
+ paths:
+ - ".github/workflows/CompileMKDocsToPDF.yml"
+ - "docs/**.md"
+ - "docs/assets/**"
+ # Allow manually running in the actions tab
+ workflow_dispatch:
+
+jobs:
+ generatepdf:
+ name: Build PDF
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout 🛒
+ uses: actions/checkout@v2
+ - name: Create Mkdocs Config 🚀
+ working-directory: ./docs
+ run: ./create-mkdocs-pdf-config.sh
+ - name: Build PDF 📃
+ uses: kartoza/mkdocs-deploy-build-pdf@master
+ # Uses orzih's mkdocs PDF builder
+ # https://github.com/orzih/mkdocs-with-pdf
+ env:
+ CONFIG_FILE: mkdocs.yml
+ EXTRA_PACKAGES: build-base
+ #REQUIREMENTS: folder/requirements.txt
+ - name: Upload PDF Artifact ⚡
+ uses: actions/upload-artifact@v3
+ with:
+ name: docs
+ path: docs/pdfs

.github/workflows/flake8.yml

@@ -0,0 +1,42 @@
+# GeoSight is UNICEF's geospatial web-based business intelligence platform.
+#
+# Contact : [email protected]
+#
+# .. note:: This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# __author__ = '[email protected]'
+# __date__ = '13/06/2023'
+# __copyright__ = ('Copyright 2023, Unicef')
+
+name: Flake8
+
+on:
+ push:
+ paths:
+ - '**.py'
+
+jobs:
+ flake8_py3:
+ name: Python Lint
+ runs-on: ubuntu-latest
+ steps:
+ - name: Setup Python
+ uses: actions/setup-python@v1
+ with:
+ python-version: 3.7
+ architecture: x64
+ - name: Checkout PyTorch
+ uses: actions/checkout@master
+ - name: Install flake8
+ run: pip install flake8
+ - name: Install flake8-docstrings
+ run: pip install flake8-docstrings
+ - name: Run flake8
+ uses: suo/flake8-github-action@releases/v1
+ with:
+ checkName: 'Python Lint' # NOTE: this needs to be the same as the job name
+ env:
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/tests.yaml

@@ -0,0 +1,55 @@
+# GeoSight is UNICEF's geospatial web-based business intelligence platform.
+#
+# Contact : [email protected]
+#
+# .. note:: This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# __author__ = '[email protected]'
+# __date__ = '13/06/2023'
+# __copyright__ = ('Copyright 2023, Unicef')
+
+name: Tests
+
+on: [ push ]
+
+jobs:
+ django_app_test:
+ name: 'Django App'
+ runs-on: ubuntu-latest
+ env:
+ APP_IMAGE: kartoza/geosight
+ steps:
+ - uses: actions/checkout@v2
+ - name: Set up QEMU
+ uses: docker/setup-qemu-action@v1
+ - name: Set up Docker Buildx
+ uses: docker/setup-buildx-action@v1
+
+ - name: Build test image
+ uses: docker/build-push-action@v2
+ with:
+ context: .
+ file: deployment/docker/Dockerfile
+ push: false
+ load: true
+ target: dev
+ tags: ${{ env.APP_IMAGE }}:dev
+ cache-from: |
+ type=gha,scope=test
+ type=gha,scope=prod
+ cache-to: type=gha,scope=test
+
+ - name: Run docker-compose services
+ working-directory: deployment
+ run: |
+ echo "Override docker-compose for testing purposes"
+ cp docker-compose.test.yml docker-compose.override.yml
+ cd ../
+ make devweb
+ make wait-db
+ make sleep
+ make create-test-db
+ make devweb-test