API 设计文档

模块功能一览表

	Cheat-System	DataManager-System	Recommend-System	VIP-System	RAG-System	Tracker-System
用户基本信息维护（用户名，密码，邮箱，性别，学校，头像URL，个人说明）【WHT】		Y
用户PT站数据维护魔力值，上传量，下载量，分享率，播种机制默认磁盘位置) 【WHT】		Y				Y

种子信息维护（种子ID，TrackerURL）【WHT】		Y				Y
种子信息搜索（下载URL，标题，副标题，基本信息[大小，类型]，外部链接，热度表）【WHT】		Y			Y
种子信息推荐（下载URL，标题，副标题，基本信息[大小，类型]，外部链接，热度表）【WHT】			Y
种子下载【RHJ】（用户id，账户状态，种子id，文件大小，文件哈希值，下载时间，开始时间）						Y
专线下载【RHJ】（用户id，账户状态，种子id，专线id，ip，端口，文件大小，文件哈希值，下载时间、开始时间）				Y
种子传输量信息维护【RHJ】（用户id，种子id，用户上传量，用户下载量，用户上传峰值，用户下载峰值，总上传量，总下载量，活跃peer数）						Y
种子成长期保护【RHJ】（种子id，做种数，播种任务id，奖励类型，奖励数值，关联用户，完成情况）				Y
主动播种机制【RHJ】（种子id，做种数，上次检查时间）				Y

做假种检测【WKJ】 (主动请求检测：客户端ID，上次请求时间，下次请求时间，连续失败次数)	Y
伪造上传，下载量检测【WKJ】（作弊个体确认：异常事件唯一ID，用户ID，种子ID）	Y
作弊惩罚申诉【WKJ】（申诉事件唯一ID，用户ID，账号惩罚内容，用户提交文件，审核状态，审核结果，用户账号状态）	Y

公告发布与保存【WKJ】（公告ID，公告内容，公告状态，公告板块）		Y
邀请机制【WKJ】 (用户ID，用户剩余可邀请数量，用户已邀请ID)		Y
求种机制与求种审核【WKJ】 (求种帖子ID，求种人数，悬赏魔力值，审核状态，审核结果，是否已推出种子)		Y				Y

论坛信息维护（帖子ID，标题，内容，发帖用户，发帖时间，回复数量，查看次数，回复[回复ID，主题ID，回复内容，回复用户，回复时间]）【WHT】		Y
论坛信息搜索（标题，内容）【WHT】		Y			Y
论坛信息推荐（标题，内容，发帖用户，发帖时间，回复数量，查看次数）【WHT】			Y

用户收藏夹		Y
魔力值兑换		Y
用户迁移		Y

功能点与系统交互接口定义

	DataManager-System
用户基本信息维护（用户名，密码，邮箱，性别，学校）	`int RegisterUser(User useri)->state(0:success,1:conflict)` `int UpdateInformation(User useri)->state(0:success,1:conflict)` `User GetInformation (UserID id)->all infors`

	DataManager-System	Tracker-System
用户PT站数据维护 (魔力值，上传量，下载量，播种机制默认磁盘位置)	`UserPT GetInformation(UserID id)` `int UpdateInformation(UserID id)` `int RegisterUser(UserPT upt)`	`bool AddUpload(UserID)` `bool ReduceUpload(UserID)` `bool AddDownload(UserID)` `bool ReduceDownload(UserID)` `bool ReduceMagic(UserID)` `bool AddMagic(UserID)`

	DataManager-System	Tracker-System
种子信息维护（直接读取Torrent文件，修改TrackerURL）	`Seed GetSeedInformation(SeedID id)` `bool RegisterSeed(Seed sd)` `bool UpdateSeed(Seed sd)`	`TTorent ReadTorrent(File file)` `Bool SaveTorrent(TTorent seed,SeedID id)`

	DataManager-System	RAG-System
种子信息搜索（包括深度搜索）【WHT】	`Seed SearchSeed(String)`	`Seed DeepSearchSeed(String)`

	Recommend-System
种子信息推荐【WHT】	`List[Seed] GetRecommend(User useri)`

	Tracker-System
种子下载【RHJ】	`File GetTorrent(SeedID id,UserID id)`

	VIP-System
专线下载【RHJ】	`File GetTorrent(SeedID id)`

	Tracker-System
种子传输量信息维护【RHJ】	`bool AddRecord（SeedID id，Time starttime，Time endtime，UserID id，TransportVolume v）`//+v :up,-v:down

	VIP-System
种子成长期保护【RHJ】	`bool AddFarmerNumber(int number)` `bool ReduceFarmerNumber(int number)` `bool AddSeed(TTorent seed,SeedID id)` `bool RemoveSeed(SeedID)` `void CheckSeed()`//检查当前保种列表是否需要更新

	VIP-System
主动播种机制【RHJ】	`List[SeedID] GetSeedList()`

	Cheat-System
做假种检测【WKJ】	`List[(UserID,SeedID)] GetFeakSeed()`

	Cheat-System
伪造上传，下载量检测【WKJ】	`void DetectionSeed(SeedID id)` `void DetectionAll(SeedID id)` `void PunishUser()` `bool GetUserPunish(UserID id)`:每次登录触发该操作 `List[UserID] GetAllPunishUser()`

	Cheat-System
作弊惩罚申诉【WKJ】	`bool AddAppeal(Appeal appeali)` `List[Appeal] GetAppeal(UserID id)` `void RevokePunish(UserID id)`

	DataManager-System
公告发布与保存【WKJ】	`bool AddNotice(Notice nti)` `bool UpdateNotice(Notice nti)` `bool DropNotice(Notice nti)`

	DataManager-System
邀请机制【WKJ】	`int GetUserAvailableTimes(UserID)` `bool InviteUser(UserID Inviter,UserID BeInviter)`

	DataManager-System
求种机制与求种审核【WKJ】	`bool AddBegSeed(BegInfo info)` `bool RevokeBeg(BegID id)` `bool VoteSeed(SeedID id,int vote)` `bool SubmitSeed(SeedID sid,BegID bid)`

	DataManager-System
论坛信息维护【WHT】	`bool AddPost(Post pi)` `bool DropPost(PostID id)` `bool AddCommend(PostID id,Comment cmt)` ``bool DropCommend(PostID id,CommentID cid)`

	DataManager-System
用户收藏夹	`bool AddCollect(UserID,SeedID)` `bool DropCollect(UserID,SeedID)`

	DataManager-System
魔力值兑换	`bool exchange(UserID id,int costmagic)`

	DataManager-System
用户迁移	`bool UploadProfile(Profile pr)` `ProfileID GetProfile(ProfileID)` `bool examineProfile(bool passornot)` `List[Profile] GetToExamines()`