# gep_fastapi_server

**Repository Path**: xi-weidong/gep_fastapi_server

## Basic Information

- **Project Name**: gep_fastapi_server
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-13
- **Last Updated**: 2026-07-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 农田 GEP 核算 WebGIS（学习案例）

本仓库面向 GIS / WebGIS 初学者，用于学习农田生态产品价值核算，并提供一套可运行的 Web 系统源码。

---

## 项目简介

**GEP** 全称是生态产品总值（Gross Ecosystem Product）。它描述的是：在一定区域、一定时期内，生态系统向人类提供的产品和服务的货币价值总和。

核算时必须按顺序进行：

1. 先算 **实物量**：用物理单位表示「有多少」（例如水量、土量、生物质量）
2. 再算 **价值量**：按规范方法把实物量折算成货币
3. 最后把多项价值量加总，得到区域 GEP

本仓库以 **农田生态系统** 为案例，包含三部分内容：

| 内容 | 说明 |
|------|------|
| 学习文档 | 基本概念、规范解读、三项指标的计算过程 |
| Web 系统 | 创建任务、准备数据、执行核算、查看结果与地图 |
| 示例数据与脚本 | 使用仓库自带数据，在命令行直接跑通实物量到价值量 |

当前系统已实现的 3 项指标如下：

| 指标 | 含义 |
|------|------|
| 生物质供给 | 农田提供的生物质数量及其货币价值 |
| 水源涵养 | 农田涵养的水量及其货币价值 |
| 土壤保持 | 农田保持的土壤量及其货币价值 |

规范中农田相关指标不止这三项。其余指标在学习教程和代码常量中有完整清单；本系统当前实现上述三项。

主程序目录为 `gep_farmland_fastapi_server/`。

---

## 技术栈

| 名称 | 作用 |
|------|------|
| FastAPI | 用 Python 编写的后端接口框架 |
| PostgreSQL / PostGIS | 关系型数据库；PostGIS 用于存储与查询空间数据 |
| Docker + TiTiler | 将 GeoTIFF 等栅格数据发布为地图瓦片，供网页地图加载 |
| Cesium | 网页端地图库 |
| Vue3 / Element Plus | 网页管理界面（任务、数据、结果） |

---

## 系统截图

截图文件放在 `docs/screenshots/`。推荐文件名见下表；若修改文件名，请同步修改本表中的图片路径。

| 界面 | 说明 | 截图 |
|------|------|------|
| 任务与数据管理 | 创建任务、查看数据、执行核算 | ![任务管理](docs/screenshots/01-task-console.png) |
| 核算结果 | 实物量与价值量汇总、分项结果 | ![核算结果](docs/screenshots/02-result-summary.png) |
| 专题地图 | 区划边界与成果图层 | ![专题地图](docs/screenshots/03-thematic-map.png) |

---

## 学习顺序推荐

| 步骤 | 内容 | 路径 |
|------|------|------|
| 1 | 核心术语与核算主线 | [`docs/【学习教程】/00-核心术语与核算主线.md`](./docs/【学习教程】/00-核心术语与核算主线.md) |
| 2 | 官方规范解读 | [`docs/【学习教程】/01-官方规范解读.md`](./docs/【学习教程】/01-官方规范解读.md)；规范原文见 [`docs/papers/`](./docs/papers/) |
| 3 | 三项指标的完整计算 | [`docs/【学习教程】/03-三项指标完整计算.md`](./docs/【学习教程】/03-三项指标完整计算.md) |
| 4 | 环境搭建 | [`docs/【学习教程】/04-环境搭建.md`](./docs/【学习教程】/04-环境搭建.md) |
| 5 | Web 系统使用 | [`docs/【学习教程】/06-系统使用与结果解读.md`](./docs/【学习教程】/06-系统使用与结果解读.md) |
| 6 | 核算核心代码（`scripts/`） | [`docs/【学习教程】/08-核算核心代码导读.md`](./docs/【学习教程】/08-核算核心代码导读.md) |

完整教程目录：[`docs/【学习教程】/`](./docs/【学习教程】/)。

核算顺序是固定的：先实物量，后价值量。阅读源码前，建议先完成上表第 1～3 步。

---

## 目录结构

| 路径 | 说明 |
|------|------|
| [`docs/【学习教程】/`](./docs/【学习教程】/) | 学习教程 |
| [`docs/papers/`](./docs/papers/) | 论文、国家标准与政策规范 PDF |
| [`docs/screenshots/`](./docs/screenshots/) | 系统界面截图 |
| [`gep_farmland_fastapi_server/`](./gep_farmland_fastapi_server/) | 主程序（后端、前端、建表脚本、核算代码） |
| [`data/`](./data/) | 合肥示例数据 |
| [`scripts/`](./scripts/) | 根目录核算脚本 |

数据库建表脚本路径：`gep_farmland_fastapi_server/SQL/tb_farmland_gep.sql`。

---

## 本地运行

环境安装与启动见 [`docs/【学习教程】/04-环境搭建.md`](./docs/【学习教程】/04-环境搭建.md)。  
启动后打开：`http://127.0.0.1:18891/static/index.html`。

命令行核算说明见 [`scripts/README.md`](./scripts/README.md)。

---

## 使用范围

本仓库用于学习与案例演示。文中数值来自示例数据与参数设定，不能作为正式发布或官方核定结果使用。