测试

源社区应用商店
一、版本记录

版本  日期  作者  说明
v0.1    2025-09-9       ①全页面手机版视觉稿②后台完整布局③评论区管理+附件④UTF-8   

二、总体定位

• 产品名称：Official App Center（官方应用中心）
• 终端：PC(≥1200px)、Pad(768-1199px)、Mobile(≤767px)
• 技术：DZX3.5 插件；PHP7.4-8.x+MySQL5.7-8.x；
• 编码：插件所有代码文件强制 UTF-8 无 BOM（含模板、语言包、JS、CSS）

三、设计系统

3.1 品牌色

• Primary：#5270FF → #7A87FF 45°渐变
• 功能色：Success #10C961 / Error #FF3B30 / Warning #FFCC00
• 中性色：Title #141733 / Body #3C4054 / Line #EEF0F6 / Bg #FAFBFC

3.2 圆角 & 阴影

• 卡片圆角：PC 12px / Mobile 16px
• 按钮圆角：PC 8px / Mobile 12px
• 阴影：0 4 24px rgba(82,112,255,0.08)

3.3 字体

• PC：PingFang SC, HarmonyOS_Sans, 14px
• Mobile：系统字体，15px 基准

3.4 栅格

• PC：24 列，间隙 24px，最大宽 1200px
• Mobile：4 列，间隙 16px，左右安全距 16px

3.5 动效

• hover: y-4px + 阴影 50ms ease
• 路由切换：opacity 100ms + 微 blur
• 按钮点击：涟漪中心扩散 200ms

3.6 暗黑模式

• CSS 变量：跟随系统或顶部开关

四、技术与耦合策略

功能  复用论坛    插件自建
用户权限    $_G['group'] 原生权限体系   ❌
附件大小    $_G['group']['maxattachsize'] ❌
交易积分    后台【积分设置】已存在字段   ❌
消息通知    common_member_notice  ❌
缓存  memory()->get/set 跟随论坛配置   ❌
文件存储    本地/COS/OSS/Kodo（插件自建驱动） ✅
网盘上传    白名单+HEAD检测（插件自建）    ✅
评论区管理   后台设置管理组+附件权限    ✅   

五、文件存储策略（详细）

5.1 本地存储

• 路径：data/attachment/appstore/
• 命名：{uid}_{md5}_{timestamp}.{ext}
• 病毒扫描：ClamAV 实时扫描

5.2 云存储（COS/OSS/Kodo）

• 配置：后台填 Region、Bucket、SecretId、SecretKey、CDN域名
• 上传流程：文件→病毒扫描→本地上传→云存储驱动→成功删除本地→remote=1
• 下载流程：优先CDN→404时fallback本地→统计+1

5.3 迁移详细逻辑

• 后台按钮：「本地→云」「云→本地」
• 点击后弹窗：
  • 单选：①仅改配置 ②迁移文件
  • 输入：并发数（默认5）、失败重试（默认3）
• 队列表 migration_queue：

  id, file_id, direction(cloud/local), status(wait/done/fail), retry, update_time

• 计划任务 cron_migration.php：
  1. 消费 N 条队列
  2. 下载源文件到临时目录
  3. 上传到目标存储
  4. 校验 MD5
  5. 更新 remote 字段
  6. 失败：retry+1；达到上限写日志+后台红点
• 站长通知：迁移完成发送 common_member_notice

六、缓存策略（跟随论坛）

• 介质：后台【性能->内存】所选 File/Redis/Memcached
• KEY 前缀：appstore_{sid}_
• 生命周期：与论坛主题列表一致（300s）；详情页 60s；评论 30s
• 清理：应用状态变更时 memory()->rm()

七、信息架构 IA

根 /
├─ 首页（PC+Mobile）
├─ 分类列表
├─ 搜索页
├─ 排行榜
├─ 应用详情页（含评论区）
├─ 开发者主页
├─ 用户中心
├─ 上传应用
├─ 更新应用
├─ 审核跟踪
├─ 帮助&协议
└─ 后台管理（PC）

八、全局规则

• 路由：plugin.php?id=appstore&mod={page}&ac={sub}
• 伪静态：/app/{id}.html /category/{catid}.html
• 权限：继承 $_G['group']；新增「开发者」「审核员」
• 货币：使用论坛【积分设置】交易积分字段
• 上传大小：读 maxattachsize；后缀后台白名单
• 通知：插入 common_member_notice；跳论坛消息中心
• 缓存：跟随论坛内存设置；KEY 见第 5 节
• 评论：表结构复用 forum_thread/post；type='appstore_comment'
• SEO：伪静态 + TKD + 结构化数据 Product

九、页面级需求（PC & Mobile 双模板）

9.1 首页

Mobile 视觉稿（像素级）

┌─ 状态栏高 24px（系统）                  ┐
├─ 导航栏高 56px                          │
│  分类图标（左）Logo 居中 发布+（右）      │
├─ Hero 轮播高 210px（16:9）               │
│  指示器圆点 6px；手势滑动                │
├─ 分类宫格 8 个 72px 图标 + 12px 文字       │
├─ 搜索入口高 48px（圆角 12）               │
├─ 新品卡片单列                           │
│  卡片高 120px；圆角 16；阴影 Y4           │
├─ 排行榜标签高 48px；指示线 2px            │
├─ 猜你喜欢瀑布流                         │
│  卡片宽 = (屏幕-48)/2；高度自适应         │
└─ 悬浮发布按钮 56px；右下 16px 安全距      │

PC 视觉稿

• 导航通栏高 64px；轮播高 400px；三栏排行榜；瀑布流三列
• 其余元素同 Mobile 比例放大

实现逻辑

• 轮播/精选：后台「首页装修」拖拽排序；缓存 300s
• 瀑布流：前端 column-count:2 + IntersectionObserver 懒加载
• 下拉加载：URL plugin.php?id=appstore&mod=index&page=2 返回 JSON

9.2 分类列表

Mobile

• 顶部 Tab 横向滑动（一级分类）
• 筛选抽屉：价格、评分、时间、排序
• 结果瀑布流；加载更多

PC

• 左侧树形分类+标签多选；右侧双列卡片；排序条；网格/列表切换

逻辑

• 分类树：读 forum_forum where type='appstore'
• 筛选缓存 KEY appstore_cat_{catid}_{filter_md5} 300s

9.3 搜索页

Mobile

• 搜索框吸顶；历史标签横向；即时建议下拉
• 结果双列；空态插图+热门关键词

PC

• 左侧高级筛选；右侧双列；支持语法 tag:游戏 价格:免费

逻辑

• 建议接口：mod=suggest&q=关键词 返回 JSON
• 结果缓存：appstore_search_{md5(q+filter)} 300s

9.4 排行榜

• 维度：下载/评分/新品/飙升/付费；时间日周月总
• Mobile：顶部标签；下拉加载
• PC：三栏并排 TOP100
• 缓存：每小时；KEY appstore_rank_{type}_{time} 3600s

9.5 应用详情页（含评论区）

Mobile 视觉稿

┌─ 返回+分享 │ 名称+收藏（右上）           ┐
├─ 媒体区轮播高 210px                     │
├─ 信息区吸顶（图标+名称+评分+下载按钮）    │
├─ Tab 横向滑动：详情 | 版本 | 评论 | 问答 │
├─ 评论区（见下独立章节）                 │
└─ 底部悬浮下载按钮高 56px                 │

PC 视觉稿

• 媒体区左 640px；信息区右 360px；评论区全宽；侧边栏相关推荐

实现逻辑

• 媒体：图片懒加载；视频自动播放静音
• 价格：限时免费倒计时 JS；到期 cron 改回积分
• 下载：按钮触发 gateway.php?id=xx→302→CDN/本地

9.6 评论区（手机版独立模板）

Mobile 视觉稿

├─ 评论输入框吸底高 88px                    │
│  左侧头像 32px；中间输入；右侧发送        │
│  支持图+语音+表情                         │
├─ 排序 Tab：最新/最热/最早（下拉菜单）      │
├─ 单条卡片：                               │
│  ├─ 头像 40px + 昵称 + 等级徽章           │
│  ├─ 内容区（图片宽度=屏幕-32px）          │
│  ├─ 底部：点赞 | 回复 | 举报 | 时间      │
│  └─ 楼中楼默认 2 条；点「展开 3 条」       │
└─ 加载更多：论坛原生分页 20                │

PC 视觉稿

• 输入框右侧；楼中楼完整显示；分页页码

逻辑

• 发帖：调用 forum_post.php?action=reply with type='appstore_comment'
• 点赞：调用 home.php?mod=spacecp&ac=praise
• 缓存：与帖子回帖一致 30s；KEY appstore_comments_{appid}_{page}

9.7 开发者主页

Mobile

• 封面图 180px；头像 80px 居中；认证标
• Tab：应用 | 动态 | 关于
• 应用卡片双列瀑布流

PC

• 封面 1440×320；左侧统计；右侧公告；应用三列

逻辑

• 统计 SQL：应用数、下载数、积分收益（读 common_credit_log）

9.8 用户中心

Mobile

• 底部 Tab：首页/搜索/发布/消息/我的
• 「我的」页面：用户卡片+宫格+动态时间轴
• 点击「消息」→ 跳 home.php?mod=space&do=notice

PC

• 左侧导航树；右侧 Dashboard 图表（Chart.js）
• 积分图表：读 common_credit_log

逻辑

• 所有数据读论坛原生表；不再自建

9.9 上传应用（首次）

Mobile 视觉稿（单页折叠）

┌─ 进度条（0%-100%）高 4px                  ┐
├─ 基础信息折叠块                         │
│  名称* / 分类* / 标签 / 简介*            │
├─ 文件折叠块                             │
│  选择文件按钮高 48px                    │
│  自动解析 config.xml→版本号             │
├─ 图文折叠块                             │
│  封面图拖拽裁剪                         │
│  截图≥3（拖拽排序）                     │
│  详情描述富文本+Markdown 切换            │
├─ 定价折叠块                             │
│  免费/积分/限时免费单选                 │
│  限时免费→日期时间选择器                │
└─ 底部保存草稿 + 提交按钮                │

PC 视觉稿

• 4 步向导；左侧步骤指示；右侧内容区
• 封面图裁剪弹窗（Cropper.js）

逻辑

• 文件大小：实时读 <!--{eval echo $_G['group']['maxattachsize']}-->
• 后缀：本地允许 = 论坛 attachextensions；网盘允许 = 后台白名单
• 云存储：选择 COS/OSS/Kodo→后台填密钥→文件流上传→remote=1

9.10 更新应用（版本）

Mobile

• 顶部提示「当前版本 1.2.3」
• 表单块：
  • 版本号 / 更新日志（富文本）
  • 文件（可选，不选则只更新日志）
  • 截图（可选，可替换）
• 提交→进入审核→原版本状态=历史

PC

• 版本时间轴左+表单右
• 支持「版本对比」diff 弹窗

逻辑

• 写入 appstore_version 新记录；状态=待审核
• 审核通过后旧版本 status=history

9.11 审核跟踪

Mobile

• 时间轴垂直；图标+状态+时间+审核员留言
• 底部「重新提交」按钮（如被拒绝）

PC

• 横向时间轴+留言卡片

逻辑

• 状态机：待审核→初审→复审→通过/拒绝→已上架/需修改
• 每次变更：插入 common_member_notice + 邮件（跟随论坛）

9.12 帮助&协议

Mobile

• 折叠面板 FAQ；顶部搜索关键词高亮
• 底部「提交工单」→跳论坛工单插件

PC

• 左侧树形帮助分类；右侧内容区

逻辑

• 后台「帮助管理」富文本编辑；缓存 1 天

9.13 后台管理（PC 仅）

布局

┌─ 顶部导航：Logo | 消息 | 头像                     ┐
├─ 左侧菜单树（可折叠）                             │
│  ├─ 仪表盘
│  ├─ 应用管理
│  ├─ 评论管理
│  ├─ 云存储迁移
│  ├─ 首页装修
│  ├─ 营销工具
│  ├─ 财务
│  └─ 系统设置
├─ 右侧内容区（卡片式）                             │
└─ 底部：版本号 + 返回站点                         │

关键页面

1. 仪表盘
   • 实时 PV、待审核、迁移进度（进度条+百分比）
   • 图表：7 日上传/下载趋势（Chart.js）
2. 应用管理
   • 表格：ID、名称、作者、版本、状态、操作（审核/下架/删除）
   • 批量操作：审核、移动分类、生成兑换码
   • 版本对比弹窗：截图、日志、文件大小 diff
3. 云存储迁移
   • 进度条+实时日志（WebSocket）
   • 按钮：暂停/继续/重试失败
4. 首页装修
   • 拖拽排序轮播、精选位
   • 定时上线/下线
5. 系统设置
   • 后缀白名单输入框
   • 交易积分下拉选择
   • 云存储密钥表单（测试按钮）
   • 暗黑模式开关

十、业务逻辑流

上传：
用户→JS校验→forum_attachment→云存储驱动→成功删除本地→写入appstore_apps→审核
下载：
用户→gateway.php→统计+1→302→CDN/本地→失败fallback本地
评论：
用户→forum_post.php→type='appstore_comment'→缓存30s→返回JSON
通知：
审核变更→common_member_notice→home.php?mod=space&do=notice

十一、数据库表 & 字段

表名  核心字段
appstore_apps   id, name, catid, price_type, price, credit_type, status, uid, create_time
appstore_version    id, app_id, version, log, file_url, size, md5, status
appstore_netdisk    id, app_id, url, password, status, check_time
appstore_download_log   id, app_id, uid, ip, create_time
migration_queue id, file_id, direction, status, retry, update_time
forum_attachment    沿用+ remote字段
forum_thread/post   沿用+ type='appstore_comment'

十二、安全 & 合规

• 上传：后缀白名单+大小+病毒扫描（ClamAV）
• 网盘：HEAD 限 5s；内网 IP 黑名单；SSRF 过滤
• 下载：gateway 302；IP 限速 60/小时
• 评论：敏感词；举报≥3 自动隐藏
• 数据：HTTPS；云存储私有读+CDN 签名
• 合规：GDDR 浮层；DMCA 投诉

十三、SEO & 结构化数据

• 伪静态：/app/{id}.html
• TKD：后台填；标题模板「{app_name} - 官方应用中心」
• Schema：Product / AggregateRating / Offer / BreadcrumbList
• Sitemap：自动生成；每日更新

十四、交付清单

• 安装包：plugin.xml + 脚本（UTF-8）
• 模板：所有页面 PC+Mobile 独立 .htm（UTF-8）
• 后台：admin 模板 + 迁移 CLI（UTF-8）
• 语言：lang/zh-cn.php、en.php（UTF-8）
• 组件：轮播、瀑布流、评论、上传、富文本（UTF-8）
• 文档：本文档 + 接口swagger + 测试用例（UTF-8）

十五、上线检查单

• 论坛 cron 已开启
• 内存缓存已配置（Redis/File）
• 伪静态规则已写入 Nginx
• 云存储密钥已测（一键测试通过）
• 病毒扫描服务已启动
• 评论敏感词库已同步
• 数据库备份完成

---