# treecount

**Repository Path**: keer2345/treecount

## Basic Information

- **Project Name**: treecount
- **Description**: 青苗补偿辅助计数系统是一个现代化的 Web 应用，用于辅助青苗、农田及设备的清点和补偿计算工作。系统参照《汝城县集体土地征收与房屋拆迁补偿安置办法》[2022]18号标准进行补偿计算。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-20
- **Last Updated**: 2026-07-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 青苗补偿辅助计数系统

## 项目概述

青苗补偿辅助计数系统是一个现代化的 Web 应用，用于辅助青苗、农田及设备的清点和补偿计算工作。系统参照《汝城县集体土地征收与房屋拆迁补偿安置办法》[2022]18 号标准进行补偿计算。

## 功能特性

### 🌲 树木清点

- 支持多种树木类型：零星树木、零星果树、零星花卉、苗圃、其他树木
- 快速计数功能，支持增减操作
- 自动计算补偿金额

### 🌾 农田清点

- 支持各类农田类型的录入
- 面积与补偿自动计算

### ⚡ 设备清点

- 设备清点与登记
- 支持快速增减计数

### 👥 居民管理

- 多户居民信息管理
- 居民信息编辑（姓名、身份证、电话、地址）
- 数据导入导出

### 📊 数据导出

- Excel 格式导出（单户/全部）
- HTML 报告导出
- 照片打包导出
- 支持批量操作

### 📱 响应式设计

- 完美适配桌面端和移动端
- 移动端优化的操作体验

## 技术栈

- **前端框架**: React 19
- **构建工具**: Vite 7
- **样式**: CSS (原生)
- **数据存储**: LocalStorage
- **导出功能**: xlsx, file-saver, jszip

## 快速开始

### 环境要求

- Node.js >= 18.0.0
- npm >= 9.0.0

### 安装依赖

```bash
npm install
```

### 开发模式

```bash
npm run dev
```

应用将在 `http://localhost:5173` 启动。

### 生产构建

```bash
npm run build
```

构建产物将输出到 `dist/` 目录。

### 预览构建

```bash
npm run preview
```

## 项目结构

```
treecount-react/
├── public/              # 静态资源
├── src/
│   ├── assets/          # 资源文件
│   ├── components/      # React 组件
│   │   ├── common/      # 通用组件
│   │   ├── CompensationStandards/   # 补偿标准
│   │   ├── CompensationSummary/     # 补偿汇总
│   │   ├── EquipmentInventory/      # 设备清点
│   │   ├── FarmlandInventory/       # 农田清点
│   │   ├── HouseholdManager/        # 居民管理
│   │   ├── Layout/                  # 布局组件
│   │   └── TreeInventory/           # 树木清点
│   ├── hooks/           # 自定义 Hooks
│   ├── models/          # 数据模型
│   ├── services/        # 业务服务
│   │   ├── CompensationCalculator.js  # 补偿计算
│   │   ├── ExcelExportService.js      # Excel导出
│   │   ├── HtmlReportService.js       # HTML报告
│   │   ├── ImageHostingService.js     # 图片服务
│   │   ├── PhotoExportService.js      # 照片导出
│   │   └── StorageService.js          # 存储服务
│   ├── App.jsx          # 主应用组件
│   ├── App.css          # 主应用样式
│   ├── main.jsx         # 入口文件
│   └── index.css        # 全局样式
├── index.html           # HTML 模板
├── vite.config.js       # Vite 配置
├── package.json         # 项目配置
└── nginx.conf           # Nginx 部署配置
```

## 部署

### Docker 部署

项目支持 Docker 部署，使用 Nginx 作为 Web 服务器。参考 `nginx.conf` 进行配置。

### EdgeOne 部署

项目已配置 Tencent Cloud EdgeOne 支持，相关配置见 `edgeone.json`。

## 数据存储

系统使用浏览器 LocalStorage 进行数据持久化存储。请注意：

- 数据存储在用户本地浏览器中
- 清除浏览器数据将导致数据丢失
- 建议定期导出数据进行备份

## 补偿标准

系统内置的补偿标准参照《汝城县集体土地征收与房屋拆迁补偿安置办法》[2022]18 号文件。可在应用内查看完整的补偿标准表。

## 开发

### 代码规范

```bash
npm run lint
```

### 项目依赖

**生产依赖：**

- `react`, `react-dom` - React 框架
- `xlsx` - Excel 文件处理
- `file-saver` - 文件下载
- `jszip` - ZIP 压缩
- `uuid` - 唯一 ID 生成
- `clsx` - 类名处理

**开发依赖：**

- `vite` - 构建工具
- `eslint` - 代码检查
- `@vitejs/plugin-react` - React 支持

## 许可证

私有项目，仅供内部使用。

## 更新日志

### v1.0.0 (2024-12)

- 🎉 首个正式版本发布
- ✨ 树木、农田、设备清点功能
- ✨ 居民信息管理
- ✨ Excel/HTML 导出
- ✨ 照片管理与导出
- ✨ 响应式设计
- ✨ 补偿自动计算