From 2d79c81e7d714e7a9b8c18f92ad689af507d15f5 Mon Sep 17 00:00:00 2001
From: Adam Moussa <166072409+amoussa1229@users.noreply.github.com>
Date: Thu, 30 Apr 2026 15:03:43 -0400
Subject: [PATCH] Update README with pending-site-review table and address
 fallback docs

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index e11c80d..44ba4e3 100644
--- a/README.md
+++ b/README.md
@@ -24,7 +24,7 @@ The `po-ingest-site-extractor` Lambda is triggered by the DynamoDB Stream on eve
 2. Parses `ship_to.address` into structured fields (street, city, state, zip).
 3. Upserts to the `verified-sites` DynamoDB table — atomically increments `poCount` and appends the PO number to `sourcePOs`.
 
-POs with no extractable site code are logged and skipped.
+POs with no extractable site code fall through to an address reverse-lookup against the verified-sites cache (normalized street + zip). If still unresolved, the PO is written to the `pending-site-review` table for manual verification against Payee Central.
 
 Backfill stats (initial run): 14,825 POs scanned → 9,900 with extractable site codes → 1,100 unique sites.
 
@@ -39,6 +39,7 @@ Backfill stats (initial run): 14,825 POs scanned → 9,900 with extractable site
   - S3 `po-ingest-emails-{AccountId}` — 90-day lifecycle expiry.
   - DynamoDB `purchase-orders` — owned by this stack, Streams enabled (NEW_AND_OLD_IMAGES).
   - DynamoDB `verified-sites` — PK `siteCode`, GSI `by-state` on `state`.
+  - DynamoDB `pending-site-review` — PK `po_number`. POs with no extractable site code and no address match, awaiting manual Payee Central verification.
 - **Secrets:** Anthropic API key in Secrets Manager at `po-ingest/anthropic-api-key`.
 - **SES:** adds the `PoEmailRule` to the existing `INBOUND_MAIL` receipt rule set (shared with `workorder-ingest`).