NEGIAO/WebGIS-Dev
NEGIAO/WebGIS-Dev has 47 GitHub stars and 13 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 22:57 UTC. Last push 2026-11-12.
Measured star growth
- in 24h
- 0
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Vue 3 + OpenLayers/Cesium 双引擎 WebGIS 平台(FastAPI 后端,项目迭代至 V3.6)| Full-stack WebGIS with 2D/3D dual-engine maps
Creative & MediaDocs/README_EN.md
OriginalNEGIAO's WebGIS
Professional Full-Stack WebGIS Platform · Vue 3 + OpenLayers + Cesium + FastAPI
🚀 Live Demo: NEGIAO's WebGIS-Dev — Click to Explore
🌟 Core Features Preview
| 🗺️ Basemap Swipe Comparison | 🧭 Fengshui Compass |
|---|---|
| 📐 2D Data Management | ☁️ 3D Roaming & Cloudscape |
| 🤖 AI Assistant Interaction | 🌊 Dynamic Flood Analysis |
📑 Table of Contents
- 🌟 Core Features Preview
- 📑 Table of Contents
- 🎯 Project Overview
- 🧰 Module Map
- 🛠️ Tech Stack
- ⚠️ Building Data Scraping — Compliance Notice
- 🚀 Quick Start
- 📁 Project Structure
- 🏗️ System Architecture
- 🧭 Documentation Navigation
- 🚧 Known Limitations & Current Status
- Star History
- 📜 Version History
- 📄 License
- 👤 Author & Hosting
🎯 Project Overview
NEGIAO's WebGIS is a full-featured, cleanly architected full-stack WebGIS platform. The frontend is hosted on GitHub Pages (production domain webgis.negiao.cn), the backend runs in Docker on Hugging Face Spaces, and the two communicate through RESTful APIs with support for independent scaling.
📚 This README keeps only the core overview and navigation. Full documentation is modularized under
Docs/Guide/.📐 Architecture docs live in
Docs/Architecture/, using Mermaid flowcharts / sequence diagrams / state diagrams to describe module relationships, data flow, and file interactions of each subsystem — for technical handover and design review.🤖 Working on this repo with an AI agent? Read
Docs/Force_command.mdfirst — the mandatory agent policy with red lines and quality gates.Want a quick orientation? Try DeepWiki — ask an LLM about this project
Scale at a Glance
| Dimension | Measured scale |
|---|---|
| Frontend | 511 source files / ~185k lines (.vue / .js / .ts), 70 Vue SFCs |
| Backend | 70 Python files / ~21.5k lines, 15 REST router groups |
| Docs | 548 Markdown files under Docs/ (13 in Guide/, 21 in Architecture/, plus per-session records in LLM_record/) |
| i18n | zh-CN / en-US, 2000+ lines each, 27 namespaces |
| CI | 4 workflows (deploy / pre-check / codeql / traffic-counter); deploy contains 5 jobs |
Capabilities · Map Core
| Area | Description |
|---|---|
| 🗺️ 2D/3D dual engine | OpenLayers 10.5 + Cesium 1.132, one-click switch, bidirectional view sync, shareable URL state |
| 🌐 Rich basemaps | 91 presets / 107 layer definitions: Tianditu, Amap, Tencent, ESRI (incl. Wayback historical imagery), Sentinel-2 Cloudless, OSM, Ovi and more; circuit-breaker fallback, GCJ-02/BD-09 rectification, custom XYZ |
| 🧩 On-the-fly tile rectification | GCJ-02 / BD-09 → WGS-84: GCJ-02 tiles from Amap, Tencent and Google China plus BD-09 tiles from Baidu are resampled per tile by a standalone rectification service and returned as 256×256 imagery aligned to the standard XYZ grid, so the front end loads them as ordinary basemaps with no changes in either engine; the Baidu path is a cross-grid reprojection, and the reverse direction (wgs2gcj / wgs2bd) plus a generic passthrough proxy are also exposed |
| 🧭 Layer management (TOC) | Drag-and-drop ordering, inline rename, visibility/opacity/style, stacking order, coordinate conversion (WGS-84 ⇄ GCJ-02), per-layer export (CSV/TXT/GeoJSON/KML), 2D → 3D import |
| 📊 Attribute table | View-extent filtering, field visibility, full-field search, CSV export, feature locate & delete |
| ✏️ Drawing & measurement | 9 draw types (point / line / polygon / rectangle / ellipse / circle / arrow / wind arrow / military arrow), distance & area measurement, cross-layer vertex editing |
| 🔍 Place search | Three providers: Tianditu / Amap / Nominatim, POI ID, paging, origin-destination picking |
| 🗂️ Administrative divisions | Drill-down tree, boundary loading, shares coordinate conversion and export with the layer system |
| 🎞️ Historical imagery | ESRI Wayback catalog (backend SQLite cache + frontend version browsing) |
| 🌓 Swipe comparison | Any two basemaps, horizontal or vertical slider |
Capabilities · 3D & Analysis
| Area | Description |
|---|---|
| 📥 Multi-format import | GeoJSON / JSON / KML / KMZ / SHP (zip or loose parts) / CZML / GLB / GLTF / 3D Tiles (zip) / GeoTIFF / CSV / GPX; dual 2D/3D pipelines, ZIP grouping, .prj projection detection, retryable inline errors |
| 🏢 Building footprint scraping | Tencent Maps / Amap / Tianditu vector tiles: Tencent and Amap scrape building footprints and heights at CE level, Tianditu supports full parsing of 12 layer types; one decoding/assembly pipeline behind all three, so lifting the layer filter extends full parsing to Tencent and Amap; cross-tile identity merge, auto-registered into TOC |
| 📐 Spatial analysis | 8 operations: buffer, overlay, Voronoi, hotspot aggregation, fishnet (square/hexagon), convex hull, multi-ring buffer, simplify (exact computation with Shapely) |
| 🔬 3D analysis | Height-limit analysis, viewshed analysis (cesium/modules/analysis) |
| ✨ 3D effects | Volumetric cloud ray marching, Bruneton atmosphere, BSM cloud shadows, wind particles, fluid flood simulation, shallow-water overlay, post-processing (HBAO / tilt-shift / fog) |
| 🛩️ Planar route planning | Survey-area drawing, boustrophedon / five-direction oblique capture, AGL terrain following, DJI KMZ import/export |
| 🚶 Player roaming | Migrated from hh-hang/cesium-player-controller and kept in sync with upstream (0.2.1): Rapier physics, local-frame rebasing, ground snapping, first/third person |
| 🛣️ Route planning | Tianditu driving / transit pipelines, place picking and route rendering |
| 🎬 First-person flight | route-fly: first-person flight along a planned route with speed/view control |
Capabilities · Data & Collaboration
| Area | Description |
|---|---|
| 🤖 AI assistant | LLM integration with three access modes (admin default key / personal key / backend proxy); function-calling tools (camera, zoom, basemap switch…) plus OL/Cesium command adapters for multi-step map operations |
| 🧭 Fengshui compass | Compass overlay, site-seeking, bearing display |
| 🌤️ Weather board | Live weather and charts via public sources behind a backend proxy |
| 🗞️ News aggregation | Multi-platform trending lists, direct + proxy racing, silent refresh with local cache fallback |
| 📢 Announcements | Admin-published notices, dismissible persistent bar |
| 🎨 Theming | Design-token driven themes (green / blue …), dark/light and mobile adaptations |
Capabilities · Accounts & Operations
| Area | Description |
|---|---|
| 🔐 Accounts | Email sign-up/sign-in, Google / GitHub OAuth with binding, three roles (guest / registered / admin), guest sequence guest_no, session auth, dual AI quotas |
| 🛡️ Admin console | Runtime config (map tokens, basemaps, agent params, announcements), API key management, visit statistics, online-user debugging |
| 📈 Stats & monitoring | Visit logs, UV/PV, real-time presence (heartbeat + offline), SSE log streaming, /statistics/* dashboards |
| 🧰 Utilities | Screen effects (fluid smoke / gravity / dimension collapse / quantum wave / black hole / ring blast), distance & area, coordinate picking, view sharing, quick locations |
🧰 Module Map
Modules by engine domain, for fast code navigation:
Cesium tool panel (cesium/composables/toolModules/)
Scene navigation · Atmosphere·Lighting·Sky · Volumetric cloud · Wind field · Fluid flood · Shallow water · Player roaming · Planar route · Route flight · 3D analysis (height limit / viewshed)
OpenLayers tools (ol/)
drawing · spatial-analysis · routing · search · basemap · tile-source · DistrictManager · url-state · startup
Shared domain (common/)
shell (SidePanel / TopBar / announcement / global loading) · layer-tree · data-import · chat (agent / tool registry / command bus) · compass · weather · user · command-bus · map-view · data-protocol · ui
Side panel tabs: Info / Toolbox / Driving / Transit / Compass / Building scraping / Weather / News / AI assistant — lazy-loaded on first use, kept mounted afterwards to preserve state.
🛠️ Tech Stack
| Layer | Choice |
|---|---|
| Frontend | Vue 3.5 (Composition API) + Vite 6.2 + Pinia 2.3 + Vue Router 4.6 |
| 2D map | OpenLayers 10.5 |
| 3D map | Cesium 1.132 (@cesium/engine) + Three.js 0.185 (effect helpers) |
| Physics | @dimforge/rapier3d-compat 0.14 (roaming rigid bodies and collision) |
| Backend | FastAPI ≥0.100 (Python 3.12), Shapely ≥2.0, SQLite caching, SSE log streams |
| Deployment | GitHub Pages / Cloudflare Pages / Posit Connect / Vercel (frontend); Hugging Face Docker (backend) |
| Quality | ESLint, vue/compiler-sfc compile check, tsc --noEmit, structure-tree & config-registry self-checks, CodeQL |
⚠️ Building Data Scraping — Compliance Notice
Data Sources
All three sources are publicly accessible vector tile services, operated by commercial platforms and a government agency:
| UI label | Real source | Coverage in this project |
|---|---|---|
| Tencent | Tencent Maps (Tencent Location Service) | Only building-level (CE) fetch & parsing |
| Amap | Amap (Amap Open Platform) | Only building-level (CE) fetch & parsing |
| Tianditu | Tianditu (National Platform for Common Geospatial Information Services) | Full parsing, 12 selectable layers |
Tencent, Amap and Tianditu share the same tile-decoding and geometry-assembly pipeline; only layer filtering and credential policy differ. The frontend implements building-level (CE) scraping for Tencent and Amap, and full parsing for Tianditu only. Lifting the layer filter on the same parser extends full parsing to Tencent and Amap — one of the reasons this project is open source.
The UI labels were previously anonymized as "Building-1 / Building-2 / Vector tiles" for compliance reasons; they now show the real sources. Historical logs keep the original anonymization rationale.
- Use the building-scraping capability only where you hold official authorization;
- Bypassing permissions, circumventing access controls, cracking, or any other unauthorized technique is strictly prohibited;
- Bulk collection, offline database creation, redistribution, or unauthorized commercial use is strictly prohibited;
- You must comply with the data source's terms of service, local laws, and platform policies;
- The project ships range/rate controls and a frontend compliance prompt, but the ultimate responsibility remains yours.
🚀 Quick Start
Prerequisites
| Dependency | Requirement | Notes |
|---|---|---|
| Node.js | 20 LTS or newer (20.x / 22.x recommended) | Vite 6 needs Node 18+; this project is validated on 20 LTS. No engines field is declared |
| npm | 10+ | Ships with Node 20 |
| Docker Desktop | Only for full-stack local runs | Running the frontend alone (npm run dev) does not need Docker |
| Python | 3.12 (pinned in the image as python:3.12-slim) |
The backend runs via Docker only; bare uvicorn is unsupported |
| LocalDev.bat | Windows one-click script | Detects the dependencies above |
Configuration (Dual env File Architecture, Read This First)
| File | Git status | Purpose | Read at | APP_ENV |
|---|---|---|---|---|
deploy/.env |
tracked | Deployment (production baseline) | npm run build + production deploy |
production |
deploy/.env.local |
tracked | Local development (overrides .env) |
npm run dev + local backend |
development |
deploy/.env.example |
tracked | Full key catalog (no real values) | — | — |
Three-tier secret layering (L1 / L2 / L3):
| Tier | Where | What |
|---|---|---|
| L1 | deploy/.env / .env.local (non-sensitive) |
URLs, ports, frontend VITE_*, public endpoints and timeouts |
| L2 | Admin console + database | Map tokens, Agent/LLM keys and params, basemaps, announcements (change often, effective at runtime) |
| L3 | Hugging Face Secrets | Strictly secret: SUPER_USER, OAuth secrets, SMTP password, Supabase keys, monitoring tokens |
# Repository root: .env (deployment) and .env.local (local development)
# Both are committed (L1 holds no secrets)
# Local dev: Vite reads .env.local, backend reads .env.local (production values overridden with localhost)
# Production build: Vite reads only .env (selectiveEnvPlugin chooses by mode)
Proxy note: the backend runs on Hugging Face, whose policy forbids mounting any
/proxy/*or/tiles/*relay. Tile proxying and third-party reverse proxying are served by a standalone VPS service (vpn.negiao.cn, repotile-proxy); the frontend builds${base}/proxy/<host>/<path>fromVITE_TILE_PROXY_BASE_URL.
One-Click Launch (Recommended)
# Windows: double-click LocalDev.bat, which automatically:
# 1. Detects dependencies (Node.js / Docker / docker compose)
# 2. Local dev: frontend Vite reads .env.local, backend load.py reads .env.local (localhost overrides)
# 3. Smart Docker image state detection (first build / hot reload / Dockerfile change prompt)
# 4. Starts the frontend dev server → http://localhost:5173
# 5. Opens the browser
LocalDev.batis pure ASCII for GBK/UTF-8 compatibility; colored Chinese output comes fromWrite-Color.ps1in the same directory.
Endpoints: frontend http://localhost:5173 · backend API docs http://localhost:7860/docs
Default local admin:
admin/123456. Only effective whenSUPER_USERis unset andAPP_ENVisdevelopment/dev/local/test(load.py→get_admin_password()). In production you must configureSUPER_USERvia HF Secrets, otherwise admin login is disabled outright.
Manual Launch (Advanced Users)
Frontend dev server
cd frontend
npm install
npm run dev
# → http://localhost:5173
Full stack, single container (recommended)
# nginx (static frontend + /api reverse proxy) + FastAPI in one container, port 7860
docker compose -f deploy/docker-compose.yml up -d --build
# Subsequent runs
docker compose -f deploy/docker-compose.yml up -d
# → http://localhost:7860/docs
Env files are centralized under
deploy/(.env/.env.local); runninguvicorndirectly is no longer supported.
Dual-track production deployment
# Static frontend track: handled by GitHub Actions (Pages / home repo / HF Static), nothing local
# Full-stack track: on push to main, CI assembles {Dockerfile, deploy/, backend/, frontend/}
# and pushes to the Hugging Face Space, which runs npm ci + vite build + uv sync
# Local equivalent: build the single-container image (nginx + FastAPI, port 7860)
docker build -t negiao/webgis -f deploy/Dockerfile .
docker run -p 7860:7860 negiao/webgis
Local Development Image
docker pull negiao/webgis_dev:V3.5
⚠️ That image was built on 2026-08-03 for frontend V3.5.10, so it lags the current code (V3.6.42). It shares its source with
deploy/docker-compose.yml(built fromdeploy/Dockerfile); run--buildlocally if you need parity with the source.
📁 Project Structure
Directory trees are maintained under Docs/Guide/:
🏗️ System Architecture
Full architecture docs are modularized under
Docs/Architecture/: System overview · CI/CD pipeline · Deployment & domain mapping
Layered Architecture Overview
flowchart TB
subgraph SRC["📦 Source"]
direction LR
REPO_DEV["WebGIS-Dev
frontend + backend"]
REPO_HOME["NEGIAO.github.io
homepage repo"]
REPO_PROXY["tile-proxy
VPS proxy / tile service"]
end
subgraph CI["⚙️ CI / CD"]
direction LR
JOB_BUILD["① Build
npm run build → dist"]
JOB_SYNC["② Sync
dist → home repo WebGIS/"]
JOB_DEPLOY["③ Deploy
multi-platform"]
end
subgraph DPL["🚀 Platforms"]
direction LR
P_GH["GitHub Pages"]
P_HF["Hugging Face"]
P_CF["Cloudflare"]
P_PC["Posit Connect"]
P_VC["Vercel"]
end
subgraph RT["🌐 Runtime"]
direction LR
FE_HOME["Homepage
multi-domain"]
FE_WEBGIS["WebGIS frontend
multi-domain"]
BE["Docker backend API"]
PR["VPS reverse proxy
vpn.negiao.cn"]
R2["Tile storage
tiles.negiao.cc.cd"]
end
REPO_DEV --> JOB_BUILD
REPO_PROXY --> PR
JOB_BUILD --> JOB_SYNC
JOB_SYNC --> REPO_HOME
JOB_BUILD --> JOB_DEPLOY
JOB_DEPLOY --> P_GH
JOB_DEPLOY --> P_HF
REPO_HOME --> P_GH
REPO_HOME --> P_CF
REPO_HOME --> P_PC
REPO_HOME --> P_VC
P_GH --> FE_HOME
P_GH --> FE_WEBGIS
P_HF --> FE_WEBGIS
P_CF --> FE_HOME
P_CF --> FE_WEBGIS
P_PC --> FE_HOME
P_PC --> FE_WEBGIS
P_VC --> FE_HOME
P_VC --> FE_WEBGIS
P_HF --> BE
FE_WEBGIS -->|"REST API"| BE
FE_WEBGIS -->|"third-party proxy / tiles"| PR
FE_WEBGIS -->|"custom tiles"| R2
Backend API Surface
15 router groups, all under /api/* (Hugging Face forbids /proxy/* and /tiles/*):
| Module | Prefix | Contents |
|---|---|---|
| Auth | /api/auth |
Email sign-up/sign-in, OAuth callback, session, guest login (guest_no), quotas |
| Spatial analysis | /api/v1/spatial |
Single endpoint dispatching the 8 operations |
| Location | /api/v1 |
Reverse geocoding, IP geolocation |
| AI chat | /api/agent |
Sessions, messages, default model/key allocation |
| AI admin | /api/admin/agent |
Model and quota management |
| External proxy | /api/proxy |
Four whitelisted groups only: amap/*, search/nominatim, geo/epsg, ipapi/country |
| Historical imagery | /api/historical-imagery |
ESRI Wayback layer catalog |
| Statistics | /api/statistics/*, /api/log-visit |
Visit logs, dashboards, realtime stats, messages, users, visit events |
| Realtime | /api/statistics |
SSE stream, heartbeat, presence (ping / offline), tickets |
| Announcements | /api/announcement/* |
Current announcement, dismissal records |
| Admin | /api/admin |
Runtime config, download TTL, dashboards |
| API management | /api/admin, /api/admin/api-keys |
Third-party key pools and allocation |
| Runtime config | /api/runtime-config |
Public runtime config for the frontend (incl. features flags) |
| Monitoring | /api/monitor/* |
Health, log stream (SSE) |
| Webhook | /api |
HF Hub and similar callbacks |
Domain Mapping
Homepage:
| Domain | Platform | CDN | Reachable from CN |
|---|---|---|---|
negiao.github.io |
GitHub Pages default | ❌ | ⚠️ unstable |
negiao.cloud-ip.cc |
GitHub Pages + custom domain | ✅ configurable | ✅ |
negiao.cc.cd |
Cloudflare Pages | ✅ Cloudflare | ❌ blocked |
negiao.pages.dev |
Cloudflare Pages default | ✅ Cloudflare | ✅ |
negiao-pages.share.connect.posit.cloud |
Posit Connect | ❌ | ✅ |
negiao.vercel.app |
Vercel | ❌ | ❌ |
WebGIS frontend:
| Domain | Platform | Source |
|---|---|---|
webgis.negiao.cn |
Primary (paid) | CNAME → GitHub Pages |
negiao.github.io/WebGIS-Dev |
GitHub Pages | WebGIS-Dev repo root |
negiao.github.io/WebGIS |
GitHub Pages | Homepage repo subdirectory |
negiao.cloud-ip.cc/WebGIS-Dev |
GitHub Pages + custom domain | auto redirect |
webgis.negiao.cc.cd |
Cloudflare Pages | private domain mount |
webgis-dev.pages.dev |
Cloudflare Pages default | auto-assigned |
negiao-webgis.share.connect.posit.cloud |
Posit Connect | triggered by homepage repo |
negiao-web.static.hf.space |
Hugging Face Static | direct push |
Backend, proxy and storage:
| Component | Domain | Platform |
|---|---|---|
| Backend API | negiao-webgis.hf.space |
Hugging Face Docker |
| Reverse proxy / tile proxy | vpn.negiao.cn |
VPS (standalone repo tile-proxy) |
| Tile storage | tiles.negiao.cc.cd |
Cloudflare R2 |
Full domain list, deployment source matrix, and platform capability comparison: deployment-relationship.md
🧭 Documentation Navigation
Development Docs (Docs/Guide/)
| Document | Contents |
|---|---|
| Handover | Must-read for maintainers: doc map, architecture tours, code coordinates, gates and pitfalls |
| Dev conventions | Mandatory rules, layering boundaries, coordinate-system conventions, pre-commit checks |
| Dev & contribution guide | Standard flows for new pages/APIs, frontend-backend communication, code style |
| Project structure | Full directory tree and module responsibilities |
| Frontend structure / Backend structure | File-level trees |
| Configuration | Three-tier config (deploy .env / Admin+DB / HF Secrets) |
| Configuration architecture plan (done, archived) | Staged consolidation roadmap (all phases V3.4.6–V3.4.13) |
| OAuth deployment | Google/GitHub login end to end |
| Tech stack & FAQ | Stacks, references, FAQ, TODO |
| ESRI Wayback layers | Historical imagery version catalog |
| Compass type notes | Compass geometry and type definitions |
| CHANGELOG | Full version history |
Architecture Docs (Docs/Architecture/)
System-level
| Document | One-liner |
|---|---|
| System architecture | Five layers: source → CI/CD → deployment → runtime → user |
| CI/CD pipeline | Five-job pipeline: Build → Sync → Multi-Deploy |
| Deployment & domains | Domain list, deployment matrix, platform comparison |
| Three-tier configuration | L1/L2/L3 end to end |
Feature-level
| Feature | Document |
|---|---|
| 2D/3D dual engine | ol-cesium-dual-engine.md |
| Dual-engine coordinate transform spec | ol-cesium-coordinate-transform-spec.md |
| Basemap source system | basemap-source-system.md |
| Multi-format data import | multi-format-data-import.md |
| Spatial analysis backend | spatial-analysis-backend.md |
| Route planning | route-planning.md |
| 3D effects | cesium-3d-effects.md |
| Flood simulation | cesium-fluid-flood-simulation.md |
| Planar route | cesium-planar-route.md |
| Cesium unified layer management | cesium-unified-layer-management.md |
| Utility tools | utility-tools.md |
| Accounts & AI quota | account-system-ai-quota.md |
| Runtime map-token pool | runtime-map-token-pool.md |
| Tile rectification (historical; moved out) | tile-rectify-system.md |
Historical refactor records (Architecture/decisions/) — how it was changed at the time, not current architecture
| Decision | Document |
|---|---|
| Basemap single-source-of-truth refactor | decisions/2026-08-02-basemap-ssot-refactor.md |
| Unified basemap selection | decisions/2026-08-20-unified-basemap-selection.md |
| Clamp-to-ground strategy | decisions/2026-08-22-clamp-to-ground-strategy.md |
Other: Docs/Force_command.md (agent policy) · Docs/TODO/ (proposals — see its README index) · Docs/LLM_record/ (per-session records) · Docs/Demo/ (demos & sample data, not docs) · Docs/Refactor.md
🚧 Known Limitations & Current Status
Listed plainly so the README does not overpromise:
| Item | Status | Notes |
|---|---|---|
| Online basemap export (GeoTIFF) | ⚠️ frontend kept, backend removed | MapDownloader.vue calls /api/download/*, removed in V3.6.5; HF returns 404. See Docs/TODO/plan-download-* |
| Tile rectification (BD-09/GCJ-02 resampling) | ⚠️ implementation moved out, capability still live | Now the standalone tile-proxy repo, served at vpn.negiao.cn/proxy/*; HF Space policy forbids mounting /proxy/*, so this repo keeps only the integration contract — see tile-rectify-system.md |
News platform cls |
⚠️ upstream returns 504 | That tab renders empty; the other 21 platforms work |
| Direct access to news / tiles from CN | ⚠️ intermittently unreachable | The vpn.negiao.cn proxy is the de-facto main channel |
frontend/package.json version |
⚠️ unmaintained | Still 2.0.0; the real version lives in README / CHANGELOG |
| Unit tests | ❌ none yet | Gates are ESLint + SFC compile + tsc --noEmit + structure/config self-checks |
engines field |
❌ undeclared | Node version is convention (20 LTS) only |
Star History
📜 Version History
Full history in
CHANGELOG.md; only recent releases are summarized here.
| Version | Date | Summary |
|---|---|---|
| V3.6.42 | 2026-11-05 | Tianditu vector layer catalog expanded to 20 codes with corrected semantics. Front-end dictionary now matches CLI DEFAULT_LAYERS (20 codes): adds railways (BA), water outlines (AN), low-zoom water polygons/lines (AR/AW), administrative & street place-name points (AF/CA), river labels (BN) and supplementary POIs (AX), plus matching topology dispatch (new point layers to topoPoints, AR to polygon passthrough) so selecting them actually yields features. Five outdated semantics (AP, BI, CK, BV, AA) fixed after an official style audit. See CHANGELOG. |
| V3.6.41 | 2026-11-05 | First-click transition stutter fixed + MineMap annotation basemap. Landing to Register transition no longer freezes on the first click (lazy chunk prefetched while idle, session check moved to pointerenter / focusin / touchstart, plain navigation when not ready). Added a MineMap annotation layer (GCJ-02 per-tile rectification, z≤18) and a preset, plus token rotation. See CHANGELOG. |
| V3.6.40 | 2026-11-02 ~ 11-03 | iOS decorative-layer black blocks fixed + first-screen interaction upgrade + security/quality clean-up (consolidated release). Orbiting dots hidden on iOS WebKit (≤768px / iPad capability query); useSpinBoost and useViewTransitionNavigation added; blob error bodies parsed for detail; admin default AI key field hardened against password-manager autofill; all 30 legacy ESLint warnings cleared; unused self-hosted Font Awesome removed; download node retired; Tianditu CRS attribution corrected. See CHANGELOG. |
Earlier versions (V3.6.39 and before): full CHANGELOG →.
📄 License
MIT License — free to use, modify, and distribute.
Notification: if you run or deploy this project (or a derivative) in any public setting — a website, server, paper, exhibition, etc. — a short note to [email protected] or a GitHub issue is appreciated.
👤 Author & Hosting
NEGIAO — GitHub · Homepage · DeepWiki analysis
| Source | Frontend | Backend |
|---|---|---|
| GitHub | webgis.negiao.cn (primary, GitHub Pages) | Hugging Face |
V3.6.42 · in development · README synced 2026-11-07