需求:小程序端代码要同时同步到服务器与 git 远程仓库,此前前端仅存在于本地目录(无 remote,从未推送), 服务器与 gitcode 上只有后端。现并入本仓库,复用现有「push 即部署」链路,一次推送双端落地。 - 新增 uniapp/:小程序端源码全量快照(150 文件 / 1.2M) pages(13 页面) · components(fc-navbar/fc-tabbar/fc-post-card/fc-empty) · common(api·utils·mock·assets·store·config) · static(74 图标 + 3 轮播插画 + LOGO) · docs(01-04 交付文档) · tests(零依赖全链路用例) · tools(图标/主题/轮播配图生成脚本) - 明确排除:AGENTS.md(含后台密码、服务器 root 密码、小程序 AppSecret,切勿入库)、 unpackage/(构建产物,由 uniapp/.gitignore 忽略)、node_modules、.DS_Store、*.log - .gitignore 新增 /uniapp/AGENTS.md 兜底(与根 /AGENTS.md、/fluniapp/ 同一约定) - README.md 增补「本项目结构 + 部署链路」章节,说明 uniapp/ 为源码快照、 小程序真正上线仍需微信开发者工具 cli upload 说明:本次为源码快照,未携带前端本地仓库历史——其历史提交中含 AGENTS.md 凭据, 若做 subtree 合并会把密码永久写入本仓库历史,故采用快照方式。
179 行
6.8 KiB
JavaScript
179 行
6.8 KiB
JavaScript
/**
|
||
* LOGO 与图标自定义 测试
|
||
* 覆盖:内置默认图 → 后台覆盖 → 用户端读取生效 的完整链路 + 资源文件完整性
|
||
*/
|
||
import fs from 'node:fs'
|
||
import path from 'node:path'
|
||
import url from 'node:url'
|
||
import { describe, it, expect, expectReject } from './harness.mjs'
|
||
import { ICON_GROUPS, ICON_DEFAULTS, ICON_BASE, CATEGORY_ICON_KEY, DEFAULT_LOGO } from '../common/assets/icons.js'
|
||
import {
|
||
iconUrl,
|
||
logoUrl,
|
||
categoryIconUrl,
|
||
setRemoteUi,
|
||
getRemoteUi,
|
||
resetRemoteUi,
|
||
isIconOverridden,
|
||
} from '../common/utils/icon.js'
|
||
import adminApi from '../common/api/admin.js'
|
||
import { settingApi } from '../common/api/index.js'
|
||
import { decodePng, transparentRatio } from '../tools/png-util.mjs'
|
||
|
||
const ROOT = path.resolve(path.dirname(url.fileURLToPath(import.meta.url)), '..')
|
||
|
||
describe('图标资源 · 文件完整性', () => {
|
||
it('注册表中每个图标都有默认文件声明', () => {
|
||
for (const g of ICON_GROUPS) {
|
||
for (const it of g.items) {
|
||
expect(it.key).toBeTruthy()
|
||
expect(it.name).toBeTruthy()
|
||
expect(ICON_DEFAULTS[it.key]).toBe(it.file)
|
||
}
|
||
}
|
||
})
|
||
|
||
it('static/icons 下存在全部内置图标 PNG', () => {
|
||
const dir = path.join(ROOT, 'static', 'icons')
|
||
const missing = []
|
||
for (const key of Object.keys(ICON_DEFAULTS)) {
|
||
const f = path.join(dir, ICON_DEFAULTS[key])
|
||
if (!fs.existsSync(f)) missing.push(ICON_DEFAULTS[key])
|
||
}
|
||
expect(missing).toEqual([])
|
||
})
|
||
|
||
it('每个图标文件都是有效 PNG 且体积合理', () => {
|
||
const dir = path.join(ROOT, 'static', 'icons')
|
||
for (const key of Object.keys(ICON_DEFAULTS)) {
|
||
const buf = fs.readFileSync(path.join(dir, ICON_DEFAULTS[key]))
|
||
// PNG 魔数
|
||
expect(buf.slice(0, 8).toString('hex')).toBe('89504e470d0a1a0a')
|
||
expect(buf.length).toBeGreaterThan(300)
|
||
}
|
||
})
|
||
|
||
it('每个配图都具备真实的透明通道(左上角必须透明)', () => {
|
||
// 回归防护:qlmanage 会把 SVG 合成到不透明白底上,
|
||
// 必须经过「白底/黑底两遍渲染 + alpha 反解」,否则会出现白色方块。
|
||
const dir = path.join(ROOT, 'static', 'icons')
|
||
const opaque = []
|
||
const lowAlpha = []
|
||
for (const key of Object.keys(ICON_DEFAULTS)) {
|
||
const img = decodePng(fs.readFileSync(path.join(dir, ICON_DEFAULTS[key])))
|
||
if (img.rgba[3] !== 0) opaque.push(`${ICON_DEFAULTS[key]}(角点不透明)`)
|
||
const ratio = transparentRatio(img)
|
||
if (ratio < 0.02) lowAlpha.push(`${ICON_DEFAULTS[key]}(${ratio.toFixed(3)})`)
|
||
}
|
||
expect(opaque).toEqual([])
|
||
expect(lowAlpha).toEqual([])
|
||
})
|
||
|
||
it('配图尺寸统一且足够清晰(≥128px 方图)', () => {
|
||
const dir = path.join(ROOT, 'static', 'icons')
|
||
const sizes = new Set()
|
||
for (const key of Object.keys(ICON_DEFAULTS)) {
|
||
const img = decodePng(fs.readFileSync(path.join(dir, ICON_DEFAULTS[key])))
|
||
expect(img.width).toBe(img.height)
|
||
expect(img.width).toBeGreaterThan(127)
|
||
sizes.add(img.width)
|
||
}
|
||
expect(sizes.size).toBe(1) // 全部同一尺寸,保证视觉一致
|
||
})
|
||
|
||
it('品牌 LOGO 存在且为 PNG', () => {
|
||
const logo = fs.readFileSync(path.join(ROOT, 'static', 'logo.png'))
|
||
expect(logo.slice(0, 8).toString('hex')).toBe('89504e470d0a1a0a')
|
||
expect(logo.length).toBeGreaterThan(1000)
|
||
})
|
||
|
||
it('分类 ID 与分类图标 key 一一对应', () => {
|
||
expect(Object.keys(CATEGORY_ICON_KEY)).toHaveLength(8)
|
||
expect(ICON_DEFAULTS[CATEGORY_ICON_KEY[1]]).toBe('cat-job.png')
|
||
expect(ICON_DEFAULTS[CATEGORY_ICON_KEY[8]]).toBe('cat-friend.png')
|
||
})
|
||
})
|
||
|
||
describe('图标解析 · 本地默认', () => {
|
||
it('未配置时返回内置默认图地址', () => {
|
||
resetRemoteUi()
|
||
expect(iconUrl('tab-home')).toBe(`${ICON_BASE}tab-home.png`)
|
||
expect(iconUrl('cat-job')).toBe(`${ICON_BASE}cat-job.png`)
|
||
expect(logoUrl()).toBe(DEFAULT_LOGO)
|
||
expect(categoryIconUrl(4)).toBe(`${ICON_BASE}cat-car.png`)
|
||
})
|
||
|
||
it('未注册的 key 返回空字符串(不产生错误图片请求)', () => {
|
||
resetRemoteUi()
|
||
expect(iconUrl('not-exist-key')).toBe('')
|
||
expect(iconUrl('')).toBe('')
|
||
})
|
||
})
|
||
|
||
describe('图标解析 · 后台覆盖生效', () => {
|
||
it('setRemoteUi 后按 key 覆盖为自定义地址', () => {
|
||
setRemoteUi({
|
||
logo: 'https://cdn.example.com/mylogo.png',
|
||
icons: { 'tab-home': 'https://cdn.example.com/home.png' },
|
||
})
|
||
expect(iconUrl('tab-home')).toBe('https://cdn.example.com/home.png')
|
||
expect(iconUrl('tab-mine')).toBe(`${ICON_BASE}tab-mine.png`) // 未覆盖的仍走默认
|
||
expect(logoUrl()).toBe('https://cdn.example.com/mylogo.png')
|
||
expect(isIconOverridden('tab-home')).toBe(true)
|
||
expect(isIconOverridden('tab-mine')).toBe(false)
|
||
})
|
||
|
||
it('分类图标被覆盖时随 key 一起生效', () => {
|
||
setRemoteUi({ icons: { 'cat-car': 'https://cdn.example.com/car.png' } })
|
||
expect(categoryIconUrl(4)).toBe('https://cdn.example.com/car.png')
|
||
expect(categoryIconUrl(1)).toBe(`${ICON_BASE}cat-job.png`)
|
||
})
|
||
|
||
it('resetRemoteUi 恢复内置默认', () => {
|
||
resetRemoteUi()
|
||
expect(getRemoteUi()).toEqual({ logo: '', icons: {} })
|
||
expect(iconUrl('tab-home')).toBe(`${ICON_BASE}tab-home.png`)
|
||
})
|
||
})
|
||
|
||
describe('后台接口 · LOGO 与图标自定义闭环', () => {
|
||
it('STEP1 后台可读取当前 UI 配置', async () => {
|
||
const cfg = await adminApi.uiSetting()
|
||
expect(cfg.siteName).toBeDefined()
|
||
expect(cfg.icons).toBeDefined()
|
||
})
|
||
|
||
it('STEP2 后台保存 LOGO 与图标后,用户端接口读到相同内容', async () => {
|
||
const saved = await adminApi.saveUiSetting({
|
||
logo: 'https://cdn.example.com/logo-new.png',
|
||
icons: { 'tab-home': 'https://cdn.example.com/h.png', 'cat-job': 'https://cdn.example.com/j.png' },
|
||
})
|
||
expect(saved.logo).toBe('https://cdn.example.com/logo-new.png')
|
||
expect(saved.icons['tab-home']).toBe('https://cdn.example.com/h.png')
|
||
|
||
// 用户端读取
|
||
const client = await settingApi.ui()
|
||
expect(client.logo).toBe('https://cdn.example.com/logo-new.png')
|
||
expect(client.icons['cat-job']).toBe('https://cdn.example.com/j.png')
|
||
|
||
// 应用到解析层
|
||
setRemoteUi(client)
|
||
expect(iconUrl('tab-home')).toBe('https://cdn.example.com/h.png')
|
||
expect(logoUrl()).toBe('https://cdn.example.com/logo-new.png')
|
||
})
|
||
|
||
it('STEP3 图标地址必须是字符串(类型校验)', async () => {
|
||
await expectReject(() => adminApi.saveUiSetting({ icons: { 'tab-home': 123 } }), '必须是字符串')
|
||
})
|
||
|
||
it('STEP4 恢复默认后用户端回到内置图', async () => {
|
||
await adminApi.resetUiSetting()
|
||
const client = await settingApi.ui()
|
||
expect(client.logo).toBe('')
|
||
expect(client.icons).toEqual({})
|
||
setRemoteUi(client)
|
||
expect(logoUrl()).toBe(DEFAULT_LOGO)
|
||
expect(iconUrl('tab-home')).toBe(`${ICON_BASE}tab-home.png`)
|
||
})
|
||
})
|