# zserver

**Repository Path**: mrcaobin/zserver

## Basic Information

- **Project Name**: zserver
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-05-17
- **Last Updated**: 2024-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# zserver

基于 Actor 模型实现的分布式计算地图服务器，符合 OpenGIS Web 的服务器规范

[![Docker Image CI](https://github.com/zmaplab/zserver/actions/workflows/docker-image.yml/badge.svg)](https://github.com/zmaplab/zserver/actions/workflows/docker-image.yml)

![DESIGN IMAGE](https://github.com/zmaplab/zserver/blob/main/img/design.jpg?raw=true)

## 开发说明

### 环境依赖

+ Docker

```
https://docs.docker.com/engine/install/
```

+ PostgreSQL + PostGIS

```
docker run --name postgis -p 5432:5432 -e POSTGRES_PASSWORD=1qazZAQ! -d postgis/postgis
```

+ dotnet sdk 7.0 或以上

```
https://dotnet.microsoft.com/download
```

+ nodejs

```
https://nodejs.org/zh-cn/
```

+ Parcel

```
yarn global add parcel-bundler 或者 npm install -g parcel-bundler
```

### 启动步骤

#### 安装 PostgreSQL
```
docker run --name postgis -p 5432:5432 -e POSTGRES_PASSWORD=1qazZAQ! -d postgis/postgis
```
#### 创建数据库并添加 postgis 扩展

```
create database zserver_dev;
create extension postgis;
```
#### 上传 Demo 数据

通过 QGIS/ArcGIS 打开 src/ZServer.API/shapes/polygon.shp 并上传到 zserver_dev 数据库中， 表名为 polygon

#### 启动 ZServer.API

##### 单机模式

```
dotnet run --Standalone true --ClusterDashboard true --ClusterDashboardPort 8182 --Port 8200
```

##### 集群模式

```
cd src/ZServer.API
dotnet run --Standalone false --ClusterSiloPort 10001 --ClusterGatewayPort 20001 --ClusterDashboard true --ClusterDashboardPort 8181 --Port 8100
dotnet run --Standalone false --ClusterSiloPort 10002 --ClusterGatewayPort 20002 --ClusterDashboard true --ClusterDashboardPort 8182 --Port 8200
```
+ 启动 Web

```
1. 用 VSC 打开 src/Web 后
2. 在终端 yarn install
3. 在终端 yarn dev
```

+ 访问 localhost:3000 切换 wmts wms 测试查看效果

##### docker-compose

```
version: "3"
networks:
  net:
    driver: bridge
    ipam:
      config:
        - subnet: 172.50.0.0/16
volumes:          
  zserver_api_conf:
    driver: local
    driver_opts:
      o: bind
      type: none
      device: /DataDisk/zserver-api/conf
  zserver_api_cache:
    driver: local
    driver_opts:
      o: bind
      type: none
      device: /DataDisk/zserver-api/cache             
  zserver_api_symbols:
    driver: local
    driver_opts:
      o: bind
      type: none
      device: /DataDisk/zserver-api/Symbols       
  zserver_api_fonts:
    driver: local
    driver_opts:
      o: bind
      type: none
      device: /DataDisk/zserver-api/Fonts      
  zserver_api_shapes:
    driver: local
    driver_opts:
      o: bind
      type: none
      device: /DataDisk/zserver-api/shapes
  zserver_api_sld:
    driver: local
    driver_opts:
      o: bind
      type: none
      device: /DataDisk/zserver-api/sld
services:
  zserver-api:
    image: "zlzforever/zserver-api:latest"
    restart: always
    ports:
      - 8200:8200
      - 8201:8182
      - 41113:41113
      - 31113:31113
    volumes:
      - zserver_api_conf:/app/conf
      - zserver_api_cache:/app/cache
      - zserver_api_symbols:/app/Symbols
      - zserver_api_fonts:/app/fonts
      - zserver_api_shapes:/app/shapes
      - zserver_api_sld:/app/sld
    environment:
      - PORT=8200
      - standalone=false
      - ClusterDashboard=true
      - ClusterDashboardPort=8182
      - HOST_IP=192.168.0.244
      - TZ=Asia/Shanghai      
      - EnableSensitiveDataLogging=false
```

## Roadmap

### 1.0 

1. 完整 OGC 规范的 WMS 服务
2. 完整 OGC 规范的 WMTS 服务（实时渲染）
3. SLD 的支持

### 2.0 

1. 管理界面
2. 支持影像数据的实时渲染/切片
3. 数据基本操作接口(CRUD）
4. 图形操作（切割、合并、相交）等
5. 过滤条件

``` JSON
{
  Logic: 'And',
  Filters:
  [
    { Field: 'id', Operator: 'Equals', Value: 1 },
    {
      Logic: 'Or',
      Filters:
      [
        { Field: 'id', Operator: 'Equals', Value: 2 },
        {
            Field: '{{ DynamicFilterCustomImpl.CustomLinq }}', 
            Operator: 'Custom', 
            Value: 'Title.StartsWith(\'new topic 1\')'
        }
      ]
    }
  ]
}
```