Terrasight

不動産投資データ可視化プラットフォーム — 土地の見えないリスクと価値を可視化する。

国土交通省 (MLIT) の公示地価・災害リスク・施設データを統合し、24 レイヤーの空間データを 3D マップ上に重畳表示。WASM 空間エンジンによる高速クエリと独自の投資スコア (0-100) で、不動産投資の意思決定を支援する。

Tech Stack

Layer	Technology
Backend	Rust (Axum + Tokio + SQLx + PostGIS)
Frontend	Next.js 16 (App Router) + React 19 + MapLibre GL + shadcn/ui + Tailwind CSS v4
WASM	Rust → wasm-bindgen → Web Worker (R-tree spatial queries)
Database	PostgreSQL 16 + PostGIS 3.4
Infra	Docker Compose

Architecture

graph LR
  subgraph Browser
    Map[MapLibre GL 3D]
    TQ[TanStack Query]
    Worker[Web Worker + WASM R-tree]
    FGB[(FlatGeobuf)]
  end

  subgraph Backend["Backend (Rust Axum)"]
    API[Handler → Usecase → Domain]
  end

  DB[(PostgreSQL + PostGIS)]

  Map -- static layers --> Worker
  Worker -.->|load| FGB
  Map -- API layers --> TQ
  TQ -->|REST| API
  API --> DB

Loading

services/
├── backend/    # Rust Axum API (Clean Architecture: handler/usecase/domain/infra)
├── frontend/   # Next.js 16 (features/components/stores/hooks)
└── wasm/       # Rust WASM spatial engine (R-tree, FlatGeobuf)

Data Layers (24)

Category	Layers	Source
Price	Land Price (time series), Land Price 3D Extrusion	MLIT L01 / PostGIS
Risk	Flood, Flood History, Steep Slope, Liquefaction, Landslide	MLIT A31b/A33/A47 / FGB
Geology	Geology, Landform, Soil	MLIT / FGB
Seismic	Fault, Volcano, Seismic Intensity	J-SHIS / FGB
Infrastructure	Railway, Station, Schools, Medical, DID	MLIT / FGB + PostGIS
Admin	Admin Boundary, Zoning, Population Mesh, Boundary	MLIT / FGB + PostGIS

Static layers are stored as FlatGeobuf (data/fgb/) and queried via WASM R-tree. API layers are served from PostGIS.

API Endpoints

Method	Path	Description
GET	/api/health	Service health check (DB connectivity, API key status)
GET	/api/area-data	GeoJSON layers for a bounding box (flood, slope, zoning, facilities)
GET	/api/area-stats?code=	Aggregated statistics for an administrative code (prefecture / municipality)
GET	/api/v1/land-prices?year=&bbox=&zoom=	Land prices for a single year within bbox
GET	/api/v1/land-prices/all-years?bbox=&from=&to=&zoom=	Land prices across a year range (time machine)
GET	/api/score?lat=&lng=&preset=	Total Location Score (TLS, 5-axis, 0-100). preset ∈ balance | investment | residential | disaster
GET	/api/stats	Aggregated statistics for a bounding box
GET	/api/trend	Price trend / CAGR analysis for a coordinate

詳細: docs/API_SPEC.md. Frontend Zod schemas (services/frontend/src/lib/schemas.ts) are the API contract source of truth.

Getting Started

Prerequisites

• Rust (stable)
• Node.js 22+ / pnpm
• Docker & Docker Compose
• uv (Python data pipeline)
• lefthook (git hooks)

Setup

# 1. Clone and configure
git clone <repo-url> && cd terrasight
cp .env.example .env   # Edit with your API keys

# 2. Start database
docker compose up -d db

# 3. Database setup (migrate + seed + import all data)
./scripts/commands/db-full-reset.sh

# 4. Build static data (pipeline v2: convert + FlatGeobuf + import)
./scripts/commands/pipeline.sh 13 P0

# 5. Run backend
cd services/backend && cargo run

# 6. Run frontend (separate terminal)
cd services/frontend && pnpm install && pnpm dev

Docker Compose (all services)

docker compose up -d --build

Service	Port
Frontend	http://localhost:3000
Backend	http://localhost:8000
PostgreSQL	localhost:5432

Environment Variables

Variable	Required	Description
DB_PASSWORD	Yes	PostgreSQL password
DATABASE_URL	Yes	Full connection string (auto-set in Docker)
REINFOLIB_API_KEY	No	MLIT Reinfolib API key (enables live data)
ESTAT_APP_ID	No	e-Stat API key
RUST_LOG	No	Log level filter (default: info)
NEXT_PUBLIC_API_URL	Yes	Backend URL for frontend (default: http://localhost:8000)

Development

Build & Test

# Backend
cd services/backend
cargo build && cargo test && cargo clippy -- -D warnings

# Frontend
cd services/frontend
pnpm tsc --noEmit && pnpm biome check . && pnpm vitest run

# WASM
cd services/wasm
cargo test

Data Pipeline

# Full pipeline for a prefecture (convert + build FGB + import DB + validate)
./scripts/commands/pipeline.sh 13 P0

# Individual steps
uv run scripts/tools/pipeline/convert.py --pref 13 --priority P0    # RAW → GeoJSON
uv run scripts/tools/pipeline/build_fgb.py --pref 13                # GeoJSON → FlatGeobuf
uv run scripts/tools/pipeline/import_db.py --pref 13 --priority P0  # GeoJSON → PostGIS

# Bulk import (all prefectures)
./scripts/commands/db-import-all.sh

Git Hooks (lefthook)

lefthook install

Hook	Checks
pre-commit	cargo fmt, cargo clippy, SQL lint
pre-push	cargo test, cargo build

Documentation

Document	Description
docs/DESIGN.md	Design system (colors, typography, components)
docs/API_SPEC.md	REST API specification (v2)
docs/UIUX_SPEC.md	UI/UX design specification + domain model
docs/DATA_STRUCTURE.md	Data models and database schema

docs/designs/, docs/research/, docs/plans/, docs/sessions/, docs/reviews/ are local-only (gitignored). See .gitignore for details.