（14162期）Farmos Land Portfolio – 智能土地资产与租赁管理平台

智能土地资产与租赁管理平台 专为农业企业设计的土地资产管理工具，整合租赁跟踪、地主关系、付款管理与财务规划，支持读写双模式操作。 使用说明 核心用法 FarmOS Land Portfolio 是一套面向规模化农业经营者的综合土地资产管理解决方案，核心功能覆盖四大模块： 1. 土地与租赁全景视图通过 /api/integration/leases/all 和 /api/integration/parcels 端点获取完整的自有与租赁土地清单，包括地块位置、面积、所有权类型及租赁条款细节。系统特别强调数据完整性——强制使用 /all 后缀端点，严禁使用会截断至5条记录的 dashboard 接口。 2. 付款与现金流管理支持多维度付款查询（按状态、类型、日期范围、作物年度），集成 /api/integration/payments/all 实现精准现金流规划。关键特性包括：逾期付款自动标红、未来N天付款预测、以及按日期/批量/单条的灵活标记付款功能。对于"三月需支付多少租金"类问题，系统要求显式返回记录总数与金额合计。 3. 地主关系维护集中管理地主联系信息、活跃租约数量及总租金规模，数据访问受严格角色管控（仅 admin/manager 可见敏感商业信息）。 4. 年度财务规划通过 /api/integration/finance/costs 与 /api/integration/finance/cost-per-field 实现按月度、类别、实体的成本拆解，支持P&L报表级的地块级成本归因。 显著优点 数据完整性保障：强制 /all 端点策略杜绝"部分数据陷阱"，所有查询必须声明记录总数 双模式架构设计：集成端点（免认证）用于高频读取，认证端点（JWT）保护写操作，平衡便利与安全 前瞻性预警机制：自动标红6个月内到期租约、逾期付款及待执行任务 批量操作安全锁：租约续签与年度结转均强制"预览→确认→执行"三步流程 精细化权限控制：敏感商业数据（租金金额、地主联系方式）与操作权限（付款标记、租约续签）分级隔离 潜在局限性与风险 网络依赖性强：所有数据实时来自 http://100.102.77.110:8009，离线场景完全不可用 令牌时效窗口：JWT 仅15分钟有效期，长时操作需频繁刷新 无内置缓存层：重复查询可能产生冗余网络负载 IP硬编码风险：内网地址暴露可能引发网络配置安全隐患 批量操作不可逆：租约续签与年度结转执行后无显式回滚机制 适合人群 规模化农场运营者（>1000英亩）、农业企业财务经理、负责多地主关系的土地协调员，以及需要整合土地成本进行作物级盈利分析的农场主。特别适合租约结构复杂（现金地租+产量分成+弹性租金混合）、付款周期密集（月付/季付/年付并存）的经营主体。 常规风险 | 风险类型 | 具体表现 | 缓解建议 ||---------|---------|---------|| 数据截断误读 | 误用 dashboard 端点导致决策基于不完整数据 | 严格遵循 /all 端点强制规则 || 越权数据泄露 | 非授权人员获取敏感租金/地主信息 | 强制检查 ~/.openclaw/farmos-users.json 角色 || 误操作执行 | 批量付款标记或租约续签未确认即提交 | 严格执行预览→确认流程 || 令牌过期中断 | 写操作中途401导致流程断裂 | 操作前主动获取新令牌 || 网络单点故障 | 内网服务不可用时全功能瘫痪 | 建议配置健康检查与降级策略 | 原始说明 Query land ownership, leases, landlord info, and land payments. Write operations for payment management and lease renewals.