Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/suizer98/deckglgis
A project to show POC of volume computation for open pit mine 3D model using web technologies.
https://github.com/suizer98/deckglgis
3d-models deckgl django docker geoserver geospatial geotiff gis postgis reactts
Last synced: 4 days ago
JSON representation
A project to show POC of volume computation for open pit mine 3D model using web technologies.
- Host: GitHub
- URL: https://github.com/suizer98/deckglgis
- Owner: Suizer98
- Created: 2024-08-25T03:47:50.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-11-07T09:03:14.000Z (7 days ago)
- Last Synced: 2024-11-07T10:18:49.598Z (7 days ago)
- Topics: 3d-models, deckgl, django, docker, geoserver, geospatial, geotiff, gis, postgis, reactts
- Language: TypeScript
- Homepage:
- Size: 26.2 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# DeckGLGIS
A project to show POC of volume computation happening in ReactTS + DeckGL Web app for CrystallBall company. Backend is comprise of Django + Geoserver + Postgres.
Demo GIF here:
Frontend:
Backend:
## Local developments
In the project directory, you can either prepare below for local developments:
1. Node.js
2. Docker Desktop + wsl2 (Ubuntu recommended)
### NPM commands
Runs the app in the development mode. Open [http://localhost:3000/](http://localhost:3000/) to view it in the browser.
```
npm install
npm run dev
```
The page will reload if you make edits.
You will also see any lint errors in the console.
### Typing issues message
The `Vite Checker` is constantly checking if any typing issues exist in
our TypeScript codes by prompting messages in runtime.
### Found issues in code style?
To fix all formatting and linting using `prettier`:
```
npm run format
```
### Check if build error exists?
To see if any errors prevent production build compilation:
```
npm run build
```
### Prepare enviroment variables for app use
To define env, create an `.env` file:
`VITE_APP_API_BASE_PATH`: The backend api to point to, for example `http://localhost:8000/api`
`VITE_APP_API_GEOSERVER`: Point to `http://localhost:8080/geoserver/`
### Generating code from the OpenAPI 3.0 schemas of the backends
To ensure that we test consistent with the latest backend changes, we grab the latest apis via its provided OpenAPI 3.0 spec.
#### Generating mocks from the backend using `openapi client generator`
Command below will ensure that we have up-to-date mocks of the backend:
```
npm run gnerate-api
```
## Docker compose commands
If you have Docker Desktop or relavant installed on your machine, you can run:
```
docker-compose up --build
docker compose exec deckglgis npx prettier --cache --write .
```
### Running full profile backend
First fetch the backend as submodule:
```
git submodule init
git submodule update
```
Then, make sure you create appropriate env files for both frontend and backend,
in their respective folder and run full profile build:
```
docker-compose --profile full up --build
```