Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 26 additions & 0 deletions .github/workflows/test-suite.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
name: Test suite

"on":
pull_request:
push:
branches:
- main

permissions:
contents: read

concurrency:
group: test-suite-${{ github.ref }}
cancel-in-progress: true

jobs:
repository-contracts:
name: Static repository contracts
runs-on: windows-latest
timeout-minutes: 10
steps:
- name: Check out repository
uses: actions/checkout@v7
- name: Run static test profile
shell: powershell
run: .\tests\run-suite.ps1 -Profile static
38 changes: 21 additions & 17 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,7 @@ The repository had no tags or GitHub Releases before this file was introduced. T
- A Natural Earth 110m/50m/10m vector PMTiles overview with land, water, boundaries, places, roads, railways, and rivers through zoom 7.
- Region-aware elevation synchronization backed by AWS Open Data Terrain Tiles, with retained HGT manifests and maintenance progress.
- ETag-backed map-pack and boundary responses, deferred catalog loading, cache warming, and a browser performance smoke test.
- A machine-readable test-case catalog and unified `static`, `browser`, `full`, and `recovery` profiles, with static contracts running automatically on GitHub pull requests.

### Fixed

Expand All @@ -25,17 +26,20 @@ The repository had no tags or GitHub Releases before this file was introduced. T
- Deduplicated overlapping regional OSM objects before Carto, search, and routing builds.
- Prevented map panning from rebuilding the complete MapLibre style or hiding installed layers still inside the viewport.
- Replaced rectangular country guesses with precise country polygons, including antimeridian handling, and suppressed low-zoom false download prompts.
- Normalized map-package prompts, resource names, feature details, and world-overview labels to display `台湾省` consistently.
- Normalized the weather JQ program to LF before mounting it into Linux containers, preventing repeated first-run failures for newly installed country packages on a Windows checkout.
- Normalized container-mounted shell scripts, waited for local Carto assets to become ready, and constrained heavy builds for a 16 GiB host.

### Improved

- Accelerated terrain tile generation by loading each required HGT grid once per row group instead of once per pixel.
- Minified the generated global catalog without changing its 547 browse regions or 554 buildable datasets, and enabled nginx compression and explicit config revalidation.
- Expanded world-map regression coverage for Carto lag, vector fallback, global movement, country selection, and persistent overview rendering.
- Added static JSON/PowerShell, bilingual-document parity, relative-link, browser-image completeness, and performance-baseline checks.

## M0.9 — Local OSM Carto rendering and cache reliability

- **Commit:** [`d360249`](https://github.com/bd4rex/personal-gis/commit/d360249de86110511eb7ae5f49e8237d810f5d96)
- **Commit:** [`d360249`](https://github.com/bd4rex/TerraSys/commit/d360249de86110511eb7ae5f49e8237d810f5d96)
- **Timestamp:** `2026-08-04T16:22:49+08:00`
- **Git status at the time:** direct `main` commit; no tag or Release

Expand All @@ -47,9 +51,9 @@ The repository had no tags or GitHub Releases before this file was introduced. T

## M0.8 — Automatic regional strategy propagation

- **Commit:** [`6daeff6`](https://github.com/bd4rex/personal-gis/commit/6daeff6458177b6aa6b4f2ad1fe0dc4640027653)
- **Commit:** [`6daeff6`](https://github.com/bd4rex/TerraSys/commit/6daeff6458177b6aa6b4f2ad1fe0dc4640027653)
- **Timestamp:** `2026-08-04T07:39:54+08:00`
- **Merged by:** [PR #7](https://github.com/bd4rex/personal-gis/pull/7)
- **Merged by:** [PR #7](https://github.com/bd4rex/TerraSys/pull/7)

### Added

Expand Down Expand Up @@ -85,7 +89,7 @@ The repository had no tags or GitHub Releases before this file was introduced. T

## M0.7 — Storage ownership and offline-map lifecycle

- **Commit:** [`b2a6503`](https://github.com/bd4rex/personal-gis/commit/b2a6503304fbea851a968d7cdabeddb1b7e1a81c)
- **Commit:** [`b2a6503`](https://github.com/bd4rex/TerraSys/commit/b2a6503304fbea851a968d7cdabeddb1b7e1a81c)
- **Timestamp:** `2026-08-03T18:13:25+08:00`
- **Git status at the time:** direct `main` commit; no tag or Release

Expand All @@ -103,23 +107,23 @@ The repository had no tags or GitHub Releases before this file was introduced. T
- Compacted Docker storage after pruning unused volumes, images, and renewable cache.
- Expanded resource-console status, task actions, tests, and honest progress reporting.

## M0.6 — GIS_P identity and default workspace
## M0.6 — TerraSys identity and default workspace

- **Commit:** [`c1de372`](https://github.com/bd4rex/personal-gis/commit/c1de372c6d69cc5ddf77d409438c4a06bf012d2e)
- **Commit:** [`c1de372`](https://github.com/bd4rex/TerraSys/commit/c1de372c6d69cc5ddf77d409438c4a06bf012d2e)
- **Timestamp:** `2026-08-02T14:38:57+08:00`
- **Merged by:** [PR #5](https://github.com/bd4rex/personal-gis/pull/5)
- **Merged by:** [PR #5](https://github.com/bd4rex/TerraSys/pull/5)

### Changed

- Renamed the user-facing product from GISS to GIS_P while retaining compatibility identifiers.
- Renamed the user-facing product from TerraSys to TerraSys while retaining compatibility identifiers.
- Made the map open with the side panel collapsed and synchronized focus, ARIA, animation, and coverage state.
- Separated shared-index coverage completeness from exact scope freshness.

## M0.5 — Product requirements baseline

- **Commit:** [`a6309f8`](https://github.com/bd4rex/personal-gis/commit/a6309f84085b0f8bc6295c444bfd26370b933844)
- **Commit:** [`a6309f8`](https://github.com/bd4rex/TerraSys/commit/a6309f84085b0f8bc6295c444bfd26370b933844)
- **Timestamp:** `2026-08-02T08:07:31+08:00`
- **Merged by:** [PR #4](https://github.com/bd4rex/personal-gis/pull/4)
- **Merged by:** [PR #4](https://github.com/bd4rex/TerraSys/pull/4)

### Added

Expand All @@ -128,9 +132,9 @@ The repository had no tags or GitHub Releases before this file was introduced. T

## M0.4 — D-drive Docker storage cleanup record

- **Commit:** [`cd28db5`](https://github.com/bd4rex/personal-gis/commit/cd28db5cde78b6dcdb78a962c3b8923de8e61491)
- **Commit:** [`cd28db5`](https://github.com/bd4rex/TerraSys/commit/cd28db5cde78b6dcdb78a962c3b8923de8e61491)
- **Timestamp:** `2026-08-02T07:53:13+08:00`
- **Merged by:** [PR #3](https://github.com/bd4rex/personal-gis/pull/3)
- **Merged by:** [PR #3](https://github.com/bd4rex/TerraSys/pull/3)

### Improved

Expand All @@ -139,9 +143,9 @@ The repository had no tags or GitHub Releases before this file was introduced. T

## M0.3 — Map-source controls and live coverage

- **Commit:** [`725ae42`](https://github.com/bd4rex/personal-gis/commit/725ae424c7cb00b86733ebdf2b025ace30d8cf0a)
- **Commit:** [`725ae42`](https://github.com/bd4rex/TerraSys/commit/725ae424c7cb00b86733ebdf2b025ace30d8cf0a)
- **Timestamp:** `2026-08-02T03:20:56+08:00`
- **Merged by:** [PR #2](https://github.com/bd4rex/personal-gis/pull/2)
- **Merged by:** [PR #2](https://github.com/bd4rex/TerraSys/pull/2)

### Added

Expand All @@ -155,9 +159,9 @@ The repository had no tags or GitHub Releases before this file was introduced. T

## M0.2 — Offline GIS platform expansion

- **Commit:** [`9d2ea5d`](https://github.com/bd4rex/personal-gis/commit/9d2ea5d29a1e3b7bd4cf0717e6ebe2606c11d3d6)
- **Commit:** [`9d2ea5d`](https://github.com/bd4rex/TerraSys/commit/9d2ea5d29a1e3b7bd4cf0717e6ebe2606c11d3d6)
- **Timestamp:** `2026-08-02T02:42:50+08:00`
- **Merged by:** [PR #1](https://github.com/bd4rex/personal-gis/pull/1)
- **Merged by:** [PR #1](https://github.com/bd4rex/TerraSys/pull/1)

### Added

Expand All @@ -174,7 +178,7 @@ The repository had no tags or GitHub Releases before this file was introduced. T

## M0.1 — Initial personal GIS publication

- **Commit:** [`aa76756`](https://github.com/bd4rex/personal-gis/commit/aa76756ad887590574cdd622b4a2133f4dafc7ba)
- **Commit:** [`aa76756`](https://github.com/bd4rex/TerraSys/commit/aa76756ad887590574cdd622b4a2133f4dafc7ba)
- **Timestamp:** `2026-08-01T18:44:56+08:00`
- **Git status at the time:** initial repository commit; no tag or Release

Expand Down
38 changes: 21 additions & 17 deletions CHANGELOG.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,7 @@
- Natural Earth 110m/50m/10m 多级矢量 PMTiles,在 z0-7 提供陆地、水体、边界、地名、道路、铁路和河流。
- 基于 AWS Open Data Terrain Tiles 的按区域高程同步,长期保留 HGT 清单并显示维护进度。
- 带 ETag 的地图包/边界缓存响应、延迟目录加载、缓存预热和浏览器性能冒烟测试。
- 机器可读测试用例目录和 `static`、`browser`、`full`、`recovery` 四层统一测试入口,并在 GitHub PR 上自动执行静态契约。

### 修复

Expand All @@ -25,17 +26,20 @@
- 在 Carto、搜索和路线构建前去除区域重叠边界产生的重复 OSM 对象。
- 地图平移不再重建整套 MapLibre 样式,也不会隐藏仍在视口内的已安装图层。
- 使用精确国界多边形替代矩形国家范围猜测,支持跨日期变更线,并抑制低缩放级别的错误下载提示。
- 地图包提示、资源名称、要素详情及全球概览标签统一使用“台湾省”。
- 天气同步在挂载进 Linux 容器前把 JQ 程序规范化为 LF,避免新增国家包首次生成天气点时因 Windows CRLF 持续失败。
- 规范化挂载到容器的 Shell 脚本、等待本地 Carto 资源服务就绪,并为 16 GiB 主机限制重型构建资源。

### 改进

- 每个行组只加载一次所需 HGT,替代逐像素重复加载,加快地形瓦片生成。
- 在不改变 547 个浏览区域和 554 个可构建数据集的前提下压缩全球目录,并启用 nginx 压缩和配置重新验证。
- 扩展全球地图回归测试,覆盖 Carto 延迟、矢量回退、全球平移、国家选择和持续概览显示。
- 加入 JSON/PowerShell、双语文档对等、相对链接、浏览器镜像完整性和性能基线静态检查。

## M0.9 — 本地 OSM Carto 渲染与缓存可靠性

- **提交:** [`d360249`](https://github.com/bd4rex/personal-gis/commit/d360249de86110511eb7ae5f49e8237d810f5d96)
- **提交:** [`d360249`](https://github.com/bd4rex/TerraSys/commit/d360249de86110511eb7ae5f49e8237d810f5d96)
- **时间:** `2026-08-04T16:22:49+08:00`
- **当时状态:** 直接提交到 `main`,没有 tag 或 Release

Expand All @@ -47,9 +51,9 @@

## M0.8 — 区域策略自动推广

- **提交:** [`6daeff6`](https://github.com/bd4rex/personal-gis/commit/6daeff6458177b6aa6b4f2ad1fe0dc4640027653)
- **提交:** [`6daeff6`](https://github.com/bd4rex/TerraSys/commit/6daeff6458177b6aa6b4f2ad1fe0dc4640027653)
- **时间:** `2026-08-04T07:39:54+08:00`
- **合并:** [PR #7](https://github.com/bd4rex/personal-gis/pull/7)
- **合并:** [PR #7](https://github.com/bd4rex/TerraSys/pull/7)

### 新增

Expand Down Expand Up @@ -85,7 +89,7 @@

## M0.7 — 存储所有权与离线地图生命周期

- **提交:** [`b2a6503`](https://github.com/bd4rex/personal-gis/commit/b2a6503304fbea851a968d7cdabeddb1b7e1a81c)
- **提交:** [`b2a6503`](https://github.com/bd4rex/TerraSys/commit/b2a6503304fbea851a968d7cdabeddb1b7e1a81c)
- **时间:** `2026-08-03T18:13:25+08:00`
- **当时状态:** 直接提交到 `main`,没有 tag 或 Release

Expand All @@ -103,23 +107,23 @@
- 清理无用卷、镜像和可再生缓存后压缩 Docker 存储。
- 扩展资源页面状态、任务操作、测试和真实进度显示。

## M0.6 — GIS_P 品牌与默认工作区
## M0.6 — TerraSys 品牌与默认工作区

- **提交:** [`c1de372`](https://github.com/bd4rex/personal-gis/commit/c1de372c6d69cc5ddf77d409438c4a06bf012d2e)
- **提交:** [`c1de372`](https://github.com/bd4rex/TerraSys/commit/c1de372c6d69cc5ddf77d409438c4a06bf012d2e)
- **时间:** `2026-08-02T14:38:57+08:00`
- **合并:** [PR #5](https://github.com/bd4rex/personal-gis/pull/5)
- **合并:** [PR #5](https://github.com/bd4rex/TerraSys/pull/5)

### 变更

- 用户界面产品名从 GISS 改为 GIS_P,同时保留兼容标识。
- 用户界面产品名从 TerraSys 改为 TerraSys,同时保留兼容标识。
- 地图默认收起侧栏,并统一焦点、ARIA、动画与覆盖状态。
- 将共享索引的覆盖完整性和范围是否最新拆分显示。

## M0.5 — 产品需求基线

- **提交:** [`a6309f8`](https://github.com/bd4rex/personal-gis/commit/a6309f84085b0f8bc6295c444bfd26370b933844)
- **提交:** [`a6309f8`](https://github.com/bd4rex/TerraSys/commit/a6309f84085b0f8bc6295c444bfd26370b933844)
- **时间:** `2026-08-02T08:07:31+08:00`
- **合并:** [PR #4](https://github.com/bd4rex/personal-gis/pull/4)
- **合并:** [PR #4](https://github.com/bd4rex/TerraSys/pull/4)

### 新增

Expand All @@ -128,9 +132,9 @@

## M0.4 — D 盘 Docker 清理记录

- **提交:** [`cd28db5`](https://github.com/bd4rex/personal-gis/commit/cd28db5cde78b6dcdb78a962c3b8923de8e61491)
- **提交:** [`cd28db5`](https://github.com/bd4rex/TerraSys/commit/cd28db5cde78b6dcdb78a962c3b8923de8e61491)
- **时间:** `2026-08-02T07:53:13+08:00`
- **合并:** [PR #3](https://github.com/bd4rex/personal-gis/pull/3)
- **合并:** [PR #3](https://github.com/bd4rex/TerraSys/pull/3)

### 改进

Expand All @@ -139,9 +143,9 @@

## M0.3 — 地图来源控制与实时覆盖状态

- **提交:** [`725ae42`](https://github.com/bd4rex/personal-gis/commit/725ae424c7cb00b86733ebdf2b025ace30d8cf0a)
- **提交:** [`725ae42`](https://github.com/bd4rex/TerraSys/commit/725ae424c7cb00b86733ebdf2b025ace30d8cf0a)
- **时间:** `2026-08-02T03:20:56+08:00`
- **合并:** [PR #2](https://github.com/bd4rex/personal-gis/pull/2)
- **合并:** [PR #2](https://github.com/bd4rex/TerraSys/pull/2)

### 新增

Expand All @@ -155,9 +159,9 @@

## M0.2 — 离线 GIS 平台扩展

- **提交:** [`9d2ea5d`](https://github.com/bd4rex/personal-gis/commit/9d2ea5d29a1e3b7bd4cf0717e6ebe2606c11d3d6)
- **提交:** [`9d2ea5d`](https://github.com/bd4rex/TerraSys/commit/9d2ea5d29a1e3b7bd4cf0717e6ebe2606c11d3d6)
- **时间:** `2026-08-02T02:42:50+08:00`
- **合并:** [PR #1](https://github.com/bd4rex/personal-gis/pull/1)
- **合并:** [PR #1](https://github.com/bd4rex/TerraSys/pull/1)

### 新增

Expand All @@ -174,7 +178,7 @@

## M0.1 — 首次发布个人 GIS

- **提交:** [`aa76756`](https://github.com/bd4rex/personal-gis/commit/aa76756ad887590574cdd622b4a2133f4dafc7ba)
- **提交:** [`aa76756`](https://github.com/bd4rex/TerraSys/commit/aa76756ad887590574cdd622b4a2133f4dafc7ba)
- **时间:** `2026-08-01T18:44:56+08:00`
- **当时状态:** 仓库初始提交,没有 tag 或 Release

Expand Down
38 changes: 20 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# GIS_P Personal Offline Map
# TerraSys Personal Offline Map

> English | [简体中文](README.zh-CN.md)
>
> Documentation snapshot: `2026-08-03T23:12:23+08:00` · Verified code revision: [`b2a6503`](https://github.com/bd4rex/personal-gis/commit/b2a6503304fbea851a968d7cdabeddb1b7e1a81c)
> Documentation snapshot: `2026-08-09` · Product identity: `TerraSys`

GIS_P is a local-first personal geographic information system for owning, exploring, and recovering offline map data. It combines an OpenStreetMap-style local renderer, portable regional vector maps, private places and tracks, address search, routing, terrain, weather, nautical references, a Chinese encyclopedia and travel guide, resource lifecycle management, backups, and disconnected recovery.
TerraSys is a local-first personal geographic information system for owning, exploring, and recovering offline map data. It combines an OpenStreetMap-style local renderer, portable regional vector maps, private places and tracks, address search, routing, terrain, weather, nautical references, a Chinese encyclopedia and travel guide, resource lifecycle management, backups, and disconnected recovery.

The project is designed for one trusted user on a local computer. Its only host-facing endpoint is:

Expand Down Expand Up @@ -66,37 +66,39 @@ The active Compose profile contains eight services: `web`, `api`, `postgis`, `ma
## Start and verify

```powershell
D:\GISS\start-giss.cmd
D:\GISS\health-check.cmd
D:\GISS\smoke-test.cmd
D:\TerraSys\start-terrasys.cmd
D:\TerraSys\health-check.cmd
D:\TerraSys\smoke-test.cmd
```

`start-giss.cmd` creates local secrets when required, starts Docker Desktop, applies ordered PostGIS migrations, builds the API image, starts the core stack, enables prepared advanced services, and starts the allowlisted maintenance worker.
Ongoing development uses the layered [test suite](tests/README.md): `static` for every commit, `browser` for map and resource UI coverage, `full` for API and personal-data lifecycles, and `recovery` for the isolated disconnected recovery drill.

`start-terrasys.cmd` creates local secrets when required, starts Docker Desktop, applies ordered PostGIS migrations, builds the API image, starts the core stack, enables prepared advanced services, and starts the allowlisted maintenance worker.

Prepare or rebuild advanced offline capabilities:

```powershell
D:\GISS\prepare-advanced.cmd
D:\TerraSys\prepare-advanced.cmd
```

Build or resume the OSM Carto renderer independently:

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File D:\GISS\scripts\build-osm-carto.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File D:\TerraSys\scripts\build-osm-carto.ps1
```

Heavy builds are intentionally serialized on a 16 GiB host. Existing validated products remain active until their staged replacements pass verification.

## Routine operations

```powershell
D:\GISS\backup-giss.cmd
D:\GISS\region-pack.cmd List
D:\GISS\region-pack.cmd Verify
D:\GISS\rebuild-shared-indexes.cmd -Plan
D:\GISS\create-offline-kit.cmd
D:\GISS\test-offline-recovery.cmd
D:\GISS\stop-giss.cmd
D:\TerraSys\backup-terrasys.cmd
D:\TerraSys\region-pack.cmd List
D:\TerraSys\region-pack.cmd Verify
D:\TerraSys\rebuild-shared-indexes.cmd -Plan
D:\TerraSys\create-offline-kit.cmd
D:\TerraSys\test-offline-recovery.cmd
D:\TerraSys\stop-terrasys.cmd
```

The resource console exposes Available, Local, and Updates views. Regular update-all jobs exclude heavy map, knowledge, and shared-index builds. Each active task owns its queue position, stage, measured transfer or generation rate, cancellation action, and retry state.
Expand All @@ -118,7 +120,7 @@ The resource console exposes Available, Local, and Updates views. Regular update
| `offline-kit/` | Complete disconnected recovery packages |
| `runtime/` and `tmp/` | Audits, logs, candidate builds, and renewable scratch data |

The active project is stored at `D:\GISS`; `C:\Users\Administrator\Documents\个人GIS` is a compatibility junction. Docker Desktop data is stored at `D:\DockerData\wsl`. The `GISS` path, `giss-*` container names, environment variables, scheduled task names, and recovery payload paths remain compatibility identifiers while the user-facing product name is GIS_P.
The canonical project path is `D:\TerraSys`; `C:\Users\Administrator\Documents\TerraSys` is a junction to the same files. Docker Desktop data is stored at `D:\DockerData\wsl`. Product text, scripts, containers, images, environment variables, browser keys, recovery payloads, and new database names use the TerraSys identity. Upgrade code migrates prior browser settings and can attach the existing verified Docker index volumes without copying them.

## Documentation

Expand All @@ -143,7 +145,7 @@ The repository had no Git tags or GitHub Releases before this documentation snap

## Security scope

GIS_P is a trusted, single-user localhost application. Do not bind it to `0.0.0.0` or expose it to the internet without authentication, TLS, rate limits, and a stricter upload policy.
TerraSys is a trusted, single-user localhost application. Do not bind it to `0.0.0.0` or expose it to the internet without authentication, TLS, rate limits, and a stricter upload policy.

## Project status

Expand Down
Loading