hoh-zone · DudeGuuud · Apr 27, 2025 · May 4, 2025 · May 4, 2025
diff --git a/move202503/DudeGuuud/README.md b/move202503/DudeGuuud/README.md
@@ -0,0 +1,9 @@
+## project
+- 项目名称: NarrFlow
+> 描述: NarrFlow 是一个基于区块链技术的去中心化协作小说创作平台，允许用户共同创作故事并获得代币奖励。平台支持故事创建、段落添加、投票决策，结合了创作自由与社区共识机制。
+
+## Member
+
+- DudeGuuud  github: https://github.com/DudeGuuud
+> 自我介绍&技术栈:  本科在读希望学习区块链 Rust Python React
+
diff --git a/move202503/DudeGuuud/code/.eslintrc.json b/move202503/DudeGuuud/code/.eslintrc.json
@@ -0,0 +1,35 @@
+{
+  "env": {
+    "browser": true,
+    "es2021": true
+  },
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "plugin:react/recommended",
+    "plugin:react-hooks/recommended",
+    "plugin:prettier/recommended"
+  ],
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaFeatures": {
+      "jsx": true
+    },
+    "ecmaVersion": "latest",
+    "sourceType": "module"
+  },
+  "plugins": [
+    "react",
+    "@typescript-eslint",
+    "prettier"
+  ],
+  "rules": {
+    "react/react-in-jsx-scope": "off",
+    "prettier/prettier": "error"
+  },
+  "settings": {
+    "react": {
+      "version": "detect"
+    }
+  }
+}
diff --git a/move202503/DudeGuuud/code/.gitignore b/move202503/DudeGuuud/code/.gitignore
@@ -0,0 +1,30 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+# Envs
+.env
+.env.local
+.env.development
+.env.test
+.env.production
diff --git a/move202503/DudeGuuud/code/.prettierrc b/move202503/DudeGuuud/code/.prettierrc
@@ -0,0 +1,8 @@
+{
+  "semi": true,
+  "tabWidth": 2,
+  "printWidth": 100,
+  "singleQuote": true,
+  "trailingComma": "es5",
+  "jsxBracketSameLine": false
+}
diff --git a/move202503/DudeGuuud/code/README.md b/move202503/DudeGuuud/code/README.md
@@ -0,0 +1,122 @@
+# NarrFlow - 协作叙事平台
+
+NarrFlow 是一个基于区块链技术的去中心化协作小说创作平台，允许用户共同创作故事并获得代币奖励。平台支持故事创建、段落添加、投票决策，结合了创作自由与社区共识机制。
+
+## 现行方案说明
+- 所有投票行为和票数统计均在前端通过数据库（Supabase）进行。
+- 前端定时统计票数，一旦某个提案票数达到阈值，自动将该内容通过合约写入链上。
+- 链上只存储最终胜出的内容元数据（如内容哈希、作者等），不再存储所有投票细节。
+- 正文内容链下存储，链上仅存元数据。
+
+## 功能特性
+- **协作创作**：多人参与故事创作，共同决定情节发展
+- **投票机制**：社区投票选出最佳段落提案，确保高质量内容
+- **代币奖励**：创作者和参与者可获得NARR代币奖励
+- **链上治理**：投票和决策透明，永久记录在区块链上
+- **移动友好**：响应式设计，支持多端访问
+- **多语言支持**：内置中英文界面切换
+
+## 技术栈
+### 前端技术
+- React 18 + TypeScript
+- TailwindCSS + CSS Modules
+- Framer Motion、GSAP、React Spring
+- Redux Toolkit
+- Vite
+- Supabase（数据库）
+
+### 区块链技术
+- 智能合约：Move on Sui
+- Web3交互：@suiet/wallet-kit
+- 钱包连接：Sui Wallet
+
+## 智能合约模块
+- **story.move** - 故事与段落管理（只存元数据和投票结果）
+- **token.move** - 代币和奖励系统
+- **narr_flow.move** - 核心业务逻辑模块
+
+## 存储策略
+- 链上存储：故事元数据、投票结果、用户奖励
+- 数据库存储：所有提案、投票、票数统计
+- 正文内容链下存储（如对象存储、数据库等）
+
+## 项目逻辑流程图
+```mermaid
+flowchart TD
+    A[用户提交提案/投票] --> B[前端写入Supabase数据库]
+    B --> C[前端定时统计票数]
+    C -->|票数达标| D[调用合约上链胜出内容]
+    D --> E[链上存储元数据]
+    E --> F[主页/故事展示]
+```
+
+## 安装与使用
+
+### 前端
+```bash
+# 克隆仓库
+git clone https://github.com/DudeGuuud/NarrFlow-Web3.git
+cd NarrFlow-Web3
+
+# 安装依赖
+pnpm install
+
+# 启动开发服务器
+pnpm run dev
+
+# 构建生产版本
+pnpm run build
+```
+
+根目录添加.env并填写
+```bash
+VITE_PACKAGE_ID=
+VITE_STORYBOOK_ID=
+VITE_TREASURY_ID=
+VITE_SUI_NETWORK=testnet
+
+数据库
+
+VITE_SUPABASE_URL=
+VITE_SUPABASE_KEY=
+
+执行sql语句
+create table if not exists proposals (
+  id bigserial primary key,
+  content text not null,
+  author text not null,
+  votes integer not null default 0,
+  type text not null,
+  created_at timestamptz not null default now()
+);
+
+create table if not exists votes (
+  id bigserial primary key,
+  proposal_id bigint not null references proposals(id) on delete cascade,
+  voter text not null,
+  created_at timestamptz not null default now()
+);
+
+
+# 后续添加 Walrus 相关 endpoint
+# VITE_WALRUS_PUBLISHER=
+# VITE_WALRUS_AGGREGATOR=
+```
+
+### 智能合约
+```bash
+# 切换到合约目录
+cd move
+
+# 编译合约
+sui move build
+
+# 部署合约
+sui client publish
+```
+
+## 贡献
+欢迎贡献代码、报告问题或提出改进建议。请先fork本仓库，创建功能分支，然后提交PR。
+
+## 许可证
+本项目采用 [MIT 许可证](LICENSE)。 
diff --git a/move202503/DudeGuuud/code/eslint.config.js b/move202503/DudeGuuud/code/eslint.config.js
@@ -0,0 +1,28 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import tseslint from 'typescript-eslint'
+
+export default tseslint.config(
+  { ignores: ['dist'] },
+  {
+    extends: [js.configs.recommended, ...tseslint.configs.recommended],
+    files: ['**/*.{ts,tsx}'],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+    },
+    plugins: {
+      'react-hooks': reactHooks,
+      'react-refresh': reactRefresh,
+    },
+    rules: {
+      ...reactHooks.configs.recommended.rules,
+      'react-refresh/only-export-components': [
+        'warn',
+        { allowConstantExport: true },
+      ],
+    },
+  },
+)
diff --git a/move202503/DudeGuuud/code/index.html b/move202503/DudeGuuud/code/index.html
@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/png" href="/logo_white.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>NarrFlow</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
diff --git a/move202503/DudeGuuud/code/linux.md b/move202503/DudeGuuud/code/linux.md
diff --git a/move202503/DudeGuuud/code/move/Move.lock b/move202503/DudeGuuud/code/move/Move.lock
@@ -0,0 +1,40 @@
+# @generated by Move, please check-in and do not edit manually.
+
+[move]
+version = 3
+manifest_digest = "12E9AEFAA7AD0A8420478128B3067979F0A926E7A7A8D656144AA0E0A7190E67"
+deps_digest = "F8BBB0CCB2491CA29A3DF03D6F92277A4F3574266507ACD77214D37ECA3F3082"
+dependencies = [
+  { id = "Sui", name = "Sui" },
+]
+
+[[move.package]]
+id = "MoveStdlib"
+source = { git = "https://github.com/MystenLabs/sui.git", rev = "framework/testnet", subdir = "crates/sui-framework/packages/move-stdlib" }
+
+[[move.package]]
+id = "Sui"
+source = { git = "https://github.com/MystenLabs/sui.git", rev = "framework/testnet", subdir = "crates/sui-framework/packages/sui-framework" }
+
+dependencies = [
+  { id = "MoveStdlib", name = "MoveStdlib" },
+]
+
+[move.toolchain-version]
+compiler-version = "1.47.0"
+edition = "2024"
+flavor = "sui"
+
+[env]
+
+[env.local]
+chain-id = "1d1c141c"
+original-published-id = "0xb046d8a64737b0f25effe4e0239976c7d00414bf868b233de6bcc54f2d470e24"
+latest-published-id = "0xb046d8a64737b0f25effe4e0239976c7d00414bf868b233de6bcc54f2d470e24"
+published-version = "1"
+
+[env.testnet]
+chain-id = "4c78adac"
+original-published-id = "0xa47599a6525da242f712bec2601dceab88f4785c6f549bb412eee30f15ed623d"
+latest-published-id = "0xa47599a6525da242f712bec2601dceab88f4785c6f549bb412eee30f15ed623d"
+published-version = "1"
diff --git a/move202503/DudeGuuud/code/move/Move.toml b/move202503/DudeGuuud/code/move/Move.toml
@@ -0,0 +1,12 @@
+[package]
+name = "narr_flow"
+version = "0.0.1"
+published-at = "0x0"
+edition = "2024" 
+
+[dependencies]
+Sui = { git = "https://github.com/MystenLabs/sui.git", subdir = "crates/sui-framework/packages/sui-framework", rev = "framework/testnet" }
+
+[addresses]
+narr_flow = "0x0"
+sui = "0000000000000000000000000000000000000000000000000000000000000002"