SYSTEM_ARCHITECTURE

Category: 06. Web3 / Blockchain
Section: Phase 2: Technical Blueprint

4. SYSTEM_ARCHITECTURE.md

Purpose: To design a realistic dApp architecture with clear data flow from frontend to blockchain.

Act as a senior blockchain architect.
Using the following PRD and TRD, design a realistic hackathon dApp architecture.

PRD: [PASTE PRD]
TRD: [PASTE TRD]

Provide:
1. Recommended blockchain stack (Chain, Language, Framework)
2. Complete dApp architecture diagram (Text-based, showing User → Wallet → Frontend → Smart Contract → Blockchain)
3. Frontend architecture (React, Next.js, Wallet connect)
4. Smart contract architecture (Contracts, Functions, Events)
5. Wallet integration architecture (Connection, Network switch, Signing)
6. Storage architecture (On-chain, IPFS, The Graph)
7. Token architecture (If applicable)
8. Data flow (How a user action becomes a transaction)
9. Security considerations (Reentrancy, Access control)
10. Folder structure
11. Major components
12. Simplifications that can be made for a hackathon

Explain every technical decision in beginner-friendly language.
Do not introduce unnecessary tools. Prefer a simple architecture that can be explained easily to judges.