S1_Desarrollo_MVP - SofiAlfonso/croody_web3_project GitHub Wiki
Desarrollo MVP V1 — Sprint 1
Entregable: Un desarrollo funcional mínimo viable (MVP) que contenga las funcionalidades planeadas en el Sprint 1.
Sprint Goal
Implementar las funcionalidades core del frontend del marketplace: conexión de wallet, visualización de NFTs y tokens, con datos mock que serán reemplazados por integración blockchain en sprints siguientes. Estas funcionalidades buscan obtener la configuración principal para los contratos en la blockchain, además de permitir al usuario una visualización inicial de sus activos.
Cumplimiento Funcional
Funcionalidades Implementadas
| HU | Funcionalidad | Estado | Notas |
|---|---|---|---|
| — | Conexión de wallet (MetaMask) | ✅ Implementada | Soporte para MetaMask real + modo demo |
| — | Dashboard con balance de tokens | ✅ Implementada | Muestra balance CRD y lista de NFTs |
| — | Visualización de NFTs propios | ✅ Implementada | Galería de NFTs del usuario |
| — | Detalle de NFT individual | ✅ Implementada | Página /nft/[id] con metadata |
| — | Visualización de tokens CRD | ✅ Implementada | Página /dashboard para ver CRD |
| — | Modo demo sin wallet | ✅ Implementada | Dirección hardcoded 0xDEM0... |
Nota: Todas las funcionalidades usan datos mock actualmente. La integración con blockchain (Wagmi, Viem, RainbowKit) y contratos inteligentes está planificada para sprints posteriores.
Páginas / Rutas del MVP
| Ruta | Componente | Descripción |
|---|---|---|
/ |
HomeClient |
Landing page para conectar con la wallet |
/dashboard |
DashboardClient |
Panel principal del usuario: balance, NFTs, acciones |
/nft/[id] |
NFTDetailClient |
Detalle de un NFT específico |
/nfts |
readOwnedNftsFromChain |
Galeria de NFT's propios listados |
Gestión Técnica del Desarrollo
Repositorio
- URL: https://github.com/SofiAlfonso/croody_web3_project
- Ramas activas:
main,develop,feature/* - Estrategia: GitHub Flow con rama
developcomo integración
Estructura del Código
src/
├── app/ # Rutas (Next.js App Router)
│ ├── page.tsx # Home
│ ├── dashboard/page.tsx
│ ├── nft/[id]/page.tsx
│ ├── auction/[id]/page.tsx
│ └── send/page.tsx
├── components/ # Componentes organizados por feature
│ ├── home/
│ ├── dashboard/
│ ├── auction/
│ ├── nft/
│ ├── send/
│ └── shared/ # Componentes reutilizables
├── hooks/ # Custom hooks (mock data)
├── context/ # WalletContext (estado global)
├── lib/ # Datos mock
├── styles/ # Tema y tokens de diseño
└── types/ # Declaraciones de tipos
Herramientas de Desarrollo
| Herramienta | Propósito |
|---|---|
| Git + GitHub | Control de versiones y colaboración |
| ESLint v9 | Análisis estático de código |
| TypeScript strict | Verificación de tipos |
| Next.js 16 | Framework de desarrollo |
| Tailwind CSS 4 | Estilos y diseño |
| Vercel | Despliegue (planeado) |