struct Candidate {
    uint id;
    string name;
    uint voteCount;
}

import "@openzeppelin/contracts/access/Ownable.sol";
contract Vote is Ownable {
    // 自动生成 owner 与 onlyOwner 修饰符
}

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.19;

import "@openzeppelin/contracts/access/Ownable.sol";

/// @title 去中心化投票合约
/// @author 教程作者
/// @notice 支持管理员注册候选人、授权选民，并确保每人只能投一票
/// @dev 基于 OpenZeppelin Ownable 做访问控制
contract Vote is Ownable {

    /// @notice 候选人数据结构
    struct Candidate {
        uint id;
        string name;
        uint voteCount;
    }

    /// @notice 选举名称
    string public electionName;

    /// @notice 候选人总数，自动递增作为 ID 分配器
    uint public candidatesCount;

    /// @notice 候选人索引映射，id => Candidate
    mapping(uint => Candidate) public candidates;

    /// @notice 记录某地址是否已投票
    mapping(address => bool) public voted;

    /// @notice 授权选民白名单
    mapping(address => bool) public authorizedVoters;

    /// @notice 投票事件，用于前端实时监听
    /// @param voter 投票者地址
    /// @param candidateId 所投候选人 ID
    event Voted(address indexed voter, uint indexed candidateId);

    /// @notice 注册候选人事件
    /// @param candidateId 候选人 ID
    /// @param name 候选人名称
    event CandidateAdded(uint indexed candidateId, string name);

    /// @notice 选民授权事件
    /// @param voter 被授权地址
    event VoterAuthorized(address indexed voter);

    /// @param _electionName 选举主题名称
    constructor(string memory _electionName) Ownable(msg.sender) {
        electionName = _electionName;
    }

    /// @notice 管理员注册新候选人
    /// @param _name 候选人名称
    function addCandidate(string memory _name) public onlyOwner {
        candidatesCount++;
        candidates[candidatesCount] = Candidate(candidatesCount, _name, 0);
        emit CandidateAdded(candidatesCount, _name);
    }

    /// @notice 管理员将地址加入授权选民白名单
    /// @param _voter 待授权的以太坊地址
    function authorizeVoter(address _voter) public onlyOwner {
        authorizedVoters[_voter] = true;
        emit VoterAuthorized(_voter);
    }

    /// @notice 授权选民为指定候选人投票，每人只能投一次
    /// @param _candidateId 候选人 ID（1-based）
    function vote(uint _candidateId) public {
        // Step 1: 身份校验
        require(authorizedVoters[msg.sender], "Vote: caller is not an authorized voter");

        // Step 2: 防重复投票
        require(!voted[msg.sender], "Vote: already voted");

        // Step 3: 候选人存在性校验
        require(_candidateId > 0 && _candidateId <= candidatesCount, "Vote: invalid candidate ID");

        // Step 4: 先更新状态（Checks-Effects）
        voted[msg.sender] = true;

        // Step 5: 计票增加
        candidates[_candidateId].voteCount++;

        // Step 6: 触发事件（Interactions 的最后一步）
        emit Voted(msg.sender, _candidateId);
    }

    /// @notice 按 ID 查询候选人信息
    /// @param _id 候选人 ID
    /// @return 候选人结构体
    function getCandidate(uint _id) public view returns (Candidate memory) {
        require(_id > 0 && _id <= candidatesCount, "Vote: invalid candidate ID");
        return candidates[_id];
    }
}

mkdir voting-dapp && cd voting-dapp
npm init -y
npm install --save-dev hardhat @nomicfoundation/hardhat-toolbox
npx hardhat init   # 选择「Create a TypeScript project」或 JavaScript 项目
npm install @openzeppelin/contracts

voting-dapp/
├── contracts/
│   └── Vote.sol          # 将 17.2.5 的合约代码放入此处
├── scripts/
│   └── deploy.js         # 部署脚本
├── test/
│   └── Vote.test.js      # 单元测试（后续章节展开）
├── hardhat.config.js     # 编译器与网络配置
├── package.json
└── node_modules/

// hardhat.config.js
require("@nomicfoundation/hardhat-toolbox");

/** @type import('hardhat/config').HardhatUserConfig */
module.exports = {
  solidity: {
    version: "0.8.19",
    settings: {
      optimizer: {
        enabled: true,
        runs: 200,
      },
    },
  },
  // 默认网络为内置的 Hardhat Network，无需额外配置即可测试
  // 后续部署到 Sepolia 等测试网时，可在此添加 network 配置
};

// scripts/deploy.js
const hre = require("hardhat");

async function main() {
  // 获取部署者钱包地址
  const [deployer, voter1, voter2] = await hre.ethers.getSigners();
  console.log("部署者地址:", deployer.address);

  // 1. 编译并获取合约工厂
  const VoteFactory = await hre.ethers.getContractFactory("Vote");

  // 2. 部署合约，传入构造函数参数
  const voteContract = await VoteFactory.deploy("2024 社区治理选举");

  // 3. 等待部署上链
  await voteContract.waitForDeployment();
  console.log("投票合约已部署至:", await voteContract.getAddress());

  // 4. 管理员操作：注册候选人
  await (await voteContract.addCandidate("Alice - 建设更多公共节点")).wait();
  await (await voteContract.addCandidate("Bob - 优化 Gas 费分配")).wait();
  await (await voteContract.addCandidate("Charlie - 引入 DAO 治理")).wait();
  console.log("已注册 3 名候选人");

  // 5. 管理员操作：授权测试选民
  await (await voteContract.authorizeVoter(voter1.address)).wait();
  await (await voteContract.authorizeVoter(voter2.address)).wait();
  console.log("已授权测试选民:", voter1.address, voter2.address);

  // 6. 初始状态查询
  const c1 = await voteContract.getCandidate(1);
  console.log(`候选人 #1: ${c1.name}, 当前票数:${c1.voteCount}`);
}

// 优雅处理异步异常
main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

npx hardhat run scripts/deploy.js --network hardhat

npx hardhat node

npx hardhat console --network localhost

// 加载已部署的合约（替换为 deploy.js 输出的实际地址）
const Vote = await ethers.getContractFactory("Vote");
const vote = await Vote.attach("0x5FbDB2315678afecb367f032d93F642f64180aa3");

// 获取可用签名者
const [owner, voter1, voter2, stranger] = await ethers.getSigners();

// 查询候选人信息
await vote.getCandidate(1);
// 返回: [ 1n, 'Alice - 建设更多公共节点', 0n ]

// 以 voter1 身份投票
await vote.connect(voter1).vote(1);
// 交易确认后，voter1 成功投票给候选人 1

// 再次查询票数
await vote.getCandidate(1);
// 返回: [ 1n, 'Alice - 建设更多公共节点', 1n ]

// 尝试重复投票（应被回滚）
await vote.connect(voter1).vote(2);
// 抛出: Error: VM Exception while processing transaction: reverted with reason string 'Vote: already voted'

// 以未授权地址投票（应被回滚）
await vote.connect(stranger).vote(1);
// 抛出: Error: VM Exception while processing transaction: reverted with reason string 'Vote: caller is not an authorized voter'

// 以 voter2 投票给不同候选人
await vote.connect(voter2).vote(3);
await vote.getCandidate(3);
// 返回: [ 3n, 'Charlie - 引入 DAO 治理', 1n ]

voting-dapp/
├── contracts/
│   └── Vote.sol              # 投票主合约（Solidity 0.8.19）
├── scripts/
│   └── deploy.js             # 部署与初始化脚本
├── test/
│   └── Vote.test.js          # 单元测试（将在后续章节展开）
├── node_modules/             # 依赖包（Hardhat、OpenZeppelin 等）
├── hardhat.config.js         # 编译器与网络配置
├── package.json
└── package-lock.json