Communitygithub.com

baneeishaque/ljt-520_openclaw-backup

Consultar propriedade de terras, arrendamentos, informações de proprietários e pagamentos de terras. Operações de escrita para gestão de pagamentos e renovações de arrendamentos.

O que é ljt-520_openclaw-backup?

Esta skill permite que agentes de IA (como Claude Code, Cursor ou Codex) consultem e gerenciem dados de portfólio de terras agrícolas no FarmOS. Ela acessa endpoints de API REST para recuperar informações completas sobre parcelas (próprias ou arrendadas), arrendamentos (incluindo datas de vencimento e termos), proprietários (com dados de contato) e pagamentos (aluguéis, hipotecas, impostos, etc.). A skill é rigorosa quanto à completude dos dados: ela proíbe explicitamente o uso de endpoints que truncam resultados (como `/api/integration/dashboard`) e sempre usa os endpoints `/all` para garantir que nenhum registro seja omitido. Além das operações de leitura, ela suporta operações de escrita autenticadas, como marcar pagamentos como pagos (individualmente ou em lote) e renovar arrendamentos, sempre exigindo uma pré-visualização antes da execução em massa. O controle de acesso é aplicado com base em funções de usuário (admin/gerente), garantindo que dados sensíveis de negócios não sejam expostos a usuários não autorizados.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/baneeishaque/ljt-520_openclaw-backup/tree/HEAD/skills/brianppetty/farmos-land-portfolio

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Portfólio de Terras FarmOS

Rastreie terras próprias e arrendadas, termos de arrendamento, relacionamentos com proprietários, pagamentos e custos anuais de terras.

CRÍTICO: Regras de Completude dos Dados

NUNCA use dados parciais ou truncados. Essas regras são inegociáveis:

  1. NUNCA use /api/integration/dashboard — ele trunca os resultados para 5 itens. Dados parciais de pagamento são piores do que nenhum dado, pois criam uma falsa sensação de completude.
  2. SEMPRE use os endpoints /all listados abaixo para dados completos.
  3. Se um endpoint retornar um erro ou resultados vazios, REPORTE A FALHA ao usuário. Não recorra silenciosamente a um endpoint diferente nem apresente dados parciais.
  4. SEMPRE informe a contagem total de registros retornados para que o usuário saiba que os dados estão completos. Exemplo: "Encontrados 11 pagamentos devidos em março totalizando $175.058."
  5. Se você não conseguir obter dados completos, diga isso explicitamente. "Não foi possível recuperar os dados completos de pagamento" é infinitamente melhor do que mostrar 5 de 11 pagamentos.

Quando Esta Skill é Acionada

  • "Quando nossos arrendamentos expiram?"
  • "Qual é o aluguel da terra do Smith?"
  • "Custos totais de terra este ano?"
  • "Mostrar pagamentos vencidos"
  • "Informações de contato do proprietário"
  • "Custo por acre por parcela"
  • "Listar todas as parcelas arrendadas"
  • "Quais pagamentos vencem em março?"
  • "Necessidades de caixa para o próximo mês"
  • "Marcar pagamento [X] como pago"
  • "Marcar todos os pagamentos de março como pagos"
  • "Renovar o arrendamento do Smith"
  • "Pré-visualizar renovações de arrendamento"

Controle de Acesso

Termos de arrendamento, valores de aluguel e informações de proprietários são dados comerciais sensíveis. Restringir apenas a funções de administrador ou gerente.

Mapeamento de funções: Verifique a função do remetente em ~/.openclaw/farmos-users.json. Se o usuário não for administrador ou gerente, informe que ele não tem acesso aos dados do portfólio de terras.

Base de API

http://100.102.77.110:8009

Endpoints de Integração (Sem Autenticação Necessária) — OPERAÇÕES SOMENTE LEITURA

IMPORTANTE: Use endpoints autenticados para operações de ESCRITA (marcar como pago, renovações). Use endpoints de integração /all para operações de LEITURA (listar pagamentos, arrendamentos, proprietários).

Pagamentos (COMPLETO — use este, não o dashboard)

GET /api/integration/payments/all

  • Retorna TODOS os pagamentos com detalhes completos — nomes das parcelas, nomes dos proprietários, status de vencimento
  • Parâmetros de consulta:
    • status — pending, paid, overdue, scheduled
    • payment_type — rent, mortgage, property_tax, insurance, improvement, other
    • parcel_id — filtrar por parcela específica
    • due_date_from — início do intervalo YYYY-MM-DD
    • due_date_to — fim do intervalo YYYY-MM-DD
    • crop_year — filtrar por ano agrícola
  • Exemplos:
    • Todos vencidos: /api/integration/payments/all?status=overdue
    • Pagamentos de março de 2026: /api/integration/payments/all?due_date_from=2026-03-01&due_date_to=2026-03-31
    • Todos os pagamentos de aluguel: /api/integration/payments/all?payment_type=rent

Pagamentos Futuros (próximos N dias)

GET /api/integration/payments/upcoming?days=30

  • Retorna TODOS os pagamentos futuros dentro de N dias (sem truncamento)
  • Use days=60 ou days=90 para um horizonte maior

Arrendamentos (COMPLETO)

GET /api/integration/leases/all

  • Retorna TODOS os arrendamentos com informações de contato do proprietário, termos de aluguel, status de expiração
  • Parâmetros de consulta:
    • status — active, expired
    • landlord_id — filtrar por proprietário

Arrendamentos a Expirar

GET /api/integration/leases/expiring?days=90

  • Retorna TODOS os arrendamentos que expiram dentro de N dias

Proprietários (COMPLETO)

GET /api/integration/landlords/all

  • Retorna TODOS os proprietários com informações de contato, contagem de arrendamentos ativos, total de acres, aluguel total

Parcelas

GET /api/integration/parcels

  • Retorna TODAS as parcelas com tipo de propriedade, acres, município
  • Parâmetro de consulta: ownership_type — owned, leased

Estatísticas Resumidas

GET /api/integration/summary

  • Total de acres, divisão própria/arrendada, contagens de parcelas/arrendamentos/proprietários, custo anual

Custos Anuais de Terra (por mês e entidade)

GET /api/integration/finance/costs?year=2026

  • Detalhamento mensal de custos por categoria (aluguel, hipoteca, imposto, seguro)
  • Detalhamento por entidade
  • Parâmetros de consulta: year, entity_id

Custo por Campo (para P&L)

GET /api/integration/finance/cost-per-field?year=2026

  • Custos de terra alocados aos campos de produção
  • Parâmetros de consulta: year, entity_id

Itens Vencidos

GET /api/integration/tasks/overdue

  • Todos os pagamentos e lembretes vencidos — itens de alta prioridade

Itens Acionáveis

GET /api/integration/tasks/actionable?days_ahead=30

  • Pagamentos futuros, arrendamentos a expirar, lembretes pendentes

Endpoints Autenticados — OPERAÇÕES DE ESCRITA

Estes exigem autenticação JWT. Consulte a seção de Autenticação abaixo.

Autenticação

Esta skill acessa endpoints protegidos do FarmOS que exigem um token JWT.

Para obter um token: Execute o auxiliar de autenticação com a função apropriada:

TOKEN=$(~/clawd/scripts/farmos-auth.sh admin)

Para usar o token: Inclua-o como um token Bearer:

curl -H "Authorization: Bearer $TOKEN" http://100.102.77.110:8009/api/endpoint

Expiração do token: Os tokens duram 15 minutos. Se você receber uma resposta 401, solicite um novo token.

Marcar Pagamento Individual como Pago

POST /api/payments/{id}/mark-paid Authorization: Bearer {token} Content-Type: application/json

Corpo:

{
  "paid_date": "2026-02-15",
  "notes": "Cheque #1234"
}

Marcar Múltiplos Pagamentos como Pagos (Lote)

POST /api/payments/bulk/mark-paid Authorization: Bearer {token} Content-Type: application/json

Corpo:

{
  "payment_ids": [12, 34, 56],
  "paid_date": "2026-02-15",
  "notes": "Execução em lote de cheques"
}

Marcar Pagamentos como Pagos por Intervalo de Datas

POST /api/payments/bulk/mark-paid-by-date Authorization: Bearer {token} Content-Type: application/json

Corpo:

{
  "due_date_from": "2026-03-01",
  "due_date_to": "2026-03-31",
  "paid_date": "2026-02-15",
  "payment_type": "rent",
  "notes": "Pagamentos de aluguel de março"
}

Use este endpoint quando o usuário disser "marcar todos os pagamentos de março como pagos" ou operações semelhantes em lote baseadas em data.

Pré-visualizar Renovação de Arrendamento

POST /api/leases/renewal-preview Authorization: Bearer {token} Content-Type: application/json

Corpo:

{
  "lease_ids": [5, 12],
  "new_start_date": "2027-03-01",
  "rent_increase_percent": 3.0
}

Retorna: Pré-visualização de como seriam os arrendamentos renovados, incluindo novos cronogramas de pagamento. Use este endpoint ANTES de executar renovações em massa para que o usuário possa confirmar.

Executar Renovação em Massa de Arrendamentos

POST /api/leases/bulk-renew Authorization: Bearer {token} Content-Type: application/json

Corpo:

{
  "lease_ids": [5, 12],
  "new_start_date": "2027-03-01",
  "new_end_date": "2028-02-28",
  "new_rent_amount": 52000.00,
  "rent_increase_percent": 3.0,
  "notes": "Renovação anual com aumento de 3%"
}

IMPORTANTE: Sempre pré-visualize primeiro, confirme com o usuário, depois execute.

Pré-visualizar Rollover de Final de Ano

POST /api/payments/year-end-rollover/preview Authorization: Bearer {token} Content-Type: application/json

Corpo:

{
  "from_year": 2026,
  "to_year": 2027
}

Retorna: Pré-visualização dos cronogramas de pagamento que seriam criados para o novo ano agrícola.

Executar Rollover de Final de Ano

POST /api/payments/year-end-rollover/execute Authorization: Bearer {token} Content-Type: application/json

Corpo:

{
  "from_year": 2026,
  "to_year": 2027,
  "apply_rent_increase": true,
  "rent_increase_percent": 2.5
}

IMPORTANTE: Isso cria os cronogramas de pagamento do próximo ano com base nos arrendamentos do ano atual. Sempre pré-visualize primeiro.

Endpoints PROIBIDOS — Não Use

EndpointMotivo
GET /api/integration/dashboardTrunca para 5 itens. NUNCA use este.

Conceitos Chave

  • Parcela: Uma unidade de terra — própria ou arrendada.
  • Tipos de arrendamento: Aluguel em dinheiro (cash rent), parceria agrícola (crop share), aluguel flexível (flex rent).
  • Expiração do arrendamento: Crítico de rastrear — expirações próximas precisam de atenção proativa.
  • Pagamentos de terra: Aluguel, hipoteca, imposto predial, seguro — cada um com datas de vencimento.

Notas de Uso

  • O rastreamento de expiração de arrendamentos é a consulta de maior valor — sempre sinalize arrendamentos que expiram dentro de 6 meses.
  • O status do pagamento (devido/vencido) é crítico — sinalize pagamentos vencidos imediatamente.
  • A análise de custo por acre ajuda a comparar a economia de terras próprias versus arrendadas.
  • As informações de contato do proprietário são privadas — nunca compartilhe fora dos canais de administrador/gerente.
  • Quando perguntado sobre "necessidades de caixa" ou "o que devemos", sempre use /api/integration/payments/all com filtragem de data para obter o quadro COMPLETO.
  • Para perguntas de planejamento financeiro, combine /api/integration/payments/all com /api/integration/finance/costs para a visão completa.
  • Operações de escrita: Sempre use endpoints autenticados para marcar pagamentos como pagos ou renovar arrendamentos. Pré-visualize primeiro ao fazer operações em lote.
  • Marcação em lote de pagamentos: Quando o usuário disser "marcar todos os pagamentos de março como pagos", use o endpoint de lote por data em vez de chamadas individuais.

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

baneeishaque/ljt-520_openclaw-backup

Complete investment portfolio risk management system. Analyze positions, calculate risk metrics, stress test scenarios, optimize allocations, and generate institutional-grade risk reports — all without external APIs.

baneeishaque/ljt-520_openclaw-backup

Balance tracking, order overview, and market data across exchanges using OpenMM.

baneeishaque/ljt-520_openclaw-backup

Balance tracking, order overview, and market data across exchanges using OpenMM.

baneeishaque/ljt-520_openclaw-backup

An investment portfolio tracker that runs entirely locally. All data stays in ~/.portfolio-tracker/.

baneeishaque/ljt-520_openclaw-backup

Discover and register autonomous AI agents. Use when: browsing the agent registry, submitting an agent for verification, or embedding agent badges. NOT for: general web search or agent capability analysis.

baneeishaque/ljt-520_openclaw-backup

Connect to a user's investment accounts via SnapTrade SDK and generate portfolio reports (e.g., daily total value). Use when the user wants SnapTrade-based brokerage connectivity (Webull, E*TRADE, etc.), connection portal links, account registration, or automated portfolio summaries.

baneeishaque/ljt-520_openclaw-backup

Build high-converting landing pages and product sales pages using proven 10-section conversion frameworks. Includes Hero → Social Proof → Benefits → CTA flow for both lead capture and e-commerce pages.

baneeishaque/ljt-520_openclaw-backup

Generate complete, responsive HTML landing pages from a product name, tagline, and description. Clean CSS, mobile-ready, with hero, features, CTA, and footer sections.

baneeishaque/ljt-520_openclaw-backup

Optimize conversion pages for paid traffic from Meta (Facebook/Instagram), Google Ads, TikTok Ads, YouTube Ads, Amazon Ads, and Shopify Ads journeys.

baneeishaque/ljt-520_openclaw-backup

Perform a structured conversion rate optimization (CRO) audit of a landing page. Use when a user shares a landing page URL, pastes their page copy, describes their page content, or uploads a screenshot and asks for a conversion audit, CRO review, conversion analysis, landing page feedback, or wants to know why their page isn't converting. Produces a scored 8-factor audit (0–80 total), prioritized fix list with quick wins and strategic recommendations, and an executive summary. Covers: headline clarity, supporting copy, social proof, CTA effectiveness, visual hierarchy, trust signals, mobile/speed signals, and offer clarity.

baneeishaque/ljt-520_openclaw-backup

Generate landing page content from PRD — hero section, features, A/B headline variants, CTA, and SEO meta tags. Use when user says "create landing page", "write landing copy", "hero section", "A/B headlines", or "landing content". Can scaffold actual pages for astro-static. Do NOT use for SEO auditing (use /seo-audit).

baneeishaque/ljt-520_openclaw-backup

Build high-converting landing pages with proven structure, persuasive copy, and conversion optimization.

baneeishaque/ljt-520_openclaw-backup

Track a crypto portfolio across Binance, Hyperliquid, and Polymarket. Calculates NAV, unrealized P&L, daily drawdown, win rate, and equity curve. Use when you need portfolio tracking, NAV calculation, drawdown monitoring, or multi-venue position management.

Habilidades Relacionadas