P03 E-Commerce Blockchain (EuroToken + Stripe + 4 apps)

.gitattributes

@@ -0,0 +1,26 @@
+# Forzar LF en todos los archivos de texto para compatibilidad WSL/Linux
+* text=auto eol=lf
+
+# Scripts de shell: siempre LF
+*.sh text eol=lf
+
+# Contratos Solidity: LF
+*.sol text eol=lf
+
+# Archivos de texto estándar: LF
+*.ts text eol=lf
+*.tsx text eol=lf
+*.js text eol=lf
+*.json text eol=lf
+*.md text eol=lf
+*.toml text eol=lf
+*.css text eol=lf
+*.env* text eol=lf
+
+# Binarios: sin conversión
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.ico binary
+*.woff binary
+*.woff2 binary

.gitignore

@@ -0,0 +1,22 @@
+# ── Claude Code (memoria local de la sesión) ────────────────────────────────
+.claude/
+
+# ── Foundry — artefactos de compilación ─────────────────────────────────────
+**/cache/
+**/out/
+
+# ── Foundry — broadcasts de red local (Anvil, chainId 31337) ─────────────────
+**/broadcast/*/31337/
+**/broadcast/**/dry-run/
+
+# ── Node.js / Next.js ────────────────────────────────────────────────────────
+**/node_modules/
+**/.next/
+**/*.tsbuildinfo
+
+# ── Logs ─────────────────────────────────────────────────────────────────────
+*.log
+
+# ── OS ───────────────────────────────────────────────────────────────────────
+.DS_Store
+Thumbs.db

.gitmodules

@@ -0,0 +1,6 @@
+[submodule "P01-eth-document-registry/contracts/lib/openzeppelin-contracts"]
+	path = P01-eth-document-registry/contracts/lib/openzeppelin-contracts
+	url = https://github.com/OpenZeppelin/openzeppelin-contracts
+[submodule "P01-eth-document-registry/contracts/lib/forge-std"]
+	path = P01-eth-document-registry/contracts/lib/forge-std
+	url = https://github.com/foundry-rs/forge-std

CLAUDE.md

@@ -0,0 +1,118 @@
+# CLAUDE.md — Contexto del Proyecto
+
+Este archivo es leído automáticamente por Claude Code al inicio de cada sesión.
+
+---
+
+## Quién eres
+
+Estás asistiendo a **MarkFrFn** con sus prácticas del curso **"Desarrollo de dApps con Ethereum"** de CODECRYPTO Academy.
+
+---
+
+## Estructura del repositorio
+
+Monorepo en `d:/MAFL_Bibliotecas/Documentos/Proyectos/CodeCrypto-MarkFrFn/`
+
+```
+CodeCrypto-MarkFrFn/          ← raíz del monorepo (único .git aquí)
+├── CLAUDE.md                 ← este archivo
+├── README.md
+├── docs/
+│   └── LECCIONES_APRENDIDAS.md
+├── P01-eth-document-registry/
+│   ├── contracts/            ← Solidity + Foundry
+│   ├── dapp/                 ← Next.js 14 + TypeScript + ethers.js v6
+│   ├── foundry.toml
+│   └── start.sh
+└── P02-dao/
+    ├── sc/                   ← Solidity + Foundry (MinimalForwarder + DAOVoting)
+    ├── web/                  ← Next.js 15 + TypeScript + ethers.js v6
+    ├── foundry.toml
+    └── start.sh
+```
+
+**Convención de nombres:** `P##-descripcion-del-proyecto` (ej: `P01-eth-document-registry`)
+
+---
+
+## Decisiones técnicas tomadas
+
+### Git / Monorepo
+- Un único `.git` en la raíz — cada práctica es una carpeta, no un subrepositorio.
+- Los proyectos se ejecutan de forma independiente desde su propia carpeta.
+- Git se gestiona siempre desde la raíz del monorepo.
+
+### Foundry (P01)
+- El `foundry.toml` **raíz de P01** apunta rutas relativas a la carpeta `contracts/`:
+  ```toml
+  src = "contracts/src"
+  out = "out"
+  libs = ["contracts/lib"]
+  test = "contracts/test"
+  script = "contracts/script"
+  remappings = ["openzeppelin-contracts/=contracts/lib/openzeppelin-contracts/"]
+  ```
+- OpenZeppelin instalado como submódulo en `contracts/lib/openzeppelin-contracts/`.
+- El `remappings` fue ajustado al migrar al monorepo para que Foundry resuelva correctamente los imports desde la raíz de P01.
+
+---
+
+## P01 — ETH Document Registry
+
+| Aspecto | Detalle |
+|---------|---------|
+| Objetivo | dApp para almacenar y verificar autenticidad de documentos en Ethereum mediante firmas ECDSA |
+| Smart Contract | `DocumentRegistry.sol` — Solidity 0.8.20, OpenZeppelin ECDSA |
+| Frontend | Next.js 14, TypeScript, ethers.js v6, Tailwind CSS |
+| Red local | Anvil (Foundry) en `http://localhost:8545`, chain ID 31337 |
+| Tests | 11/11 pasando — suite completa en `contracts/test/DocumentRegistry.t.sol` |
+
+### Optimizaciones del contrato
+- Existencia verificada via `signer != address(0)` — sin `bool exists` redundante.
+- Modifiers `documentNotExists` / `documentExists` para guards reutilizables.
+- Optimizer habilitado (`optimizer_runs = 200`). Ahorro estimado ~39% en gas.
+
+### Arrancar P01
+```bash
+cd P01-eth-document-registry
+bash start.sh   # Anvil + deploy + Next.js en un solo comando
+```
+
+---
+
+## Stack común del curso
+
+- **Solidity** + **Foundry** (forge, anvil) para contratos
+- **Next.js 14** + **TypeScript** + **ethers.js v6** para frontends
+- **Tailwind CSS** para estilos
+- **Node.js v18+** requerido
+
+---
+
+## Preferencias de trabajo
+
+- Nombres de carpetas cortos: `P##-descripcion` en lugar de `practica-##-descripcion`.
+- Cada práctica tiene su propio `README.md` y `start.sh`.
+- Documentación adicional en subcarpeta `docs/` dentro de cada práctica.
+
+---
+
+## Documentación transversal
+
+- [docs/LECCIONES_APRENDIDAS.md](./docs/LECCIONES_APRENDIDAS.md) — patrones y antipatrones acumulados de todos los proyectos. **Leer antes de iniciar un nuevo proyecto.**
+
+---
+
+## Progreso del curso
+
+| # | Carpeta | Estado |
+|---|---------|--------|
+| P01 | `P01-eth-document-registry` | Completado |
+| P02 | `P02-dao` | Completado |
+| P03 | — | Pendiente |
+
+**Al iniciar o completar cada práctica, actualizar:**
+1. La tabla de progreso de este archivo (`CLAUDE.md`)
+2. El `README.md` raíz — agregar fila en la tabla de prácticas
+3. `docs/LECCIONES_APRENDIDAS.md` — añadir nuevos patrones aprendidos

P01-eth-document-registry/.gitignore

@@ -0,0 +1,43 @@
+# ─── Foundry (raiz) ───────────────────────────────────────
+cache/
+out/
+
+# Broadcasts de red local (31337 = Anvil); conservar testnet/mainnet
+broadcast/*/31337/
+broadcast/**/dry-run/
+
+# ─── Contratos ────────────────────────────────────────────
+contracts/cache/
+contracts/out/
+
+# ─── Frontend ─────────────────────────────────────────────
+dapp/node_modules/
+dapp/.next/
+dapp/out/
+dapp/dist/
+dapp/build/
+
+# ─── Logs y temporales ────────────────────────────────────
+*.log
+test_results.log
+
+# ─── Entorno ──────────────────────────────────────────────
+.env
+.env.local.backup
+*.env
+
+# Mantener .env.local del dapp (solo contiene datos publicos de Anvil)
+!dapp/.env.local
+
+# ─── Sistema operativo ────────────────────────────────────
+.DS_Store
+Thumbs.db
+
+# ─── Editor ───────────────────────────────────────────────
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# ─── Claude Code ──────────────────────────────────────────
+.claude/

P01-eth-document-registry/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "contracts/lib/openzeppelin-contracts"]
+	path = contracts/lib/openzeppelin-contracts
+	url = https://github.com/OpenZeppelin/openzeppelin-contracts