农产品新鲜度监测与区域收益推荐系统

这个仓库已整理为 TypeScript 后端 + 静态前端 架构，旧的 Python 后端和相关脚本已移除。

技术栈

• 后端：NestJS + Prisma + TypeScript
• 数据库：SQLite（默认），支持迁移到 PostgreSQL
• 前端：HTML + CSS + Vanilla JavaScript

快速启动

1. 启动后端

   cd backend
   npm install
   Copy-Item .env.example .env
   npm run db:push
   npm run start:dev

2. 打开前端页面
   • 直接打开仓库根目录 index.html
   • 或用任意静态服务器打开该文件

默认后端地址：http://localhost:5000
默认 API 前缀：http://localhost:5000/api

核心 API

• POST /api/sensor-data 上传传感器数据（支持 camelCase 与 snake_case 字段）
• GET /api/freshness/:sensorId 获取最新新鲜度分析
• GET /api/recommendations/:sensorId 获取最新区域推荐
• GET /api/data 查询传感器历史数据
• GET /api/sensors 获取传感器列表
• GET /api/dashboard 获取仪表盘聚合数据

项目结构（已整理）

Farming software/
├── backend/                 # TypeScript 后端
│   ├── prisma/
│   │   └── schema.prisma
│   └── src/
│       ├── algorithm/       # 算法接口与默认实现
│       ├── hardware/        # 硬件接入接口与默认 HTTP 适配器
│       ├── sensor-data/
│       ├── freshness/
│       ├── recommendation/
│       ├── dashboard/
│       ├── prisma/
│       └── common/
├── frontend/
│   ├── css/
│   └── js/
├── docs/
│   └── BACKEND_TS_GUIDE.md  # 新后端骨架使用与扩展说明
├── data/                    # SQLite 数据文件目录
└── index.html               # 前端入口

详细文档

后端骨架使用方式、预留接口位置、以及 SQLite 切换 PostgreSQL 的完整说明见：
docs/BACKEND_TS_GUIDE.md