术语表
行业术语表
了解沺源系统中的核心概念和行业术语。
#承诺达标合格证（Compliance Certificate）
2026年2月起，农产品上市流通必须附带的合规文件。包含产品名称、生产者信息、产地、生产日期等，生产者承诺不使用禁用农药兽药、符合食品安全国家标准。
#Asset（资产）
农场管理的对象，共12种类型。每种类型有特有字段。资产可标记为位置（is_location）或固定（is_fixed），支持归入群组（Group）。
#Land（地块）
固定资产。可圈地，有 land_type（水田/旱地/果园等）。可作为其他资产的位置引用。
#Structure（设施）
固定资产。大棚、圈舍、仓库等，有 structure_type。
#Water（水源）
固定资产。池塘、水井、灌溉水源等。
#Animal（动物）
非固定资产。有品种、生日、性别、绝育标记、昵称等字段。
#Plant（作物）
非固定资产。有 plant_type（水稻/番茄/葡萄等）和 season（春/夏/秋/冬）。
#Equipment（设备）
非固定资产。拖拉机、收割机、无人机等，有厂商/型号/序列号。
#Material（物料）
非固定资产。肥料、农药、饲料等投入品，有 material_type。
#Product（产品）
非固定资产。收获物或加工品，有 product_type。
#Seed（种子）
非固定资产。同 Plant，有 plant_type + season。
#Log（农事日志）
农事活动的记录，共10种类型。状态机：PENDING → DONE 或 ABANDONED。
#Activity（活动）
通用农事活动日志。
#Observation（观察）
病虫害观察、生长状态评估。
#Input（投入品）
记录肥料、农药、饲料等投入品施用。
#Harvest（采收）
记录采收活动，通常携带重量 Quantity。
#Seeding（播种）
记录播种活动。
#Transplanting（移栽）
记录秧苗移栽。
#Birth（出生）
记录动物出生。
#Medical（医疗）
记录动物医疗、疫苗接种。
#Maintenance（维护）
记录设备/设施维护保养。
#LabTest（实验室检测）
记录土壤检测、水质检测、农药残留检测等。
#Quantity（数量）
附着在日志上的结构化测量值。支持重量/体积/计数/长度/面积/时间/温度/速率/比率/金额。
#Quick Form（快捷操作）
一键完成多步操作。已实现：Planting（种植）、Harvest（采收）、Input（投入品）。
#角色权限（RBAC）
5 种预置角色：Worker、Manager、Viewer、Account Admin、Config Admin。
#事件溯源（Event Sourcing）
所有业务变更以只追加的事件形式存储。不更新、不删除。可重建任意时间点的系统状态。
#地块（CaiYuan Land）
园主在地图上圈定的一块物理土地。一个 land 1:1 关联一个 grid (DECISION-018)。渲染为地图上的 Marker,用 location_lng/lat 定位。
#地块网格（Plot Grid）
把一块地切成 N×M 个小格子 (rows × cols)。每格边长 cellSizeM (米)。例如 5×8 = 40 格,边长 1 米。规划期独立于 land 创建,卖完可删除重建。
#格子 / 种植位（Plot Cell）
网格里的一格,标识 grid_id + row_num + col_num。一个 cell 可被一个用户认养。有 status:available/rented/reserved/maintenance。'不可分配' = status='maintenance'。
#认养记录（Plot Rental）
用户认养某个 cell 的完整历史。包含 started_at、ended_at、status (active/expired/cancelled)。CaiYuan 收取年费会写 expires_at 自动续期。
#工单（Work Order）
种植/维护/采收任务。一个工单关联到具体 cell 和 assignee。可以拍照留痕,园主用于记录每块地的实际作业。
#代收券（Voucher）
园主给认养人发的实物采摘凭证。用户带券到现场换产品。status:active/claimed/collected/cancelled。
#盲盒（Blind Box）
用户上架的待交换产品。另一位用户扫码 '匹配' 把自己的盒子和对方的配对,双方到地里互相交换。鼓励陌生人之间的邻里互动。
#集市商品（Market Listing）
园主发布的卖品 (蔬菜/采摘券/菜品),附带价格、库存、销售方式 (一口价/竞拍)。C 端认养人可在小程序里看到。
#Webhook 订阅（Webhook Subscription）
园主配置的外部回调。事件 (work_order.created / voucher.claimed / market.listing.sold) 触发时,系统 POST 到订阅 URL。可用于园主 ERP 集成。
#CaiYuan 订单（Order）
园主 SaaS 订阅订单 (金额给平台) 或消费者认养结算订单 (金额给园主)。两个商户自动路由 (DECISION-031)。status:pending/active/expired/cancelled。
#用户档位（Tier）
V40 引入,FREE / CAIYUAN / ENTERPRISE。决定每日高德地图调用配额:50 / 500 / 5000。admin 可临时覆盖 (tenant_tier_overrides 表)。
#租户档位覆盖（Tenant Tier Override）
Admin 给指定 tenant 临时调高 tier,带 expires_at。过期自动失效。常见场景:新园区上线期配 ENTERPRISE 练手一周。
#地图配额表（Tier Map Quota）
V40 seed 表,tier → daily_quota 的映射。修改这里即可全局调额,不用改代码。
#配额消耗（Map Quota Check）
前端调地图组件前调 POST /api/v1/me/map-quota/check,消耗 1 次配额。超额返 429。前端弹升级提示。
#落地页咨询（Marketing Inquiry）
Landing 页用户提交表单 (邮箱 + 套餐 + 留言) 后写 marketing_inquiries 表。飞书群机器人同步推送。admin 在 /admin/caiyuan-inquiries 跟进。
#落地页订阅留资（Marketing Subscription）
用户在 Landing 点 '选这个' 按钮后,POST /api/v1/marketing/subscribe 写本表,status='pending'。支付接入后会转 'active' 并填金额。
#UTM 访问埋点（Marketing Visit）
用户在 Landing 页面的访问记录,带 utm_source / utm_medium / utm_campaign / utm_content 后端抽样 30% 写入 marketing_visits 用于 ROI 归因。
#套餐档位（Landing Plan）
CaiYuan SaaS 三档:基础 ¥299/年、专业 ¥999/年、企业 ¥3,999/年。后端 GET /api/v1/marketing/plans 返回,前端在 Hero 区静态展示节省请求。
#飞书机器人（Feishu Webhook）
自定义机器人 incoming webhook URL。配 tianyuan.feishu.inquiry-webhook-url 后,Landing 提交 → 飞书群同步提示。
#事件通知（Event Notification）
marketing_notifications 表,sent_at IS NULL 的待重试列表(每 30s FeishuRetryCron 扫)。给关键事件可靠推送加一道保险。
#演示种子脚本（Reset & Seed）
backend/scripts/reset_and_seed.sh (4 步可重跑)。dev-only,会 truncate 数据表让 /admin/{plans,assets,logs,inventory,caiyuan-*} 全有数据看。