From fa463232505bb8ceed73bc226f10deb0bf25f880 Mon Sep 17 00:00:00 2001
From: Jodson Graves <info@ntari.org>
Date: Mon, 29 Jun 2026 21:46:34 -0400
Subject: [PATCH 01/16] =?UTF-8?q?feat(posts):=20Phase=202=20frontend=20?=
 =?UTF-8?q?=E2=80=94=20typed=20create=20flow=20+=20posts-backed=20marketpl?=
 =?UTF-8?q?ace?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- lib/postTypes.js: config-driven field sets for high-value types
  (Service, Direct Market, Product) + buildPostBody() → /posts payload
- components/posts/NewPostModal.js: type picker → per-type form +
  media upload (/posts/upload-media) → POST /posts
- components/posts/MyPosts.js: reusable owner view (list/create/delete)
- app/farm + app/services: wired to the user's own posts via MyPosts
- app/marketplace: switched /listings → /posts General Broadcast,
  category pills → post-type pills, NewListingModal → NewPostModal
- ListingCard: render media[] + post-type badge, tolerate no-price
  (service) posts, guard quantity/location
- i18n: Products + a few owner-view strings

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 app/farm/page.js                   |  50 +++--------
 app/marketplace/page.js            |  64 +++++++-------
 app/services/page.js               |  50 ++---------
 components/listings/ListingCard.js |  51 +++++++----
 components/posts/MyPosts.js        |  94 +++++++++++++++++++++
 components/posts/NewPostModal.js   | 130 +++++++++++++++++++++++++++++
 lib/i18n.js                        |   5 ++
 lib/postTypes.js                   |  74 ++++++++++++++++
 8 files changed, 389 insertions(+), 129 deletions(-)
 create mode 100644 components/posts/MyPosts.js
 create mode 100644 components/posts/NewPostModal.js
 create mode 100644 lib/postTypes.js

diff --git a/app/farm/page.js b/app/farm/page.js
index b2ab10c..a573086 100644
--- a/app/farm/page.js
+++ b/app/farm/page.js
@@ -1,46 +1,16 @@
 'use client';
-import { useEffect, useState } from 'react';
-import { useRouter } from 'next/navigation';
-import { getUser } from '@/lib/auth';
-import { useI18n } from '@/lib/i18n';
-
-// Producer side of the network (whitepaper §4.5.3.2-.6). Posting flows land in Phase 2.
-const SECTIONS = [
-  { icon: '🌱', title: 'Producer Plans', desc: 'Plant→harvest plans buyers can contract against, with scheduled PING updates.' },
-  { icon: '🥕', title: 'Direct Market', desc: 'Harvested goods listed for immediate sale.' },
-  { icon: '📦', title: 'Products', desc: 'Value-added goods, seeds & young plants, tools, infrastructure, soil inputs.' },
-  { icon: '🌾', title: 'Agrotourism', desc: 'Market gardens, events, tours, education, and volunteering.' },
-];
+import MyPosts from '@/components/posts/MyPosts';
 
+// Producer side of the network (whitepaper §4.5.3.2-.6).
+// Phase 2 high-value types live here: Direct Market + Products (Plans & Agrotourism follow).
 export default function MyFarm() {
-  const router = useRouter();
-  const { t } = useI18n();
-  const [user, setUser] = useState(null);
-
-  useEffect(() => {
-    const u = getUser();
-    if (!u) { router.push('/'); return; }
-    setUser(u);
-  }, []);
-
-  if (!user) return null;
-
   return (
-    <div className="min-h-screen bg-cream">
-      <div style={{ maxWidth: 1000, margin: '0 auto', padding: 'clamp(20px,3vw,40px) var(--page-pad)' }}>
-        <h1 className="font-serif text-3xl font-black text-soil mb-1">{t('Minha Fazenda')}</h1>
-        <p className="text-sm text-text3 mb-6">{t('Gerencie sua produção: planos, produtos, venda direta e agroturismo.')}</p>
-        <div className="grid gap-4" style={{ gridTemplateColumns: 'repeat(auto-fit, minmax(min(240px,100%),1fr))' }}>
-          {SECTIONS.map(s => (
-            <div key={s.title} className="card-agro p-5 flex flex-col">
-              <div className="text-2xl mb-2">{s.icon}</div>
-              <div className="font-semibold text-soil">{s.title}</div>
-              <div className="text-sm text-text3 mt-1 flex-1">{s.desc}</div>
-              <span className="badge-agro badge-wheat text-[10px] mt-3 self-start">{t('Em breve')}</span>
-            </div>
-          ))}
-        </div>
-      </div>
-    </div>
+    <MyPosts
+      title="Minha Fazenda"
+      subtitle="Gerencie sua produção: planos, produtos, venda direta e agroturismo."
+      types={['direct_market', 'product', 'plan_producer', 'agrotourism']}
+      defaultType="direct_market"
+      newLabel="Novo anúncio"
+    />
   );
 }
diff --git a/app/marketplace/page.js b/app/marketplace/page.js
index e32cf4e..3396e72 100644
--- a/app/marketplace/page.js
+++ b/app/marketplace/page.js
@@ -6,37 +6,36 @@ import { api } from '@/lib/api';
 import { getToken } from '@/lib/auth';
 import ListingCard, { ListingCardSkeleton } from '@/components/listings/ListingCard';
 import ListingDetail from '@/components/listings/ListingDetail';
-import NewListingModal from '@/components/listings/NewListingModal';
+import NewPostModal from '@/components/posts/NewPostModal';
 import { useI18n } from '@/lib/i18n';
 
-const CATEGORIES = [
-  { value: '',          label: 'Todos',      emoji: '🌿' },
-  { value: 'graos',    label: 'Grãos',      emoji: '🌾' },
-  { value: 'frutas',   label: 'Frutas',     emoji: '🍊' },
-  { value: 'gado',     label: 'Pecuária',   emoji: '🐄' },
-  { value: 'maquinas', label: 'Máquinas',   emoji: '🚜' },
-  { value: 'outros',   label: 'Outros',     emoji: '📦' },
+// Whitepaper §4.5.2 General Broadcast — filter by post type.
+const POST_TYPES = [
+  { value: '',              label: 'Tudo',      emoji: '✨' },
+  { value: 'service',       label: 'Serviços',  emoji: '🧰' },
+  { value: 'direct_market', label: 'Mercado',   emoji: '🥕' },
+  { value: 'product',       label: 'Produtos',  emoji: '📦' },
 ];
 
 const STATES = ['SP','MG','PR','RS','GO','MT','MS','BA','SC','PE','CE','RO','PA'];
 
 const DEMO = [
-  { id: 'd1', title: 'Soja Safra 2025 — Tipo 1',        category: 'graos',    city: 'Rondonópolis', state: 'MT', price: 145.50, unit: 'saca',  quantity_available: 500  },
-  { id: 'd2', title: 'Milho Granado Premium',            category: 'graos',    city: 'Sorriso',      state: 'MT', price: 78.00,  unit: 'saca',  quantity_available: 1200 },
-  { id: 'd3', title: 'Laranja Pera Rio',                 category: 'frutas',   city: 'Limeira',      state: 'SP', price: 2.80,   unit: 'kg',    quantity_available: 8000 },
-  { id: 'd4', title: 'Nelore Boi Gordo',                 category: 'gado',     city: 'Araçatuba',    state: 'SP', price: 320.00, unit: 'cabeça',quantity_available: 45   },
-  { id: 'd5', title: 'Café Arábica Especial',            category: 'graos',    city: 'Varginha',     state: 'MG', price: 980.00, unit: 'saca',  quantity_available: 30   },
-  { id: 'd6', title: 'Tomate Italiano Hidropônica',      category: 'frutas',   city: 'Cajamar',      state: 'SP', price: 3.20,   unit: 'kg',    quantity_available: 2500 },
-  { id: 'd7', title: 'Trator New Holland T7.240',        category: 'maquinas', city: 'Cascavel',     state: 'PR', price: 480000, unit: 'un.',   quantity_available: 1    },
-  { id: 'd8', title: 'Feijão Carioca Safra Nova',        category: 'graos',    city: 'Uberaba',      state: 'MG', price: 220.00, unit: 'saca',  quantity_available: 150  },
+  { id: 'd1', post_type: 'direct_market', title: 'Soja Safra 2025 — Tipo 1', category: 'graos',       city: 'Rondonópolis', state: 'MT', price: 145.50, unit: 'saca', quantity_available: 500  },
+  { id: 'd2', post_type: 'direct_market', title: 'Milho Granado Premium',     category: 'graos',       city: 'Sorriso',      state: 'MT', price: 78.00,  unit: 'saca', quantity_available: 1200 },
+  { id: 'd3', post_type: 'direct_market', title: 'Laranja Pera Rio',          category: 'frutas',      city: 'Limeira',      state: 'SP', price: 2.80,   unit: 'kg',   quantity_available: 8000 },
+  { id: 'd4', post_type: 'service',       title: 'Colheita Mecanizada',       category: 'la',          city: 'Araçatuba',    state: 'SP', terms: 'R$ 90/hora — mín. 4h' },
+  { id: 'd5', post_type: 'direct_market', title: 'Café Arábica Especial',     category: 'graos',       city: 'Varginha',     state: 'MG', price: 980.00, unit: 'saca', quantity_available: 30 },
+  { id: 'd6', post_type: 'product',       title: 'Sementes de Milho Híbrido', category: 'seeds_young', city: 'Cajamar',      state: 'SP', price: 320.00, quantity_available: 200 },
+  { id: 'd7', post_type: 'product',       title: 'Trator New Holland T7.240', category: 'tools',       city: 'Cascavel',     state: 'PR', price: 480000, quantity_available: 1 },
+  { id: 'd8', post_type: 'service',       title: 'Transporte de Grãos',       category: 'lr',          city: 'Uberaba',      state: 'MG', terms: 'R$ 4,50/km' },
 ];
 
 function MarketplaceInner() {
   const params = useSearchParams();
   const [listings, setListings] = useState(null);
   const [selected, setSelected]   = useState(null);
-  const [newListing, setNewListing] = useState(false);
-  const [cat, setCat]   = useState(params.get('cat') || '');
+  const [newPost, setNewPost] = useState(false);
+  const [ptype, setPtype]   = useState(params.get('type') || '');
   const [search, setSearch] = useState('');
   const [stateF, setStateF] = useState('');
   const [minP, setMinP] = useState('');
@@ -48,28 +47,29 @@ function MarketplaceInner() {
   async function load() {
     setListings(null);
     let qs = '?status=active&limit=40';
-    if (cat)    qs += '&category=' + cat;
+    if (ptype)  qs += '&post_type=' + ptype;
     if (stateF) qs += '&state=' + stateF;
     if (minP)   qs += '&minPrice=' + minP;
     if (maxP)   qs += '&maxPrice=' + maxP;
+    if (sort)   qs += '&sort=' + sort;
     try {
-      const data = await api('/listings' + qs);
-      let items = data.listings || data || [];
+      const data = await api('/posts' + qs);
+      let items = data.posts || data.listings || data || [];
       if (search) items = items.filter(l =>
         l.title.toLowerCase().includes(search.toLowerCase()) ||
         l.city?.toLowerCase().includes(search.toLowerCase())
       );
       setListings(items);
     } catch {
-      setListings(DEMO.filter(l => !cat || l.category === cat));
+      setListings(DEMO.filter(l => !ptype || l.post_type === ptype));
     }
   }
 
-  useEffect(() => { load(); }, [cat, stateF, sort]);
+  useEffect(() => { load(); }, [ptype, stateF, sort]);
 
   function openNew() {
     if (!getToken()) return alert(t('Faça login para anunciar'));
-    setNewListing(true);
+    setNewPost(true);
   }
 
   const filtered = listings?.filter(l =>
@@ -84,7 +84,7 @@ function MarketplaceInner() {
       <div className="bg-cream2 border-b border-[var(--border-c)]" style={{ padding: 'clamp(24px,4vw,48px) var(--page-pad) clamp(20px,3vw,36px)' }}>
         <motion.div initial={{ opacity: 0, y: -12 }} animate={{ opacity: 1, y: 0 }} transition={{ duration: .4 }}>
           <h1 className="font-serif text-3xl md:text-4xl font-black text-soil mb-1">{t('Marketplace')}</h1>
-          <p className="text-sm text-text3">{t('Produtos agrícolas de produtores de todo o Brasil')}</p>
+          <p className="text-sm text-text3">{t('Produtos agrícolas e serviços de produtores de todo o Brasil')}</p>
         </motion.div>
 
         {/* SEARCH BAR */}
@@ -111,15 +111,15 @@ function MarketplaceInner() {
           </button>
         </motion.div>
 
-        {/* CATEGORY PILLS */}
+        {/* POST-TYPE PILLS */}
         <motion.div
           initial={{ opacity: 0 }} animate={{ opacity: 1 }} transition={{ duration: .4, delay: .2 }}
           className="flex gap-2 mt-4 flex-wrap">
-          {CATEGORIES.map(c => (
+          {POST_TYPES.map(c => (
             <button
               key={c.value}
-              onClick={() => setCat(c.value)}
-              className={`cat-pill ${cat === c.value ? 'active' : ''}`}>
+              onClick={() => setPtype(c.value)}
+              className={`cat-pill ${ptype === c.value ? 'active' : ''}`}>
               <span>{c.emoji}</span> {t(c.label)}
             </button>
           ))}
@@ -202,15 +202,15 @@ function MarketplaceInner() {
                 className="flex flex-col items-center py-20 gap-3">
                 <span className="text-5xl">🌾</span>
                 <p className="text-text3 text-sm">{t('Nenhum produto encontrado')}</p>
-                <button className="btn btn-ghost btn-sm" onClick={() => { setCat(''); setSearch(''); setStateF(''); load(); }}>{t('Limpar filtros')}</button>
+                <button className="btn btn-ghost btn-sm" onClick={() => { setPtype(''); setSearch(''); setStateF(''); load(); }}>{t('Limpar filtros')}</button>
               </motion.div>
             )}
           </AnimatePresence>
         </div>
       </div>
 
-      {selected   && <ListingDetail listing={selected} onClose={() => setSelected(null)} />}
-      {newListing && <NewListingModal onClose={() => setNewListing(false)} onCreated={load} />}
+      {selected && <ListingDetail listing={selected} onClose={() => setSelected(null)} />}
+      {newPost  && <NewPostModal onClose={() => setNewPost(false)} onCreated={load} />}
     </div>
   );
 }
diff --git a/app/services/page.js b/app/services/page.js
index 6a777dc..66de803 100644
--- a/app/services/page.js
+++ b/app/services/page.js
@@ -1,47 +1,15 @@
 'use client';
-import { useEffect, useState } from 'react';
-import { useRouter } from 'next/navigation';
-import { getUser } from '@/lib/auth';
-import { useI18n } from '@/lib/i18n';
-
-// Service posts (whitepaper §4.5.3.1). Posting flows land in Phase 2.
-const SECTIONS = [
-  { icon: '🧑‍🌾', title: 'Labor', desc: 'Planning & advising, setup & maintenance, planting & harvest.' },
-  { icon: '🚚', title: 'Logistics', desc: 'Transport by range: under 10 km, over 10 km, over 20 km.' },
-  { icon: '🏭', title: 'Processing', desc: 'Cottage / home-based, general, and animal processing.' },
-  { icon: '♻️', title: 'Composting & Recycling', desc: 'Waste-to-soil and material recovery services.' },
-  { icon: '🌿', title: 'Environmental Services', desc: 'Restoration, stewardship, and ecosystem services.' },
-];
+import MyPosts from '@/components/posts/MyPosts';
 
+// Service posts (whitepaper §4.5.3.1): labor, logistics, processing, composting, environmental.
 export default function MyServices() {
-  const router = useRouter();
-  const { t } = useI18n();
-  const [user, setUser] = useState(null);
-
-  useEffect(() => {
-    const u = getUser();
-    if (!u) { router.push('/'); return; }
-    setUser(u);
-  }, []);
-
-  if (!user) return null;
-
   return (
-    <div className="min-h-screen bg-cream">
-      <div style={{ maxWidth: 1000, margin: '0 auto', padding: 'clamp(20px,3vw,40px) var(--page-pad)' }}>
-        <h1 className="font-serif text-3xl font-black text-soil mb-1">{t('Meus Serviços')}</h1>
-        <p className="text-sm text-text3 mb-6">{t('Ofereça serviços à rede: trabalho, logística, processamento e mais.')}</p>
-        <div className="grid gap-4" style={{ gridTemplateColumns: 'repeat(auto-fit, minmax(min(240px,100%),1fr))' }}>
-          {SECTIONS.map(s => (
-            <div key={s.title} className="card-agro p-5 flex flex-col">
-              <div className="text-2xl mb-2">{s.icon}</div>
-              <div className="font-semibold text-soil">{s.title}</div>
-              <div className="text-sm text-text3 mt-1 flex-1">{s.desc}</div>
-              <span className="badge-agro badge-wheat text-[10px] mt-3 self-start">{t('Em breve')}</span>
-            </div>
-          ))}
-        </div>
-      </div>
-    </div>
+    <MyPosts
+      title="Meus Serviços"
+      subtitle="Ofereça serviços à rede: trabalho, logística, processamento e mais."
+      types={['service']}
+      defaultType="service"
+      newLabel="Novo serviço"
+    />
   );
 }
diff --git a/components/listings/ListingCard.js b/components/listings/ListingCard.js
index 3dd8464..bda5f8f 100644
--- a/components/listings/ListingCard.js
+++ b/components/listings/ListingCard.js
@@ -11,10 +11,21 @@ const CAT_BG = {
   outros:   'from-cream to-cream2',
 };
 
+// Post-type presentation (whitepaper taxonomy). Falls back to legacy category styling.
+const TYPE_LABEL = { service: 'Service', direct_market: 'Market', product: 'Product', plan_consumer: 'Plan', plan_producer: 'Plan', agrotourism: 'Agrotourism' };
+const TYPE_EMOJI = { service: '🧰', direct_market: '🥕', product: '📦', plan_consumer: '📋', plan_producer: '📋', agrotourism: '🌄' };
+const TYPE_BG = { service: 'from-sky-50 to-cyan-100', product: 'from-violet-50 to-purple-100', agrotourism: 'from-lime-50 to-green-100' };
+
 export default function ListingCard({ listing, onClick }) {
   const { t } = useI18n();
   const l = listing;
-  const bg = CAT_BG[l.category] || CAT_BG.outros;
+  const img = l.media?.[0] || l.images?.[0];
+  const bg = TYPE_BG[l.post_type] || CAT_BG[l.category] || CAT_BG.outros;
+  const emoji = TYPE_EMOJI[l.post_type] || CAT_EMOJI[l.category] || '📦';
+  const badge = l.post_type ? (TYPE_LABEL[l.post_type] || l.post_type) : catLabel(l.category);
+  const hasPrice = l.price !== null && l.price !== undefined && l.price !== '';
+  const qty = Number(l.quantity_available);
+  const hasQty = Number.isFinite(qty) && qty > 0;
 
   return (
     <motion.div
@@ -25,14 +36,14 @@ export default function ListingCard({ listing, onClick }) {
 
       {/* IMAGE / EMOJI AREA */}
       <div className={`listing-img bg-gradient-to-br ${bg} relative`}>
-        {l.images?.[0]
-          ? <img src={l.images[0]} alt={l.title} className="w-full h-full object-cover" />
-          : <span className="text-5xl select-none">{CAT_EMOJI[l.category] || '📦'}</span>
+        {img
+          ? <img src={img} alt={l.title} className="w-full h-full object-cover" />
+          : <span className="text-5xl select-none">{emoji}</span>
         }
         <div className="absolute top-2.5 left-2.5">
-          <span className="badge-agro badge-green text-[10px]">{t(catLabel(l.category))}</span>
+          <span className="badge-agro badge-green text-[10px]">{t(badge)}</span>
         </div>
-        {l.quantity_available <= 10 && (
+        {hasQty && qty <= 10 && (
           <div className="absolute top-2.5 right-2.5">
             <span className="badge-agro badge-rust text-[10px]">{t('Últimas unidades')}</span>
           </div>
@@ -42,16 +53,24 @@ export default function ListingCard({ listing, onClick }) {
       {/* BODY */}
       <div className="listing-body">
         <div className="listing-title line-clamp-2">{l.title}</div>
-        <div className="listing-loc">
-          <span className="text-xs">📍</span> {l.city}, {l.state}
-        </div>
-        <div className="flex items-baseline gap-1 mt-auto pt-2">
-          <span className="listing-price">{formatCurrency(l.price)}</span>
-          <span className="listing-unit">/{l.unit}</span>
-        </div>
-        <div className="listing-qty">
-          {Number(l.quantity_available).toLocaleString('pt-BR')} {t('disponível')}
-        </div>
+        {(l.city || l.state) && (
+          <div className="listing-loc">
+            <span className="text-xs">📍</span> {[l.city, l.state].filter(Boolean).join(', ')}
+          </div>
+        )}
+        {hasPrice ? (
+          <div className="flex items-baseline gap-1 mt-auto pt-2">
+            <span className="listing-price">{formatCurrency(l.price)}</span>
+            {l.unit && <span className="listing-unit">/{l.unit}</span>}
+          </div>
+        ) : l.terms ? (
+          <div className="listing-unit mt-auto pt-2 line-clamp-1">{l.terms}</div>
+        ) : null}
+        {hasQty && (
+          <div className="listing-qty">
+            {qty.toLocaleString('pt-BR')} {t('disponível')}
+          </div>
+        )}
       </div>
     </motion.div>
   );
diff --git a/components/posts/MyPosts.js b/components/posts/MyPosts.js
new file mode 100644
index 0000000..1631634
--- /dev/null
+++ b/components/posts/MyPosts.js
@@ -0,0 +1,94 @@
+'use client';
+import { useEffect, useState } from 'react';
+import { useRouter } from 'next/navigation';
+import { api } from '@/lib/api';
+import { getUser } from '@/lib/auth';
+import { useI18n } from '@/lib/i18n';
+import ListingCard from '@/components/listings/ListingCard';
+import ListingDetail from '@/components/listings/ListingDetail';
+import NewPostModal from '@/components/posts/NewPostModal';
+
+// Shared owner view: lists the current user's posts of the given types,
+// with a create button (NewPostModal) and per-card delete. Used by My Farm & My Services.
+export default function MyPosts({ title, subtitle, types, defaultType, newLabel }) {
+  const router = useRouter();
+  const { t } = useI18n();
+  const [user, setUser] = useState(null);
+  const [posts, setPosts] = useState(null);
+  const [selected, setSelected] = useState(null);
+  const [creating, setCreating] = useState(false);
+
+  useEffect(() => {
+    const u = getUser();
+    if (!u) { router.push('/'); return; }
+    setUser(u);
+  }, []);
+
+  async function load() {
+    if (!user) return;
+    setPosts(null);
+    try {
+      const data = await api('/posts?user_id=' + encodeURIComponent(user.id) + '&limit=100');
+      const items = (data.posts || data.listings || data || []).filter((p) => types.includes(p.post_type));
+      setPosts(items);
+    } catch {
+      setPosts([]);
+    }
+  }
+
+  useEffect(() => { if (user) load(); }, [user]);
+
+  async function onDelete(id) {
+    if (!confirm(t('Remover este anúncio?'))) return;
+    try {
+      await api('/posts/' + id, 'DELETE');
+      load();
+    } catch (e) {
+      alert(e.message);
+    }
+  }
+
+  if (!user) return null;
+
+  return (
+    <div className="min-h-screen bg-cream">
+      <div style={{ maxWidth: 1000, margin: '0 auto', padding: 'clamp(20px,3vw,40px) var(--page-pad)' }}>
+        <div className="flex items-start justify-between gap-3 flex-wrap mb-6">
+          <div>
+            <h1 className="font-serif text-3xl font-black text-soil mb-1">{t(title)}</h1>
+            <p className="text-sm text-text3">{t(subtitle)}</p>
+          </div>
+          <button className="btn btn-primary" onClick={() => setCreating(true)}>+ {t(newLabel)}</button>
+        </div>
+
+        {posts === null ? (
+          <p className="text-text3 text-sm">{t('Buscando...')}</p>
+        ) : posts.length === 0 ? (
+          <div className="card-agro p-8 text-center text-text3">
+            <div className="text-4xl mb-2">🌱</div>
+            <p className="text-sm mb-3">{t('Você ainda não tem nada por aqui.')}</p>
+            <button className="btn btn-outline btn-sm" onClick={() => setCreating(true)}>+ {t(newLabel)}</button>
+          </div>
+        ) : (
+          <div className="listing-grid">
+            {posts.map((p) => (
+              <div key={p.id} className="relative group">
+                <ListingCard listing={p} onClick={setSelected} />
+                <button
+                  onClick={(e) => { e.stopPropagation(); onDelete(p.id); }}
+                  className="absolute top-2 right-2 z-10 bg-white/90 hover:bg-rust hover:text-white rounded-full w-7 h-7 text-sm shadow opacity-0 group-hover:opacity-100 transition"
+                  title={t('Remover')}>✕</button>
+                {p.status && p.status !== 'active' && (
+                  <span className="absolute top-2 left-2 z-10 badge-agro badge-wheat text-[10px]">{p.status}</span>
+                )}
+              </div>
+            ))}
+          </div>
+        )}
+      </div>
+
+      {selected && <ListingDetail listing={selected} onClose={() => setSelected(null)} />}
+      {creating && <NewPostModal initialType={defaultType} onClose={() => setCreating(false)} onCreated={load} />}
+    </div>
+  );
+}
diff --git a/components/posts/NewPostModal.js b/components/posts/NewPostModal.js
new file mode 100644
index 0000000..53b7154
--- /dev/null
+++ b/components/posts/NewPostModal.js
@@ -0,0 +1,130 @@
+'use client';
+import { useState } from 'react';
+import { Modal, ModalHeader } from '@/components/ui/Modal';
+import { api } from '@/lib/api';
+import { getToken } from '@/lib/auth';
+import { useToast } from '@/components/ui/Toast';
+import { POST_TYPE_FORMS, buildPostBody } from '@/lib/postTypes';
+
+function Field({ f, value, onChange }) {
+  const label = (<label className="form-label">{f.label}{f.required ? ' *' : ''}</label>);
+  if (f.kind === 'textarea') {
+    return (
+      <div className="form-group">{label}
+        <textarea className="form-input min-h-[70px] resize-y" value={value || ''} placeholder={f.placeholder || ''} onChange={(e) => onChange(f.key, e.target.value)} />
+      </div>
+    );
+  }
+  if (f.kind === 'select') {
+    return (
+      <div className="form-group">{label}
+        <select className="form-input" value={value || ''} onChange={(e) => onChange(f.key, e.target.value)}>
+          <option value="">—</option>
+          {f.options.map(([v, l]) => <option key={v} value={v}>{l}</option>)}
+        </select>
+      </div>
+    );
+  }
+  return (
+    <div className="form-group">{label}
+      <input
+        type={f.kind === 'number' ? 'number' : f.kind === 'date' ? 'date' : 'text'}
+        className="form-input" value={value || ''} placeholder={f.placeholder || ''}
+        onChange={(e) => onChange(f.key, e.target.value)} />
+    </div>
+  );
+}
+
+export default function NewPostModal({ onClose, onCreated, initialType = null }) {
+  const toast = useToast();
+  const [type, setType] = useState(initialType);
+  const [values, setValues] = useState({});
+  const [media, setMedia] = useState([]);
+  const [uploading, setUploading] = useState(false);
+  const [loading, setLoading] = useState(false);
+
+  const set = (k, v) => setValues((s) => ({ ...s, [k]: v }));
+  const API = process.env.NEXT_PUBLIC_API_URL || '';
+
+  async function onFiles(e) {
+    const files = Array.from(e.target.files || []).slice(0, 5);
+    if (!files.length) return;
+    setUploading(true);
+    const urls = [];
+    for (const file of files) {
+      try {
+        const fd = new FormData();
+        fd.append('image', file);
+        const headers = { Authorization: 'Bearer ' + getToken() };
+        if (process.env.NEXT_PUBLIC_API_KEY) headers['X-API-Key'] = process.env.NEXT_PUBLIC_API_KEY;
+        const res = await fetch(API + '/posts/upload-media', { method: 'POST', headers, body: fd });
+        const data = await res.json();
+        if (data.url) urls.push(data.url);
+      } catch { /* skip failed file */ }
+    }
+    setMedia((m) => [...m, ...urls].slice(0, 5));
+    setUploading(false);
+  }
+
+  async function submit() {
+    const form = POST_TYPE_FORMS[type];
+    const missing = form.fields.filter((f) => f.required && !values[f.key]);
+    if (missing.length) return toast('Please fill in: ' + missing.map((f) => f.label).join(', '), 'error');
+    setLoading(true);
+    try {
+      await api('/posts', 'POST', buildPostBody(type, values, media));
+      toast('Post published!');
+      onClose();
+      onCreated?.();
+    } catch (e) {
+      toast(e.message, 'error');
+    } finally {
+      setLoading(false);
+    }
+  }
+
+  return (
+    <Modal onClose={onClose} maxWidth="560px">
+      <ModalHeader title={type ? `New ${POST_TYPE_FORMS[type].label}` : 'What are you posting?'} onClose={onClose} />
+
+      {!type ? (
+        <div className="grid gap-3" style={{ gridTemplateColumns: 'repeat(auto-fit, minmax(150px, 1fr))' }}>
+          {Object.entries(POST_TYPE_FORMS).map(([k, cfg]) => (
+            <button key={k} onClick={() => setType(k)}
+              className="card-agro p-4 text-left hover:border-moss transition-colors cursor-pointer">
+              <div className="text-2xl mb-1">{cfg.icon}</div>
+              <div className="font-semibold text-soil">{cfg.label}</div>
+              <div className="text-xs text-text3 mt-1">{cfg.blurb}</div>
+            </button>
+          ))}
+        </div>
+      ) : (
+        <div>
+          {POST_TYPE_FORMS[type].fields.map((f) => (
+            <Field key={f.key} f={f} value={values[f.key]} onChange={set} />
+          ))}
+
+          <div className="form-group">
+            <label className="form-label">Photos (up to 5)</label>
+            <input type="file" accept="image/*" multiple onChange={onFiles} className="text-sm" />
+            {uploading && <span className="text-xs text-text3 ml-2">Uploading…</span>}
+            {media.length > 0 && (
+              <div className="flex gap-2 mt-2 flex-wrap">
+                {media.map((u, i) => (
+                  <img key={i} src={u} alt="" className="w-14 h-14 object-cover rounded-lg border border-[var(--border-c)]" />
+                ))}
+              </div>
+            )}
+          </div>
+
+          <div className="flex gap-3 mt-4">
+            <button className="btn btn-ghost" onClick={() => setType(null)}>← Back</button>
+            <button className="btn btn-primary flex-1" onClick={submit} disabled={loading}>
+              {loading ? 'Publishing…' : 'Publish'}
+            </button>
+          </div>
+        </div>
+      )}
+    </Modal>
+  );
+}
diff --git a/lib/i18n.js b/lib/i18n.js
index 6b54f8a..7442145 100644
--- a/lib/i18n.js
+++ b/lib/i18n.js
@@ -89,6 +89,8 @@ const EN = {
   'Confirme e avalie': 'Confirm and rate',
   'Recebeu? Confirme e o produtor recebe na hora. Simples assim.': 'Received it? Confirm and the producer gets paid instantly. Simple as that.',
   'Tudo': 'All',
+  'Produtos': 'Products',
+  'Produtos agrícolas e serviços de produtores de todo o Brasil': 'Agricultural products and services from producers across Brazil',
   'Grãos & Cereais': 'Grains & Cereals',
   'Frutas & Hortaliças': 'Fruits & Vegetables',
   'Insumos': 'Supplies',
@@ -250,6 +252,9 @@ const EN = {
   'Ver': 'View',
   'Seus anúncios publicados': 'Your published listings',
   'Novo anúncio': 'New listing',
+  'Novo serviço': 'New service',
+  'Remover este anúncio?': 'Remove this post?',
+  'Você ainda não tem nada por aqui.': 'You don\'t have anything here yet.',
   'Nenhum anúncio publicado': 'No listings published',
   'Criar primeiro anúncio': 'Create your first listing',
   'Depositar na wallet': 'Deposit to wallet',
diff --git a/lib/postTypes.js b/lib/postTypes.js
new file mode 100644
index 0000000..9a571dc
--- /dev/null
+++ b/lib/postTypes.js
@@ -0,0 +1,74 @@
+// Frontend descriptors for the whitepaper post types (Phase 2: high-value types first).
+// Each field: { key, label, kind, options?, payload?, required?, placeholder? }
+//   kind: 'text' | 'textarea' | 'number' | 'select' | 'date'
+// Keys in TOP_LEVEL map to post columns; everything else goes into the JSON payload.
+
+export const USE_CATEGORIES = ['food', 'pharmaceutical', 'fiber', 'chemical', 'mineral', 'ornamental'];
+const ucOptions = USE_CATEGORIES.map((c) => [c, c.charAt(0).toUpperCase() + c.slice(1)]);
+
+const TOP_LEVEL = new Set(['title', 'description', 'category', 'price', 'unit', 'quantity_available', 'city', 'state', 'terms']);
+
+export const POST_TYPE_FORMS = {
+  service: {
+    label: 'Service',
+    icon: '🧰',
+    blurb: 'Labor, logistics, processing, composting, or environmental services.',
+    fields: [
+      { key: 'title', label: 'Title', kind: 'text', required: true },
+      { key: 'category', label: 'Category', kind: 'select', required: true, options: [['la', 'Labor'], ['lr', 'Logistics'], ['pr', 'Processing'], ['cr', 'Composting / Recycling'], ['es', 'Environmental']] },
+      { key: 'sub', label: 'Subcategory', kind: 'text', payload: true, placeholder: 'e.g. pa = planning, sm = setup, ph = planting/harvest' },
+      { key: 'description', label: 'Description', kind: 'textarea' },
+      { key: 'city', label: 'City', kind: 'text' },
+      { key: 'state', label: 'State (UF)', kind: 'text' },
+      { key: 'terms', label: 'Terms (pricing & conditions)', kind: 'text', placeholder: 'e.g. USD 120 / month' },
+    ],
+  },
+  direct_market: {
+    label: 'Direct Market',
+    icon: '🥕',
+    blurb: 'Harvested goods for immediate sale.',
+    fields: [
+      { key: 'title', label: 'Title', kind: 'text', required: true },
+      { key: 'description', label: 'Description', kind: 'textarea' },
+      { key: 'variety', label: 'Variety', kind: 'text', payload: true },
+      { key: 'use_category', label: 'Use category', kind: 'select', payload: true, options: ucOptions },
+      { key: 'price', label: 'Price', kind: 'number', required: true },
+      { key: 'unit', label: 'Unit', kind: 'text', placeholder: 'kg, saca, tonelada…' },
+      { key: 'quantity_available', label: 'Starting inventory', kind: 'number' },
+      { key: 'date_harvested', label: 'Date harvested', kind: 'date', payload: true },
+      { key: 'spoil_date', label: 'Expected spoil date', kind: 'date', payload: true },
+      { key: 'pickup_delivery', label: 'Pickup / Delivery', kind: 'select', payload: true, options: [['pickup', 'Pickup'], ['delivery', 'Delivery'], ['both', 'Both']] },
+      { key: 'city', label: 'City', kind: 'text' },
+      { key: 'state', label: 'State (UF)', kind: 'text' },
+    ],
+  },
+  product: {
+    label: 'Product',
+    icon: '📦',
+    blurb: 'Value-added goods, seeds, tools, infrastructure, or soil inputs.',
+    fields: [
+      { key: 'title', label: 'Title', kind: 'text', required: true },
+      { key: 'category', label: 'Product category', kind: 'select', required: true, options: [['value_added', 'Value-Added Good'], ['seeds_young', 'Seeds / Live Plants / Young'], ['tools', 'Node Management Tools'], ['infrastructure', 'Infrastructure & Environmental Control'], ['soil_input', 'Soil Input']] },
+      { key: 'description', label: 'Description', kind: 'textarea' },
+      { key: 'price', label: 'Price per item', kind: 'number', required: true },
+      { key: 'quantity_available', label: 'Inventory (blank = made to order)', kind: 'number' },
+      { key: 'city', label: 'City', kind: 'text' },
+      { key: 'state', label: 'State (UF)', kind: 'text' },
+      { key: 'terms', label: 'Terms', kind: 'text' },
+    ],
+  },
+};
+
+// Build the POST /posts request body from collected form values + uploaded media.
+export function buildPostBody(postType, values, media) {
+  const form = POST_TYPE_FORMS[postType];
+  const body = { post_type: postType, media: media || [], payload: {} };
+  for (const f of form.fields) {
+    const v = values[f.key];
+    if (v === undefined || v === '') continue;
+    const val = f.kind === 'number' ? Number(v) : v;
+    if (f.payload || !TOP_LEVEL.has(f.key)) body.payload[f.key] = val;
+    else body[f.key] = val;
+  }
+  return body;
+}

From e3a2fa3d2c096565c904dd5e04e548f023c11415 Mon Sep 17 00:00:00 2001
From: Jodson Graves <info@ntari.org>
Date: Mon, 29 Jun 2026 21:53:33 -0400
Subject: [PATCH 02/16] feat(posts): add Plans + Agrotourism post types (Phase
 2 complete)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- lib/postTypes.js: plan_producer, plan_consumer, agrotourism field
  sets per whitepaper §4.5.3.2/.4 (PING rate, contract shares,
  planting/harvest dates, hydration/nutrition/health plans, event kind)
- marketplace: "Planos" pill groups both plan types client-side
  (single post_type param can't), + Agroturismo pill + demo rows
- My Farm now surfaces plan_consumer too so nothing created is orphaned

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 app/farm/page.js        |  2 +-
 app/marketplace/page.js | 21 +++++++++----
 lib/i18n.js             |  2 ++
 lib/postTypes.js        | 65 +++++++++++++++++++++++++++++++++++++++++
 4 files changed, 83 insertions(+), 7 deletions(-)

diff --git a/app/farm/page.js b/app/farm/page.js
index a573086..8560dd8 100644
--- a/app/farm/page.js
+++ b/app/farm/page.js
@@ -8,7 +8,7 @@ export default function MyFarm() {
     <MyPosts
       title="Minha Fazenda"
       subtitle="Gerencie sua produção: planos, produtos, venda direta e agroturismo."
-      types={['direct_market', 'product', 'plan_producer', 'agrotourism']}
+      types={['direct_market', 'product', 'plan_producer', 'plan_consumer', 'agrotourism']}
       defaultType="direct_market"
       newLabel="Novo anúncio"
     />
diff --git a/app/marketplace/page.js b/app/marketplace/page.js
index 3396e72..8ea7910 100644
--- a/app/marketplace/page.js
+++ b/app/marketplace/page.js
@@ -11,10 +11,12 @@ import { useI18n } from '@/lib/i18n';
 
 // Whitepaper §4.5.2 General Broadcast — filter by post type.
 const POST_TYPES = [
-  { value: '',              label: 'Tudo',      emoji: '✨' },
-  { value: 'service',       label: 'Serviços',  emoji: '🧰' },
-  { value: 'direct_market', label: 'Mercado',   emoji: '🥕' },
-  { value: 'product',       label: 'Produtos',  emoji: '📦' },
+  { value: '',              label: 'Tudo',        emoji: '✨' },
+  { value: 'service',       label: 'Serviços',    emoji: '🧰' },
+  { value: 'direct_market', label: 'Mercado',     emoji: '🥕' },
+  { value: 'product',       label: 'Produtos',    emoji: '📦' },
+  { value: 'plan',          label: 'Planos',      emoji: '📋' },
+  { value: 'agrotourism',   label: 'Agroturismo', emoji: '🌄' },
 ];
 
 const STATES = ['SP','MG','PR','RS','GO','MT','MS','BA','SC','PE','CE','RO','PA'];
@@ -28,6 +30,8 @@ const DEMO = [
   { id: 'd6', post_type: 'product',       title: 'Sementes de Milho Híbrido', category: 'seeds_young', city: 'Cajamar',      state: 'SP', price: 320.00, quantity_available: 200 },
   { id: 'd7', post_type: 'product',       title: 'Trator New Holland T7.240', category: 'tools',       city: 'Cascavel',     state: 'PR', price: 480000, quantity_available: 1 },
   { id: 'd8', post_type: 'service',       title: 'Transporte de Grãos',       category: 'lr',          city: 'Uberaba',      state: 'MG', terms: 'R$ 4,50/km' },
+  { id: 'd9', post_type: 'plan_producer', title: 'Plano de Soja 2026',         city: 'Sorriso',      state: 'MT', price: 150.00, unit: 'saca', quantity_available: 800 },
+  { id: 'd10', post_type: 'agrotourism',  title: 'Tour na Fazenda Orgânica',   category: 'event',    city: 'Holambra',     state: 'SP', price: 45.00 },
 ];
 
 function MarketplaceInner() {
@@ -44,10 +48,14 @@ function MarketplaceInner() {
   const [filtersOpen, setFiltersOpen] = useState(false);
   const { t } = useI18n();
 
+  // The "Planos" pill groups both plan types (one post_type query param can't); filter client-side.
+  const isPlan = l => l.post_type === 'plan_consumer' || l.post_type === 'plan_producer';
+  const matchesType = l => !ptype || (ptype === 'plan' ? isPlan(l) : l.post_type === ptype);
+
   async function load() {
     setListings(null);
     let qs = '?status=active&limit=40';
-    if (ptype)  qs += '&post_type=' + ptype;
+    if (ptype && ptype !== 'plan') qs += '&post_type=' + ptype;
     if (stateF) qs += '&state=' + stateF;
     if (minP)   qs += '&minPrice=' + minP;
     if (maxP)   qs += '&maxPrice=' + maxP;
@@ -55,13 +63,14 @@ function MarketplaceInner() {
     try {
       const data = await api('/posts' + qs);
       let items = data.posts || data.listings || data || [];
+      if (ptype === 'plan') items = items.filter(isPlan);
       if (search) items = items.filter(l =>
         l.title.toLowerCase().includes(search.toLowerCase()) ||
         l.city?.toLowerCase().includes(search.toLowerCase())
       );
       setListings(items);
     } catch {
-      setListings(DEMO.filter(l => !ptype || l.post_type === ptype));
+      setListings(DEMO.filter(matchesType));
     }
   }
 
diff --git a/lib/i18n.js b/lib/i18n.js
index 7442145..2208e03 100644
--- a/lib/i18n.js
+++ b/lib/i18n.js
@@ -90,6 +90,8 @@ const EN = {
   'Recebeu? Confirme e o produtor recebe na hora. Simples assim.': 'Received it? Confirm and the producer gets paid instantly. Simple as that.',
   'Tudo': 'All',
   'Produtos': 'Products',
+  'Planos': 'Plans',
+  'Agroturismo': 'Agrotourism',
   'Produtos agrícolas e serviços de produtores de todo o Brasil': 'Agricultural products and services from producers across Brazil',
   'Grãos & Cereais': 'Grains & Cereals',
   'Frutas & Hortaliças': 'Fruits & Vegetables',
diff --git a/lib/postTypes.js b/lib/postTypes.js
index 9a571dc..5def9d8 100644
--- a/lib/postTypes.js
+++ b/lib/postTypes.js
@@ -6,6 +6,9 @@
 export const USE_CATEGORIES = ['food', 'pharmaceutical', 'fiber', 'chemical', 'mineral', 'ornamental'];
 const ucOptions = USE_CATEGORIES.map((c) => [c, c.charAt(0).toUpperCase() + c.slice(1)]);
 
+const PING_OPTS = [['daily', 'Daily'], ['weekly', 'Weekly'], ['monthly', 'Monthly']];
+const SHARES_OPTS = [['none', 'No shares'], ['fixed', 'Fixed shares'], ['variable', 'Variable shares']];
+
 const TOP_LEVEL = new Set(['title', 'description', 'category', 'price', 'unit', 'quantity_available', 'city', 'state', 'terms']);
 
 export const POST_TYPE_FORMS = {
@@ -57,6 +60,68 @@ export const POST_TYPE_FORMS = {
       { key: 'terms', label: 'Terms', kind: 'text' },
     ],
   },
+  plan_producer: {
+    label: 'Producer Plan',
+    icon: '🌱',
+    blurb: 'A plant→harvest plan buyers can contract against, with scheduled PING updates.',
+    fields: [
+      { key: 'title', label: 'Title', kind: 'text', required: true },
+      { key: 'description', label: 'Description', kind: 'textarea' },
+      { key: 'variety', label: 'Variety', kind: 'text', payload: true },
+      { key: 'use_category', label: 'Use category', kind: 'select', payload: true, options: ucOptions },
+      { key: 'planting_date', label: 'Planting date', kind: 'date', payload: true },
+      { key: 'expected_harvest_date', label: 'Expected harvest date', kind: 'date', payload: true },
+      { key: 'quantity_available', label: 'Expected yield (amount)', kind: 'number' },
+      { key: 'unit', label: 'Unit', kind: 'text', placeholder: 'kg, saca…' },
+      { key: 'price', label: 'Sold by price (per unit)', kind: 'number' },
+      { key: 'ping_rate', label: 'PING rate', kind: 'select', payload: true, options: PING_OPTS },
+      { key: 'contract_shares', label: 'Contract shares', kind: 'select', payload: true, options: SHARES_OPTS },
+      { key: 'hydration_plan', label: 'Hydration plan', kind: 'text', payload: true },
+      { key: 'nutrition_plan', label: 'Nutrition plan', kind: 'text', payload: true },
+      { key: 'health_plan', label: 'Health plan', kind: 'text', payload: true },
+      { key: 'city', label: 'City', kind: 'text' },
+      { key: 'state', label: 'State (UF)', kind: 'text' },
+    ],
+  },
+  plan_consumer: {
+    label: 'Consumer Plan',
+    icon: '📋',
+    blurb: 'Request future production from growers, with optional contract shares.',
+    fields: [
+      { key: 'title', label: 'Title', kind: 'text', required: true },
+      { key: 'description', label: 'Description', kind: 'textarea' },
+      { key: 'variety', label: 'Variety', kind: 'text', payload: true },
+      { key: 'use_category', label: 'Use category', kind: 'select', payload: true, options: ucOptions },
+      { key: 'desired_planting_date', label: 'Desired planting date', kind: 'date', payload: true },
+      { key: 'desired_harvest_date', label: 'Desired harvest date', kind: 'date', payload: true },
+      { key: 'needed_by_date', label: 'Needed by date', kind: 'date', payload: true },
+      { key: 'quantity_available', label: 'Required amount', kind: 'number' },
+      { key: 'unit', label: 'Unit', kind: 'text', placeholder: 'kg, saca…' },
+      { key: 'price', label: 'Price per amount', kind: 'number' },
+      { key: 'ping_rate', label: 'PING rate', kind: 'select', payload: true, options: PING_OPTS },
+      { key: 'contract_shares', label: 'Contract shares', kind: 'select', payload: true, options: SHARES_OPTS },
+      { key: 'hydration_plan', label: 'Hydration plan (optional)', kind: 'text', payload: true },
+      { key: 'nutrition_plan', label: 'Nutrition plan (optional)', kind: 'text', payload: true },
+      { key: 'health_plan', label: 'Health plan (optional)', kind: 'text', payload: true },
+      { key: 'city', label: 'City', kind: 'text' },
+      { key: 'state', label: 'State (UF)', kind: 'text' },
+    ],
+  },
+  agrotourism: {
+    label: 'Agrotourism',
+    icon: '🌄',
+    blurb: 'Market gardens, events, tours, education, and volunteering.',
+    fields: [
+      { key: 'title', label: 'Title', kind: 'text', required: true },
+      { key: 'category', label: 'Type', kind: 'select', options: [['market_garden', 'Market Garden'], ['event', 'Event']] },
+      { key: 'event_kind', label: 'Event kind (if event)', kind: 'select', payload: true, options: [['entertainment', 'Entertainment'], ['education', 'Education'], ['volunteering', 'Volunteering'], ['community', 'Community'], ['tour', 'Tour']] },
+      { key: 'description', label: 'Description', kind: 'textarea' },
+      { key: 'price', label: 'Cost (optional)', kind: 'number' },
+      { key: 'date_time', label: 'Date', kind: 'date', payload: true },
+      { key: 'city', label: 'City', kind: 'text' },
+      { key: 'state', label: 'State (UF)', kind: 'text' },
+    ],
+  },
 };
 
 // Build the POST /posts request body from collected form values + uploaded media.

From 0e72fbcb1d72a74e88f5a4967e092d3629632235 Mon Sep 17 00:00:00 2001
From: Jodson Graves <info@ntari.org>
Date: Tue, 30 Jun 2026 05:34:32 -0400
Subject: [PATCH 03/16] =?UTF-8?q?feat(lbtas):=20Phase=203=20frontend=20?=
 =?UTF-8?q?=E2=80=94=20rating=20prompt=20+=20distribution=20display?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Reputation is rendered as the canonical LBTAS distribution (a row of the six
static levels -1..+4 with the live count beneath each, single divider) — never
an average. Matches the reference "How to Display LBTAS Ratings".

- lib/lbtas.js: client mirror of the scale (levels, labels, descriptions,
  totalOf, word count)
- components/ratings/LbtasDistribution.js: the static-levels / dynamic-counts display
- components/ratings/RatePrompt.js: -1..+4 selector + comment box that becomes
  required (<=500 words) when -1 is chosen -> POST /ratings/transactions/:id
- app/perfil: replace the meaningless "Rep: N" badge with the distribution
  (GET /ratings/me); add a Rate button to rateable transactions
- app/contracts: functional page — pending-rating prompt feed
  (GET /ratings/me/pending) + my reputation distribution
- i18n: rating UI strings

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 app/contracts/page.js                   |  85 +++++++++++++++----
 app/perfil/page.js                      |  29 ++++++-
 components/ratings/LbtasDistribution.js |  65 +++++++++++++++
 components/ratings/RatePrompt.js        | 105 ++++++++++++++++++++++++
 lib/i18n.js                             |  21 +++++
 lib/lbtas.js                            |  36 ++++++++
 6 files changed, 323 insertions(+), 18 deletions(-)
 create mode 100644 components/ratings/LbtasDistribution.js
 create mode 100644 components/ratings/RatePrompt.js
 create mode 100644 lib/lbtas.js

diff --git a/app/contracts/page.js b/app/contracts/page.js
index 02e5d22..607e0eb 100644
--- a/app/contracts/page.js
+++ b/app/contracts/page.js
@@ -1,29 +1,43 @@
 'use client';
 import { useEffect, useState } from 'react';
 import { useRouter } from 'next/navigation';
+import { api } from '@/lib/api';
 import { getUser } from '@/lib/auth';
+import { formatCurrency, formatDate } from '@/lib/format';
 import { useI18n } from '@/lib/i18n';
+import LbtasDistribution from '@/components/ratings/LbtasDistribution';
+import RatePrompt from '@/components/ratings/RatePrompt';
 
-// Contracts/PING/transactions side (whitepaper §4.5.4-.5). The existing
-// transactions view + the LBTAS-gated escrow release wire in here in Phases 3-4.
-const SECTIONS = [
-  { icon: '📑', title: 'Plans & PINGs', desc: 'Consumer/producer plans and the PING update schedule.' },
-  { icon: '⇄', title: 'Transactions', desc: 'Purchases, escrow holds, and settlement status.' },
-  { icon: '📅', title: 'PING Calendar', desc: 'Planting, harvest, and PING report dates.' },
-  { icon: '⭐', title: 'LBTAS Ratings', desc: 'One −1…+4 rating per transaction; required before escrow release.' },
-];
-
+// Contracts side (whitepaper §4.5.4-.5). Phase 3 surfaces the LBTAS prompt feed
+// (transactions awaiting your rating) and your own reputation distribution.
 export default function MyContracts() {
   const router = useRouter();
   const { t } = useI18n();
   const [user, setUser] = useState(null);
+  const [pending, setPending] = useState(null);
+  const [myRep, setMyRep] = useState(null);
+  const [rateItem, setRateItem] = useState(null);
 
   useEffect(() => {
     const u = getUser();
     if (!u) { router.push('/'); return; }
     setUser(u);
+    load();
   }, []);
 
+  async function load() {
+    try {
+      const [p, rep] = await Promise.all([
+        api('/ratings/me/pending').catch(() => ({ pending: [] })),
+        api('/ratings/me').catch(() => null),
+      ]);
+      setPending(p.pending || []);
+      setMyRep(rep);
+    } catch {
+      setPending([]);
+    }
+  }
+
   if (!user) return null;
 
   return (
@@ -31,17 +45,54 @@ export default function MyContracts() {
       <div style={{ maxWidth: 1000, margin: '0 auto', padding: 'clamp(20px,3vw,40px) var(--page-pad)' }}>
         <h1 className="font-serif text-3xl font-black text-soil mb-1">{t('Meus Contratos')}</h1>
         <p className="text-sm text-text3 mb-6">{t('Acompanhe planos, PINGs, transações e avaliações LBTAS.')}</p>
-        <div className="grid gap-4" style={{ gridTemplateColumns: 'repeat(auto-fit, minmax(min(240px,100%),1fr))' }}>
-          {SECTIONS.map(s => (
-            <div key={s.title} className="card-agro p-5 flex flex-col">
-              <div className="text-2xl mb-2">{s.icon}</div>
-              <div className="font-semibold text-soil">{s.title}</div>
-              <div className="text-sm text-text3 mt-1 flex-1">{s.desc}</div>
-              <span className="badge-agro badge-wheat text-[10px] mt-3 self-start">{t('Em breve')}</span>
+
+        {/* ── MY REPUTATION ── */}
+        <div className="card-agro p-5 mb-5">
+          <div className="text-xs font-semibold uppercase tracking-widest text-text3 mb-3">{t('Minha reputação')}</div>
+          <LbtasDistribution distribution={myRep?.distribution} total={myRep?.total} size="md" />
+          <p className="text-xs text-text3 mt-3 italic">{t('Reputação é uma distribuição, nunca uma média.')}</p>
+        </div>
+
+        {/* ── PENDING RATINGS (the bidirectional prompt feed) ── */}
+        <div className="card-agro p-5">
+          <div className="text-xs font-semibold uppercase tracking-widest text-text3 mb-1">{t('Avaliações pendentes')}</div>
+          <p className="text-xs text-text3 mb-4">{t('Avalie suas transações para construir confiança na rede.')}</p>
+
+          {pending === null ? (
+            <div className="flex flex-col gap-2">{Array(2).fill(0).map((_, i) => <div key={i} className="skeleton h-16 rounded-xl" />)}</div>
+          ) : pending.length === 0 ? (
+            <div className="flex flex-col items-center py-10 gap-2">
+              <span className="text-3xl">✅</span>
+              <p className="text-sm text-text3">{t('Nada pendente para avaliar')}</p>
             </div>
-          ))}
+          ) : (
+            <div className="flex flex-col gap-3">
+              {pending.map((item) => (
+                <div key={item.transaction_id} className="tx-item">
+                  <div className="tx-icon">⭐</div>
+                  <div className="flex-1 min-w-0">
+                    <div className="text-[15px] font-semibold text-soil leading-tight">{item.listing_title || t('Produto')}</div>
+                    <div className="text-xs text-text3 mt-1">
+                      {item.role === 'buyer' ? t('Compra') : t('Venda')} · {formatCurrency(item.amount)} · {formatDate(item.created_at)}
+                    </div>
+                  </div>
+                  <button className="btn btn-primary btn-sm self-center" onClick={() => setRateItem(item)}>{t('Avaliar')}</button>
+                </div>
+              ))}
+            </div>
+          )}
         </div>
       </div>
+
+      {rateItem && (
+        <RatePrompt
+          transactionId={rateItem.transaction_id}
+          title={rateItem.listing_title}
+          counterparty={rateItem.counterparty_id}
+          onClose={() => setRateItem(null)}
+          onRated={load}
+        />
+      )}
     </div>
   );
 }
diff --git a/app/perfil/page.js b/app/perfil/page.js
index f187fb4..23f9736 100644
--- a/app/perfil/page.js
+++ b/app/perfil/page.js
@@ -11,6 +11,8 @@ import NewListingModal from '@/components/listings/NewListingModal';
 import { Modal, ModalHeader } from '@/components/ui/Modal';
 import { useToast } from '@/components/ui/Toast';
 import { Avatar, AvatarFallback } from '@/components/ui/avatar';
+import LbtasDistribution from '@/components/ratings/LbtasDistribution';
+import RatePrompt from '@/components/ratings/RatePrompt';
 import { useI18n } from '@/lib/i18n';
 
 const HIST_ICON = {
@@ -42,14 +44,21 @@ function PerfilInner() {
   const [depAmt, setDepAmt]       = useState('');
   const [txDetail, setTxDetail]   = useState(null);
   const [loading, setLoading]     = useState(false);
+  const [myRep, setMyRep]         = useState(null);
+  const [rateTx, setRateTx]       = useState(null);
 
   useEffect(() => {
     const u = getUser();
     if (!u) { router.push('/'); return; }
     setUser(u);
     loadWallet();
+    loadMyRep();
   }, []);
 
+  async function loadMyRep() {
+    try { setMyRep(await api('/ratings/me')); } catch {}
+  }
+
   useEffect(() => {
     if (!user) return;
     if (tab === 'wallet')     loadWallet();
@@ -150,8 +159,13 @@ function PerfilInner() {
             <div className="flex gap-2 mt-2 flex-wrap">
               <Badge variant="green">{user.trust_level || 'new'}</Badge>
               {isAdmin(user) && <Badge variant="wheat">{t('Admin')}</Badge>}
-              <Badge variant="gray">Rep: {user.reputation_score ?? 0}</Badge>
             </div>
+            {myRep && (
+              <div className="mt-3">
+                <div className="text-[10px] font-semibold uppercase tracking-widest text-text3 mb-1">{t('Minha reputação')}</div>
+                <LbtasDistribution distribution={myRep.distribution} total={myRep.total} size="sm" />
+              </div>
+            )}
           </div>
           <button className="btn btn-ghost btn-sm self-start" onClick={() => { clearAuth(); router.push('/'); }}>
             {t('Sair')}
@@ -248,6 +262,8 @@ function PerfilInner() {
                       </div>
                     : txs.map((tx, i) => {
                         const isBuyer = tx.buyer_id === user.id;
+                        const canRate = ['paid', 'completed'].includes(tx.status) &&
+                          (isBuyer ? !tx.buyer_rated : !tx.seller_rated);
                         return (
                           <motion.div
                             key={tx.id}
@@ -267,6 +283,7 @@ function PerfilInner() {
                                 {tx.status === 'pending'  && isBuyer  && <button className="btn btn-primary btn-sm"  onClick={() => payTx(tx.id)}>{t('Pagar')}</button>}
                                 {tx.status === 'paid'     && !isBuyer && <button className="btn btn-ghost btn-sm"    onClick={() => releaseTx(tx.id)}>{t('Liberar')}</button>}
                                 {tx.status === 'paid'     && isBuyer  && <button className="btn btn-danger btn-sm"   onClick={() => disputeTx(tx.id)}>{t('Disputar')}</button>}
+                                {canRate && <button className="btn btn-primary btn-sm" onClick={() => setRateTx(tx)}>{t('Avaliar')}</button>}
                                 <button className="btn btn-ghost btn-sm" onClick={() => showTxDetail(tx.id)}>{t('Ver')}</button>
                               </div>
                             </div>
@@ -353,6 +370,16 @@ function PerfilInner() {
       )}
 
       {newListing && <NewListingModal onClose={() => setNewListing(false)} onCreated={loadMyListings} />}
+
+      {rateTx && (
+        <RatePrompt
+          transactionId={rateTx.id}
+          title={rateTx.listing_title}
+          counterparty={rateTx.buyer_id === user.id ? rateTx.seller_id : rateTx.buyer_id}
+          onClose={() => setRateTx(null)}
+          onRated={() => { loadTxs(); loadMyRep(); }}
+        />
+      )}
     </div>
   );
 }
diff --git a/components/ratings/LbtasDistribution.js b/components/ratings/LbtasDistribution.js
new file mode 100644
index 0000000..30ab73f
--- /dev/null
+++ b/components/ratings/LbtasDistribution.js
@@ -0,0 +1,65 @@
+'use client';
+import { LEVELS, LEVEL_LABELS, totalOf, signed } from '@/lib/lbtas';
+import { useI18n } from '@/lib/i18n';
+
+/**
+ * LBTAS reputation display — the canonical "How to Display LBTAS Ratings" layout:
+ * a row of the six STATIC levels (-1..+4) with the DYNAMIC count beneath each,
+ * separated by a single divider line. Counts are a distribution — never averaged.
+ *
+ * props: distribution ({ "-1":n, "0":n, ... }), total (optional), size, showTotal
+ */
+export default function LbtasDistribution({ distribution, total, size = 'md', showTotal = true }) {
+  const { t } = useI18n();
+  const dist = distribution || {};
+  const sum = total != null ? total : totalOf(dist);
+  const harm = Number(dist['-1'] || 0);
+
+  const big = { sm: 'text-base', md: 'text-2xl', lg: 'text-4xl' }[size] || 'text-2xl';
+  const small = { sm: 'text-[11px]', md: 'text-sm', lg: 'text-base' }[size] || 'text-sm';
+  const gap = size === 'lg' ? 'gap-x-5' : 'gap-x-3';
+
+  if (sum === 0) {
+    return <div className="text-xs text-text3">{t('Sem avaliações ainda')}</div>;
+  }
+
+  return (
+    <div className="inline-block">
+      <div className={`grid ${gap} items-center`} style={{ gridTemplateColumns: `repeat(${LEVELS.length}, minmax(1.6em, 1fr))` }}>
+        {/* static level row */}
+        {LEVELS.map((level) => (
+          <div
+            key={`h${level}`}
+            title={LEVEL_LABELS[String(level)]}
+            className={`text-center font-serif font-black leading-none ${big} ${level === -1 ? 'text-rust' : 'text-soil'}`}>
+            {signed(level)}
+          </div>
+        ))}
+
+        {/* single divider spanning all columns */}
+        <div style={{ gridColumn: '1 / -1' }} className="border-t border-[var(--border-c2)] my-1.5" />
+
+        {/* dynamic count row */}
+        {LEVELS.map((level) => {
+          const count = Number(dist[String(level)] || 0);
+          return (
+            <div
+              key={`c${level}`}
+              className={`text-center tabular-nums ${small} ${level === -1 && count > 0 ? 'text-rust font-semibold' : 'text-text3'}`}>
+              {count}
+            </div>
+          );
+        })}
+      </div>
+
+      {showTotal && (
+        <div className="mt-2 text-xs text-text3">
+          {sum} {sum === 1 ? t('avaliação') : t('avaliações')}
+          {harm > 0 && (
+            <span className="text-rust font-semibold"> · {harm}× -1 {t('Sem confiança')}</span>
+          )}
+        </div>
+      )}
+    </div>
+  );
+}
diff --git a/components/ratings/RatePrompt.js b/components/ratings/RatePrompt.js
new file mode 100644
index 0000000..83da794
--- /dev/null
+++ b/components/ratings/RatePrompt.js
@@ -0,0 +1,105 @@
+'use client';
+import { useState } from 'react';
+import { Modal, ModalHeader } from '@/components/ui/Modal';
+import { api } from '@/lib/api';
+import { useToast } from '@/components/ui/Toast';
+import { useI18n } from '@/lib/i18n';
+import { LEVELS, LEVEL_LABELS, LEVEL_DESCRIPTIONS, MAX_COMMENT_WORDS, wordCount, signed } from '@/lib/lbtas';
+
+/**
+ * LBTAS rating prompt. Bidirectional: one -1..+4 rating per transaction per side.
+ * A -1 ("No Trust") requires a justifying comment of <=500 words (enforced here and
+ * again at the API boundary).
+ */
+export default function RatePrompt({ transactionId, title, counterparty, onClose, onRated }) {
+  const toast = useToast();
+  const { t } = useI18n();
+  const [value, setValue] = useState(null);
+  const [comment, setComment] = useState('');
+  const [loading, setLoading] = useState(false);
+
+  const wc = wordCount(comment);
+  const needsComment = value === -1;
+  const commentTooLong = wc > MAX_COMMENT_WORDS;
+  const blocked = value === null || (needsComment && !comment.trim()) || commentTooLong;
+
+  async function submit() {
+    if (value === null) return toast(t('Selecione uma avaliação'), 'error');
+    if (needsComment && !comment.trim()) return toast(t('Uma avaliação -1 exige um comentário'), 'error');
+    if (commentTooLong) return toast(t('Comentário muito longo'), 'error');
+    setLoading(true);
+    try {
+      await api('/ratings/transactions/' + transactionId, 'POST', {
+        rating: value,
+        comment: comment.trim() || undefined,
+      });
+      toast(t('Avaliação registrada!'));
+      onClose();
+      onRated?.();
+    } catch (e) {
+      toast(e.message, 'error');
+    } finally {
+      setLoading(false);
+    }
+  }
+
+  return (
+    <Modal onClose={onClose} maxWidth="520px">
+      <ModalHeader title={t('Avaliar transação')} onClose={onClose} />
+
+      {title && <p className="text-sm font-semibold text-soil mb-0.5">{title}</p>}
+      {counterparty && <p className="text-xs text-text3 mb-4">{t('Avaliando')}: {counterparty}</p>}
+
+      {/* level selector — same -1..+4 order as the display */}
+      <div className="grid gap-2" style={{ gridTemplateColumns: 'repeat(6, 1fr)' }}>
+        {LEVELS.map((level) => {
+          const active = value === level;
+          const isHarm = level === -1;
+          return (
+            <button
+              key={level}
+              type="button"
+              onClick={() => setValue(level)}
+              title={LEVEL_LABELS[String(level)]}
+              className={`flex items-center justify-center py-3 rounded-lg border transition-colors font-serif text-xl font-black ${
+                active
+                  ? isHarm ? 'border-rust bg-rust/10 text-rust' : 'border-moss bg-moss-light text-soil'
+                  : `border-[var(--border-c)] hover:border-moss ${isHarm ? 'text-rust' : 'text-soil'}`
+              }`}>
+              {signed(level)}
+            </button>
+          );
+        })}
+      </div>
+
+      {value !== null && (
+        <div className="mt-3 text-sm leading-snug">
+          <span className="font-semibold text-soil">{LEVEL_LABELS[String(value)]}</span>
+          <span className="text-text3"> — {LEVEL_DESCRIPTIONS[String(value)]}</span>
+        </div>
+      )}
+
+      {/* comment — mandatory on -1 */}
+      <div className="form-group mt-4">
+        <label className="form-label">
+          {t('Comentário')}{' '}
+          {needsComment
+            ? <span className="text-rust">({t('obrigatório')})</span>
+            : <span className="text-text3">({t('opcional')})</span>}
+        </label>
+        <textarea
+          className="form-input min-h-[80px] resize-y"
+          value={comment}
+          onChange={(e) => setComment(e.target.value)}
+          placeholder={needsComment ? t('Explique o que houve (máx. 500 palavras)') : ''} />
+        <div className={`text-xs mt-1 text-right ${commentTooLong ? 'text-rust' : 'text-text3'}`}>
+          {wc}/{MAX_COMMENT_WORDS}
+        </div>
+      </div>
+
+      <button className="btn btn-primary w-full mt-2" onClick={submit} disabled={loading || blocked}>
+        {loading ? t('Enviando...') : t('Enviar avaliação')}
+      </button>
+    </Modal>
+  );
+}
diff --git a/lib/i18n.js b/lib/i18n.js
index 2208e03..8442d62 100644
--- a/lib/i18n.js
+++ b/lib/i18n.js
@@ -252,6 +252,27 @@ const EN = {
   'Pagar': 'Pay',
   'Disputar': 'Dispute',
   'Ver': 'View',
+  'Avaliar': 'Rate',
+  'Avaliar transação': 'Rate transaction',
+  'Avaliando': 'Rating',
+  'Selecione uma avaliação': 'Select a rating',
+  'Uma avaliação -1 exige um comentário': 'A -1 rating requires a comment',
+  'Comentário muito longo': 'Comment too long',
+  'Avaliação registrada!': 'Rating submitted!',
+  'Comentário': 'Comment',
+  'obrigatório': 'required',
+  'opcional': 'optional',
+  'Explique o que houve (máx. 500 palavras)': 'Explain what happened (max 500 words)',
+  'Enviar avaliação': 'Submit rating',
+  'Sem avaliações ainda': 'No ratings yet',
+  'avaliação': 'rating',
+  'avaliações': 'ratings',
+  'Sem confiança': 'No Trust',
+  'Minha reputação': 'My reputation',
+  'Reputação é uma distribuição, nunca uma média.': 'Reputation is a distribution, never an average.',
+  'Avaliações pendentes': 'Pending ratings',
+  'Nada pendente para avaliar': 'Nothing pending to rate',
+  'Avalie suas transações para construir confiança na rede.': 'Rate your transactions to build trust across the network.',
   'Seus anúncios publicados': 'Your published listings',
   'Novo anúncio': 'New listing',
   'Novo serviço': 'New service',
diff --git a/lib/lbtas.js b/lib/lbtas.js
new file mode 100644
index 0000000..9274071
--- /dev/null
+++ b/lib/lbtas.js
@@ -0,0 +1,36 @@
+// LBTAS scale (client-side mirror of the backend services/lbtas.js).
+// Levels run -1..+4 ascending — the order used by the reputation display.
+export const LEVELS = [-1, 0, 1, 2, 3, 4];
+
+export const LEVEL_LABELS = {
+  '-1': 'No Trust',
+  '0': 'Cynical Satisfaction',
+  '1': 'Basic Promise',
+  '2': 'Basic Satisfaction',
+  '3': 'No Negative Consequences',
+  '4': 'Delight',
+};
+
+export const LEVEL_DESCRIPTIONS = {
+  '-1': 'User was harmed, exploited, or received a product/service with evidence of no discipline or malicious intent.',
+  '0': 'Interaction fulfills a basic promise requiring little to no discipline toward user satisfaction.',
+  '1': 'Interaction meets all articulated user demands, no more.',
+  '2': 'Interaction meets socially acceptable standards, exceeding articulated user demands.',
+  '3': 'Interaction designed to prevent loss, exceeding basic quality standards.',
+  '4': 'Interaction anticipates the evolution of user practices and concerns post-transaction.',
+};
+
+export const MAX_COMMENT_WORDS = 500;
+
+// Total = sum of all per-level counts. Reputation is this distribution, never an average.
+export function totalOf(dist) {
+  return LEVELS.reduce((s, l) => s + Number(dist?.[String(l)] || 0), 0);
+}
+
+export function wordCount(text) {
+  return String(text || '').trim().split(/\s+/).filter(Boolean).length;
+}
+
+export function signed(level) {
+  return level > 0 ? `+${level}` : String(level);
+}

From 22d0baaef35426f2514566e2d0ec1388e149d51f Mon Sep 17 00:00:00 2001
From: Jodson Graves <info@ntari.org>
Date: Tue, 30 Jun 2026 05:51:44 -0400
Subject: [PATCH 04/16] =?UTF-8?q?feat(escrow):=20Phase=204=20frontend=20?=
 =?UTF-8?q?=E2=80=94=20buyer=20rating=20confirms=20receipt=20+=20releases?=
 =?UTF-8?q?=20escrow?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- RatePrompt: releasesEscrow prop shows a "held payment released to seller"
  note, switches the CTA to "Confirm & release", and reports the payment-released
  toast when the API returns escrowReleased
- perfil: buyer's action on a paid tx is now "Confirm & rate"; the seller's
  "Liberar" button only appears once the buyer has rated (gate is server-enforced)
- contracts: pending buyer-side paid items flag releasesEscrow
- i18n: gate strings

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 app/contracts/page.js            |  1 +
 app/perfil/page.js               |  7 ++++---
 components/ratings/RatePrompt.js | 14 ++++++++++----
 lib/i18n.js                      |  4 ++++
 4 files changed, 19 insertions(+), 7 deletions(-)

diff --git a/app/contracts/page.js b/app/contracts/page.js
index 607e0eb..a959ec8 100644
--- a/app/contracts/page.js
+++ b/app/contracts/page.js
@@ -89,6 +89,7 @@ export default function MyContracts() {
           transactionId={rateItem.transaction_id}
           title={rateItem.listing_title}
           counterparty={rateItem.counterparty_id}
+          releasesEscrow={rateItem.role === 'buyer' && rateItem.status === 'paid'}
           onClose={() => setRateItem(null)}
           onRated={load}
         />
diff --git a/app/perfil/page.js b/app/perfil/page.js
index 23f9736..9626266 100644
--- a/app/perfil/page.js
+++ b/app/perfil/page.js
@@ -281,9 +281,9 @@ function PerfilInner() {
                               <div className="font-serif text-xl font-black text-soil">{formatCurrency(tx.amount)}</div>
                               <div className="flex gap-1.5 flex-wrap justify-end">
                                 {tx.status === 'pending'  && isBuyer  && <button className="btn btn-primary btn-sm"  onClick={() => payTx(tx.id)}>{t('Pagar')}</button>}
-                                {tx.status === 'paid'     && !isBuyer && <button className="btn btn-ghost btn-sm"    onClick={() => releaseTx(tx.id)}>{t('Liberar')}</button>}
+                                {tx.status === 'paid'     && !isBuyer && tx.buyer_rated && <button className="btn btn-ghost btn-sm" onClick={() => releaseTx(tx.id)}>{t('Liberar')}</button>}
                                 {tx.status === 'paid'     && isBuyer  && <button className="btn btn-danger btn-sm"   onClick={() => disputeTx(tx.id)}>{t('Disputar')}</button>}
-                                {canRate && <button className="btn btn-primary btn-sm" onClick={() => setRateTx(tx)}>{t('Avaliar')}</button>}
+                                {canRate && <button className="btn btn-primary btn-sm" onClick={() => setRateTx(tx)}>{isBuyer && tx.status === 'paid' ? t('Confirmar e avaliar') : t('Avaliar')}</button>}
                                 <button className="btn btn-ghost btn-sm" onClick={() => showTxDetail(tx.id)}>{t('Ver')}</button>
                               </div>
                             </div>
@@ -376,8 +376,9 @@ function PerfilInner() {
           transactionId={rateTx.id}
           title={rateTx.listing_title}
           counterparty={rateTx.buyer_id === user.id ? rateTx.seller_id : rateTx.buyer_id}
+          releasesEscrow={rateTx.buyer_id === user.id && rateTx.status === 'paid'}
           onClose={() => setRateTx(null)}
-          onRated={() => { loadTxs(); loadMyRep(); }}
+          onRated={() => { loadTxs(); loadMyRep(); loadWallet(); }}
         />
       )}
     </div>
diff --git a/components/ratings/RatePrompt.js b/components/ratings/RatePrompt.js
index 83da794..d46ee4b 100644
--- a/components/ratings/RatePrompt.js
+++ b/components/ratings/RatePrompt.js
@@ -11,7 +11,7 @@ import { LEVELS, LEVEL_LABELS, LEVEL_DESCRIPTIONS, MAX_COMMENT_WORDS, wordCount,
  * A -1 ("No Trust") requires a justifying comment of <=500 words (enforced here and
  * again at the API boundary).
  */
-export default function RatePrompt({ transactionId, title, counterparty, onClose, onRated }) {
+export default function RatePrompt({ transactionId, title, counterparty, releasesEscrow = false, onClose, onRated }) {
   const toast = useToast();
   const { t } = useI18n();
   const [value, setValue] = useState(null);
@@ -29,11 +29,11 @@ export default function RatePrompt({ transactionId, title, counterparty, onClose
     if (commentTooLong) return toast(t('Comentário muito longo'), 'error');
     setLoading(true);
     try {
-      await api('/ratings/transactions/' + transactionId, 'POST', {
+      const res = await api('/ratings/transactions/' + transactionId, 'POST', {
         rating: value,
         comment: comment.trim() || undefined,
       });
-      toast(t('Avaliação registrada!'));
+      toast(res?.escrowReleased ? t('Pagamento liberado ao vendedor!') : t('Avaliação registrada!'));
       onClose();
       onRated?.();
     } catch (e) {
@@ -50,6 +50,12 @@ export default function RatePrompt({ transactionId, title, counterparty, onClose
       {title && <p className="text-sm font-semibold text-soil mb-0.5">{title}</p>}
       {counterparty && <p className="text-xs text-text3 mb-4">{t('Avaliando')}: {counterparty}</p>}
 
+      {releasesEscrow && (
+        <div className="mb-4 text-xs bg-wheat/10 border border-wheat/40 rounded-lg p-2.5 text-soil leading-snug">
+          🔒 {t('Ao confirmar, o pagamento retido é liberado ao vendedor.')}
+        </div>
+      )}
+
       {/* level selector — same -1..+4 order as the display */}
       <div className="grid gap-2" style={{ gridTemplateColumns: 'repeat(6, 1fr)' }}>
         {LEVELS.map((level) => {
@@ -98,7 +104,7 @@ export default function RatePrompt({ transactionId, title, counterparty, onClose
       </div>
 
       <button className="btn btn-primary w-full mt-2" onClick={submit} disabled={loading || blocked}>
-        {loading ? t('Enviando...') : t('Enviar avaliação')}
+        {loading ? t('Enviando...') : releasesEscrow ? t('Confirmar e liberar') : t('Enviar avaliação')}
       </button>
     </Modal>
   );
diff --git a/lib/i18n.js b/lib/i18n.js
index 8442d62..6e0d043 100644
--- a/lib/i18n.js
+++ b/lib/i18n.js
@@ -253,6 +253,10 @@ const EN = {
   'Disputar': 'Dispute',
   'Ver': 'View',
   'Avaliar': 'Rate',
+  'Confirmar e avaliar': 'Confirm & rate',
+  'Confirmar e liberar': 'Confirm & release',
+  'Ao confirmar, o pagamento retido é liberado ao vendedor.': 'Confirming releases the held payment to the seller.',
+  'Pagamento liberado ao vendedor!': 'Payment released to the seller!',
   'Avaliar transação': 'Rate transaction',
   'Avaliando': 'Rating',
   'Selecione uma avaliação': 'Select a rating',

From 871f7d3146e7bb768dbfb08a8f0ff8d74e8313e5 Mon Sep 17 00:00:00 2001
From: Jodson Graves <info@ntari.org>
Date: Tue, 30 Jun 2026 06:34:47 -0400
Subject: [PATCH 05/16] feat(escrow): value-aware RatePrompt for the -1 dispute
 freeze

A buyer's -1 now warns that it opens a dispute and freezes payment (instead of
releasing), with a "Submit & open dispute" CTA and a "funds frozen" toast.
0..+4 keep the release note + "Confirm & release". Mirrors the backend change.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 components/ratings/RatePrompt.js | 20 ++++++++++++++++----
 lib/i18n.js                      |  5 ++++-
 2 files changed, 20 insertions(+), 5 deletions(-)

diff --git a/components/ratings/RatePrompt.js b/components/ratings/RatePrompt.js
index d46ee4b..dc8c299 100644
--- a/components/ratings/RatePrompt.js
+++ b/components/ratings/RatePrompt.js
@@ -33,7 +33,13 @@ export default function RatePrompt({ transactionId, title, counterparty, release
         rating: value,
         comment: comment.trim() || undefined,
       });
-      toast(res?.escrowReleased ? t('Pagamento liberado ao vendedor!') : t('Avaliação registrada!'));
+      toast(
+        res?.disputeOpened
+          ? t('Disputa aberta — fundos congelados para análise.')
+          : res?.escrowReleased
+            ? t('Pagamento liberado ao vendedor!')
+            : t('Avaliação registrada!')
+      );
       onClose();
       onRated?.();
     } catch (e) {
@@ -51,8 +57,10 @@ export default function RatePrompt({ transactionId, title, counterparty, release
       {counterparty && <p className="text-xs text-text3 mb-4">{t('Avaliando')}: {counterparty}</p>}
 
       {releasesEscrow && (
-        <div className="mb-4 text-xs bg-wheat/10 border border-wheat/40 rounded-lg p-2.5 text-soil leading-snug">
-          🔒 {t('Ao confirmar, o pagamento retido é liberado ao vendedor.')}
+        <div className={`mb-4 text-xs rounded-lg p-2.5 leading-snug border ${value === -1 ? 'bg-rust/10 border-rust/40 text-rust' : 'bg-wheat/10 border-wheat/40 text-soil'}`}>
+          {value === -1
+            ? '⚠ ' + t('Uma avaliação Sem Confiança (-1) abre uma disputa e congela o pagamento para análise.')
+            : '🔒 ' + t('Ao confirmar, o pagamento retido é liberado ao vendedor. Uma avaliação -1 abre uma disputa.')}
         </div>
       )}
 
@@ -104,7 +112,11 @@ export default function RatePrompt({ transactionId, title, counterparty, release
       </div>
 
       <button className="btn btn-primary w-full mt-2" onClick={submit} disabled={loading || blocked}>
-        {loading ? t('Enviando...') : releasesEscrow ? t('Confirmar e liberar') : t('Enviar avaliação')}
+        {loading
+          ? t('Enviando...')
+          : releasesEscrow
+            ? (value === -1 ? t('Enviar e abrir disputa') : t('Confirmar e liberar'))
+            : t('Enviar avaliação')}
       </button>
     </Modal>
   );
diff --git a/lib/i18n.js b/lib/i18n.js
index 6e0d043..41b71b5 100644
--- a/lib/i18n.js
+++ b/lib/i18n.js
@@ -255,8 +255,11 @@ const EN = {
   'Avaliar': 'Rate',
   'Confirmar e avaliar': 'Confirm & rate',
   'Confirmar e liberar': 'Confirm & release',
-  'Ao confirmar, o pagamento retido é liberado ao vendedor.': 'Confirming releases the held payment to the seller.',
+  'Enviar e abrir disputa': 'Submit & open dispute',
+  'Ao confirmar, o pagamento retido é liberado ao vendedor. Uma avaliação -1 abre uma disputa.': 'Confirming releases the held payment to the seller. A -1 rating opens a dispute instead.',
+  'Uma avaliação Sem Confiança (-1) abre uma disputa e congela o pagamento para análise.': 'A No Trust (-1) rating opens a dispute and freezes the payment for review.',
   'Pagamento liberado ao vendedor!': 'Payment released to the seller!',
+  'Disputa aberta — fundos congelados para análise.': 'Dispute opened — funds frozen for review.',
   'Avaliar transação': 'Rate transaction',
   'Avaliando': 'Rating',
   'Selecione uma avaliação': 'Select a rating',

From f9079f6cf2cef5a77ea20a7b223f3fe2d5e5ffa0 Mon Sep 17 00:00:00 2001
From: Jodson Graves <info@ntari.org>
Date: Tue, 30 Jun 2026 06:57:08 -0400
Subject: [PATCH 06/16] feat(lbtas): render reputation as separate
 distributions per role
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The same user can be an excellent market seller and a poor agrotourism host —
ReputationPanel shows one LBTAS distribution per role (from /ratings/me roles[]),
replacing the single mixed distribution on the profile and contracts pages.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 app/contracts/page.js                 |  6 +++---
 app/perfil/page.js                    |  8 ++++----
 components/ratings/ReputationPanel.js | 25 +++++++++++++++++++++++++
 lib/i18n.js                           |  1 +
 4 files changed, 33 insertions(+), 7 deletions(-)
 create mode 100644 components/ratings/ReputationPanel.js

diff --git a/app/contracts/page.js b/app/contracts/page.js
index a959ec8..cb70824 100644
--- a/app/contracts/page.js
+++ b/app/contracts/page.js
@@ -5,7 +5,7 @@ import { api } from '@/lib/api';
 import { getUser } from '@/lib/auth';
 import { formatCurrency, formatDate } from '@/lib/format';
 import { useI18n } from '@/lib/i18n';
-import LbtasDistribution from '@/components/ratings/LbtasDistribution';
+import ReputationPanel from '@/components/ratings/ReputationPanel';
 import RatePrompt from '@/components/ratings/RatePrompt';
 
 // Contracts side (whitepaper §4.5.4-.5). Phase 3 surfaces the LBTAS prompt feed
@@ -49,8 +49,8 @@ export default function MyContracts() {
         {/* ── MY REPUTATION ── */}
         <div className="card-agro p-5 mb-5">
           <div className="text-xs font-semibold uppercase tracking-widest text-text3 mb-3">{t('Minha reputação')}</div>
-          <LbtasDistribution distribution={myRep?.distribution} total={myRep?.total} size="md" />
-          <p className="text-xs text-text3 mt-3 italic">{t('Reputação é uma distribuição, nunca uma média.')}</p>
+          <ReputationPanel rep={myRep} size="md" />
+          <p className="text-xs text-text3 mt-3 italic">{t('Reputação é uma distribuição por papel, nunca uma média.')}</p>
         </div>
 
         {/* ── PENDING RATINGS (the bidirectional prompt feed) ── */}
diff --git a/app/perfil/page.js b/app/perfil/page.js
index 9626266..4ca5a0a 100644
--- a/app/perfil/page.js
+++ b/app/perfil/page.js
@@ -11,7 +11,7 @@ import NewListingModal from '@/components/listings/NewListingModal';
 import { Modal, ModalHeader } from '@/components/ui/Modal';
 import { useToast } from '@/components/ui/Toast';
 import { Avatar, AvatarFallback } from '@/components/ui/avatar';
-import LbtasDistribution from '@/components/ratings/LbtasDistribution';
+import ReputationPanel from '@/components/ratings/ReputationPanel';
 import RatePrompt from '@/components/ratings/RatePrompt';
 import { useI18n } from '@/lib/i18n';
 
@@ -160,10 +160,10 @@ function PerfilInner() {
               <Badge variant="green">{user.trust_level || 'new'}</Badge>
               {isAdmin(user) && <Badge variant="wheat">{t('Admin')}</Badge>}
             </div>
-            {myRep && (
+            {myRep && myRep.roles?.length > 0 && (
               <div className="mt-3">
-                <div className="text-[10px] font-semibold uppercase tracking-widest text-text3 mb-1">{t('Minha reputação')}</div>
-                <LbtasDistribution distribution={myRep.distribution} total={myRep.total} size="sm" />
+                <div className="text-[10px] font-semibold uppercase tracking-widest text-text3 mb-2">{t('Minha reputação')}</div>
+                <ReputationPanel rep={myRep} size="sm" />
               </div>
             )}
           </div>
diff --git a/components/ratings/ReputationPanel.js b/components/ratings/ReputationPanel.js
new file mode 100644
index 0000000..cc2ff21
--- /dev/null
+++ b/components/ratings/ReputationPanel.js
@@ -0,0 +1,25 @@
+'use client';
+import LbtasDistribution from './LbtasDistribution';
+import { useI18n } from '@/lib/i18n';
+
+// A user's reputation is SEPARATE per role — the same person can be an excellent
+// market seller and a poor agrotourism host. Renders one distribution per role.
+export default function ReputationPanel({ rep, size = 'sm' }) {
+  const { t } = useI18n();
+  const roles = rep?.roles || [];
+
+  if (!roles.length) {
+    return <div className="text-xs text-text3">{t('Sem avaliações ainda')}</div>;
+  }
+
+  return (
+    <div className="flex flex-col gap-4">
+      {roles.map((r) => (
+        <div key={r.role}>
+          <div className="text-[11px] font-semibold uppercase tracking-wide text-text3 mb-1">{r.label}</div>
+          <LbtasDistribution distribution={r.distribution} total={r.total} size={size} />
+        </div>
+      ))}
+    </div>
+  );
+}
diff --git a/lib/i18n.js b/lib/i18n.js
index 41b71b5..107de79 100644
--- a/lib/i18n.js
+++ b/lib/i18n.js
@@ -277,6 +277,7 @@ const EN = {
   'Sem confiança': 'No Trust',
   'Minha reputação': 'My reputation',
   'Reputação é uma distribuição, nunca uma média.': 'Reputation is a distribution, never an average.',
+  'Reputação é uma distribuição por papel, nunca uma média.': 'Reputation is a distribution per role, never an average.',
   'Avaliações pendentes': 'Pending ratings',
   'Nada pendente para avaliar': 'Nothing pending to rate',
   'Avalie suas transações para construir confiança na rede.': 'Rate your transactions to build trust across the network.',

From 5a997f67b59e0e31abf39d3d9c3c038dbb07f530 Mon Sep 17 00:00:00 2001
From: Jodson Graves <info@ntari.org>
Date: Tue, 30 Jun 2026 07:03:40 -0400
Subject: [PATCH 07/16] feat(admin): dispute resolution console with rating
 void/replace

Replaces the bare release/refund buttons on the admin Disputes tab with a
resolution modal that:
- shows the transaction's LBTAS ratings (incl. the disputed -1 + justification),
  voided ones dimmed
- settles the money: release to seller or refund buyer
- on a bad-faith finding: voids the buyer's rating and lets the admin issue a
  replacement rating of the seller (-1 requires a comment), via the
  voidBuyerRating/adminRating payload on POST /admin/disputes/:id/resolve

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 app/admin/page.js                       |  21 ++--
 components/admin/DisputeResolveModal.js | 136 ++++++++++++++++++++++++
 lib/i18n.js                             |  15 +++
 3 files changed, 165 insertions(+), 7 deletions(-)
 create mode 100644 components/admin/DisputeResolveModal.js

diff --git a/app/admin/page.js b/app/admin/page.js
index 8ad1382..40be310 100644
--- a/app/admin/page.js
+++ b/app/admin/page.js
@@ -8,6 +8,7 @@ import { formatCurrency, formatDate } from '@/lib/format';
 import { StatusBadge, Badge } from '@/components/ui/Badge';
 import { useToast } from '@/components/ui/Toast';
 import AnimatedStat from '@/components/motion/AnimatedStat';
+import DisputeResolveModal from '@/components/admin/DisputeResolveModal';
 import { useI18n } from '@/lib/i18n';
 
 const STAT_CONFIG = [
@@ -32,6 +33,7 @@ export default function Admin() {
   const [stats, setStats] = useState({});
   const [tab, setTab]     = useState('users');
   const [data, setData]   = useState(null);
+  const [resolveTarget, setResolveTarget] = useState(null);
 
   useEffect(() => {
     const u = getUser();
@@ -187,15 +189,12 @@ export default function Admin() {
                         {data.map(d => (
                           <tr key={d.id}>
                             <td className="text-xs text-text3 font-mono">{d.id?.substring(0,8)}…</td>
-                            <td>{d.reason}</td>
+                            <td className="max-w-[320px] truncate">{d.reason}</td>
                             <td><StatusBadge status={d.status} /></td>
                             <td>
-                              {d.status === 'open' && (
-                                <div className="flex gap-1.5">
-                                  <button className="btn btn-primary btn-sm" onClick={() => action(`/admin/disputes/${d.id}/resolve`,'POST',{resolution:'release'},'Liberado')}>{t('Liberar')}</button>
-                                  <button className="btn btn-danger btn-sm" onClick={() => action(`/admin/disputes/${d.id}/resolve`,'POST',{resolution:'refund'},'Reembolsado')}>{t('Reembolsar')}</button>
-                                </div>
-                              )}
+                              {d.status === 'open'
+                                ? <button className="btn btn-primary btn-sm" onClick={() => setResolveTarget(d)}>{t('Resolver')}</button>
+                                : <span className="text-xs text-text3">{d.resolution || d.status}</span>}
                             </td>
                           </tr>
                         ))}
@@ -248,6 +247,14 @@ export default function Admin() {
           </motion.div>
         </AnimatePresence>
       </div>
+
+      {resolveTarget && (
+        <DisputeResolveModal
+          dispute={resolveTarget}
+          onClose={() => setResolveTarget(null)}
+          onResolved={() => { loadTab('disputes'); loadStats(); }}
+        />
+      )}
     </div>
   );
 }
diff --git a/components/admin/DisputeResolveModal.js b/components/admin/DisputeResolveModal.js
new file mode 100644
index 0000000..cb0a353
--- /dev/null
+++ b/components/admin/DisputeResolveModal.js
@@ -0,0 +1,136 @@
+'use client';
+import { useEffect, useState } from 'react';
+import { Modal, ModalHeader } from '@/components/ui/Modal';
+import { api } from '@/lib/api';
+import { useToast } from '@/components/ui/Toast';
+import { useI18n } from '@/lib/i18n';
+import { LEVELS, LEVEL_LABELS, signed, MAX_COMMENT_WORDS, wordCount } from '@/lib/lbtas';
+
+const ROLE_LABEL = { buyer: 'Comprador', seller: 'Vendedor', admin: 'Admin' };
+
+// Operator console for resolving a frozen dispute: review the transaction's ratings
+// (incl. the disputed -1 + its justification), settle the money (release/refund),
+// and on a bad-faith finding void the buyer's rating + issue a replacement.
+export default function DisputeResolveModal({ dispute, onClose, onResolved }) {
+  const toast = useToast();
+  const { t } = useI18n();
+  const [ratings, setRatings] = useState(null);
+  const [resolution, setResolution] = useState('release');
+  const [voidBuyer, setVoidBuyer] = useState(false);
+  const [voidReason, setVoidReason] = useState('');
+  const [adminValue, setAdminValue] = useState(null);
+  const [adminComment, setAdminComment] = useState('');
+  const [loading, setLoading] = useState(false);
+
+  useEffect(() => {
+    if (!dispute?.transaction_id) { setRatings([]); return; }
+    api(`/ratings/transactions/${dispute.transaction_id}`)
+      .then((r) => setRatings(r.ratings || []))
+      .catch(() => setRatings([]));
+  }, [dispute]);
+
+  const adminNeedsComment = voidBuyer && adminValue === -1;
+  const adminWc = wordCount(adminComment);
+  const adminCommentTooLong = adminWc > MAX_COMMENT_WORDS;
+  const blocked = loading || (adminNeedsComment && !adminComment.trim()) || adminCommentTooLong;
+
+  async function submit() {
+    setLoading(true);
+    try {
+      const payload = { resolution, voidBuyerRating: voidBuyer };
+      if (voidBuyer) {
+        if (voidReason.trim()) payload.voidReason = voidReason.trim();
+        if (adminValue !== null) payload.adminRating = { value: adminValue, comment: adminComment.trim() || undefined };
+      }
+      await api(`/admin/disputes/${dispute.id}/resolve`, 'POST', payload);
+      toast(t('Disputa resolvida'));
+      onClose();
+      onResolved?.();
+    } catch (e) {
+      toast(e.message, 'error');
+    } finally {
+      setLoading(false);
+    }
+  }
+
+  return (
+    <Modal onClose={onClose} maxWidth="560px">
+      <ModalHeader title={t('Resolver disputa')} onClose={onClose} />
+
+      <div className="bg-rust/5 border border-rust/30 rounded-lg p-3 mb-4">
+        <div className="text-[11px] font-semibold uppercase tracking-wide text-rust mb-1">{t('Motivo')}</div>
+        <div className="text-sm text-soil break-words">{dispute.reason}</div>
+      </div>
+
+      <div className="mb-4">
+        <div className="text-[11px] font-semibold uppercase tracking-wide text-text3 mb-2">{t('Avaliações desta transação')}</div>
+        {ratings === null ? (
+          <div className="skeleton h-12 rounded" />
+        ) : ratings.length === 0 ? (
+          <p className="text-xs text-text3">{t('Nenhuma avaliação nesta transação')}</p>
+        ) : (
+          <div className="flex flex-col gap-2">
+            {ratings.map((r) => (
+              <div key={r.id} className={`text-sm border rounded-lg p-2.5 ${r.voided ? 'opacity-50 border-[var(--border-c)]' : r.value === -1 ? 'border-rust/40 bg-rust/5' : 'border-[var(--border-c)]'}`}>
+                <div className="flex items-center gap-2">
+                  <span className="font-semibold text-soil">{t(ROLE_LABEL[r.rater_role] || r.rater_role)}</span>
+                  <span className={`font-serif font-black ${r.value === -1 ? 'text-rust' : 'text-soil'}`}>{signed(r.value)}</span>
+                  <span className="text-xs text-text3">{LEVEL_LABELS[String(r.value)]}</span>
+                  {r.voided ? <span className="text-[10px] uppercase tracking-wide text-text3 ml-auto">{t('Anulada')}</span> : null}
+                </div>
+                {r.comment && <div className="text-xs text-text2 mt-1 break-words">{r.comment}</div>}
+              </div>
+            ))}
+          </div>
+        )}
+      </div>
+
+      <div className="flex gap-2 mb-3">
+        <button className={`btn btn-sm flex-1 ${resolution === 'release' ? 'btn-primary' : 'btn-outline'}`} onClick={() => setResolution('release')}>{t('Liberar ao vendedor')}</button>
+        <button className={`btn btn-sm flex-1 ${resolution === 'refund' ? 'btn-primary' : 'btn-outline'}`} onClick={() => setResolution('refund')}>{t('Reembolsar comprador')}</button>
+      </div>
+
+      <label className="flex items-center gap-2 text-sm text-soil mb-2 cursor-pointer">
+        <input type="checkbox" checked={voidBuyer} onChange={(e) => setVoidBuyer(e.target.checked)} />
+        {t('Comprador agiu de má-fé — anular sua avaliação')}
+      </label>
+
+      {voidBuyer && (
+        <div className="border-l-2 border-rust/40 pl-3 ml-1 mb-3 flex flex-col gap-2">
+          <input className="form-input text-sm" placeholder={t('Motivo da anulação (opcional)')} value={voidReason} onChange={(e) => setVoidReason(e.target.value)} />
+          <div className="text-[11px] text-text3">{t('Emitir avaliação do vendedor (opcional)')}</div>
+          <div className="grid gap-1.5" style={{ gridTemplateColumns: 'repeat(6, 1fr)' }}>
+            {LEVELS.map((level) => {
+              const active = adminValue === level;
+              const isHarm = level === -1;
+              return (
+                <button
+                  key={level}
+                  type="button"
+                  onClick={() => setAdminValue(active ? null : level)}
+                  title={LEVEL_LABELS[String(level)]}
+                  className={`py-2 rounded-lg border font-serif font-black text-sm ${active ? (isHarm ? 'border-rust bg-rust/10 text-rust' : 'border-moss bg-moss-light text-soil') : `border-[var(--border-c)] ${isHarm ? 'text-rust' : 'text-soil'}`}`}>
+                  {signed(level)}
+                </button>
+              );
+            })}
+          </div>
+          {adminValue !== null && (
+            <div>
+              <textarea
+                className="form-input text-sm min-h-[56px] resize-y"
+                placeholder={adminNeedsComment ? t('Comentário obrigatório para -1') : t('Comentário (opcional)')}
+                value={adminComment}
+                onChange={(e) => setAdminComment(e.target.value)} />
+              <div className={`text-[10px] text-right ${adminCommentTooLong ? 'text-rust' : 'text-text3'}`}>{adminWc}/{MAX_COMMENT_WORDS}</div>
+            </div>
+          )}
+        </div>
+      )}
+
+      <button className="btn btn-primary w-full mt-2" onClick={submit} disabled={blocked}>
+        {loading ? t('Enviando...') : t('Resolver disputa')}
+      </button>
+    </Modal>
+  );
+}
diff --git a/lib/i18n.js b/lib/i18n.js
index 107de79..f903234 100644
--- a/lib/i18n.js
+++ b/lib/i18n.js
@@ -220,6 +220,21 @@ const EN = {
   'Motivo': 'Reason',
   'Liberar': 'Release',
   'Reembolsar': 'Refund',
+  'Resolver': 'Resolve',
+  'Resolver disputa': 'Resolve dispute',
+  'Comprador': 'Buyer',
+  'Vendedor': 'Seller',
+  'Liberar ao vendedor': 'Release to seller',
+  'Reembolsar comprador': 'Refund buyer',
+  'Comprador agiu de má-fé — anular sua avaliação': 'Buyer acted in bad faith — void their rating',
+  'Emitir avaliação do vendedor (opcional)': 'Issue a rating of the seller (optional)',
+  'Avaliações desta transação': 'Ratings for this transaction',
+  'Anulada': 'Voided',
+  'Motivo da anulação (opcional)': 'Void reason (optional)',
+  'Disputa resolvida': 'Dispute resolved',
+  'Nenhuma avaliação nesta transação': 'No ratings on this transaction',
+  'Comentário obrigatório para -1': 'Comment required for -1',
+  'Comentário (opcional)': 'Comment (optional)',
   'Aprovar': 'Approve',
   'Valor': 'Amount',
   'Data': 'Date',

From 55d1b1bb6867cefbfeb987d885cc869f6e421e67 Mon Sep 17 00:00:00 2001
From: Jodson Graves <info@ntari.org>
Date: Tue, 30 Jun 2026 07:18:55 -0400
Subject: [PATCH 08/16] =?UTF-8?q?feat(contracts):=20plan-aware=20ListingDe?=
 =?UTF-8?q?tail=20=E2=80=94=20contract=20/=20fulfill=20action?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

A plan post now shows a "Contract plan" (plan_producer) or "Fulfill request"
(plan_consumer) action that posts to /transactions/from-plan and routes to the
profile to pay — mirroring the listing-purchase flow.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 components/listings/ListingDetail.js | 17 ++++++++++++++---
 lib/i18n.js                          |  3 +++
 2 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/components/listings/ListingDetail.js b/components/listings/ListingDetail.js
index a201fae..126b37b 100644
--- a/components/listings/ListingDetail.js
+++ b/components/listings/ListingDetail.js
@@ -24,14 +24,21 @@ export default function ListingDetail({ listing, onClose }) {
   const router = useRouter();
   const { t } = useI18n();
   const l = listing;
+  const isPlan = l.post_type === 'plan_producer' || l.post_type === 'plan_consumer';
+  const isConsumerPlan = l.post_type === 'plan_consumer';
 
   async function buy() {
     const q = parseFloat(qty);
     if (!q || q <= 0) return toast(t('Informe a quantidade'), 'error');
     setLoading(true);
     try {
-      await api('/transactions/from-listing', 'POST', { listingId: l.id, quantity: q });
-      toast(t('Compra iniciada! Acesse seu perfil para pagar.'));
+      if (isPlan) {
+        await api('/transactions/from-plan', 'POST', { planId: l.id, quantity: q });
+        toast(t('Contrato iniciado! Acesse seu perfil para pagar.'));
+      } else {
+        await api('/transactions/from-listing', 'POST', { listingId: l.id, quantity: q });
+        toast(t('Compra iniciada! Acesse seu perfil para pagar.'));
+      }
       onClose();
       router.push('/perfil?tab=transacoes');
     } catch (e) {
@@ -116,7 +123,11 @@ export default function ListingDetail({ listing, onClose }) {
           className="btn btn-primary flex-1"
           onClick={buy}
           disabled={loading}>
-          {loading ? t('Aguarde...') : `🛒 ${t('Comprar agora')}`}
+          {loading
+            ? t('Aguarde...')
+            : isConsumerPlan ? `🤝 ${t('Atender pedido')}`
+            : isPlan ? `📋 ${t('Contratar plano')}`
+            : `🛒 ${t('Comprar agora')}`}
         </button>
         <button className="btn btn-ghost" onClick={onClose}>{t('Cancelar')}</button>
       </div>
diff --git a/lib/i18n.js b/lib/i18n.js
index f903234..1895a06 100644
--- a/lib/i18n.js
+++ b/lib/i18n.js
@@ -220,6 +220,9 @@ const EN = {
   'Motivo': 'Reason',
   'Liberar': 'Release',
   'Reembolsar': 'Refund',
+  'Contratar plano': 'Contract plan',
+  'Atender pedido': 'Fulfill request',
+  'Contrato iniciado! Acesse seu perfil para pagar.': 'Contract started! Go to your profile to pay.',
   'Resolver': 'Resolve',
   'Resolver disputa': 'Resolve dispute',
   'Comprador': 'Buyer',

From 1abae75a9dc7808b6a622221db5274a9b66ecd77 Mon Sep 17 00:00:00 2001
From: Jodson Graves <info@ntari.org>
Date: Tue, 30 Jun 2026 07:32:45 -0400
Subject: [PATCH 09/16] =?UTF-8?q?feat(contracts):=20ContractModal=20?=
 =?UTF-8?q?=E2=80=94=20PING=20timeline=20+=20post-update=20+=20sell/transf?=
 =?UTF-8?q?er?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Opened from a plan-contract transaction in the profile:
- PING schedule summary (cadence + checkpoints + next) and the producer's
  progress-update timeline (notes + photos)
- seller can post an update (note + photo upload via /posts/upload-media)
- buyer can sell/transfer the contract to another buyer's email at a negotiated
  price (POST /transactions/:id/transfer); PING reporting follows ownership

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 app/perfil/page.js                    |  12 ++
 components/contracts/ContractModal.js | 164 ++++++++++++++++++++++++++
 lib/i18n.js                           |  21 ++++
 3 files changed, 197 insertions(+)
 create mode 100644 components/contracts/ContractModal.js

diff --git a/app/perfil/page.js b/app/perfil/page.js
index 4ca5a0a..7a73334 100644
--- a/app/perfil/page.js
+++ b/app/perfil/page.js
@@ -13,6 +13,7 @@ import { useToast } from '@/components/ui/Toast';
 import { Avatar, AvatarFallback } from '@/components/ui/avatar';
 import ReputationPanel from '@/components/ratings/ReputationPanel';
 import RatePrompt from '@/components/ratings/RatePrompt';
+import ContractModal from '@/components/contracts/ContractModal';
 import { useI18n } from '@/lib/i18n';
 
 const HIST_ICON = {
@@ -46,6 +47,7 @@ function PerfilInner() {
   const [loading, setLoading]     = useState(false);
   const [myRep, setMyRep]         = useState(null);
   const [rateTx, setRateTx]       = useState(null);
+  const [contractTx, setContractTx] = useState(null);
 
   useEffect(() => {
     const u = getUser();
@@ -284,6 +286,7 @@ function PerfilInner() {
                                 {tx.status === 'paid'     && !isBuyer && tx.buyer_rated && <button className="btn btn-ghost btn-sm" onClick={() => releaseTx(tx.id)}>{t('Liberar')}</button>}
                                 {tx.status === 'paid'     && isBuyer  && <button className="btn btn-danger btn-sm"   onClick={() => disputeTx(tx.id)}>{t('Disputar')}</button>}
                                 {canRate && <button className="btn btn-primary btn-sm" onClick={() => setRateTx(tx)}>{isBuyer && tx.status === 'paid' ? t('Confirmar e avaliar') : t('Avaliar')}</button>}
+                                {tx.post_id && <button className="btn btn-ghost btn-sm" onClick={() => setContractTx(tx)}>{t('Contrato')}</button>}
                                 <button className="btn btn-ghost btn-sm" onClick={() => showTxDetail(tx.id)}>{t('Ver')}</button>
                               </div>
                             </div>
@@ -381,6 +384,15 @@ function PerfilInner() {
           onRated={() => { loadTxs(); loadMyRep(); loadWallet(); }}
         />
       )}
+
+      {contractTx && (
+        <ContractModal
+          transaction={contractTx}
+          me={user}
+          onClose={() => setContractTx(null)}
+          onChanged={() => { loadTxs(); loadWallet(); }}
+        />
+      )}
     </div>
   );
 }
diff --git a/components/contracts/ContractModal.js b/components/contracts/ContractModal.js
new file mode 100644
index 0000000..3ef669f
--- /dev/null
+++ b/components/contracts/ContractModal.js
@@ -0,0 +1,164 @@
+'use client';
+import { useEffect, useState } from 'react';
+import { Modal, ModalHeader } from '@/components/ui/Modal';
+import { api } from '@/lib/api';
+import { getToken } from '@/lib/auth';
+import { useToast } from '@/components/ui/Toast';
+import { useI18n } from '@/lib/i18n';
+import { formatCurrency, formatDate } from '@/lib/format';
+
+const RATE_LABEL = { daily: 'Daily', weekly: 'Weekly', monthly: 'Monthly' };
+
+// Contract detail: PING schedule + the producer's progress updates, plus role
+// actions — the seller posts updates, the buyer can sell (transfer) the position.
+export default function ContractModal({ transaction: tx, me, onClose, onChanged }) {
+  const toast = useToast();
+  const { t } = useI18n();
+  const [data, setData] = useState(null);
+  const [note, setNote] = useState('');
+  const [media, setMedia] = useState([]);
+  const [uploading, setUploading] = useState(false);
+  const [posting, setPosting] = useState(false);
+  const [toEmail, setToEmail] = useState('');
+  const [price, setPrice] = useState('');
+  const [transferring, setTransferring] = useState(false);
+
+  const API = process.env.NEXT_PUBLIC_API_URL || '';
+  const isSeller = me?.id === tx.seller_id;
+  const isBuyer = me?.id === tx.buyer_id;
+  const live = tx.status === 'paid' && (tx.escrow_locked === 1 || tx.escrow_locked === true);
+
+  async function load() {
+    try { setData(await api(`/transactions/${tx.id}/pings`)); }
+    catch (e) { toast(e.message, 'error'); setData({ schedule: [], reports: [] }); }
+  }
+  useEffect(() => { load(); }, []);
+
+  async function onFiles(e) {
+    const files = Array.from(e.target.files || []).slice(0, 5);
+    if (!files.length) return;
+    setUploading(true);
+    const urls = [];
+    for (const file of files) {
+      try {
+        const fd = new FormData();
+        fd.append('image', file);
+        const headers = { Authorization: 'Bearer ' + getToken() };
+        if (process.env.NEXT_PUBLIC_API_KEY) headers['X-API-Key'] = process.env.NEXT_PUBLIC_API_KEY;
+        const res = await fetch(API + '/posts/upload-media', { method: 'POST', headers, body: fd });
+        const d = await res.json();
+        if (d.url) urls.push(d.url);
+      } catch { /* skip */ }
+    }
+    setMedia((m) => [...m, ...urls].slice(0, 5));
+    setUploading(false);
+  }
+
+  async function postUpdate() {
+    if (!note.trim() && media.length === 0) return toast(t('Nota da atualização'), 'error');
+    setPosting(true);
+    try {
+      await api(`/transactions/${tx.id}/pings`, 'POST', { note: note.trim() || undefined, media });
+      toast(t('Atualização publicada!'));
+      setNote(''); setMedia([]);
+      load();
+    } catch (e) { toast(e.message, 'error'); }
+    finally { setPosting(false); }
+  }
+
+  async function transfer() {
+    const p = parseFloat(price);
+    if (!toEmail.trim()) return toast(t('E-mail do comprador'), 'error');
+    if (!p || p <= 0) return toast(t('Preço de venda (R$)'), 'error');
+    setTransferring(true);
+    try {
+      await api(`/transactions/${tx.id}/transfer`, 'POST', { toEmail: toEmail.trim(), price: p });
+      toast(t('Contrato transferido!'));
+      onClose();
+      onChanged?.();
+    } catch (e) { toast(e.message, 'error'); }
+    finally { setTransferring(false); }
+  }
+
+  const schedule = data?.schedule || [];
+  const reports = data?.reports || [];
+  const past = schedule.filter((s) => s.status === 'past').length;
+  const next = schedule.find((s) => s.status === 'upcoming');
+
+  return (
+    <Modal onClose={onClose} maxWidth="560px">
+      <ModalHeader title={tx.listing_title || t('Contrato')} onClose={onClose} />
+
+      {/* PING schedule summary */}
+      {schedule.length > 0 && (
+        <div className="bg-cream2 border border-[var(--border-c)] rounded-lg p-3 mb-4 text-sm">
+          <div className="text-[11px] font-semibold uppercase tracking-wide text-text3 mb-1">{t('Cronograma PING')}</div>
+          <div className="text-soil">
+            {t('Cadência')}: {t(RATE_LABEL[data?.ping_rate] || 'Weekly')} · {past}/{schedule.length} {t('checkpoints')}
+            {next && <> · {t('Próximo')}: {next.date}</>}
+          </div>
+        </div>
+      )}
+
+      {/* reports timeline */}
+      <div className="mb-4">
+        <div className="text-[11px] font-semibold uppercase tracking-wide text-text3 mb-2">{t('Atualizações')}</div>
+        {data === null ? (
+          <div className="skeleton h-12 rounded" />
+        ) : reports.length === 0 ? (
+          <p className="text-xs text-text3">{t('Nenhuma atualização ainda')}</p>
+        ) : (
+          <div className="flex flex-col gap-2.5">
+            {reports.map((r) => (
+              <div key={r.id} className="border-l-2 border-moss/40 pl-3">
+                <div className="text-xs text-text3">{formatDate(r.created_at)}</div>
+                {r.note && <div className="text-sm text-soil mt-0.5">{r.note}</div>}
+                {r.media?.length > 0 && (
+                  <div className="flex gap-2 mt-1.5 flex-wrap">
+                    {r.media.map((u, i) => <img key={i} src={u} alt="" className="w-14 h-14 object-cover rounded-lg border border-[var(--border-c)]" />)}
+                  </div>
+                )}
+              </div>
+            ))}
+          </div>
+        )}
+      </div>
+
+      {/* seller: post an update */}
+      {isSeller && live && (
+        <div className="border-t border-[var(--border-c)] pt-4 mb-2">
+          <div className="text-[11px] font-semibold uppercase tracking-wide text-text3 mb-2">{t('Publicar atualização')}</div>
+          <textarea className="form-input text-sm min-h-[60px] resize-y" placeholder={t('Nota da atualização')} value={note} onChange={(e) => setNote(e.target.value)} />
+          <div className="flex items-center gap-2 mt-2">
+            <input type="file" accept="image/*" multiple onChange={onFiles} className="text-xs" />
+            {uploading && <span className="text-xs text-text3">{t('Enviando...')}</span>}
+          </div>
+          {media.length > 0 && (
+            <div className="flex gap-2 mt-2 flex-wrap">
+              {media.map((u, i) => <img key={i} src={u} alt="" className="w-12 h-12 object-cover rounded-lg border border-[var(--border-c)]" />)}
+            </div>
+          )}
+          <button className="btn btn-primary btn-sm mt-2" onClick={postUpdate} disabled={posting}>{posting ? t('Enviando...') : t('Publicar atualização')}</button>
+        </div>
+      )}
+
+      {/* buyer: sell / transfer the position */}
+      {isBuyer && live && (
+        <div className="border-t border-[var(--border-c)] pt-4">
+          <div className="text-[11px] font-semibold uppercase tracking-wide text-text3 mb-1">{t('Vender contrato')}</div>
+          <p className="text-xs text-text3 mb-2">{t('Transfira sua posição a outro comprador pelo preço acordado. O PING acompanha a titularidade.')}</p>
+          <div className="flex gap-2 flex-wrap">
+            <input type="email" className="form-input text-sm flex-1 min-w-[160px]" placeholder={t('E-mail do comprador')} value={toEmail} onChange={(e) => setToEmail(e.target.value)} />
+            <input type="number" min="1" step="0.01" className="form-input text-sm w-32" placeholder={t('Preço de venda (R$)')} value={price} onChange={(e) => setPrice(e.target.value)} />
+          </div>
+          {price && parseFloat(price) > 0 && tx.amount != null && (
+            <div className="text-xs text-text3 mt-1">
+              {t('Pago originalmente')}: {formatCurrency(tx.amount)} → {t('venda')}: {formatCurrency(parseFloat(price))}
+            </div>
+          )}
+          <button className="btn btn-outline btn-sm mt-2" onClick={transfer} disabled={transferring}>{transferring ? t('Enviando...') : t('Transferir')}</button>
+        </div>
+      )}
+    </Modal>
+  );
+}
diff --git a/lib/i18n.js b/lib/i18n.js
index 1895a06..f59610b 100644
--- a/lib/i18n.js
+++ b/lib/i18n.js
@@ -222,6 +222,27 @@ const EN = {
   'Reembolsar': 'Refund',
   'Contratar plano': 'Contract plan',
   'Atender pedido': 'Fulfill request',
+  'Contrato': 'Contract',
+  'Cronograma PING': 'PING schedule',
+  'Cadência': 'Cadence',
+  'checkpoints': 'checkpoints',
+  'Próximo': 'Next',
+  'Daily': 'Daily',
+  'Weekly': 'Weekly',
+  'Monthly': 'Monthly',
+  'Atualizações': 'Updates',
+  'Nenhuma atualização ainda': 'No updates yet',
+  'Publicar atualização': 'Post update',
+  'Nota da atualização': 'Update note',
+  'Atualização publicada!': 'Update posted!',
+  'Vender contrato': 'Sell contract',
+  'Transfira sua posição a outro comprador pelo preço acordado. O PING acompanha a titularidade.': 'Transfer your position to another buyer at an agreed price. PING reporting follows ownership.',
+  'E-mail do comprador': 'Buyer email',
+  'Preço de venda (R$)': 'Sale price (R$)',
+  'Pago originalmente': 'Originally paid',
+  'venda': 'sale',
+  'Transferir': 'Transfer',
+  'Contrato transferido!': 'Contract transferred!',
   'Contrato iniciado! Acesse seu perfil para pagar.': 'Contract started! Go to your profile to pay.',
   'Resolver': 'Resolve',
   'Resolver disputa': 'Resolve dispute',

From 8bbb9179d48e6be0834e794c20b3ee774ba3810b Mon Sep 17 00:00:00 2001
From: Jodson Graves <info@ntari.org>
Date: Tue, 30 Jun 2026 09:08:53 -0400
Subject: [PATCH 10/16] feat(messaging+edit): Message button on posts +
 editable posts
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- ListingDetail: a "Message" button (any post, hidden on your own) opens/continues
  the post's conversation via POST /conversations {post_id} and routes to the thread
- NewPostModal: edit mode — prefill from an existing post and PUT /posts/:id
- MyPosts: an Edit (✎) action on each owned post opens the editor; plans included
- i18n: Message / Edit / sign-in-to-message strings

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 components/listings/ListingDetail.js | 47 +++++++++++++++++++++-------
 components/posts/MyPosts.js          | 16 +++++++---
 components/posts/NewPostModal.js     | 37 ++++++++++++++++------
 lib/i18n.js                          |  3 ++
 4 files changed, 79 insertions(+), 24 deletions(-)

diff --git a/components/listings/ListingDetail.js b/components/listings/ListingDetail.js
index 126b37b..7ea1c41 100644
--- a/components/listings/ListingDetail.js
+++ b/components/listings/ListingDetail.js
@@ -5,6 +5,7 @@ import { Modal, ModalHeader } from '@/components/ui/Modal';
 import { catLabel, CAT_EMOJI, formatCurrency, formatDate } from '@/lib/format';
 import { Badge } from '@/components/ui/Badge';
 import { api } from '@/lib/api';
+import { getUser } from '@/lib/auth';
 import { useToast } from '@/components/ui/Toast';
 import { useRouter } from 'next/navigation';
 import { useI18n } from '@/lib/i18n';
@@ -26,6 +27,23 @@ export default function ListingDetail({ listing, onClose }) {
   const l = listing;
   const isPlan = l.post_type === 'plan_producer' || l.post_type === 'plan_consumer';
   const isConsumerPlan = l.post_type === 'plan_consumer';
+  const me = getUser();
+  const isOwner = me?.id && l.user_id && me.id === l.user_id;
+  const [messaging, setMessaging] = useState(false);
+
+  async function message() {
+    if (!me) return toast(t('Faça login para enviar mensagens'), 'error');
+    setMessaging(true);
+    try {
+      const c = await api('/conversations', 'POST', { post_id: l.id });
+      onClose();
+      router.push('/chat/' + c.id);
+    } catch (e) {
+      toast(e.message, 'error');
+    } finally {
+      setMessaging(false);
+    }
+  }
 
   async function buy() {
     const q = parseFloat(qty);
@@ -118,17 +136,24 @@ export default function ListingDetail({ listing, onClose }) {
         )}
       </div>
 
-      <div className="flex gap-3">
-        <button
-          className="btn btn-primary flex-1"
-          onClick={buy}
-          disabled={loading}>
-          {loading
-            ? t('Aguarde...')
-            : isConsumerPlan ? `🤝 ${t('Atender pedido')}`
-            : isPlan ? `📋 ${t('Contratar plano')}`
-            : `🛒 ${t('Comprar agora')}`}
-        </button>
+      <div className="flex gap-3 flex-wrap">
+        {!isOwner && (
+          <button
+            className="btn btn-primary flex-1"
+            onClick={buy}
+            disabled={loading}>
+            {loading
+              ? t('Aguarde...')
+              : isConsumerPlan ? `🤝 ${t('Atender pedido')}`
+              : isPlan ? `📋 ${t('Contratar plano')}`
+              : `🛒 ${t('Comprar agora')}`}
+          </button>
+        )}
+        {!isOwner && (
+          <button className="btn btn-outline" onClick={message} disabled={messaging}>
+            💬 {t('Mensagem')}
+          </button>
+        )}
         <button className="btn btn-ghost" onClick={onClose}>{t('Cancelar')}</button>
       </div>
     </Modal>
diff --git a/components/posts/MyPosts.js b/components/posts/MyPosts.js
index 1631634..ee3fff8 100644
--- a/components/posts/MyPosts.js
+++ b/components/posts/MyPosts.js
@@ -17,6 +17,7 @@ export default function MyPosts({ title, subtitle, types, defaultType, newLabel
   const [posts, setPosts] = useState(null);
   const [selected, setSelected] = useState(null);
   const [creating, setCreating] = useState(false);
+  const [editing, setEditing] = useState(null);
 
   useEffect(() => {
     const u = getUser();
@@ -74,10 +75,16 @@ export default function MyPosts({ title, subtitle, types, defaultType, newLabel
             {posts.map((p) => (
               <div key={p.id} className="relative group">
                 <ListingCard listing={p} onClick={setSelected} />
-                <button
-                  onClick={(e) => { e.stopPropagation(); onDelete(p.id); }}
-                  className="absolute top-2 right-2 z-10 bg-white/90 hover:bg-rust hover:text-white rounded-full w-7 h-7 text-sm shadow opacity-0 group-hover:opacity-100 transition"
-                  title={t('Remover')}>✕</button>
+                <div className="absolute top-2 right-2 z-10 flex gap-1 opacity-0 group-hover:opacity-100 transition">
+                  <button
+                    onClick={(e) => { e.stopPropagation(); setEditing(p); }}
+                    className="bg-white/90 hover:bg-moss hover:text-white rounded-full w-7 h-7 text-sm shadow"
+                    title={t('Editar')}>✎</button>
+                  <button
+                    onClick={(e) => { e.stopPropagation(); onDelete(p.id); }}
+                    className="bg-white/90 hover:bg-rust hover:text-white rounded-full w-7 h-7 text-sm shadow"
+                    title={t('Remover')}>✕</button>
+                </div>
                 {p.status && p.status !== 'active' && (
                   <span className="absolute top-2 left-2 z-10 badge-agro badge-wheat text-[10px]">{p.status}</span>
                 )}
@@ -89,6 +96,7 @@ export default function MyPosts({ title, subtitle, types, defaultType, newLabel
 
       {selected && <ListingDetail listing={selected} onClose={() => setSelected(null)} />}
       {creating && <NewPostModal initialType={defaultType} onClose={() => setCreating(false)} onCreated={load} />}
+      {editing && <NewPostModal existing={editing} onClose={() => setEditing(null)} onCreated={load} />}
     </div>
   );
 }
diff --git a/components/posts/NewPostModal.js b/components/posts/NewPostModal.js
index 53b7154..b26e0e6 100644
--- a/components/posts/NewPostModal.js
+++ b/components/posts/NewPostModal.js
@@ -35,11 +35,24 @@ function Field({ f, value, onChange }) {
   );
 }
 
-export default function NewPostModal({ onClose, onCreated, initialType = null }) {
+export default function NewPostModal({ onClose, onCreated, initialType = null, existing = null }) {
   const toast = useToast();
-  const [type, setType] = useState(initialType);
-  const [values, setValues] = useState({});
-  const [media, setMedia] = useState([]);
+  const [type, setType] = useState(existing ? existing.post_type : initialType);
+  const [values, setValues] = useState(() => {
+    if (!existing) return {};
+    const v = {};
+    const form = POST_TYPE_FORMS[existing.post_type];
+    if (form) {
+      for (const f of form.fields) {
+        const top = existing[f.key];
+        const pay = existing.payload?.[f.key];
+        const val = top !== undefined && top !== null ? top : pay;
+        if (val !== undefined && val !== null) v[f.key] = val;
+      }
+    }
+    return v;
+  });
+  const [media, setMedia] = useState(existing?.media || []);
   const [uploading, setUploading] = useState(false);
   const [loading, setLoading] = useState(false);
 
@@ -72,8 +85,14 @@ export default function NewPostModal({ onClose, onCreated, initialType = null })
     if (missing.length) return toast('Please fill in: ' + missing.map((f) => f.label).join(', '), 'error');
     setLoading(true);
     try {
-      await api('/posts', 'POST', buildPostBody(type, values, media));
-      toast('Post published!');
+      const body = buildPostBody(type, values, media);
+      if (existing) {
+        await api('/posts/' + existing.id, 'PUT', body);
+        toast('Changes saved');
+      } else {
+        await api('/posts', 'POST', body);
+        toast('Post published!');
+      }
       onClose();
       onCreated?.();
     } catch (e) {
@@ -85,7 +104,7 @@ export default function NewPostModal({ onClose, onCreated, initialType = null })
 
   return (
     <Modal onClose={onClose} maxWidth="560px">
-      <ModalHeader title={type ? `New ${POST_TYPE_FORMS[type].label}` : 'What are you posting?'} onClose={onClose} />
+      <ModalHeader title={existing ? `Edit ${POST_TYPE_FORMS[type]?.label || 'post'}` : type ? `New ${POST_TYPE_FORMS[type].label}` : 'What are you posting?'} onClose={onClose} />
 
       {!type ? (
         <div className="grid gap-3" style={{ gridTemplateColumns: 'repeat(auto-fit, minmax(150px, 1fr))' }}>
@@ -118,9 +137,9 @@ export default function NewPostModal({ onClose, onCreated, initialType = null })
           </div>
 
           <div className="flex gap-3 mt-4">
-            <button className="btn btn-ghost" onClick={() => setType(null)}>← Back</button>
+            {!existing && <button className="btn btn-ghost" onClick={() => setType(null)}>← Back</button>}
             <button className="btn btn-primary flex-1" onClick={submit} disabled={loading}>
-              {loading ? 'Publishing…' : 'Publish'}
+              {existing ? (loading ? 'Saving…' : 'Save changes') : (loading ? 'Publishing…' : 'Publish')}
             </button>
           </div>
         </div>
diff --git a/lib/i18n.js b/lib/i18n.js
index f59610b..7a7091d 100644
--- a/lib/i18n.js
+++ b/lib/i18n.js
@@ -222,6 +222,9 @@ const EN = {
   'Reembolsar': 'Refund',
   'Contratar plano': 'Contract plan',
   'Atender pedido': 'Fulfill request',
+  'Mensagem': 'Message',
+  'Faça login para enviar mensagens': 'Sign in to send messages',
+  'Editar': 'Edit',
   'Contrato': 'Contract',
   'Cronograma PING': 'PING schedule',
   'Cadência': 'Cadence',

From f4bd890d9347cec005e16938cfeebd1ad10a832f Mon Sep 17 00:00:00 2001
From: Jodson Graves <info@ntari.org>
Date: Tue, 30 Jun 2026 09:29:04 -0400
Subject: [PATCH 11/16] feat(contracts): plan allocation display + PING
 calendar
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- ListingDetail: plans show "allocated / total contracted · N backers" (and a
  not-divisible note for contract_shares=none), from GET /posts/:id/contracts
- ContractModal: PING calendar — checkpoint chips, next highlighted, 📷 on
  checkpoints that received a producer report

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 components/contracts/ContractModal.js | 30 +++++++++++++++++++++++++--
 components/listings/ListingDetail.js  | 16 +++++++++++++-
 lib/i18n.js                           |  3 +++
 3 files changed, 46 insertions(+), 3 deletions(-)

diff --git a/components/contracts/ContractModal.js b/components/contracts/ContractModal.js
index 3ef669f..83b9821 100644
--- a/components/contracts/ContractModal.js
+++ b/components/contracts/ContractModal.js
@@ -84,19 +84,45 @@ export default function ContractModal({ transaction: tx, me, onClose, onChanged
   const reports = data?.reports || [];
   const past = schedule.filter((s) => s.status === 'past').length;
   const next = schedule.find((s) => s.status === 'upcoming');
+  const reportTimes = reports.map((r) => new Date(r.created_at).getTime());
+
+  // Did the producer post a report within this checkpoint's window?
+  function reportedAt(i) {
+    const start = new Date(schedule[i].date).getTime();
+    const end = i + 1 < schedule.length ? new Date(schedule[i + 1].date).getTime() : Infinity;
+    return reportTimes.some((t2) => t2 >= start && t2 < end);
+  }
 
   return (
     <Modal onClose={onClose} maxWidth="560px">
       <ModalHeader title={tx.listing_title || t('Contrato')} onClose={onClose} />
 
-      {/* PING schedule summary */}
+      {/* PING calendar */}
       {schedule.length > 0 && (
         <div className="bg-cream2 border border-[var(--border-c)] rounded-lg p-3 mb-4 text-sm">
           <div className="text-[11px] font-semibold uppercase tracking-wide text-text3 mb-1">{t('Cronograma PING')}</div>
-          <div className="text-soil">
+          <div className="text-soil mb-2">
             {t('Cadência')}: {t(RATE_LABEL[data?.ping_rate] || 'Weekly')} · {past}/{schedule.length} {t('checkpoints')}
             {next && <> · {t('Próximo')}: {next.date}</>}
           </div>
+          <div className="flex flex-wrap gap-1.5">
+            {schedule.map((s, i) => {
+              const isNext = next && s.date === next.date;
+              const reported = reportedAt(i);
+              return (
+                <span
+                  key={s.date}
+                  title={reported ? t('Atualização publicada') : s.status === 'past' ? t('checkpoints') : t('Próximo')}
+                  className={`text-[11px] px-2 py-1 rounded-md border tabular-nums ${
+                    reported ? 'bg-moss-light border-moss/40 text-soil'
+                      : s.status === 'past' ? 'bg-cream border-[var(--border-c)] text-text3'
+                      : 'border-[var(--border-c)] text-text3'
+                  } ${isNext ? 'ring-1 ring-moss' : ''}`}>
+                  {s.date.slice(5)}{reported ? ' 📷' : ''}
+                </span>
+              );
+            })}
+          </div>
         </div>
       )}
 
diff --git a/components/listings/ListingDetail.js b/components/listings/ListingDetail.js
index 7ea1c41..5be2fe8 100644
--- a/components/listings/ListingDetail.js
+++ b/components/listings/ListingDetail.js
@@ -1,5 +1,5 @@
 'use client';
-import { useState } from 'react';
+import { useState, useEffect } from 'react';
 import { motion } from 'framer-motion';
 import { Modal, ModalHeader } from '@/components/ui/Modal';
 import { catLabel, CAT_EMOJI, formatCurrency, formatDate } from '@/lib/format';
@@ -30,6 +30,12 @@ export default function ListingDetail({ listing, onClose }) {
   const me = getUser();
   const isOwner = me?.id && l.user_id && me.id === l.user_id;
   const [messaging, setMessaging] = useState(false);
+  const [alloc, setAlloc] = useState(null);
+
+  useEffect(() => {
+    if (!isPlan) return;
+    api(`/posts/${l.id}/contracts`).then(setAlloc).catch(() => {});
+  }, []);
 
   async function message() {
     if (!me) return toast(t('Faça login para enviar mensagens'), 'error');
@@ -101,6 +107,14 @@ export default function ListingDetail({ listing, onClose }) {
         </div>
       </div>
 
+      {/* PLAN SHARE ALLOCATION */}
+      {isPlan && alloc && alloc.total != null && (
+        <div className="text-sm text-text3 mb-4">
+          <span className="font-semibold text-soil">{alloc.allocated}</span> / {alloc.total} {t('contratado')} · {alloc.backer_count} {t('apoiadores')}
+          {alloc.contract_shares === 'none' && <span className="text-rust"> · {t('Plano completo (não divisível)')}</span>}
+        </div>
+      )}
+
       {/* DESCRIPTION */}
       {l.description && (
         <p className="text-sm text-text2 leading-relaxed mb-4">{l.description}</p>
diff --git a/lib/i18n.js b/lib/i18n.js
index 7a7091d..2b1ada3 100644
--- a/lib/i18n.js
+++ b/lib/i18n.js
@@ -226,6 +226,9 @@ const EN = {
   'Faça login para enviar mensagens': 'Sign in to send messages',
   'Editar': 'Edit',
   'Contrato': 'Contract',
+  'contratado': 'contracted',
+  'apoiadores': 'backers',
+  'Plano completo (não divisível)': 'Full plan only (not divisible)',
   'Cronograma PING': 'PING schedule',
   'Cadência': 'Cadence',
   'checkpoints': 'checkpoints',

From cf093a495fca55b2bd684353ee4ee990184d9cd6 Mon Sep 17 00:00:00 2001
From: Jodson Graves <info@ntari.org>
Date: Tue, 30 Jun 2026 09:37:24 -0400
Subject: [PATCH 12/16] feat(escrow): maturity-hold settlement UI
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- plan forms: a Settlement select (On confirmation / At maturity)
- ContractModal: shows "🔒 Settles at maturity: <date>" when the contract holds
- profile: the confirm-and-rate button is hidden until the contract matures
  (the backend enforces the hold regardless)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 app/perfil/page.js                    | 3 ++-
 components/contracts/ContractModal.js | 4 ++++
 lib/i18n.js                           | 1 +
 lib/postTypes.js                      | 3 +++
 4 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/app/perfil/page.js b/app/perfil/page.js
index 7a73334..1087612 100644
--- a/app/perfil/page.js
+++ b/app/perfil/page.js
@@ -264,8 +264,9 @@ function PerfilInner() {
                       </div>
                     : txs.map((tx, i) => {
                         const isBuyer = tx.buyer_id === user.id;
+                        const matured = !tx.settle_at || new Date(tx.settle_at) <= new Date();
                         const canRate = ['paid', 'completed'].includes(tx.status) &&
-                          (isBuyer ? !tx.buyer_rated : !tx.seller_rated);
+                          (isBuyer ? !tx.buyer_rated && matured : !tx.seller_rated);
                         return (
                           <motion.div
                             key={tx.id}
diff --git a/components/contracts/ContractModal.js b/components/contracts/ContractModal.js
index 83b9821..e0c6ea5 100644
--- a/components/contracts/ContractModal.js
+++ b/components/contracts/ContractModal.js
@@ -97,6 +97,10 @@ export default function ContractModal({ transaction: tx, me, onClose, onChanged
     <Modal onClose={onClose} maxWidth="560px">
       <ModalHeader title={tx.listing_title || t('Contrato')} onClose={onClose} />
 
+      {tx.settle_at && (
+        <p className="text-xs text-rust mb-3">🔒 {t('Liquidação na maturidade')}: {String(tx.settle_at).slice(0, 10)}</p>
+      )}
+
       {/* PING calendar */}
       {schedule.length > 0 && (
         <div className="bg-cream2 border border-[var(--border-c)] rounded-lg p-3 mb-4 text-sm">
diff --git a/lib/i18n.js b/lib/i18n.js
index 2b1ada3..b41132d 100644
--- a/lib/i18n.js
+++ b/lib/i18n.js
@@ -229,6 +229,7 @@ const EN = {
   'contratado': 'contracted',
   'apoiadores': 'backers',
   'Plano completo (não divisível)': 'Full plan only (not divisible)',
+  'Liquidação na maturidade': 'Settles at maturity',
   'Cronograma PING': 'PING schedule',
   'Cadência': 'Cadence',
   'checkpoints': 'checkpoints',
diff --git a/lib/postTypes.js b/lib/postTypes.js
index 5def9d8..4faa7c8 100644
--- a/lib/postTypes.js
+++ b/lib/postTypes.js
@@ -8,6 +8,7 @@ const ucOptions = USE_CATEGORIES.map((c) => [c, c.charAt(0).toUpperCase() + c.sl
 
 const PING_OPTS = [['daily', 'Daily'], ['weekly', 'Weekly'], ['monthly', 'Monthly']];
 const SHARES_OPTS = [['none', 'No shares'], ['fixed', 'Fixed shares'], ['variable', 'Variable shares']];
+const SETTLEMENT_OPTS = [['on_confirmation', 'On confirmation'], ['maturity', 'At maturity (harvest date)']];
 
 const TOP_LEVEL = new Set(['title', 'description', 'category', 'price', 'unit', 'quantity_available', 'city', 'state', 'terms']);
 
@@ -76,6 +77,7 @@ export const POST_TYPE_FORMS = {
       { key: 'price', label: 'Sold by price (per unit)', kind: 'number' },
       { key: 'ping_rate', label: 'PING rate', kind: 'select', payload: true, options: PING_OPTS },
       { key: 'contract_shares', label: 'Contract shares', kind: 'select', payload: true, options: SHARES_OPTS },
+      { key: 'settlement', label: 'Settlement', kind: 'select', payload: true, options: SETTLEMENT_OPTS },
       { key: 'hydration_plan', label: 'Hydration plan', kind: 'text', payload: true },
       { key: 'nutrition_plan', label: 'Nutrition plan', kind: 'text', payload: true },
       { key: 'health_plan', label: 'Health plan', kind: 'text', payload: true },
@@ -100,6 +102,7 @@ export const POST_TYPE_FORMS = {
       { key: 'price', label: 'Price per amount', kind: 'number' },
       { key: 'ping_rate', label: 'PING rate', kind: 'select', payload: true, options: PING_OPTS },
       { key: 'contract_shares', label: 'Contract shares', kind: 'select', payload: true, options: SHARES_OPTS },
+      { key: 'settlement', label: 'Settlement', kind: 'select', payload: true, options: SETTLEMENT_OPTS },
       { key: 'hydration_plan', label: 'Hydration plan (optional)', kind: 'text', payload: true },
       { key: 'nutrition_plan', label: 'Nutrition plan (optional)', kind: 'text', payload: true },
       { key: 'health_plan', label: 'Health plan (optional)', kind: 'text', payload: true },

From 400ab3e5a0b59eb4976aeed2055a3ee1a29c7698 Mon Sep 17 00:00:00 2001
From: Jodson Graves <info@ntari.org>
Date: Tue, 30 Jun 2026 09:50:07 -0400
Subject: [PATCH 13/16] feat(escrow): progress-payment tranches UI

- plan forms: Settlement gains "Progress payments (tranches)" + a tranche count field
- ContractModal: shows tranche progress (X/N released, amount released of total) and,
  for the buyer on a live contract, a "Release next payment" button (final tranche
  is released by the rating)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 components/contracts/ContractModal.js | 33 +++++++++++++++++++++++++++
 lib/i18n.js                           |  5 ++++
 lib/postTypes.js                      |  4 +++-
 3 files changed, 41 insertions(+), 1 deletion(-)

diff --git a/components/contracts/ContractModal.js b/components/contracts/ContractModal.js
index e0c6ea5..b178156 100644
--- a/components/contracts/ContractModal.js
+++ b/components/contracts/ContractModal.js
@@ -22,6 +22,8 @@ export default function ContractModal({ transaction: tx, me, onClose, onChanged
   const [toEmail, setToEmail] = useState('');
   const [price, setPrice] = useState('');
   const [transferring, setTransferring] = useState(false);
+  const [tranches, setTranches] = useState({ released: tx.tranches_released || 0, amount: Number(tx.released_amount || 0) });
+  const [releasingT, setReleasingT] = useState(false);
 
   const API = process.env.NEXT_PUBLIC_API_URL || '';
   const isSeller = me?.id === tx.seller_id;
@@ -66,6 +68,20 @@ export default function ContractModal({ transaction: tx, me, onClose, onChanged
     finally { setPosting(false); }
   }
 
+  async function releaseNextTranche() {
+    setReleasingT(true);
+    try {
+      const r = await api(`/transactions/${tx.id}/release-tranche`, 'POST');
+      setTranches({ released: r.tranches_released, amount: tranches.amount + r.released });
+      toast(t('Pagamento parcial liberado!'));
+      onChanged?.();
+    } catch (e) {
+      toast(e.message, 'error');
+    } finally {
+      setReleasingT(false);
+    }
+  }
+
   async function transfer() {
     const p = parseFloat(price);
     if (!toEmail.trim()) return toast(t('E-mail do comprador'), 'error');
@@ -101,6 +117,23 @@ export default function ContractModal({ transaction: tx, me, onClose, onChanged
         <p className="text-xs text-rust mb-3">🔒 {t('Liquidação na maturidade')}: {String(tx.settle_at).slice(0, 10)}</p>
       )}
 
+      {tx.tranche_count && (
+        <div className="bg-cream2 border border-[var(--border-c)] rounded-lg p-3 mb-4">
+          <div className="text-[11px] font-semibold uppercase tracking-wide text-text3 mb-1">{t('Pagamentos por etapas')}</div>
+          <div className="text-sm text-soil">
+            {tranches.released} / {tx.tranche_count} {t('liberado')} · {formatCurrency(tranches.amount)} / {formatCurrency(tx.amount)}
+          </div>
+          {me?.id === tx.buyer_id && live && tranches.released < tx.tranche_count - 1 && (
+            <button className="btn btn-outline btn-sm mt-2" onClick={releaseNextTranche} disabled={releasingT}>
+              {releasingT ? t('Enviando...') : t('Liberar próximo pagamento')}
+            </button>
+          )}
+          {tranches.released >= tx.tranche_count - 1 && (
+            <p className="text-xs text-text3 mt-1">{t('O pagamento final é liberado pela sua avaliação.')}</p>
+          )}
+        </div>
+      )}
+
       {/* PING calendar */}
       {schedule.length > 0 && (
         <div className="bg-cream2 border border-[var(--border-c)] rounded-lg p-3 mb-4 text-sm">
diff --git a/lib/i18n.js b/lib/i18n.js
index b41132d..9e8fc14 100644
--- a/lib/i18n.js
+++ b/lib/i18n.js
@@ -230,6 +230,11 @@ const EN = {
   'apoiadores': 'backers',
   'Plano completo (não divisível)': 'Full plan only (not divisible)',
   'Liquidação na maturidade': 'Settles at maturity',
+  'Pagamentos por etapas': 'Progress payments',
+  'liberado': 'released',
+  'Liberar próximo pagamento': 'Release next payment',
+  'Pagamento parcial liberado!': 'Progress payment released!',
+  'O pagamento final é liberado pela sua avaliação.': 'The final payment is released by your rating.',
   'Cronograma PING': 'PING schedule',
   'Cadência': 'Cadence',
   'checkpoints': 'checkpoints',
diff --git a/lib/postTypes.js b/lib/postTypes.js
index 4faa7c8..59895c3 100644
--- a/lib/postTypes.js
+++ b/lib/postTypes.js
@@ -8,7 +8,7 @@ const ucOptions = USE_CATEGORIES.map((c) => [c, c.charAt(0).toUpperCase() + c.sl
 
 const PING_OPTS = [['daily', 'Daily'], ['weekly', 'Weekly'], ['monthly', 'Monthly']];
 const SHARES_OPTS = [['none', 'No shares'], ['fixed', 'Fixed shares'], ['variable', 'Variable shares']];
-const SETTLEMENT_OPTS = [['on_confirmation', 'On confirmation'], ['maturity', 'At maturity (harvest date)']];
+const SETTLEMENT_OPTS = [['on_confirmation', 'On confirmation'], ['maturity', 'At maturity (harvest date)'], ['tranches', 'Progress payments (tranches)']];
 
 const TOP_LEVEL = new Set(['title', 'description', 'category', 'price', 'unit', 'quantity_available', 'city', 'state', 'terms']);
 
@@ -78,6 +78,7 @@ export const POST_TYPE_FORMS = {
       { key: 'ping_rate', label: 'PING rate', kind: 'select', payload: true, options: PING_OPTS },
       { key: 'contract_shares', label: 'Contract shares', kind: 'select', payload: true, options: SHARES_OPTS },
       { key: 'settlement', label: 'Settlement', kind: 'select', payload: true, options: SETTLEMENT_OPTS },
+      { key: 'tranche_count', label: 'Number of tranches (if progress payments)', kind: 'number', payload: true },
       { key: 'hydration_plan', label: 'Hydration plan', kind: 'text', payload: true },
       { key: 'nutrition_plan', label: 'Nutrition plan', kind: 'text', payload: true },
       { key: 'health_plan', label: 'Health plan', kind: 'text', payload: true },
@@ -103,6 +104,7 @@ export const POST_TYPE_FORMS = {
       { key: 'ping_rate', label: 'PING rate', kind: 'select', payload: true, options: PING_OPTS },
       { key: 'contract_shares', label: 'Contract shares', kind: 'select', payload: true, options: SHARES_OPTS },
       { key: 'settlement', label: 'Settlement', kind: 'select', payload: true, options: SETTLEMENT_OPTS },
+      { key: 'tranche_count', label: 'Number of tranches (if progress payments)', kind: 'number', payload: true },
       { key: 'hydration_plan', label: 'Hydration plan (optional)', kind: 'text', payload: true },
       { key: 'nutrition_plan', label: 'Nutrition plan (optional)', kind: 'text', payload: true },
       { key: 'health_plan', label: 'Health plan (optional)', kind: 'text', payload: true },

From 0716c57ce0046dcc450c013e897f5aafb428fc4f Mon Sep 17 00:00:00 2001
From: Jodson Graves <info@ntari.org>
Date: Tue, 30 Jun 2026 11:40:20 -0400
Subject: [PATCH 14/16] =?UTF-8?q?fix(lbtas):=20P3-011=20v2=20audit=20?=
 =?UTF-8?q?=E2=80=94=20surface=20dismissals,=20contest=20flags,=20governan?=
 =?UTF-8?q?ce=20footer?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- ReputationPanel: show "N× rating dismissed (on record)" per role (V1 — never hide)
- My Contracts: "Flags received" — contest a -1 made against you, either direction
  (V2), via POST /ratings/:id/contest
- DisputeResolveModal: read the operator-local narrative field (V3)
- Footer: "Network & Governance" — names the Agrinet protocol + NTARI steward,
  states front-end standing / cheap exit (G1) and links a rule-contestation path (G2)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 app/contracts/page.js                   | 38 ++++++++++++++++++++++-
 components/Footer.js                    | 40 +++++++++++++++++++------
 components/admin/DisputeResolveModal.js |  2 +-
 components/ratings/ReputationPanel.js   |  5 ++++
 lib/i18n.js                             |  6 ++++
 5 files changed, 80 insertions(+), 11 deletions(-)

diff --git a/app/contracts/page.js b/app/contracts/page.js
index cb70824..3f87028 100644
--- a/app/contracts/page.js
+++ b/app/contracts/page.js
@@ -17,6 +17,7 @@ export default function MyContracts() {
   const [pending, setPending] = useState(null);
   const [myRep, setMyRep] = useState(null);
   const [rateItem, setRateItem] = useState(null);
+  const [received, setReceived] = useState([]);
 
   useEffect(() => {
     const u = getUser();
@@ -27,19 +28,32 @@ export default function MyContracts() {
 
   async function load() {
     try {
-      const [p, rep] = await Promise.all([
+      const [p, rep, rec] = await Promise.all([
         api('/ratings/me/pending').catch(() => ({ pending: [] })),
         api('/ratings/me').catch(() => null),
+        api('/ratings/me/received').catch(() => ({ received: [] })),
       ]);
       setPending(p.pending || []);
       setMyRep(rep);
+      setReceived(rec.received || []);
     } catch {
       setPending([]);
     }
   }
 
+  async function contest(ratingId) {
+    const reason = prompt(t('Por que esta avaliação é injusta?'));
+    if (!reason || !reason.trim()) return;
+    try {
+      await api('/ratings/' + ratingId + '/contest', 'POST', { reason: reason.trim() });
+      load();
+    } catch (e) { alert(e.message); }
+  }
+
   if (!user) return null;
 
+  const openFlags = received.filter((r) => !r.voided);
+
   return (
     <div className="min-h-screen bg-cream">
       <div style={{ maxWidth: 1000, margin: '0 auto', padding: 'clamp(20px,3vw,40px) var(--page-pad)' }}>
@@ -82,6 +96,28 @@ export default function MyContracts() {
             </div>
           )}
         </div>
+
+        {/* ── FLAGS RECEIVED (contest a -1 made against you — either direction) ── */}
+        {openFlags.length > 0 && (
+          <div className="card-agro p-5 mt-5">
+            <div className="text-xs font-semibold uppercase tracking-widest text-rust mb-1">{t('Sinalizações recebidas')}</div>
+            <p className="text-xs text-text3 mb-4">{t('Uma avaliação “Sem confiança” contra você pode ser contestada para revisão.')}</p>
+            <div className="flex flex-col gap-3">
+              {openFlags.map((f) => (
+                <div key={f.id} className="tx-item">
+                  <div className="tx-icon text-rust">-1</div>
+                  <div className="flex-1 min-w-0">
+                    <div className="text-sm font-semibold text-soil">{t('Sem confiança')} · {f.rated_role}</div>
+                    <div className="text-xs text-text3 mt-1">{formatDate(f.created_at)}{f.contested ? ' · ' + t('contestada') : ''}</div>
+                  </div>
+                  {f.contested
+                    ? <span className="badge-agro badge-wheat text-[10px] self-center">{t('contestada')}</span>
+                    : <button className="btn btn-outline btn-sm self-center" onClick={() => contest(f.id)}>{t('Contestar')}</button>}
+                </div>
+              ))}
+            </div>
+          </div>
+        )}
       </div>
 
       {rateItem && (
diff --git a/components/Footer.js b/components/Footer.js
index 878ede6..8d27923 100644
--- a/components/Footer.js
+++ b/components/Footer.js
@@ -2,18 +2,40 @@ export default function Footer() {
   // AGPL-3 "Appropriate Legal Notices" (§0): copyright, no-warranty, license link,
   // and the Corresponding Source (§13) for the network-served version — Fruitful
   // (this frontend) + Agrinet (the backend) — plus the upstream it derives from.
+  // Plus a Network & Governance section (P3-011 v2): name the protocol and the
+  // steward, and surface the paths — front-end standing/exit and rule contestation.
   const link = { fontSize: 12, color: 'rgba(255,255,255,.5)', textDecoration: 'none' };
+  const gov = { fontSize: 12, color: 'rgba(255,255,255,.7)', textDecoration: 'underline' };
+  const strong = { color: 'rgba(255,255,255,.85)' };
   return (
-    <footer style={{ background: 'var(--soil2)', padding: 'var(--space-md) var(--page-pad)', display: 'flex', alignItems: 'center', justifyContent: 'space-between', flexWrap: 'wrap', gap: 12 }}>
-      <div style={{ fontFamily: 'var(--font-serif)', fontSize: 18, fontWeight: 700, color: 'var(--cream)' }}>Fruitful</div>
-      <div className="flex flex-wrap gap-x-8 gap-y-1">
-        <a href="https://www.gnu.org/licenses/agpl-3.0.html" target="_blank" rel="noreferrer" style={link}>AGPL-3.0</a>
-        <a href="https://github.com/NTARI-RAND/fruitful" target="_blank" rel="noreferrer" style={link}>Source: Fruitful</a>
-        <a href="https://github.com/NTARI-RAND/Agrinet" target="_blank" rel="noreferrer" style={link}>Source: Agrinet</a>
-        <a href="https://github.com/carloszambonii/agrinet-brazil" target="_blank" rel="noreferrer" style={link}>Upstream</a>
-        <a href="https://docs.theagri.net" target="_blank" rel="noreferrer" style={link}>Docs</a>
+    <footer style={{ background: 'var(--soil2)', padding: 'var(--space-md) var(--page-pad)', display: 'flex', flexDirection: 'column', gap: 14 }}>
+      <div style={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between', flexWrap: 'wrap', gap: 12 }}>
+        <div style={{ fontFamily: 'var(--font-serif)', fontSize: 18, fontWeight: 700, color: 'var(--cream)' }}>Fruitful</div>
+        <div className="flex flex-wrap gap-x-8 gap-y-1">
+          <a href="https://www.gnu.org/licenses/agpl-3.0.html" target="_blank" rel="noreferrer" style={link}>AGPL-3.0</a>
+          <a href="https://github.com/NTARI-RAND/fruitful" target="_blank" rel="noreferrer" style={link}>Source: Fruitful</a>
+          <a href="https://github.com/NTARI-RAND/Agrinet" target="_blank" rel="noreferrer" style={link}>Source: Agrinet</a>
+          <a href="https://github.com/carloszambonii/agrinet-brazil" target="_blank" rel="noreferrer" style={link}>Upstream</a>
+          <a href="https://docs.theagri.net" target="_blank" rel="noreferrer" style={link}>Docs</a>
+        </div>
       </div>
-      <div style={{ fontSize: 11, color: 'rgba(255,255,255,.4)', maxWidth: 380 }}>
+
+      {/* ── Network & Governance ── */}
+      <div style={{ borderTop: '1px solid rgba(255,255,255,.1)', paddingTop: 12, display: 'flex', flexDirection: 'column', gap: 6 }}>
+        <div style={{ fontSize: 11, fontWeight: 600, letterSpacing: '.12em', textTransform: 'uppercase', color: 'rgba(255,255,255,.55)' }}>
+          Network &amp; Governance
+        </div>
+        <div style={{ fontSize: 12, color: 'rgba(255,255,255,.6)', maxWidth: 760, lineHeight: 1.6 }}>
+          The marketplace, your reputation, and the immutable transaction ledger live in the <strong style={strong}>Agrinet</strong> protocol — not in this front end. Your record and the market are portable: if a front end declines, read its standing and leave on the trend — your reputation and counterparties come with you. The protocol is stewarded by the <strong style={strong}>Network Theory Applied Research Institute</strong>, a mission-locked 501(c)(3) governed one member, one vote, with its open-source and privacy-first commitments entrenched behind a double supermajority.
+        </div>
+        <div className="flex flex-wrap gap-x-6 gap-y-1" style={{ marginTop: 2 }}>
+          <a href="https://ntari.org" target="_blank" rel="noreferrer" style={gov}>NTARI — the steward</a>
+          <a href="https://ntari.org" target="_blank" rel="noreferrer" style={gov}>Propose or contest a rule</a>
+          <a href="https://github.com/NTARI-RAND/Agrinet" target="_blank" rel="noreferrer" style={gov}>The Agrinet protocol</a>
+        </div>
+      </div>
+
+      <div style={{ fontSize: 11, color: 'rgba(255,255,255,.4)', maxWidth: 520 }}>
         © 2025 Network Theory Applied Research Institute. Fruitful is free software (AGPL-3.0) provided with NO WARRANTY; its source is linked above.
       </div>
     </footer>
diff --git a/components/admin/DisputeResolveModal.js b/components/admin/DisputeResolveModal.js
index cb0a353..2460164 100644
--- a/components/admin/DisputeResolveModal.js
+++ b/components/admin/DisputeResolveModal.js
@@ -78,7 +78,7 @@ export default function DisputeResolveModal({ dispute, onClose, onResolved }) {
                   <span className="text-xs text-text3">{LEVEL_LABELS[String(r.value)]}</span>
                   {r.voided ? <span className="text-[10px] uppercase tracking-wide text-text3 ml-auto">{t('Anulada')}</span> : null}
                 </div>
-                {r.comment && <div className="text-xs text-text2 mt-1 break-words">{r.comment}</div>}
+                {r.narrative && <div className="text-xs text-text2 mt-1 break-words">{r.narrative}</div>}
               </div>
             ))}
           </div>
diff --git a/components/ratings/ReputationPanel.js b/components/ratings/ReputationPanel.js
index cc2ff21..1f7404b 100644
--- a/components/ratings/ReputationPanel.js
+++ b/components/ratings/ReputationPanel.js
@@ -18,6 +18,11 @@ export default function ReputationPanel({ rep, size = 'sm' }) {
         <div key={r.role}>
           <div className="text-[11px] font-semibold uppercase tracking-wide text-text3 mb-1">{r.label}</div>
           <LbtasDistribution distribution={r.distribution} total={r.total} size={size} />
+          {r.dismissed?.length > 0 && (
+            <div className="text-[11px] text-text3 mt-1" title={r.dismissed.map((d) => `${d.value} — ${d.voided_reason || 'dismissed'}`).join('\n')}>
+              {r.dismissed.length}× {t('avaliação anulada (registrada)')}
+            </div>
+          )}
         </div>
       ))}
     </div>
diff --git a/lib/i18n.js b/lib/i18n.js
index 9e8fc14..8cb2bb7 100644
--- a/lib/i18n.js
+++ b/lib/i18n.js
@@ -327,6 +327,12 @@ const EN = {
   'avaliações': 'ratings',
   'Sem confiança': 'No Trust',
   'Minha reputação': 'My reputation',
+  'avaliação anulada (registrada)': 'rating dismissed (on record)',
+  'Sinalizações recebidas': 'Flags received',
+  'Uma avaliação “Sem confiança” contra você pode ser contestada para revisão.': 'A "No Trust" rating against you can be contested for review.',
+  'Por que esta avaliação é injusta?': 'Why is this rating unfair?',
+  'Contestar': 'Contest',
+  'contestada': 'contested',
   'Reputação é uma distribuição, nunca uma média.': 'Reputation is a distribution, never an average.',
   'Reputação é uma distribuição por papel, nunca uma média.': 'Reputation is a distribution per role, never an average.',
   'Avaliações pendentes': 'Pending ratings',

From 2e3619e8d7c28589c6cffc0efc116f0f388c9384 Mon Sep 17 00:00:00 2001
From: Jodson Graves <info@ntari.org>
Date: Wed, 1 Jul 2026 08:51:19 -0400
Subject: [PATCH 15/16] =?UTF-8?q?feat(perfil):=20JFA=20=C2=A77.3=20UI=20co?=
 =?UTF-8?q?nformance=20=E2=80=94=20retire=20wallet=20top-up,=20show=20fee?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Pairs with Agrinet PR #141 (backend retired the general fiat top-up).

- Remove the deposit UI (modal, "Depositar" button, doDeposit -> /payments/pix/create,
  "Total depositado" stat): the in-network unit is earned and spend-only, never
  purchasable.
- Balance card now labels the balance honestly: earned in-network, credited from
  sales and refunds, not purchasable or redeemable for cash.
- Wallet summary shows Spent / Received from sales / Refunded, plus the current
  platform fee fetched from GET /payments/fee (transparent, contestable fee).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 app/perfil/page.js | 68 ++++++++++++++--------------------------------
 lib/i18n.js        |  3 ++
 2 files changed, 24 insertions(+), 47 deletions(-)

diff --git a/app/perfil/page.js b/app/perfil/page.js
index 1087612..e5f41b8 100644
--- a/app/perfil/page.js
+++ b/app/perfil/page.js
@@ -41,10 +41,8 @@ function PerfilInner() {
   const [txs, setTxs]             = useState(null);
   const [myListings, setMyListings] = useState(null);
   const [newListing, setNewListing] = useState(false);
-  const [depositOpen, setDepositOpen] = useState(false);
-  const [depAmt, setDepAmt]       = useState('');
+  const [fee, setFee]             = useState(null);
   const [txDetail, setTxDetail]   = useState(null);
-  const [loading, setLoading]     = useState(false);
   const [myRep, setMyRep]         = useState(null);
   const [rateTx, setRateTx]       = useState(null);
   const [contractTx, setContractTx] = useState(null);
@@ -70,12 +68,14 @@ function PerfilInner() {
 
   async function loadWallet() {
     try {
-      const [w, h] = await Promise.all([
+      const [w, h, f] = await Promise.all([
         api('/wallet').catch(() => ({ balance: 0 })),
         api('/wallet/history').catch(() => []),
+        api('/payments/fee').catch(() => null),
       ]);
       setWallet(w);
       setHistory(h.history || h || []);
+      setFee(f);
     } catch {}
   }
 
@@ -96,18 +96,8 @@ function PerfilInner() {
     } catch { setMyListings([]); }
   }
 
-  async function doDeposit() {
-    const amt = parseFloat(depAmt);
-    if (!amt || amt <= 0) return toast(t('Informe um valor'), 'error');
-    setLoading(true);
-    try {
-      await api('/payments/pix/create', 'POST', { amount: amt });
-      toast(t('PaymentIntent criado! Verifique o e-mail.'));
-      setDepositOpen(false);
-      setDepAmt('');
-    } catch (e) { toast(e.message, 'error'); }
-    finally { setLoading(false); }
-  }
+  // Wallet top-up removed (JFA §7.3): the in-network unit is earned and spend-only,
+  // never purchasable. Balance grows only from sales settlements and refunds.
 
   async function payTx(id)     { try { await api('/transactions/'+id+'/pay','POST');     toast(t('Pagamento iniciado!'));  loadTxs(); } catch(e){ toast(e.message,'error'); } }
   async function releaseTx(id) { try { await api('/transactions/'+id+'/release','POST'); toast(t('Escrow liberado!'));     loadTxs(); loadWallet(); } catch(e){ toast(e.message,'error'); } }
@@ -126,12 +116,12 @@ function PerfilInner() {
 
   const initials = (user.email || 'U').substring(0, 2).toUpperCase();
   const bal  = wallet?.balance || 0;
-  let inc = 0, out = 0, sales = 0;
+  let out = 0, sales = 0, refunds = 0;
   history.forEach(h => {
     const a = Number(h.amount);
-    if (h.type === 'deposit')  inc   += a;
-    if (h.type === 'purchase') out   += Math.abs(a);
-    if (h.type === 'sale')     sales += a;
+    if (h.type === 'purchase') out     += Math.abs(a);
+    if (h.type === 'sale')     sales   += a;
+    if (h.type === 'refund')   refunds += Math.abs(a);
   });
 
   const TABS = [
@@ -199,12 +189,8 @@ function PerfilInner() {
                   <div className="wallet-card rounded-2xl p-6 flex flex-col">
                     <div className="text-xs font-semibold uppercase tracking-widest text-white/70 mb-1">{t('Saldo disponível')}</div>
                     <div className="font-serif text-4xl font-black text-white mt-1">{formatCurrency(bal)}</div>
-                    <div className="mt-auto pt-6">
-                      <button
-                        onClick={() => setDepositOpen(true)}
-                        className="px-4 py-2 rounded-lg text-sm font-semibold text-white border border-white/30 bg-white/10 hover:bg-white/20 transition-colors">
-                        + {t('Depositar')}
-                      </button>
+                    <div className="mt-auto pt-6 text-xs text-white/70 leading-relaxed">
+                      {t('Ganho na rede — creditado por vendas e reembolsos. Não é comprável nem resgatável por dinheiro.')}
                     </div>
                   </div>
 
@@ -212,15 +198,21 @@ function PerfilInner() {
                   <div className="card-agro p-6 flex flex-col gap-3">
                     <div className="text-xs font-semibold uppercase tracking-widest text-text3 mb-1">{t('Resumo')}</div>
                     {[
-                      ['Total depositado',    formatCurrency(inc),   'text-moss'],
-                      ['Total gasto',         formatCurrency(out),   'text-rust'],
-                      ['Recebido em vendas',  formatCurrency(sales), 'text-moss'],
+                      ['Total gasto',         formatCurrency(out),     'text-rust'],
+                      ['Recebido em vendas',  formatCurrency(sales),   'text-moss'],
+                      ['Reembolsado',         formatCurrency(refunds), 'text-wheat'],
                     ].map(([label, val, cls]) => (
                       <div key={label} className="flex items-center justify-between">
                         <span className="text-sm text-text3">{t(label)}</span>
                         <span className={`text-sm font-semibold ${cls}`}>{val}</span>
                       </div>
                     ))}
+                    {fee && (
+                      <div className="flex items-center justify-between border-t border-[var(--border-c)] pt-2 mt-1">
+                        <span className="text-sm text-text3">{t('Taxa da plataforma')}</span>
+                        <span className="text-sm font-semibold text-soil">{fee.fee_percent}%</span>
+                      </div>
+                    )}
                   </div>
                 </div>
 
@@ -323,24 +315,6 @@ function PerfilInner() {
         </AnimatePresence>
       </div>
 
-      {/* ── DEPOSIT MODAL ── */}
-      {depositOpen && (
-        <Modal onClose={() => setDepositOpen(false)} maxWidth="400px">
-          <ModalHeader title={t('Depositar na wallet')} onClose={() => setDepositOpen(false)} />
-          <div className="form-group">
-            <label className="form-label">{t('Valor (R$)')}</label>
-            <input type="number" placeholder="0,00" step="0.01" min="1"
-              className="form-input" value={depAmt} onChange={e => setDepAmt(e.target.value)} />
-          </div>
-          <div className="bg-cream2 border border-[var(--border-c)] rounded-lg p-3 text-sm text-text3 mb-4 leading-relaxed">
-            {t('Pagamento processado com segurança via Stripe. Saldo creditado instantaneamente.')}
-          </div>
-          <button className="btn btn-primary w-full" onClick={doDeposit} disabled={loading}>
-            {loading ? t('Processando...') : t('Confirmar depósito')}
-          </button>
-        </Modal>
-      )}
-
       {/* ── TX DETAIL MODAL ── */}
       {txDetail && (
         <Modal onClose={() => setTxDetail(null)}>
diff --git a/lib/i18n.js b/lib/i18n.js
index 8cb2bb7..5c0eff8 100644
--- a/lib/i18n.js
+++ b/lib/i18n.js
@@ -295,6 +295,9 @@ const EN = {
   'Total depositado': 'Total deposited',
   'Total gasto': 'Total spent',
   'Recebido em vendas': 'Received from sales',
+  'Reembolsado': 'Refunded',
+  'Taxa da plataforma': 'Platform fee',
+  'Ganho na rede — creditado por vendas e reembolsos. Não é comprável nem resgatável por dinheiro.': 'Earned in-network — credited from sales and refunds. Not purchasable or redeemable for cash.',
   'Histórico de movimentações': 'Transaction history',
   'Nenhuma movimentação': 'No transactions',
   'Nenhuma transação ainda': 'No transactions yet',

From cde8f5eb60bdbb4d8e589d07d97738dcc04d0766 Mon Sep 17 00:00:00 2001
From: Jodson Graves <info@ntari.org>
Date: Wed, 1 Jul 2026 08:52:48 -0400
Subject: [PATCH 16/16] fix(i18n): drop duplicate 'Reembolsado' key (already
 defined)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 lib/i18n.js | 1 -
 1 file changed, 1 deletion(-)

diff --git a/lib/i18n.js b/lib/i18n.js
index 5c0eff8..53ce2fd 100644
--- a/lib/i18n.js
+++ b/lib/i18n.js
@@ -295,7 +295,6 @@ const EN = {
   'Total depositado': 'Total deposited',
   'Total gasto': 'Total spent',
   'Recebido em vendas': 'Received from sales',
-  'Reembolsado': 'Refunded',
   'Taxa da plataforma': 'Platform fee',
   'Ganho na rede — creditado por vendas e reembolsos. Não é comprável nem resgatável por dinheiro.': 'Earned in-network — credited from sales and refunds. Not purchasable or redeemable for cash.',
   'Histórico de movimentações': 'Transaction history',