[STELA-US] Rosetta Stela User Stories — Gemini 3 Pro Perspective

{
  "code": "## Rosetta Stela User Stories — Comprehensive Perspective\n\n---\n\n### 1. TRADE USERS\n\n**US1.1** As a **customs broker handling 200+ entries/day**, I want to drag a .stela file into my ABI software so that it auto-populates all 80+ fields of the 7501 Entry Summary without manual keying, reducing my per-entry processing time from 45 minutes to under 5.\n\n**US1.2** As a **Mexican freight forwarder at the Laredo crossing**, I want to scan a product's QR code on my phone (which resolves to a .stela file) so that I can verify the HTS classification matches the physical goods and the USMCA certificate of origin is valid — all while standing at the truck.\n\n**US1.3** As an **exporter in Shenzhen**, I want to generate a .stela file from my ERP system so that my buyer's broker in Long Beach receives a pre-classified, pre-documented package that clears customs 3x faster than competitors still emailing PDFs.\n\n**US1.4** As a **small importer doing my first shipment from Vietnam**, I want to upload my commercial invoice to a service that returns a .stela file so that I don't need to hire a broker — the file contains everything CBP needs, with confidence scores I can verify before submitting.\n\n**US1.5** As a **Amazon FBA seller sourcing from Alibaba**, I want my supplier's .stela files to automatically sync with my Seller Central account so that country-of-origin declarations, material compositions, and safety certifications are always current and auditable.\n\n---\n\n### 2. GOVERNMENT USERS\n\n**US2.1** As a **CBP Import Specialist at the NTC**, I want to query a .stela file's intelligence layer using natural language (\"show me similar products that were reclassified in the last 12 months\") so that I can make informed classification decisions backed by precedent data — without searching CROSS manually.\n\n**US2.2** As an **FDA Prior Notice reviewer**, I want to verify a .stela file's food facility registration, process filing, and lab test certificates against my PREDICT database so that I can flag high-risk shipments before they arrive at port — with the file providing cryptographic proof of certificate validity.\n\n**US2.3** As a **SAT (Mexican tax authority) auditor**, I want to verify that a .stela file's customs value, transfer pricing data, and related-party flags are internally consistent so that I can detect undervaluation without requesting additional documents from the importer.\n\n**US2.4** As an **OFAC compliance screener**, I want to run a .stela file's vendor network graph against the SDN list so that I can detect if any party in the supply chain (vendor, broker, carrier, financial intermediary) is sanctioned — including shell company detection via the behavioral embedding.\n\n**US2.5** As a **European customs officer processing goods entering via Rotterdam**, I want to verify the .stela file's CBAM (Carbon Border Adjustment Mechanism) embedded emissions data so that I can calculate the correct carbon levy without requiring the importer to fill out separate CBAM declaration forms.\n\n---\n\n### 3. TECHNOLOGY USERS\n\n**US3.1** As a **marketplace platform developer building a cross-border e-commerce app**, I want to query a .stela file's MCP interface so that my AI shopping agent can answer \"Can I ship this to Brazil?\" with accurate landed cost, duty rate, and required certificates — without building my own compliance engine.\n\n**US3.2** As a **Vertex AI pipeline engineer**, I want to batch-process 100K .stela files through a BigQuery ML model so that I can train product classification models on real trade data with embeddings, achieving higher accuracy than text-only approaches.\n\n**US3.3** As an **A2A agent developer**, I want to discover a .stela file's Agent Card so that my logistics optimization agent can negotiate directly with the product's embedded trade agent about routing, insurance, and customs strategies — agent-to-agent without human intermediation.\n\n**US3.4** As a **Google Maps Platform integrator**, I want to plot a .stela file's complete supply chain route (origin factory → ports of loading → transshipment → port of discharge → inland warehouse) on a map so that customs authorities can visualize routing anomalies and my clients can track their goods in real-time.\n\n**US3.5** As a **mobile-first developer in Lagos**, I want to build an app where Nigerian traders photograph goods with their phone camera, get back a .stela file with auto-classification via the visual embedding, so that informal traders can formalize their imports without understanding the HS Nomenclature.\n\n---\n\n### 4. INTELLIGENCE USERS\n\n**US4.1** As a **TBML (Trade-Based Money Laundering) analyst at FinCEN**, I want to cluster .stela files by behavioral embedding similarity so that I can identify trade patterns that match known laundering typologies — over/under-invoicing, phantom shipments, rapid origin-switching.\n\n**US4.2** As a **transshipment detection analyst**, I want to compare a .stela file's routing data against UN Comtrade bilateral trade statistics so that I can flag shipments where the declared origin country doesn't produce the commodity in the declared volume — a strong transshipment indicator.\n\n**US4.3** As a **sanctions evasion investigator**, I want to query the Intelligence Layer's vendor network graph across multiple .stela files so that I can discover hidden beneficial ownership — where the same ultimateconsignee appears across seemingly unrelated shipments from different vendors.\n\n**US4.4** As a **Europol trade crimes unit officer**, I want to perform selective disclosure verification on a .stela file so that I can prove to a court that the intelligence was derived from legitimately obtained data (the BBS+ proof chain) without revealing the full intelligence methodology.\n\n---\n\n### 5. COMPLIANCE USERS\n\n**US5.1** As a **Chief Compliance Officer at a Fortune 500 importer**, I want a dashboard that automatically validates all incoming .stela files against our denied-party screening, forced labor due diligence (UFLPA), and hazmat regulations so that I receive a daily compliance scorecard with zero manual screening effort.\n\n**US5.2** As a **C-TPAT (Customs-Trade Partnership Against Terrorism) validator**, I want to verify that a supply chain partner's .stela files contain valid security profiles (factory audits, transport security, personnel vetting) so that I can assess their C-TPAT tier without conducting an on-site visit for routine revalidation.\n\n**US5.3** As a **EU Digital Product Passport compliance manager**, I want to generate a DPP-compliant .stela file (using the DPPProfile consumer profile) so that my products meet the upcoming EU Battery Regulation and Ecodesign requirements with a single file format instead of maintaining separate DPP systems.\n\n---\n\n### 6. LOGISTICS USERS\n\n**US6.1** As a **cold chain logistics manager**, I want to embed IoT temperature sensor data into a .stela file's spatial embedding block so that any party downstream can verify the cold chain was maintained — with the data cryptographically timestamped and tamper-evident.\n\n**US6.2** As a **last-mile delivery driver in Mexico City**, I want to scan a package's .stela QR code on my phone so that I can verify the delivery address, customs clearance status, and any special handling instructions — in Spanish, auto-translated from the original language.\n\n**US6.3** As a **3PL warehouse operator**, I want my WMS to read .stela files so that incoming goods are automatically slotted by hazmat class, temperature requirements, and country-of-origin (for duty drawback tracking) — without manual data entry from paper BOLs.\n\n---\n\n### 7. FINANCIAL USERS\n\n**US7.1** As a **trade finance analyst at a bank**, I want to verify a .stela file's document authenticity score and value-weight anomaly flags so that I can assess the risk of a letter of credit application — rejecting applications where the intelligence layer indicates potential fraud indicators.\n\n**US7.2** As a **cargo insurance underwriter**, I want to query a .stela file's complete risk profile (commodity type, routing, vendor history, document authenticity) so that I can price policies more accurately — offering lower premiums for shipments with high-confidence Stela data and penalizing opaque supply chains.\n\n**US7.3** As a **trade credit insurer (Coface/Euler Hermes)**, I want to aggregate .stela files from a buyer's import history so that I can build a behavioral credit model based on actual trade patterns rather than financial statements alone — including concentration risk (single-source dependency) and compliance track record.\n\n---\n\n### CROSS-CUTTING: Emerging Market & Mobile-First\n\n**US-EM.1** As a **smallholder coffee farmer in Colombia**, I want to create a .stela file from a photo of my harvest and a GPS pin so that international buyers can verify origin, quality grade (via visual embedding), and fair-trade certification — giving me direct access to specialty markets without intermediaries.\n\n**US-EM.2** As a **border agent at the Cotonou port in Benin**, I want to validate .stela files offline on my phone (local ISOBMFF parser + cached credential verification) so that I can process shipments even when internet connectivity is intermittent — with sync happening when connectivity returns.\n\n**US-EM.3** As a **ASEAN customs harmonization officer**, I want to map .stela files' multi-jurisdiction classification data (HS2022 → AHTN → national tariff) so that I can verify consistent classification across the 10 ASEAN member states for goods moving through the ASEAN Single Window.",
  "content": "## Rosetta Stela User Stories — Comprehensive Perspective\n\n---\n\n### 1. TRADE USERS\n\n**US1.1** As a **customs broker handling 200+ entries/day**, I want to drag a .stela file into my ABI software so that it auto-populates all 80+ fields of the 7501 Entry Summary without manual keying, reducing my per-entry processing time from 45 minutes to under 5.\n\n**US1.2** As a **Mexican freight forwarder at the Laredo crossing**, I want to scan a product's QR code on my phone (which resolves to a .stela file) so that I can verify the HTS classification matches the physical goods and the USMCA certificate of origin is valid — all while standing at the truck.\n\n**US1.3** As an **exporter in Shenzhen**, I want to generate a .stela file from my ERP system so that my buyer's broker in Long Beach receives a pre-classified, pre-documented package that clears customs 3x faster than competitors still emailing PDFs.\n\n**US1.4** As a **small importer doing my first shipment from Vietnam**, I want to upload my commercial invoice to a service that returns a .stela file so that I don't need to hire a broker — the file contains everything CBP needs, with confidence scores I can verify before submitting.\n\n**US1.5** As a **Amazon FBA seller sourcing from Alibaba**, I want my supplier's .stela files to automatically sync with my Seller Central account so that country-of-origin declarations, material compositions, and safety certifications are always current and auditable.\n\n---\n\n### 2. GOVERNMENT USERS\n\n**US2.1** As a **CBP Import Specialist at the NTC**, I want to query a .stela file's intelligence layer using natural language (\"show me similar products that were reclassified in the last 12 months\") so that I can make informed classification decisions backed by precedent data — without searching CROSS manually.\n\n**US2.2** As an **FDA Prior Notice reviewer**, I want to verify a .stela file's food facility registration, process filing, and lab test certificates against my PREDICT database so that I can flag high-risk shipments before they arrive at port — with the file providing cryptographic proof of certificate validity.\n\n**US2.3** As a **SAT (Mexican tax authority) auditor**, I want to verify that a .stela file's customs value, transfer pricing data, and related-party flags are internally consistent so that I can detect undervaluation without requesting additional documents from the importer.\n\n**US2.4** As an **OFAC compliance screener**, I want to run a .stela file's vendor network graph against the SDN list so that I can detect if any party in the supply chain (vendor, broker, carrier, financial intermediary) is sanctioned — including shell company detection via the behavioral embedding.\n\n**US2.5** As a **European customs officer processing goods entering via Rotterdam**, I want to verify the .stela file's CBAM (Carbon Border Adjustment Mechanism) embedded emissions data so that I can calculate the correct carbon levy without requiring the importer to fill out separate CBAM declaration forms.\n\n---\n\n### 3. TECHNOLOGY USERS\n\n**US3.1** As a **marketplace platform developer building a cross-border e-commerce app**, I want to query a .stela file's MCP interface so that my AI shopping agent can answer \"Can I ship this to Brazil?\" with accurate landed cost, duty rate, and required certificates — without building my own compliance engine.\n\n**US3.2** As a **Vertex AI pipeline engineer**, I want to batch-process 100K .stela files through a BigQuery ML model so that I can train product classification models on real trade data with embeddings, achieving higher accuracy than text-only approaches.\n\n**US3.3** As an **A2A agent developer**, I want to discover a .stela file's Agent Card so that my logistics optimization agent can negotiate directly with the product's embedded trade agent about routing, insurance, and customs strategies — agent-to-agent without human intermediation.\n\n**US3.4** As a **Google Maps Platform integrator**, I want to plot a .stela file's complete supply chain route (origin factory → ports of loading → transshipment → port of discharge → inland warehouse) on a map so that customs authorities can visualize routing anomalies and my clients can track their goods in real-time.\n\n**US3.5** As a **mobile-first developer in Lagos**, I want to build an app where Nigerian traders photograph goods with their phone camera, get back a .stela file with auto-classification via the visual embedding, so that informal traders can formalize their imports without understanding the HS Nomenclature.\n\n---\n\n### 4. INTELLIGENCE USERS\n\n**US4.1** As a **TBML (Trade-Based Money Laundering) analyst at FinCEN**, I want to cluster .stela files by behavioral embedding similarity so that I can identify trade patterns that match known laundering typologies — over/under-invoicing, phantom shipments, rapid origin-switching.\n\n**US4.2** As a **transshipment detection analyst**, I want to compare a .stela file's routing data against UN Comtrade bilateral trade statistics so that I can flag shipments where the declared origin country doesn't produce the commodity in the declared volume — a strong transshipment indicator.\n\n**US4.3** As a **sanctions evasion investigator**, I want to query the Intelligence Layer's vendor network graph across multiple .stela files so that I can discover hidden beneficial ownership — where the same ultimateconsignee appears across seemingly unrelated shipments from different vendors.\n\n**US4.4** As a **Europol trade crimes unit officer**, I want to perform selective disclosure verification on a .stela file so that I can prove to a court that the intelligence was derived from legitimately obtained data (the BBS+ proof chain) without revealing the full intelligence methodology.\n\n---\n\n### 5. COMPLIANCE USERS\n\n**US5.1** As a **Chief Compliance Officer at a Fortune 500 importer**, I want a dashboard that automatically validates all incoming .stela files against our denied-party screening, forced labor due diligence (UFLPA), and hazmat regulations so that I receive a daily compliance scorecard with zero manual screening effort.\n\n**US5.2** As a **C-TPAT (Customs-Trade Partnership Against Terrorism) validator**, I want to verify that a supply chain partner's .stela files contain valid security profiles (factory audits, transport security, personnel vetting) so that I can assess their C-TPAT tier without conducting an on-site visit for routine revalidation.\n\n**US5.3** As a **EU Digital Product Passport compliance manager**, I want to generate a DPP-compliant .stela file (using the DPPProfile consumer profile) so that my products meet the upcoming EU Battery Regulation and Ecodesign requirements with a single file format instead of maintaining separate DPP systems.\n\n---\n\n### 6. LOGISTICS USERS\n\n**US6.1** As a **cold chain logistics manager**, I want to embed IoT temperature sensor data into a .stela file's spatial embedding block so that any party downstream can verify the cold chain was maintained — with the data cryptographically timestamped and tamper-evident.\n\n**US6.2** As a **last-mile delivery driver in Mexico City**, I want to scan a package's .stela QR code on my phone so that I can verify the delivery address, customs clearance status, and any special handling instructions — in Spanish, auto-translated from the original language.\n\n**US6.3** As a **3PL warehouse operator**, I want my WMS to read .stela files so that incoming goods are automatically slotted by hazmat class, temperature requirements, and country-of-origin (for duty drawback tracking) — without manual data entry from paper BOLs.\n\n---\n\n### 7. FINANCIAL USERS\n\n**US7.1** As a **trade finance analyst at a bank**, I want to verify a .stela file's document authenticity score and value-weight anomaly flags so that I can assess the risk of a letter of credit application — rejecting applications where the intelligence layer indicates potential fraud indicators.\n\n**US7.2** As a **cargo insurance underwriter**, I want to query a .stela file's complete risk profile (commodity type, routing, vendor history, document authenticity) so that I can price policies more accurately — offering lower premiums for shipments with high-confidence Stela data and penalizing opaque supply chains.\n\n**US7.3** As a **trade credit insurer (Coface/Euler Hermes)**, I want to aggregate .stela files from a buyer's import history so that I can build a behavioral credit model based on actual trade patterns rather than financial statements alone — including concentration risk (single-source dependency) and compliance track record.\n\n---\n\n### CROSS-CUTTING: Emerging Market & Mobile-First\n\n**US-EM.1** As a **smallholder coffee farmer in Colombia**, I want to create a .stela file from a photo of my harvest and a GPS pin so that international buyers can verify origin, quality grade (via visual embedding), and fair-trade certification — giving me direct access to specialty markets without intermediaries.\n\n**US-EM.2** As a **border agent at the Cotonou port in Benin**, I want to validate .stela files offline on my phone (local ISOBMFF parser + cached credential verification) so that I can process shipments even when internet connectivity is intermittent — with sync happening when connectivity returns.\n\n**US-EM.3** As a **ASEAN customs harmonization officer**, I want to map .stela files' multi-jurisdiction classification data (HS2022 → AHTN → national tariff) so that I can verify consistent classification across the 10 ASEAN member states for goods moving through the ASEAN Single Window."
}