# 颂暖SongWarm

**Repository Path**: dancy-db/song-warm

## Basic Information

- **Project Name**: 颂暖SongWarm
- **Description**: 基于区块链的慈善捐款系统
- **Primary Language**: NodeJS
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2024-06-21
- **Last Updated**: 2025-05-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

######颂暖

#### 介绍
本项目是基于区块链的慈善基金会

#### 安装教程

项目部署已经部署在服务器，可以直接访问：http://47.120.14.16/。 或在该gitee网页上下载项目的源代码，请在下载之后检查所需的依赖关系是否已经正确安装。

 一、准备环境： 

1.Node.js，可以从 Node.js 的官方网站 https://nodejs.org/ 下载并安装适用于你操作系统的版本。 

2.Meta Mask,可以从官方网站https://metamask.io/下载并安装。 

二、运行项目：

将项目源代码下载到本地之后，在vscode或其他编译软件上打开。

1.通过在项目路径对应的命令行中输入命令npm i以下载项目相关依赖。
 
2.相关依赖下载完成之后，输入命令npm start 运行启动项目。

3.运行成功之后在浏览器输入 127.0.0.1:3000 访问项目服务。

#### 使用说明

欢迎来到 SongWarm 颂暖平台
SongWarm 颂暖是一个基于区块链技术的慈善捐款平台，旨在为需要帮助的人提供资金支持。以下是您在开始使用我们的平台之前需要了解的一些基本信息和操作步骤：

1. 安装 MetaMask
在开始项目之前，请确保您已经安装了MetaMask扩展。MetaMask 是一个浏览器扩展，允许您与以太坊区块链进行交互。如果您还没有安装，请访问 Chrome、Edge或者在运行成功项目之后进入网址，直接点击页面上的链接进行安装。
![输入图片说明](SongWarm/public/images/%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202024-06-21%20180039.png)
2. 连接 MetaMask
安装完成后，请连接您的MetaMask 钱包。在我们的平台上点击“连接MetaMask" 按钮，按照提示操作先勾选要连接的账户，随即点击“下一步”按钮，再点击“连接”按钮，确保您的钱包已成功连接。
![输入图片说明](SongWarm/public/images/%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202024-06-21%20180132.png)
3. 选择慈善类别
进入平台之后，您可以选择不同的慈善类别进行投票（必须先进行捐款），包括教育资助、慈善救助、环境保护、社会福利和文化艺术等，也可直接在首页面进行捐款。
4. 捐款流程
选择您想要支持的筹款项目后，您可以通过输入捐款金额（以WEI 为单位，捐款金额不得小于100wei）来进行捐款。捐款成功后，您将获得投票权，可以对需要帮助的人进行投票。
5. 投票机制
投票是平台的核心功能之一。当投票人数超过总捐款人数的一半时，平台将会给需要帮助的人发放资金。
6. 创建筹款项目
管理员和用户都可以创建筹款项目。用户创建的筹款项目收款方是我们基金会， 这些资金将用于捐助有需要的人。创建项目时，请详细填写项目信息，包括项目描述、目标金额和筹款图片等。
7. 查看合约余额
我们的合约余额都是公开透明的，您可以在平台上实时查看。
8. 投票捐款详情记录
所有筹款项目的相关记录都是公开透明的。管理员创建的每个项目都有记录投票者；用户创建的每个项目也都有记录谁捐款者以及捐款总金额。
9. 查看个人信息
登录成功的用户可以查看和管理自己的个人相关信息，包括个人信息、投票记录、捐款记录、hash交易记录和个人筹款记录等。也可在投票记录里面点击项目查看项目详情，在hash记录页面点击hash交易查看对应的hash详情。