术语定义
金豆游戏中主要的货币单位
银豆游戏中的货币单位
FPA游戏中的货币单位，可按比例兑换成金豆，后台配置兑换比例。在金币市场兑换。
FLA游戏中的货币单位，可由银豆兑换，后台配置兑换比例
联盟用户分区域的依据。
金土地小财主及以上级别专有土地，只能种植南瓜。
黑土地用于种植作物的载体，以块为单位，能种任何蔬菜作物
灰土地用于种植作物的载体，以块为单位，只能种植盲盒开出的各类果树
冻土地土地到期后的一种状态，此时作物停止生长，土地续期后恢复生长，灰色土地没有冰冻期。
虚拟土地用户抽盲盒赠送一定数量的虚拟土地，用于级别累计，虚拟土地默认有效期一个月。
播种在当前土地上播种作物种子
铲除种植作物之前将上次枯萎的作物铲除
种子用来播种的作物的种子
果实农作物或者果树产出的，卖出获得银豆。
绑定果实所有在农贸市场购买的果实都是绑定果实，绑定的果实卖出只能获得金豆。
盲盒商店售卖的一种产品，打开主要能获得各类果树种子，和各类道具。购买盲盒需要银豆。
种子兑换券在兑换种子时，能代替金豆作为手续费的等值券，兑换券不产生级别奖励，设置有效期。
租地抵扣券可用于续租土地抵扣金豆，抵扣券不产生级别奖励，设置有效期。
激活会员抵扣券可用于激活会员抵扣金豆，抵扣券不产生级别奖励，设置有效期。
除虫给有病虫害的作物除虫
除草浇水施肥偷菜进入玩家农场相互摘取果实。
能量罩用户可以在商店购买的一种道具，可以作用于土地上面，防止被偷菜改名卡能够修改用户昵称，设置有效期。
收割把成熟的作物果实收到仓库中
商店购买种子，道具等，购买物品放入个人仓库
仓库用于存储玩家种子，果实，道具等
兑换中心能兑换果实种子、道具等
农贸市场玩家自由交易的平台
农贸VIP非VIP交易手续费和VIP交易手续费不一样
农贸VIPVIP无手续费。
NFT合成石用于合成所需的消耗品
红宝石系统配发的消耗品
绑定的红宝石交易系统购买获得的红宝石
任务目标
本项目目标是开发一个农场小游戏APP，包含网页版和安卓版，游戏具有租地，翻地，播种，收获，偷菜，交易等一系列农场的功能。
功能需求
用户注册登录
用户注册实现玩家的账号建立，字段有：用户名，昵称，登录密码，支付密码，推荐码（根据推荐人自动生成，且不能修改），图片验证码。用户名校验性，登录密码不能和支付密码相同，设置密码需要大小写字母加数字缺一不可。
昵称可自己编写，增加随机选项。
每个账户有ID号，ID号从999开始往后递增，999为公司顶点账户。注册分不同联盟，当注册时推荐人ID是999时，该会员注册时可以自由选择所属联盟。当推荐人不是999时，所属联盟由上级推荐码决定。注册时的用户名有固定前缀，由不同的联盟决定，不能更改，后台可配置联盟前缀，比如：联盟A，同一个联盟可配置多个前缀，前缀有A01，A02，A03等，管理员可管理所有联盟数据。各联盟设置分后台，可单独管理。
用户登录
用户名字段提供下拉历史记录，记住账号/密码选项。
主界面展示
界面上方展示公告，日志，排行榜，个人中心。
界面下方展示仓库，兑换中心，商店，装扮。界面中心以建筑物方式展示地图，包含人物，市场，农场，果园，酒坊，娱乐中心，留两个预留位置写敬请期待。
公告
有新公告时登录进界面后弹窗显示公告，有未读公告时红色高亮提示信息。
显示包含历史公告在内的所有公告，并显示公告时间，未读公告以红色字体高亮显示。公告内容能根据内容大小上下滚动展示。
日志
下拉滚动方式展示基本操作所有日志，分两部分，奖励部分和基本操作部分分别独立展示。用户日志历史记录保留三个月。
排行榜
分三类，推荐人数量排行榜，种植南瓜数量排行榜，小财主下属续租土地数量排行榜，联盟推荐人新增排行榜。
推荐人数量排行榜：统计所有会员的下级推荐人数量。
种植南瓜数量排行榜：统计所有会员种植南瓜的数量。
续租土地数量排行榜：统计小财主的下级推荐人续租土地的数量。联盟推荐人新增排行榜：统计联盟在一定周期内推荐人数的新增率。
以上排行榜统计周期后台可分别单独自由调节，前端需要显示统计的周期，各排行榜可单独设置黑名单，黑名单用户不参与排行。
个人中心包含以下：
密码修改：昵称修改：需要改名卡，商店或者参加活动获得改名卡。
音效开关：推广：（推荐关系展示用户名，ID和级别）
公会：（1.可以给下级激活会员，扣除金豆；2.金豆转账，银豆转账（转账需要一定级别以上才能转，后台可配置），需要输入被转人数量和ID；给自己开通农贸VIP，扣除金豆），开通农贸VIP默认100金豆，开通页面显示开通价格，价格可在后台配置修改。激活会员默认105金豆，后台可配置。
记录：（展示公会的操作记录）
钱包：提供给会员充值和提现功能，打通链上的交易，分两个币种，FPA和FLA，FPA用于充值，FLA用于提现。两个币种都能在游戏钱包和交易所之间相互转移资产。FPA上链分两个阶段，一阶段不显示FPA。
分享APP地址和二维码海报切换登录账号
仓库
物品分类存储，每一类48格物品栏，每一类前10格免费享有，剩余38格需要花费金豆扩容（金豆数量可在后台配置）。每一格物品堆叠有上限，可在后台单独配置各个物品的堆叠上限。分类：果实，种子，果树，道具，活动卡片仓库中所有物品可丢弃，丢弃时需要输入支付密码进行确认。
兑换中心
分类：种子兑换，货币兑换，主界面背景兑换。
种子兑换
兑换种子需要各种果实加手续费，手续费可以是金豆或者种子兑换券。种子兑换券只能由系统赠送，不能购买，不能交易。种子兑换券不产生交易奖励。
所有数据可在后台修改配置，默认参数如下：
需要韭菜需要白菜需要西红柿需要胡萝卜需要金豆
西红柿 50 2 15
胡萝卜 100 3 1.5 30
南瓜 4 2 1.5 50
需要南瓜
需要红宝石
白菜种子*32 0.5 24
货币兑换
提供货币兑换专区，FPA可兑换金豆（有兑换手续费，可配置）。银豆可兑换成FLA，兑换FLA收取兑换手续费。银豆可兑换成金豆，所有兑换比例和兑换手续费可在后台配置，兑换手续费可对单个会员配置或者对单个联盟配置。（FPA与金豆的兑换分成两个阶段，一阶段不上链，不与个人中心的钱包连通，后台手动报单。二阶段与钱包连通。）
FPA兑换金豆的比例设置两个比例，一个默认比例，默认比例可根据FPA市场价格实时调整，适用于所有会员。一个VIP比例，VIP比例是在默认比例的基础上加一定数值，这个数值可在后台调整配置，单个VIP所加的数值可以单独配置，也可以批量设置。享受VIP比例的需要后台设置VIP的名单，VIP用户可享受VIP比例兑换资格。
商店
商品的价格和库存余额可在后台设置。无库存的商品不展示。
商品：韭菜种子，白菜种子，除草剂，除虫剂，盲盒，肥料，酒曲等后续需要可在后台随时添加。各商品的交易单位可单独配置。
盲盒
商店内设置盲盒专区，盲盒分黄金盲盒和白金盲盒，分别开出黄金果树和白金果树。黄金盲盒价格默认100银豆，白金盲盒默认500银豆，可配置，开出各类果树比例默认如下：
樱桃树65%
苹果树28%
蕉树6%
芒果树1%
若玩家开10个及以上盲盒，需保证中奖率。
装扮提供界面背景，个性化装扮，人物时装，宠物时装，房屋农场个性化等的操作。
人物
系统提供免费人物形象和收费人物形象可供选择，个人形象外形元素可在装扮购买或者参加活动获得时装卡。
人物里面显示以下内容：
游戏昵称；用户ID；用户等级；玩家土地数量：土地数量统计本人的和所有下级推荐人的总和，抽盲盒赠送的虚拟土地一并计入土地总和，土地总和只升不降；
FPA数量（jingque到）；
FLA数量（jingque到）；
金豆数量（jingque到）；
银豆数量（jingque到）；
偷菜有效期；
农贸VIP有效期如果是VIP则显示VIP有效期；
能量罩有效期；所属联盟；
金豆当日价格（金豆对应价格可在后台修改）。
市场
市场设置分区，有农贸市场，果园市场，酒坊市场。
农贸市场
所有果实可在农贸市场进行交易，以金豆结算。后台可设置果实的指导价上下限，玩家买卖必须在设置的上下限中间才可进行交易。交易优先级按照价格高低，从低往高排列，按照时间先后顺序交易，价格优先级高于时间优先级。交易收取手续费，系统自动从卖家商品收益扣除卖家金豆，手续费分农贸VIP会员和非会员，费率可在后台配置，默认费率非会员8%，会员4%，会员0%。每天晚上12点卖家挂卖的商品全部退回，没有成功交易的挂卖商品退回以后第二天需要重新挂卖。交易市场有交易时间，交易时间外截止交易，后台可配置交易时间。系统默认果实指导价格表：
产品
韭菜0.1 0.1
白菜种子51 51
白菜71 71
西红柿230 230
胡萝卜835 841
南瓜3180 3193
农贸市场购买的所有果实都是绑定果实，绑定的果实在农贸市场卖出获得金豆。非绑定的果实在农贸市场卖出获得银豆。
果园市场
果园市场以银豆结算。
樱桃1.23
银豆结算
苹果50
银豆结算
蕉66.7
银豆结算
芒果333.4
银豆结算
酒坊市场
提供红宝石和特级酒的交易。卖出红宝石获得银豆，卖出绑定的红宝石获得金豆，会员花费金豆购买的红宝石，所获得的的红宝石变成绑定的红宝石。红宝石交易不收取手续费，特级酒交易每次收取0.5金豆的交易手续费，该交易手续费不参与税收奖励。
特级酒能进行交易，所有特级酒的交易都是以金豆结算。特级酒交易以后获得的酒类型随机获得，获得概率可在后台配置修改，默认参数如下：
特级清香型50%
特级浓香型25%
特级米香型20%
特级酱香型5%
农场
农场功能
农场设置60块黑土地，可种植蔬菜类农作物，需要缴纳租金才能使用，前三块土地捆绑出租，第四块开始每一块土地单独缴纳租金。
1.一块土地每次种植一枚种子，收获一颗果实。首次注册会员需要玩家激活会员，缴纳土地租金，租期默认30天，可后台配置，jingque到秒。过期自动变为冻土地，所有冻土地上面的农作物停止生长，需要续租才能继续生长。
2.单击未开垦的土地进入租地界面
3.单击未种植农作物的土地可播种种子
4.单击未成熟农作物可铲除，铲除未成熟的作物需要输入支付密码二次确认。
5.单击已成熟农作物可收割，收割完以后在土地上显示枯萎的农作物
6.单击枯萎的农作物可铲除
7.在农场土地上长按可实时显示对应土地上种植的作物名称，当前生长周期及剩余时间，当前土地剩余租期，土地干旱，虫害状态等。
8.各农作物默认成长周期如下，可在后台配置：单位/小时
生长期
韭菜8
白菜192
西红柿653
胡萝卜792
南瓜1104
浇水，除虫，除草等功能，前期可隐藏，可在后台配置开关。
偷菜：前三块0，1，2号土地必须是在开通使用的情况下才能允许偷菜，若到期需要续租土地才能偷菜。后台可设置每人每天偷菜次数上限。
增加偷菜按键，点击偷菜，自动跳转到已成熟农场（全系统跳转展示可偷菜列表，实时更新数据）。玩家偷菜农场只能看到菜地信息，其他信息隐藏。每人每天偷菜次数上限（可在后台配置）。一颗果树被一个人只能偷一次，偷取数量颗（可在后台配置）。每颗果实Zui多能被偷的百分比（后台可配置）。后台配置一键偷菜功能，一键偷取系统所有满足被偷条件的果实。偷取的果实进入公司顶点账户。系统偷菜需要满足以下条件：
*1成熟一小时以后的果实。
*2没有被其他会员偷完。
*3一颗果树只偷一次。
防偷菜能量罩：商店增加一个能量罩的产品，用金豆购买，金豆价格后台可调。能量罩还能作为活动赠送，抽盲盒赠送等。在使用了能量罩的所有菜地上面增加一个能量罩，有能量罩保护的果实不能被偷取。每一个能量罩有时间限制，时间到了自动消失，可以叠加使用，每使用一个能量罩时间叠加。能量罩上方显示剩余时间。
所有小财主及以上级别只能种植南瓜，不能种植其他蔬菜。只要达到小财主及以上级别，现有已开通土地直接升级到金土地，继续激活土地也是金土地。
农场活动
在农场种植农作物的时候，可以设置种植活动，设置活动时，需要设置活动的时间周期；参与活动的农作物；活动的奖励卡片类型。奖励以卡片形式发放，卡片分不同形式的卡片，当集齐一套卡片时，可以兑换相应奖励。参与活动的农作物在播种的时候，可以随机获得参与活动的卡片。卡片的类型及奖励方式如下：
类型一：月饼。分类：五仁月饼，莲蓉月饼，蛋黄月饼，叉烧月饼，鲜花月饼，奶黄月饼。各种卡片产出的概率默认如下，后台可配置概率：卡片概率五仁月饼50%莲蓉月饼20%蛋黄月饼15%叉烧月饼10%鲜花月饼4%奶黄月饼1%
类型二：欢庆勋章。分类：同盟十字勋章，战功利剑勋章，黑森英勇勋章，王冠金质勋章，雄鹰十字勋章，lingxiu金质勋章。各种卡片产出的概率默认如下，后台可配置概率：卡片概率同盟银质勋章50%战功利剑勋章20%黑森英勇勋章15%王冠金质勋章10%雄鹰十字勋章4%lingxiu金质勋章1%
类型三：南瓜灯。分类：笑脸南瓜灯，鬼脸南瓜灯，女巫南瓜灯，死神南瓜灯，Q萌南瓜灯，万圣南瓜灯。各种卡片产出的概率默认如下，后台可配置概率：卡片概率笑脸南瓜灯50%鬼脸南瓜灯20%女巫南瓜灯15%死神南瓜灯10%Q萌南瓜灯4%万圣南瓜灯1%
类型四：情人节鲜花。分类：倾城之恋，甜蜜爱人，蒙娜丽莎，幸福相伴，今生挚爱，梦幻女神。各种卡片产出的概率默认如下，后台可配置概率：卡片概率倾城之恋50%甜蜜爱人20%蒙娜丽莎15%幸福相伴10%今生挚爱4%梦幻女神1%
类型五：粽子。分类：五香麻辣粽，栗子莲蓉粽，蛋黄肉香粽，酱香五香粽，绿豆芝麻粽，zhizun百香粽。各种卡片产出的概率默认如下，后台可配置概率：卡片概率五香麻辣粽50%栗子莲蓉粽20%蛋黄肉香粽15%酱香五香粽10%绿豆芝麻粽4%zhizun百香粽1%
类型六：春联。分类：新春大吉，万事如意，一帆风顺，吉祥富贵，喜迎新春，财源滚滚。各种卡片产出的概率默认如下，后台可配置概率：卡片概率新春大吉50%万事如意20%一帆风顺15%吉祥富贵10%喜迎新春4%财源滚滚1%当仓库中集齐任何一套6个不同的卡片时，可以一键兑换奖励，奖励的类型可以是金豆，种子，盲盒，和兑换券，奖励类型可以在后台单独配置。
果园
果园设置三十块灰色土地，可种植果树，种植前不需要租地。
黄金果树每一个生长周期产出一颗果实，白金果树每一个生长周期产出5颗果实，生长周期默认一天，种植以后马上成熟一次，可立即收取，成熟时间按自然日每天晚上12:00成熟。果树收取同等寿命时间后立即枯萎（如：苹果树寿命三天，即收取三次后立即枯萎）。果树寿命到期后自动枯萎（如：假设寿命周期三天，1号下午18:00种植，马上成熟次，2号凌晨12:00成熟第二次，3号凌晨12:00成熟第三次，到4号凌晨12:00直接枯萎），枯萎后需要铲除重新种植，每一种果树寿命默认如下表：
樱桃树90天
苹果树3天
蕉树3天
芒果树3天
酒坊
酒的分类
酒按照类型不同分类：清香型-浓香型-米香型-酱香型
每种类型的酒能单独升级，有五个级别：二级，一级，优级，特级，仙人醉。
各级别及升级所需材料如下，材料数量可在后台配置调整：级别获得或者升级所需材料二级会员直接从商店花费红宝石购买酒曲获得二级酒一级两个二级同类型酒优级两个一级同类型酒特级一个优级+1颗白菜（白菜可换成NFT合成石或者红宝石，在后台可随时配置类型和数量）仙人醉特级清香型+特级浓香型+特级米香型+特级酱香型+20个NFT合成石（数量可配置）会员从商店购买的酒曲随机获得二级各类型酒，获得概率后台可配置，默认如下：
二级清香型25%
二级浓香型25%二
级米香型25%
二级酱香型25%
奖金池
在酒坊主界面实时展示总奖金池大小。奖金池的获得：所有小财主及以上级别的账户（公司顶点账户除外），系统所有产生奖励的20%直接进入奖金池，奖金池每天累加。
红宝石的产出
小财主及以上级别按照每天贡献给奖金池的数量配发红宝石。默认每贡献1金豆配发一颗红宝石，配比参数后台可调节
收益系统
会员从商店花费红宝石购买酒曲，酒曲随机获得不同类型的酒，各类型酒的获得概率后台可配置，会员通过各级别酒合成的方式Zui终获得仙人醉，仙人醉可在每天固定的时间（暂定11:00-13:00）进行合成，每一个仙人醉合成以后即时获得当时总奖金池的2%（可后台配置），所有兑换按时间先后顺序配发奖金，奖金池实时更新。兑换完成以后给用户展示兑换成功界面，显示奖金大小，在酒坊页面上端滚动展示各会员兑换情况。
娱乐中心
预留功能，后期增加。
级别说明
长工免费用户，任何用户注册进去级别就是长工，长工没有推广资格。当长工在商店抽取盲盒以后，级别自动升为贫农，有推广资格。
贫农免费用户可直接点击前三块土地中的任何一块进行土地升级，前三块土地都是捆绑升级，一次性花费105金豆升级到黑土地，需要花费105金豆激活会员，共计210金豆。贫农以上级别有推广资格。
用户级别按拥有土地块数量划分级别，包括自己的和所有下级推荐关系的土地总和，土地到期后不计入总和，续租土地后重新计入。抽盲盒赠送的虚拟土地设置土地有效期，默认一个月，一个月到期后虚拟土地数量不计入土地总和，默认等级表如下（后台可配置修改）：
级别土地数量
长工0
贫农3
中农60
富农300
小财主1500
大财主10000
小地主50000
大地主200000
士绅在不同线上的下线拥有三个大地主
推荐奖励制度
所有奖励同一条线上的同一级别不叠加，只有Zui下面的级别拿一次。自己不拿自己的奖金。
农场及果园奖励
贫农以上级别享受推荐奖励及游戏消费奖励，贫农以上直接推荐人享受开会员费用的40%，以银豆形式发放。
果园中玩家抽取盲盒即产生奖励，所有级别需要自己果园有正在种植的果树并且前三块土地只在使用才能享受相应奖励，如果前三块地到期需要续租才能享受奖励，奖励以银豆形式发放。各奖励表格如下：
级别
开会员费奖励
租地费用
种子兑换的金豆
税收（手续费）
盲盒奖励
长工贫农中农16%1%
富农10%25%2%
小财主4%10%25%3%
大财主4%8%10%25%3%
小地主4%4%8%15%3%
大地主2%3%7%10%3%
所有小财主及以上级别，需要种植3个南瓜（数量可在后台配置）以上才能享受以上动态收益（当会员升级到小财主时开始计算时间，一个月内可以继续享受原来的动态收益，达到小财主级别以上一个月后，只有种植三个南瓜以上才能享受相应的动态奖励）。单个账号动态收益设置每日上限，达到上限值不在产生动态收益。
每日动态收益上限根据会员种植南瓜的数量动态调整，默认每日动态收益上限500银豆。通过种植南瓜可以提升动态收益每日上限，具体如下：
第4～30个南瓜每增加一颗，日封顶增加100银豆（3200）
第31～40个南瓜，每增加一颗，日封顶增加300银豆（6200）
第41～50个南瓜，每增加一颗，日封顶增加600银豆（1.22万）
第51～60个南瓜，每增加一颗，日封顶增加800银豆（2.02万）
以上所有分配比例可对独立账号单独设置。
所有使用了兑换券或者抵扣券的部分不参与奖金分配，对应费用减去兑换券以后按照上表分配比例参与奖金分配。
其中，租地费用的奖励单独设置，参与分配的数值为：（租地费用*50%-抵扣券价值）*2。比如租地价格41金豆，抵扣券价值10金豆，那么参与奖金分配的数值为：（41*50%-10）*2=21，则对应级别按照分配比例乘以21进行奖励。
