Resumen del Proyecto }+ primer esbozo +

 # 🪙 Proyecto WKR-DAPP – Resumen Maestro

## 1️⃣ Objetivo General

Crear una **dApp integral** que conecte la economía real con blockchain.  

El usuario podrá comprar tokens **WKR** (trigo orgánico) y **DEJAVU** (yerba orgánica) con moneda local (pesos argentinos), holdearlos en una **wallet interna o MetaMask**, y opcionalmente realizar **swap, staking y aportar liquidez** desde una sola pantalla.

---

## 2️⃣ Tokens Base

| Token   | Representa                 | Valor Base (USD) | Fuente |

|----------|-----------------------------|------------------|--------|

| **WKR** | 1 kg de trigo orgánico      | 3 USDC/kg        | Precio manual |

| **DEJAVU** | 1 kg de yerba orgánica  | 6 USDC/kg        | Precio manual |

> Los precios se fijan manualmente a través de un **PriceOracle** administrado por Mariel.

---

## 3️⃣ Módulos Principales

1. **PriceOracle:** almacena precios manuales (USD por token).  

2. **PrimarySale:** permite comprar WKR/DEJAVU a su precio oficial (en USDC o fiat).  

3. **Swap:** AMM funcional para intercambiar tokens entre pares.  

4. **StakingPool:** permite hacer staking y recibir recompensas.  

5. **LiquidityPool:** permite aportar liquidez (link directo o integración Uniswap).  

6. **UserWallet:** sistema de wallet interna (email/passkey) o MetaMask.

---

## 4️⃣ Flujo del Usuario

1. Ingreso al portal.  

2. Creación o conexión de wallet.  

3. Compra de tokens con **ARS → USDC → tokens** (vía checkout o agregador).  

4. Visualización de **balances**.  

5. Posibilidad de **swappear**, **stakear** o **aportar liquidez**.  

6. Opción de **mantener tokens** en la app o **exportar** a MetaMask.

---

## 5️⃣ Diseño UX/UI

- **Pantalla única y modular**:

  - Balance general.

  - Compra de tokens.

  - Swap.

  - Staking.

  - Liquidez.

- Estilo visual: limpio, cálido y profesional (Tailwind + shadcn/ui).

- Datos en columnas, números tabulares y espaciado aireado.

---

## 6️⃣ Redes y Pruebas

- **Dev:** localhost (Hardhat/Anvil) con ETH de prueba.  

- **Testnet:** Sepolia (ETH + USDC de faucet).  

- **Mainnet:** despliegue final con contratos reales.  

- No se requiere ETH real durante desarrollo.

---

## 7️⃣ Infraestructura

| Componente | Herramienta / Servicio |

|-------------|------------------------|

| **Frontend** | Next.js + Tailwind + shadcn/ui |

| **Backend** | Opcional (relayer, registro, notificaciones) |

| **RPC** | Alchemy / Infura / Thirdweb |

| **Hosting** | Vercel (plan gratuito) |

| **Wallet / Pagos** | Thirdweb Embedded Wallet + Checkout / Onramper |

---

## 8️⃣ Fases del Proyecto

1. **Fase 0:** Limpieza visual y UI unificada.  

2. **Fase 1:** PriceOracle + PrimarySale (precios manuales).  

3. **Fase 2:** Integración de pagos (checkout fiat → USDC).  

4. **Fase 3:** Wallet interna con exportación.  

5. **Fase 4:** Swap/AMM refinado + precios de mercado.  

6. **Fase 5:** Staking operativo.  

7. **Fase 6:** Liquidez Uniswap + link directo.  

8. **Fase 7:** Deploy Sepolia → Mainnet.  

9. **Fase 8:** Interfaz pública (portal WKR).  

10. **Fase 9:** Comunicación y documentación final.

---

## 9️⃣ Prioridades Técnicas Actuales

- Unificar balance + swap + staking en una sola pantalla.  

- Crear `.env` con direcciones de contratos y RPC.  

- Mantener persistencia de wallet (evitar “missing recovery share”).  

- Corregir importaciones de `ethers v6` (`parseUnits`, `formatUnits`).  

- Implementar **PriceOracle** para precios manuales.

---

## 🔟 Meta Final

Un portal público y confiable donde:  

🌾 los productores validan precios reales,  

💳 los usuarios compran con pesos,  

🪙 los tokens representan bienes orgánicos,  

🌐 y toda la experiencia sucede dentro de una dApp moderna, clara y estable.

---

**Autor:** Mariel Castello  

**Proyecto:** WKR-DAPP  

**Versión:** 1.0  

**Fecha:** _(actualizar al último cambio)_