feat: add brand knowledge engagement actions

This commit is contained in:
江林铖 2026-09-14 13:56:08 +08:00
parent f5cb86e875
commit 6d05ec2de6
15 changed files with 680 additions and 42 deletions

View File

@ -94,7 +94,8 @@ RUN test -s "/app/public/brand/header-logo.png" && \
test -f "/app/prisma/migrations/20260902_add_employee_roster_history/migration.sql" && \
test -f "/app/prisma/migrations/20260903_add_work_review_brand/migration.sql" && \
test -f "/app/prisma/migrations/20260908_add_brand_knowledge/migration.sql" && \
test -f "/app/prisma/migrations/20260909_expand_brand_knowledge_upload/migration.sql"
test -f "/app/prisma/migrations/20260909_expand_brand_knowledge_upload/migration.sql" && \
test -f "/app/prisma/migrations/20260914_add_brand_knowledge_engagement/migration.sql"
# 这两个动态路由负责兜底访问本地上传文件;如果它们在构建上下文里丢失,
# 线上音频/视频就会直接 404。这里提前失败,避免再把缺路由的镜像发出去。
@ -222,6 +223,7 @@ COPY --from=builder --chown=root:root /app/prisma/migrations/20260902_add_employ
COPY --from=builder --chown=root:root /app/prisma/migrations/20260903_add_work_review_brand ./prisma/migrations/20260903_add_work_review_brand
COPY --from=builder --chown=root:root /app/prisma/migrations/20260908_add_brand_knowledge ./prisma/migrations/20260908_add_brand_knowledge
COPY --from=builder --chown=root:root /app/prisma/migrations/20260909_expand_brand_knowledge_upload ./prisma/migrations/20260909_expand_brand_knowledge_upload
COPY --from=builder --chown=root:root /app/prisma/migrations/20260914_add_brand_knowledge_engagement ./prisma/migrations/20260914_add_brand_knowledge_engagement
COPY --from=builder --chown=nextjs:nodejs /app/lib ./lib
COPY --from=builder --chown=nextjs:nodejs /app/scripts/public-traffic-rollup-from-nginx.py ./scripts/public-traffic-rollup-from-nginx.py
COPY --from=builder --chown=nextjs:nodejs /app/scripts/collapse-performance-survey-template-versions.mjs ./scripts/collapse-performance-survey-template-versions.mjs

View File

@ -0,0 +1,49 @@
import { getServerSession } from 'next-auth'
import { NextRequest, NextResponse } from 'next/server'
import { authOptions } from '@/lib/auth'
import { assertBrandCenterDashboardAccess, BrandCenterDashboardAccessError } from '@/lib/brand-center-dashboard-access'
import { prisma } from '@/lib/prisma'
export const dynamic = 'force-dynamic'
const PRIVATE_HEADERS = { 'Cache-Control': 'private, no-store, max-age=0' }
export async function PUT(request: NextRequest, { params }: { params: { id: string } }) {
try {
const session = await getServerSession(authOptions)
await assertBrandCenterDashboardAccess(session)
const userId = session?.user?.id
if (!userId) return NextResponse.json({ success: false, error: '请先登录' }, { status: 401, headers: PRIVATE_HEADERS })
const body = await request.json().catch(() => null)
if (typeof body?.active !== 'boolean') {
return NextResponse.json({ success: false, error: '收藏状态不合法' }, { status: 400, headers: PRIVATE_HEADERS })
}
const knowledge = await prisma.brandKnowledge.findUnique({ where: { id: params.id }, select: { id: true } })
if (!knowledge) {
return NextResponse.json({ success: false, error: '知识内容不存在' }, { status: 404, headers: PRIVATE_HEADERS })
}
if (body.active) {
await prisma.brandKnowledgeFavorite.upsert({
where: { knowledgeId_userId: { knowledgeId: knowledge.id, userId } },
create: { knowledgeId: knowledge.id, userId },
update: {},
})
} else {
await prisma.brandKnowledgeFavorite.deleteMany({ where: { knowledgeId: knowledge.id, userId } })
}
return NextResponse.json(
{ success: true, isFavorited: body.active },
{ headers: PRIVATE_HEADERS },
)
} catch (error) {
if (error instanceof BrandCenterDashboardAccessError) {
return NextResponse.json({ success: false, error: error.message }, { status: error.status, headers: PRIVATE_HEADERS })
}
console.error('[department-dashboard] 品牌知识收藏失败:', error)
return NextResponse.json({ success: false, error: '收藏操作失败,请稍后重试' }, { status: 500, headers: PRIVATE_HEADERS })
}
}

View File

@ -0,0 +1,50 @@
import { getServerSession } from 'next-auth'
import { NextRequest, NextResponse } from 'next/server'
import { authOptions } from '@/lib/auth'
import { assertBrandCenterDashboardAccess, BrandCenterDashboardAccessError } from '@/lib/brand-center-dashboard-access'
import { prisma } from '@/lib/prisma'
export const dynamic = 'force-dynamic'
const PRIVATE_HEADERS = { 'Cache-Control': 'private, no-store, max-age=0' }
export async function PUT(request: NextRequest, { params }: { params: { id: string } }) {
try {
const session = await getServerSession(authOptions)
await assertBrandCenterDashboardAccess(session)
const userId = session?.user?.id
if (!userId) return NextResponse.json({ success: false, error: '请先登录' }, { status: 401, headers: PRIVATE_HEADERS })
const body = await request.json().catch(() => null)
if (typeof body?.active !== 'boolean') {
return NextResponse.json({ success: false, error: '点赞状态不合法' }, { status: 400, headers: PRIVATE_HEADERS })
}
const knowledge = await prisma.brandKnowledge.findUnique({ where: { id: params.id }, select: { id: true } })
if (!knowledge) {
return NextResponse.json({ success: false, error: '知识内容不存在' }, { status: 404, headers: PRIVATE_HEADERS })
}
if (body.active) {
await prisma.brandKnowledgeLike.upsert({
where: { knowledgeId_userId: { knowledgeId: knowledge.id, userId } },
create: { knowledgeId: knowledge.id, userId },
update: {},
})
} else {
await prisma.brandKnowledgeLike.deleteMany({ where: { knowledgeId: knowledge.id, userId } })
}
const likeCount = await prisma.brandKnowledgeLike.count({ where: { knowledgeId: knowledge.id } })
return NextResponse.json(
{ success: true, liked: body.active, likeCount },
{ headers: PRIVATE_HEADERS },
)
} catch (error) {
if (error instanceof BrandCenterDashboardAccessError) {
return NextResponse.json({ success: false, error: error.message }, { status: error.status, headers: PRIVATE_HEADERS })
}
console.error('[department-dashboard] 品牌知识点赞失败:', error)
return NextResponse.json({ success: false, error: '点赞操作失败,请稍后重试' }, { status: 500, headers: PRIVATE_HEADERS })
}
}

View File

@ -0,0 +1,143 @@
import { getServerSession } from 'next-auth'
import { prisma } from '@/lib/prisma'
import { assertBrandCenterDashboardAccess } from '@/lib/brand-center-dashboard-access'
jest.mock('next-auth', () => ({ getServerSession: jest.fn() }))
jest.mock('@/lib/auth', () => ({ authOptions: {} }))
jest.mock('@/lib/brand-center-dashboard-access', () => ({
BrandCenterDashboardAccessError: class BrandCenterDashboardAccessError extends Error {
constructor(message: string, readonly status = 403) { super(message) }
},
assertBrandCenterDashboardAccess: jest.fn(async () => undefined),
}))
jest.mock('@/lib/prisma', () => ({
prisma: {
brandKnowledge: { findMany: jest.fn(), findUnique: jest.fn() },
brandKnowledgeLike: { upsert: jest.fn(), deleteMany: jest.fn(), count: jest.fn() },
brandKnowledgeFavorite: { upsert: jest.fn(), deleteMany: jest.fn() },
},
}))
const { TextDecoder, TextEncoder } = require('util') as typeof import('util')
const { clearImmediate, setImmediate } = require('timers') as typeof import('timers')
Object.assign(globalThis, { TextDecoder, TextEncoder, clearImmediate, setImmediate })
const edgePrimitives = require('next/dist/compiled/@edge-runtime/primitives') as typeof globalThis
Object.assign(globalThis, {
Headers: edgePrimitives.Headers,
Request: edgePrimitives.Request,
Response: edgePrimitives.Response,
})
let GET: typeof import('./route').GET
let putLike: typeof import('./[id]/like/route').PUT
let putFavorite: typeof import('./[id]/favorite/route').PUT
const context = { params: { id: 'knowledge-1' } }
function actionRequest(path: string, active: unknown) {
return new Request(`http://localhost${path}`, {
method: 'PUT',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ active }),
}) as unknown as import('next/server').NextRequest
}
describe('brand knowledge engagement routes', () => {
beforeAll(async () => {
;({ GET } = await import('./route'))
;({ PUT: putLike } = await import('./[id]/like/route'))
;({ PUT: putFavorite } = await import('./[id]/favorite/route'))
})
beforeEach(() => {
jest.clearAllMocks()
;(getServerSession as jest.Mock).mockResolvedValue({ user: { id: 'user-1' } })
;(prisma.brandKnowledge.findUnique as jest.Mock).mockResolvedValue({ id: 'knowledge-1' })
;(prisma.brandKnowledgeLike.count as jest.Mock).mockResolvedValue(1)
})
test('list returns current user engagement state and total likes', async () => {
;(prisma.brandKnowledge.findMany as jest.Mock).mockResolvedValue([{
id: 'knowledge-1',
title: '影像规范',
knowledgeType: '影像规范',
brand: '索菲亚',
productCategoryName: '衣柜',
fileName: 'guide.pdf',
mimeType: 'application/pdf',
fileSize: BigInt(10),
previewImageName: null,
previewImagePath: null,
previewImageMimeType: null,
previewImageSize: null,
createdAt: new Date('2026-09-14T00:00:00.000Z'),
uploader: { realName: '无邪', username: 'wuxie' },
likes: [{ id: 'like-1' }],
favorites: [{ id: 'favorite-1' }],
_count: { likes: 3 },
}])
const response = await GET(new Request('http://localhost/api/department-dashboard/brand-knowledge'))
const body = await response.json()
expect(response.status).toBe(200)
expect(response.headers.get('cache-control')).toBe('private, no-store, max-age=0')
expect(body.data[0]).toEqual(expect.objectContaining({ likeCount: 3, isLiked: true, isFavorited: true }))
expect(prisma.brandKnowledge.findMany).toHaveBeenCalledWith(expect.objectContaining({
select: expect.objectContaining({
likes: expect.objectContaining({ where: { userId: 'user-1' } }),
favorites: expect.objectContaining({ where: { userId: 'user-1' } }),
_count: { select: { likes: true } },
}),
}))
})
test('like uses an idempotent active state and returns the new count', async () => {
const response = await putLike(actionRequest('/like', true), context)
expect(response.status).toBe(200)
expect(prisma.brandKnowledgeLike.upsert).toHaveBeenCalledWith(expect.objectContaining({
where: { knowledgeId_userId: { knowledgeId: 'knowledge-1', userId: 'user-1' } },
}))
await expect(response.json()).resolves.toEqual({ success: true, liked: true, likeCount: 1 })
})
test('unlike and unfavorite are idempotent deletes', async () => {
const likeResponse = await putLike(actionRequest('/like', false), context)
const favoriteResponse = await putFavorite(actionRequest('/favorite', false), context)
expect(prisma.brandKnowledgeLike.deleteMany).toHaveBeenCalledWith({ where: { knowledgeId: 'knowledge-1', userId: 'user-1' } })
expect(prisma.brandKnowledgeFavorite.deleteMany).toHaveBeenCalledWith({ where: { knowledgeId: 'knowledge-1', userId: 'user-1' } })
await expect(likeResponse.json()).resolves.toEqual({ success: true, liked: false, likeCount: 1 })
await expect(favoriteResponse.json()).resolves.toEqual({ success: true, isFavorited: false })
})
test('favorite upserts one user state', async () => {
const response = await putFavorite(actionRequest('/favorite', true), context)
expect(prisma.brandKnowledgeFavorite.upsert).toHaveBeenCalledWith(expect.objectContaining({
where: { knowledgeId_userId: { knowledgeId: 'knowledge-1', userId: 'user-1' } },
}))
await expect(response.json()).resolves.toEqual({ success: true, isFavorited: true })
})
test('rejects invalid state and missing knowledge without writing', async () => {
const invalid = await putLike(actionRequest('/like', 'yes'), context)
expect(invalid.status).toBe(400)
;(prisma.brandKnowledge.findUnique as jest.Mock).mockResolvedValue(null)
const missing = await putFavorite(actionRequest('/favorite', true), context)
expect(missing.status).toBe(404)
expect(prisma.brandKnowledgeFavorite.upsert).not.toHaveBeenCalled()
})
test('checks brand center access before reading or writing', async () => {
const AccessError = jest.requireMock('@/lib/brand-center-dashboard-access').BrandCenterDashboardAccessError
;(assertBrandCenterDashboardAccess as jest.Mock).mockRejectedValue(new AccessError('无权访问', 403))
const response = await putLike(actionRequest('/like', true), context)
expect(response.status).toBe(403)
expect(prisma.brandKnowledge.findUnique).not.toHaveBeenCalled()
expect(prisma.brandKnowledgeLike.upsert).not.toHaveBeenCalled()
})
})

View File

@ -58,6 +58,9 @@ function serializeKnowledge(item: {
previewImageSize: bigint | null
createdAt: Date
uploader: { realName: string | null; username: string }
likes: { id: string }[]
favorites: { id: string }[]
_count: { likes: number }
}) {
return {
id: item.id,
@ -73,6 +76,9 @@ function serializeKnowledge(item: {
downloadUrl: `/api/department-dashboard/brand-knowledge/${item.id}/file`,
previewUrl: item.previewImagePath ? `/api/department-dashboard/brand-knowledge/${item.id}/preview` : null,
previewImageName: item.previewImageName,
likeCount: item._count.likes,
isLiked: item.likes.length > 0,
isFavorited: item.favorites.length > 0,
}
}
@ -80,6 +86,8 @@ export async function GET(request: Request) {
try {
const session = await getServerSession(authOptions)
await assertBrandCenterDashboardAccess(session)
const userId = session?.user?.id
if (!userId) return NextResponse.json({ success: false, error: '请先登录' }, { status: 401, headers: PRIVATE_HEADERS })
const params = new URL(request.url).searchParams
const type = params.get('type')?.trim() || ''
const query = params.get('q')?.trim() || ''
@ -112,6 +120,9 @@ export async function GET(request: Request) {
previewImageSize: true,
createdAt: true,
uploader: { select: { realName: true, username: true } },
likes: { where: { userId }, select: { id: true } },
favorites: { where: { userId }, select: { id: true } },
_count: { select: { likes: true } },
},
})
return NextResponse.json({ success: true, data: items.map(serializeKnowledge) }, { headers: PRIVATE_HEADERS })
@ -250,6 +261,9 @@ export async function POST(request: Request) {
previewImageSize: true,
createdAt: true,
uploader: { select: { realName: true, username: true } },
likes: { select: { id: true } },
favorites: { select: { id: true } },
_count: { select: { likes: true } },
},
})
storedPath = null

View File

@ -62,13 +62,18 @@ describe('BrandKnowledgeDashboard', () => {
downloadUrl: '/api/department-dashboard/brand-knowledge/knowledge-1/file',
previewUrl: '/api/department-dashboard/brand-knowledge/knowledge-1/preview',
previewImageName: 'preview.png',
likeCount: 0,
isLiked: false,
isFavorited: false,
}],
}),
} as Response)
render(<BrandKnowledgeDashboard />)
expect(await screen.findByRole('img', { name: '预览图:索菲亚图像影像规范' })).toBeInTheDocument()
const preview = await screen.findByRole('img', { name: '预览图:索菲亚图像影像规范' })
expect(preview).toHaveClass('object-contain', 'object-center')
expect(preview).not.toHaveClass('object-cover')
expect(screen.getByRole('heading', { level: 3, name: '索菲亚图像影像规范' })).toBeInTheDocument()
expect(screen.getByText(/637\.90 MB/)).toBeInTheDocument()
expect(screen.getByText(/无邪/)).toBeInTheDocument()
@ -82,11 +87,66 @@ describe('BrandKnowledgeDashboard', () => {
expect(copyIdButton).toHaveTextContent('作品ID knowledge-1')
fireEvent.click(copyIdButton)
await waitFor(() => expect(navigator.clipboard.writeText).toHaveBeenCalledWith('knowledge-1'))
expect(screen.getByRole('status')).toHaveTextContent('作品ID已复制')
await waitFor(() => expect(screen.getByRole('status')).toHaveTextContent('作品ID已复制'))
expect(screen.getByRole('link', { name: '下载索菲亚图像影像规范' })).toHaveAttribute(
'href',
'/api/department-dashboard/brand-knowledge/knowledge-1/file',
)
expect(screen.getByRole('button', { name: '分享索菲亚图像影像规范' })).toBeInTheDocument()
expect(screen.getByRole('button', { name: '点赞索菲亚图像影像规范' })).toHaveAttribute('aria-pressed', 'false')
expect(screen.getByRole('button', { name: '收藏索菲亚图像影像规范' })).toHaveAttribute('aria-pressed', 'false')
})
it('copies a knowledge deep link and persists like and favorite state', async () => {
const item = {
id: 'knowledge-1',
title: '索菲亚图像影像规范',
knowledgeType: '影像规范',
brand: '索菲亚',
productCategoryName: '衣柜',
fileName: '索菲亚图像影像规范.rar',
mimeType: 'application/vnd.rar',
fileSize: 668886630,
createdAt: '2026-09-12T00:00:00.000Z',
uploadedBy: '无邪',
downloadUrl: '/api/department-dashboard/brand-knowledge/knowledge-1/file',
previewUrl: '/api/department-dashboard/brand-knowledge/knowledge-1/preview',
previewImageName: 'preview.png',
likeCount: 0,
isLiked: false,
isFavorited: false,
}
global.fetch = jest.fn().mockImplementation((input: RequestInfo | URL, init?: RequestInit) => {
if (String(input).endsWith('/like') && init?.method === 'PUT') {
return Promise.resolve({ ok: true, json: async () => ({ success: true, liked: true, likeCount: 1 }) } as Response)
}
if (String(input).endsWith('/favorite') && init?.method === 'PUT') {
return Promise.resolve({ ok: true, json: async () => ({ success: true, isFavorited: true }) } as Response)
}
return Promise.resolve({ ok: true, json: async () => ({ success: true, data: [item] }) } as Response)
})
render(<BrandKnowledgeDashboard />)
fireEvent.click(await screen.findByRole('button', { name: '分享索菲亚图像影像规范' }))
await waitFor(() => expect(navigator.clipboard.writeText).toHaveBeenCalledWith(
expect.stringMatching(/\/workspaces\/assets\/brand-knowledge\?knowledge=knowledge-1$/),
))
await waitFor(() => expect(screen.getByRole('status')).toHaveTextContent('分享链接已复制'))
fireEvent.click(screen.getByRole('button', { name: '点赞索菲亚图像影像规范' }))
await waitFor(() => expect(screen.getByRole('button', { name: '取消点赞索菲亚图像影像规范' })).toHaveTextContent('点赞 1'))
expect(global.fetch).toHaveBeenCalledWith(
'/api/department-dashboard/brand-knowledge/knowledge-1/like',
expect.objectContaining({ method: 'PUT', body: JSON.stringify({ active: true }) }),
)
fireEvent.click(screen.getByRole('button', { name: '收藏索菲亚图像影像规范' }))
await waitFor(() => expect(screen.getByRole('button', { name: '取消收藏索菲亚图像影像规范' })).toHaveTextContent('已收藏'))
expect(global.fetch).toHaveBeenCalledWith(
'/api/department-dashboard/brand-knowledge/knowledge-1/favorite',
expect.objectContaining({ method: 'PUT', body: JSON.stringify({ active: true }) }),
)
})
it('submits a selected knowledge file to the independent API', async () => {
@ -119,6 +179,7 @@ describe('BrandKnowledgeDashboard', () => {
fireEvent.change(screen.getByLabelText('选择预览图片'), { target: { files: [previewFile] } })
expect(screen.getByText('品牌手册.pdf')).toBeInTheDocument()
expect(screen.getByText('预览图.png')).toBeInTheDocument()
expect(screen.getByRole('img', { name: '预览图:预览图.png' })).toHaveClass('object-contain', 'object-center')
expect(screen.getByRole('button', { name: '提交知识' })).toBeEnabled()
fireEvent.click(screen.getByRole('button', { name: '提交知识' }))
await waitFor(() => expect(fetchMock).toHaveBeenCalledWith('/api/department-dashboard/brand-knowledge', expect.objectContaining({ method: 'POST', body: expect.any(FormData) })))

View File

@ -2,17 +2,44 @@
import { useCallback, useEffect, useMemo, useRef, useState } from 'react'
import Image from 'next/image'
import { BookOpen, ChevronDown, Download, FileText, Search, Upload } from 'lucide-react'
import { BookOpen, ChevronDown, Download, FileText, Heart, Search, Share2, Upload } from 'lucide-react'
import DepartmentShell from './DepartmentShell'
import BrandKnowledgeUploadDialog from './BrandKnowledgeUploadDialog'
import { BRAND_KNOWLEDGE_TYPE_OPTIONS } from '@/lib/brand-knowledge-file-types'
const KNOWLEDGE_TYPES = ['全部', ...BRAND_KNOWLEDGE_TYPE_OPTIONS]
type BrandKnowledgeItem = { id: string; title: string; knowledgeType: string; brand: string; productCategoryName: string; fileName: string; mimeType: string; fileSize: number; createdAt: string; uploadedBy: string; downloadUrl: string; previewUrl: string | null; previewImageName: string | null }
type BrandKnowledgeItem = { id: string; title: string; knowledgeType: string; brand: string; productCategoryName: string; fileName: string; mimeType: string; fileSize: number; createdAt: string; uploadedBy: string; downloadUrl: string; previewUrl: string | null; previewImageName: string | null; likeCount: number; isLiked: boolean; isFavorited: boolean }
function formatFileSize(size: number) { if (size < 1024) return `${size} B`; if (size < 1024 * 1024) return `${(size / 1024).toFixed(2)} KB`; if (size < 1024 * 1024 * 1024) return `${(size / (1024 * 1024)).toFixed(2)} MB`; return `${(size / (1024 * 1024 * 1024)).toFixed(2)} GB` }
function formatDate(value: string) { const date = new Date(value); if (Number.isNaN(date.getTime())) return value; const parts = new Intl.DateTimeFormat('zh-CN', { year: 'numeric', month: '2-digit', day: '2-digit' }).formatToParts(date); const values = Object.fromEntries(parts.map((part) => [part.type, part.value])); return `${values.year}.${values.month}.${values.day}` }
function BrandKnowledgeCard({ item, onNotice }: { item: BrandKnowledgeItem; onNotice: (message: string) => void }) {
async function copyText(value: string) {
try {
await navigator.clipboard.writeText(value)
return true
} catch {
const textarea = document.createElement('textarea')
textarea.value = value
textarea.style.position = 'fixed'
textarea.style.left = '-999999px'
document.body.appendChild(textarea)
textarea.select()
try {
return document.execCommand('copy')
} catch {
return false
} finally {
document.body.removeChild(textarea)
}
}
}
function BrandKnowledgeCard({ item, onNotice, onLike, onFavorite }: {
item: BrandKnowledgeItem
onNotice: (message: string) => void
onLike: (id: string, active: boolean) => Promise<void>
onFavorite: (id: string, active: boolean) => Promise<void>
}) {
const [busyAction, setBusyAction] = useState<'like' | 'favorite' | null>(null)
const details = [
formatFileSize(item.fileSize),
item.uploadedBy,
@ -23,38 +50,44 @@ function BrandKnowledgeCard({ item, onNotice }: { item: BrandKnowledgeItem; onNo
].filter(Boolean)
const handleCopyId = async () => {
onNotice(await copyText(item.id) ? '作品ID已复制' : '作品ID复制失败,请手动复制')
}
const handleShare = async () => {
const url = new URL('/workspaces/assets/brand-knowledge', window.location.origin)
url.searchParams.set('knowledge', item.id)
onNotice(await copyText(url.toString()) ? '分享链接已复制' : '分享链接复制失败,请手动复制')
}
const handleEngagement = async (action: 'like' | 'favorite') => {
if (busyAction) return
setBusyAction(action)
try {
await navigator.clipboard.writeText(item.id)
onNotice('作品ID已复制')
} catch {
const textarea = document.createElement('textarea')
textarea.value = item.id
textarea.style.position = 'fixed'
textarea.style.left = '-999999px'
document.body.appendChild(textarea)
textarea.select()
try {
const copied = document.execCommand('copy')
onNotice(copied ? '作品ID已复制' : '作品ID复制失败,请手动复制')
} catch {
onNotice('作品ID复制失败,请手动复制')
} finally {
document.body.removeChild(textarea)
if (action === 'like') {
await onLike(item.id, !item.isLiked)
onNotice(item.isLiked ? '已取消点赞' : '点赞成功')
} else {
await onFavorite(item.id, !item.isFavorited)
onNotice(item.isFavorited ? '已取消收藏' : '收藏成功')
}
} catch (error) {
onNotice(error instanceof Error ? error.message : '操作失败,请稍后重试')
} finally {
setBusyAction(null)
}
}
return (
<li className="min-w-0">
<article className="bg-transparent">
<div className="relative h-[400px] w-full overflow-hidden rounded-[12px] border border-[#e7e8ea] bg-[#f3f4f5]">
<div className="relative h-[400px] w-full overflow-hidden rounded-[12px] border border-[#e7e8ea] bg-white">
{item.previewUrl ? (
<Image
src={item.previewUrl}
alt={`预览图:${item.title}`}
fill
unoptimized
className="object-cover"
className="object-contain object-center"
sizes="(max-width: 639px) 100vw, (max-width: 1279px) 50vw, 33vw"
/>
) : (
@ -97,6 +130,39 @@ function BrandKnowledgeCard({ item, onNotice }: { item: BrandKnowledgeItem; onNo
<Download className="h-3.5 w-3.5" strokeWidth={1.6} aria-hidden="true" />
下载
</a>
<button
type="button"
onClick={() => void handleShare()}
className="inline-flex min-h-10 items-center gap-1.5 rounded-sm text-[#1a1c1d] transition-colors hover:text-[#5a66b8] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[#1a1c1d]/70 focus-visible:ring-offset-2"
aria-label={`分享${item.title}`}
title="分享"
>
<Share2 className="h-3.5 w-3.5" strokeWidth={1.6} aria-hidden="true" />
分享
</button>
<button
type="button"
onClick={() => void handleEngagement('like')}
disabled={busyAction !== null}
aria-pressed={item.isLiked}
aria-label={`${item.isLiked ? '取消点赞' : '点赞'}${item.title}`}
className={`inline-flex min-h-10 items-center gap-1.5 rounded-sm transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[#1a1c1d]/70 focus-visible:ring-offset-2 disabled:cursor-wait disabled:opacity-60 ${item.isLiked ? 'text-[#1a1c1d]' : 'text-[#86898e] hover:text-[#1a1c1d]'}`}
title={item.isLiked ? '取消点赞' : '点赞'}
>
点赞 <span className="font-en text-[12px] tabular-nums tracking-[0.06em]">{item.likeCount}</span>
</button>
<button
type="button"
onClick={() => void handleEngagement('favorite')}
disabled={busyAction !== null}
aria-pressed={item.isFavorited}
aria-label={`${item.isFavorited ? '取消收藏' : '收藏'}${item.title}`}
className={`inline-flex min-h-10 items-center gap-1.5 rounded-sm transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[#1a1c1d]/70 focus-visible:ring-offset-2 disabled:cursor-wait disabled:opacity-60 ${item.isFavorited ? 'text-[#1a1c1d]' : 'text-[#86898e] hover:text-[#1a1c1d]'}`}
title={item.isFavorited ? '取消收藏' : '收藏'}
>
<Heart className="h-3.5 w-3.5" fill={item.isFavorited ? 'currentColor' : 'none'} strokeWidth={1.6} aria-hidden="true" />
{item.isFavorited ? '已收藏' : '收藏'}
</button>
</div>
</div>
</article>
@ -121,6 +187,24 @@ export default function BrandKnowledgeDashboard() {
finally { setIsLoading(false) }
}, [])
useEffect(() => { void loadKnowledge() }, [loadKnowledge])
useEffect(() => {
const sharedKnowledgeId = new URLSearchParams(window.location.search).get('knowledge')?.trim()
if (sharedKnowledgeId) setSearchKeyword(sharedKnowledgeId)
}, [])
const setEngagement = useCallback(async (id: string, action: 'like' | 'favorite', active: boolean) => {
const response = await fetch(`/api/department-dashboard/brand-knowledge/${encodeURIComponent(id)}/${action}`, {
method: 'PUT',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ active }),
})
const payload = await response.json().catch(() => null)
if (!response.ok || !payload?.success) throw new Error(payload?.error || '操作失败,请稍后重试')
setItems((current) => current.map((item) => item.id === id ? {
...item,
...(action === 'like' ? { isLiked: payload.liked, likeCount: payload.likeCount } : { isFavorited: payload.isFavorited }),
} : item))
}, [])
const visibleItems = useMemo(() => { const keyword = searchKeyword.trim().toLowerCase(); return items.filter((item) => (selectedType === '全部' || item.knowledgeType === selectedType) && (!keyword || [item.id, item.title, item.fileName, item.brand, item.productCategoryName, item.uploadedBy].some((value) => value.toLowerCase().includes(keyword)))) }, [items, searchKeyword, selectedType])
@ -215,7 +299,7 @@ export default function BrandKnowledgeDashboard() {
</button>
</div>
{isLoading ? <div className="border-t border-[#e2e8f0] py-24 text-center text-sm text-[#66758b]" role="status">正在读取知识内容…</div> : visibleItems.length > 0 ? <ul className="mt-5 grid grid-cols-1 gap-x-6 gap-y-10 sm:grid-cols-2 xl:grid-cols-3" aria-label="品牌知识内容列表">{visibleItems.map((item) => <BrandKnowledgeCard key={item.id} item={item} onNotice={setNotice} />)}</ul> : <div className="border-t border-[#e2e8f0] py-24 text-center">
{isLoading ? <div className="border-t border-[#e2e8f0] py-24 text-center text-sm text-[#66758b]" role="status">正在读取知识内容…</div> : visibleItems.length > 0 ? <ul className="mt-5 grid grid-cols-1 gap-x-6 gap-y-10 sm:grid-cols-2 xl:grid-cols-3" aria-label="品牌知识内容列表">{visibleItems.map((item) => <BrandKnowledgeCard key={item.id} item={item} onNotice={setNotice} onLike={(id, active) => setEngagement(id, 'like', active)} onFavorite={(id, active) => setEngagement(id, 'favorite', active)} />)}</ul> : <div className="border-t border-[#e2e8f0] py-24 text-center">
<BookOpen className="mx-auto h-8 w-8 text-[#aab5c3]" aria-hidden="true" />
<p className="mt-4 text-base font-semibold text-[#4f6077]">{emptyMessage}</p>
<p className="mt-2 text-sm text-[#8a8f97]">点击右上角“上传知识”,即可将文件保存到品牌知识库。</p>

View File

@ -178,7 +178,7 @@ export default function BrandKnowledgeUploadDialog({ onClose, onUploaded, return
<div className="grid gap-5 sm:grid-cols-2"><label className="block"><span className="mb-2 block text-sm font-semibold text-[#101828]">知识类型</span><select value={knowledgeType} onChange={(event) => setKnowledgeType(event.currentTarget.value)} className="h-11 w-full rounded-lg border border-[#e2e8f0] bg-white px-3 text-sm text-[#101828] outline-none transition-colors focus:border-[#1677ff] focus-visible:ring-2 focus-visible:ring-[#1677ff]/20">{BRAND_KNOWLEDGE_TYPE_OPTIONS.map((option) => <option key={option}>{option}</option>)}</select></label><label className="block"><span className="mb-2 block text-sm font-semibold text-[#101828]">关联品牌 <span className="font-normal text-[#66758b]">(可选)</span></span><select value={brand} onChange={(event) => setBrand(event.currentTarget.value)} className="h-11 w-full rounded-lg border border-[#e2e8f0] bg-white px-3 text-sm text-[#101828] outline-none transition-colors focus:border-[#1677ff] focus-visible:ring-2 focus-visible:ring-[#1677ff]/20">{BRAND_OPTIONS.map((option) => <option key={option}>{option}</option>)}</select></label></div>
<div className="grid gap-5 sm:grid-cols-2"><label className="block"><span className="mb-2 block text-sm font-semibold text-[#101828]">品类 <span className="font-normal text-[#66758b]">(可选)</span></span><select value={productCategoryName} onChange={(event) => setProductCategoryName(event.currentTarget.value)} className="h-11 w-full rounded-lg border border-[#e2e8f0] bg-white px-3 text-sm text-[#101828] outline-none transition-colors focus:border-[#1677ff] focus-visible:ring-2 focus-visible:ring-[#1677ff]/20"><option value="">不选择品类</option>{productCategories.map((category) => <option key={category.id} value={category.name}>{category.name}</option>)}</select><span className="mt-2 block text-xs text-[#8a99ad]">品类列表与素材资产库保持一致</span></label><label className="block"><span className="mb-2 block text-sm font-semibold text-[#101828]">知识标题</span><input type="text" value={title} onChange={(event) => setTitle(event.currentTarget.value)} placeholder="例如:索菲亚新品场景图文规范" className="h-11 w-full rounded-lg border border-[#e2e8f0] bg-white px-3 text-sm text-[#101828] outline-none transition-colors placeholder:text-[#8a99ad] focus:border-[#1677ff] focus-visible:ring-2 focus-visible:ring-[#1677ff]/20" /></label></div>
<section aria-labelledby="brand-knowledge-preview-label"><div className="mb-2 flex items-center justify-between gap-3"><h3 id="brand-knowledge-preview-label" className="text-sm font-semibold text-[#101828]">预览图片 <span className="font-normal text-[#66758b]">(可选)</span></h3>{previewImage && <button type="button" onClick={removePreview} className="text-sm font-semibold text-[#b42318] hover:text-[#8f1d15] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[#b42318] focus-visible:ring-offset-2">移除图片</button>}</div><div onDragEnter={handlePreviewDragEnter} onDragOver={(event) => event.preventDefault()} onDragLeave={handlePreviewDragLeave} onDrop={(event) => { event.preventDefault(); previewDragDepthRef.current = 0; setIsPreviewDragging(false); setPreview(event.dataTransfer.files[0]) }} className={`rounded-xl border border-dashed p-4 transition-colors ${isPreviewDragging ? 'border-[#1677ff] bg-[#e6f4ff]' : 'border-[#cbd5e1] bg-[#f8fafc]'}`}><input ref={previewInputRef} type="file" aria-label="选择预览图片" accept={BRAND_KNOWLEDGE_PREVIEW_IMAGE_ACCEPT} onChange={(event) => setPreview(event.currentTarget.files?.[0])} className="sr-only" />{previewImage && previewUrl ? <div className="flex items-center gap-4"><div className="relative h-28 w-40 shrink-0 overflow-hidden rounded-lg border border-[#e2e8f0] bg-white"><Image src={previewUrl} alt={`预览图:${previewImage.name}`} fill unoptimized className="object-cover" /></div><div className="min-w-0"><p className="break-all text-sm font-semibold text-[#101828]">{previewImage.name}</p><p className="mt-1 text-sm text-[#66758b]">{formatFileSize(previewImage.size)} · 第一张图作为知识卡片预览</p><button type="button" onClick={() => previewInputRef.current?.click()} className="mt-3 inline-flex min-h-10 items-center gap-2 rounded-lg border border-[#cbd5e1] bg-white px-4 text-sm font-semibold text-[#101828] transition-colors hover:bg-[#f2f4f7] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[#1677ff] focus-visible:ring-offset-2"><FolderOpen className="h-4 w-4" aria-hidden="true" />更换图片</button></div></div> : <div className="flex flex-col items-center py-4 text-center"><span className="flex h-10 w-10 items-center justify-center rounded-lg bg-white text-[#247fd3] shadow-sm"><ImagePlus className="h-5 w-5" aria-hidden="true" /></span><p className="mt-3 text-sm font-semibold text-[#101828]">拖放预览图片到这里,或选择图片</p><p className="mt-1 text-sm text-[#66758b]">支持 JPG、PNG、WebP,单张不超过 50MB</p><button type="button" onClick={() => previewInputRef.current?.click()} className="mt-4 inline-flex min-h-10 items-center gap-2 rounded-lg border border-[#cbd5e1] bg-white px-4 text-sm font-semibold text-[#101828] transition-colors hover:bg-[#f2f4f7] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[#1677ff] focus-visible:ring-offset-2"><FolderOpen className="h-4 w-4" aria-hidden="true" />选择图片</button></div>}</div></section>
<section aria-labelledby="brand-knowledge-preview-label"><div className="mb-2 flex items-center justify-between gap-3"><h3 id="brand-knowledge-preview-label" className="text-sm font-semibold text-[#101828]">预览图片 <span className="font-normal text-[#66758b]">(可选)</span></h3>{previewImage && <button type="button" onClick={removePreview} className="text-sm font-semibold text-[#b42318] hover:text-[#8f1d15] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[#b42318] focus-visible:ring-offset-2">移除图片</button>}</div><div onDragEnter={handlePreviewDragEnter} onDragOver={(event) => event.preventDefault()} onDragLeave={handlePreviewDragLeave} onDrop={(event) => { event.preventDefault(); previewDragDepthRef.current = 0; setIsPreviewDragging(false); setPreview(event.dataTransfer.files[0]) }} className={`rounded-xl border border-dashed p-4 transition-colors ${isPreviewDragging ? 'border-[#1677ff] bg-[#e6f4ff]' : 'border-[#cbd5e1] bg-[#f8fafc]'}`}><input ref={previewInputRef} type="file" aria-label="选择预览图片" accept={BRAND_KNOWLEDGE_PREVIEW_IMAGE_ACCEPT} onChange={(event) => setPreview(event.currentTarget.files?.[0])} className="sr-only" />{previewImage && previewUrl ? <div className="flex items-center gap-4"><div className="relative h-28 w-40 shrink-0 overflow-hidden rounded-lg border border-[#e2e8f0] bg-white"><Image src={previewUrl} alt={`预览图:${previewImage.name}`} fill unoptimized className="object-contain object-center" /></div><div className="min-w-0"><p className="break-all text-sm font-semibold text-[#101828]">{previewImage.name}</p><p className="mt-1 text-sm text-[#66758b]">{formatFileSize(previewImage.size)} · 第一张图作为知识卡片预览</p><button type="button" onClick={() => previewInputRef.current?.click()} className="mt-3 inline-flex min-h-10 items-center gap-2 rounded-lg border border-[#cbd5e1] bg-white px-4 text-sm font-semibold text-[#101828] transition-colors hover:bg-[#f2f4f7] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[#1677ff] focus-visible:ring-offset-2"><FolderOpen className="h-4 w-4" aria-hidden="true" />更换图片</button></div></div> : <div className="flex flex-col items-center py-4 text-center"><span className="flex h-10 w-10 items-center justify-center rounded-lg bg-white text-[#247fd3] shadow-sm"><ImagePlus className="h-5 w-5" aria-hidden="true" /></span><p className="mt-3 text-sm font-semibold text-[#101828]">拖放预览图片到这里,或选择图片</p><p className="mt-1 text-sm text-[#66758b]">支持 JPG、PNG、WebP,单张不超过 50MB</p><button type="button" onClick={() => previewInputRef.current?.click()} className="mt-4 inline-flex min-h-10 items-center gap-2 rounded-lg border border-[#cbd5e1] bg-white px-4 text-sm font-semibold text-[#101828] transition-colors hover:bg-[#f2f4f7] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[#1677ff] focus-visible:ring-offset-2"><FolderOpen className="h-4 w-4" aria-hidden="true" />选择图片</button></div>}</div></section>
<section aria-labelledby="brand-knowledge-file-label"><div className="mb-2 flex items-center justify-between gap-3"><h3 id="brand-knowledge-file-label" className="text-sm font-semibold text-[#101828]">知识文件</h3>{selectedFile && <button type="button" onClick={() => setSelectedFile(null)} className="text-sm font-semibold text-[#b42318] hover:text-[#8f1d15] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[#b42318] focus-visible:ring-offset-2">移除文件</button>}</div><div onDragEnter={handleDragEnter} onDragOver={(event) => event.preventDefault()} onDragLeave={handleDragLeave} onDrop={(event) => { event.preventDefault(); dragDepthRef.current = 0; setIsDragging(false); setFile(event.dataTransfer.files[0]) }} className={`rounded-xl border border-dashed p-6 text-center transition-colors sm:p-8 ${isDragging ? 'border-[#1677ff] bg-[#e6f4ff]' : 'border-[#cbd5e1] bg-[#f8fafc]'}`}><input ref={fileInputRef} id="brand-knowledge-file" aria-label="选择知识文件" type="file" accept={BRAND_KNOWLEDGE_MAIN_FILE_ACCEPT} onChange={(event) => setFile(event.currentTarget.files?.[0])} className="sr-only" />{selectedFile ? <div className="flex flex-col items-center"><span className="flex h-10 w-10 items-center justify-center rounded-lg bg-white text-[#087052] shadow-sm"><FileText className="h-5 w-5" aria-hidden="true" /></span><p className="mt-3 max-w-full break-all text-sm font-semibold text-[#101828]">{selectedFile.name}</p><p className="mt-1 text-sm text-[#66758b]">{formatFileSize(selectedFile.size)} · 提交后保存到品牌知识库</p><button type="button" onClick={() => fileInputRef.current?.click()} className="mt-4 inline-flex min-h-10 items-center gap-2 rounded-lg border border-[#cbd5e1] bg-white px-4 text-sm font-semibold text-[#101828] transition-colors hover:bg-[#f2f4f7] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[#1677ff] focus-visible:ring-offset-2"><FolderOpen className="h-4 w-4" aria-hidden="true" />更换文件</button></div> : <div className="flex flex-col items-center"><span className="flex h-10 w-10 items-center justify-center rounded-lg bg-white text-[#247fd3] shadow-sm"><Upload className="h-5 w-5" aria-hidden="true" /></span><p className="mt-3 text-sm font-semibold text-[#101828]">拖放文件到这里,或选择文件</p><p className="mt-1 max-w-xl text-sm text-[#66758b]">支持{BRAND_KNOWLEDGE_MAIN_FILE_LABEL}</p><button type="button" onClick={() => fileInputRef.current?.click()} className="mt-4 inline-flex min-h-10 items-center gap-2 rounded-lg border border-[#cbd5e1] bg-white px-4 text-sm font-semibold text-[#101828] transition-colors hover:bg-[#f2f4f7] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[#1677ff] focus-visible:ring-offset-2"><FolderOpen className="h-4 w-4" aria-hidden="true" />选择文件</button></div>}</div></section>
</div>

View File

@ -2,7 +2,7 @@
## 结论
当前应用发布工具验证十九份目标 migration。普通部署脚本**只读验证,不会自动修改数据库**。只有独立 migrator 在同时拿到精确 Git 提交、数据库身份和备份凭证后,才允许执行 `prisma migrate deploy`。
当前应用发布工具验证二十二份目标 migration。普通部署脚本**只读验证,不会自动修改数据库**。只有独立 migrator 在同时拿到精确 Git 提交、数据库身份和备份凭证后,才允许执行 `prisma migrate deploy`。
目标 migration:
@ -27,6 +27,9 @@
- `20260903_add_work_review_brand`
- `20260908_add_brand_knowledge`
- `20260909_expand_brand_knowledge_upload`
- `20260914_add_brand_knowledge_engagement`
`20260914_add_brand_knowledge_engagement` 只新增品牌知识点赞、收藏关联表及唯一约束、查询索引和级联外键,不改写已有知识内容。
它们新增可空租约字段/索引、修改未来 Logo 默认值、精确把 `system_settings` 品牌两列中的退役 `s3.1080p.hk` 值改为本地品牌图,并把 `materials_uploadId_key` 重建为“`uploadId` 非空且素材未软删除”范围内的唯一 btree 索引;同时新增人员组织树、素材托管字段、素材不完整空壳标记、账号—人员绑定表、钉钉流程快照字段,以及任务详情图片变更审批单和通知 outbox。审批迁移只新增表、约束与索引,不改写现有素材和资产行。`20260829_add_recoverable_api_key_secret` 只新增 `api_keys.secret_ciphertext` / `secret_nonce` / `secret_auth_tag` 三个可空加密列、`api_key_reveal_audits` 审计表和 `api_key_id+created_at`、`viewer_user_id+created_at` 两个非唯一 btree 索引,不回填旧 key。`20260831_add_private_task_detail` 只新增 `materials.task_detail_demand_type`、`materials.task_detail_private default false`、`material_permission_pack_items.can_access_private default false`,并加上 `materials_private_optimization_check`,确保私密任务详情只能落在“任务-详情 + 优化”语义下。`20260902_add_employee_roster_history` 新增员工完整花名册的时间快照表及查询索引,团队产能按每周结束前最近一份快照统计在职人数;不会用当前花名册回填没有快照的历史周。新增 `form_fields` 后会将同步游标重置一次,让下一轮同步完整补齐明细字段。索引迁移会先检测未删除素材中的重复 `uploadId`;人员绑定迁移会先检测一个钉钉身份对应多个账号的冲突。任一预检失败都会直接停止,不会猜测性合并、删除素材或留下一半回填。迁移没有自动 down;执行失败时停止发布,恢复依赖执行前的数据库备份。
@ -43,7 +46,7 @@
1. 构建并固定同一 exact SHA/digest 的 runner 与 migrator;
2. legacy bootstrap `Audit`;
3. legacy bootstrap `Apply`,外部验收 503,确认旧容器停止且保留;
4. 在同一维护窗内运行本文的真实备份、隔离恢复、十九条目标 migration 和迁移后审计;
4. 在同一维护窗内运行本文的真实备份、隔离恢复、二十二条目标 migration 和迁移后审计;
5. 仅在所有门禁通过后,运行普通同 SHA 应用部署。
顺序不得改为“先 migration,后 bootstrap”。本文备份工具的生产前后摘要若有变化,说明维护窗内仍可能存在写入,会直接失败且不生成 receipt。
@ -367,7 +370,7 @@ docker run --rm \
"$MIGRATOR_IMAGE" --apply
```
工具会在修改数据库前先验证审计目录可执行“新建→原子改名→删除”,再依次完成:核对镜像 SHA、配置端口与数据库实际端口、核对机器生成的 receipt 和完整备份产物、拒绝未知待执行/失败 migration、执行 `prisma migrate deploy`,最后核对十九条目标 migration 的数据库 checksum、完成状态、关键人员组织表、素材空壳标记、钉钉流程快照表及需求类型和表单字段、员工花名册历史快照表、字段类型与可空性、`api_keys` 三个可空加密列、`api_key_reveal_audits` 关键列、租约/需求类型/API Key reveal 审计索引的精确列顺序、`materials_uploadId_key` 的唯一性/btree/单列/有效就绪状态/active-only 谓词、Logo 默认值,以及 `materials.task_detail_demand_type` 无默认值、`materials.task_detail_private` / `material_permission_pack_items.can_access_private` 默认值为 `false`,并用稳定语义核对 `materials_private_optimization_check`,确认私密任务详情仍被精确限制在“任务-详情 + 优化”条件下;最后原子写审计 JSON。
工具会在修改数据库前先验证审计目录可执行“新建→原子改名→删除”,再依次完成:核对镜像 SHA、配置端口与数据库实际端口、核对机器生成的 receipt 和完整备份产物、拒绝未知待执行/失败 migration、执行 `prisma migrate deploy`,最后核对二十二条目标 migration 的数据库 checksum、完成状态、关键人员组织表、素材空壳标记、钉钉流程快照表及需求类型和表单字段、员工花名册历史快照表、字段类型与可空性、`api_keys` 三个可空加密列、`api_key_reveal_audits` 关键列、租约/需求类型/API Key reveal 审计索引的精确列顺序、`materials_uploadId_key` 的唯一性/btree/单列/有效就绪状态/active-only 谓词、Logo 默认值,以及 `materials.task_detail_demand_type` 无默认值、`materials.task_detail_private` / `material_permission_pack_items.can_access_private` 默认值为 `false`,并用稳定语义核对 `materials_private_optimization_check`,确认私密任务详情仍被精确限制在“任务-详情 + 优化”条件下;最后原子写审计 JSON。
apply 成功后立即固定审计文件本身;后续“迁移批次部署”读取这一个文件,不能手工重写:
@ -383,7 +386,7 @@ test -n "$MIGRATION_AUDIT_SHA256"
只有以下全部成立,才进入应用首次安全上线步骤:
- `applied.json` 的 `verified=true`;
- 十九条 target migration 均 `completed=true`,source/database checksum 一致;
- 二十二条 target migration 均 `completed=true`,source/database checksum 一致;
- `_prisma_migrations.finished_at` 非空、`rolled_back_at` 为空;
- 视频租约列/索引、任务详情作业租约列/索引、active-only `uploadId` 唯一索引、品牌默认值精确匹配;
- 再次运行 `--audit` 仍通过;

View File

@ -0,0 +1,49 @@
CREATE TABLE "brand_knowledge_likes" (
"id" TEXT NOT NULL,
"knowledge_id" TEXT NOT NULL,
"user_id" TEXT NOT NULL,
"created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
CONSTRAINT "brand_knowledge_likes_pkey" PRIMARY KEY ("id")
);
CREATE TABLE "brand_knowledge_favorites" (
"id" TEXT NOT NULL,
"knowledge_id" TEXT NOT NULL,
"user_id" TEXT NOT NULL,
"created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
CONSTRAINT "brand_knowledge_favorites_pkey" PRIMARY KEY ("id")
);
CREATE UNIQUE INDEX "brand_knowledge_likes_knowledge_id_user_id_key"
ON "brand_knowledge_likes"("knowledge_id", "user_id");
CREATE INDEX "brand_knowledge_likes_knowledge_id_idx"
ON "brand_knowledge_likes"("knowledge_id");
CREATE INDEX "brand_knowledge_likes_user_id_idx"
ON "brand_knowledge_likes"("user_id");
CREATE UNIQUE INDEX "brand_knowledge_favorites_knowledge_id_user_id_key"
ON "brand_knowledge_favorites"("knowledge_id", "user_id");
CREATE INDEX "brand_knowledge_favorites_knowledge_id_idx"
ON "brand_knowledge_favorites"("knowledge_id");
CREATE INDEX "brand_knowledge_favorites_user_id_idx"
ON "brand_knowledge_favorites"("user_id");
ALTER TABLE "brand_knowledge_likes"
ADD CONSTRAINT "brand_knowledge_likes_knowledge_id_fkey"
FOREIGN KEY ("knowledge_id") REFERENCES "brand_knowledge"("id")
ON DELETE CASCADE ON UPDATE CASCADE;
ALTER TABLE "brand_knowledge_likes"
ADD CONSTRAINT "brand_knowledge_likes_user_id_fkey"
FOREIGN KEY ("user_id") REFERENCES "users"("id")
ON DELETE CASCADE ON UPDATE CASCADE;
ALTER TABLE "brand_knowledge_favorites"
ADD CONSTRAINT "brand_knowledge_favorites_knowledge_id_fkey"
FOREIGN KEY ("knowledge_id") REFERENCES "brand_knowledge"("id")
ON DELETE CASCADE ON UPDATE CASCADE;
ALTER TABLE "brand_knowledge_favorites"
ADD CONSTRAINT "brand_knowledge_favorites_user_id_fkey"
FOREIGN KEY ("user_id") REFERENCES "users"("id")
ON DELETE CASCADE ON UPDATE CASCADE;

View File

@ -59,6 +59,8 @@ model User {
submittedTaskDetailChangeRequests TaskDetailChangeRequest[] @relation("TaskDetailChangeRequesterUser")
managedTaskDetailChangeRequests TaskDetailChangeRequest[] @relation("TaskDetailChangeManagerUser")
brandKnowledgeUploads BrandKnowledge[] @relation("BrandKnowledgeUploader")
brandKnowledgeLikes BrandKnowledgeLike[]
brandKnowledgeFavorites BrandKnowledgeFavorite[]
@@index([status])
@@index([archivedAt])
@ -182,6 +184,8 @@ model BrandKnowledge {
createdAt DateTime @default(now()) @map("created_at")
updatedAt DateTime @updatedAt @map("updated_at")
uploader User @relation("BrandKnowledgeUploader", fields: [uploadedBy], references: [id], onDelete: Cascade)
likes BrandKnowledgeLike[]
favorites BrandKnowledgeFavorite[]
@@index([knowledgeType])
@@index([brand])
@ -191,6 +195,34 @@ model BrandKnowledge {
@@map("brand_knowledge")
}
model BrandKnowledgeLike {
id String @id @default(uuid())
knowledgeId String @map("knowledge_id")
userId String @map("user_id")
createdAt DateTime @default(now()) @map("created_at")
knowledge BrandKnowledge @relation(fields: [knowledgeId], references: [id], onDelete: Cascade)
user User @relation(fields: [userId], references: [id], onDelete: Cascade)
@@unique([knowledgeId, userId])
@@index([knowledgeId])
@@index([userId])
@@map("brand_knowledge_likes")
}
model BrandKnowledgeFavorite {
id String @id @default(uuid())
knowledgeId String @map("knowledge_id")
userId String @map("user_id")
createdAt DateTime @default(now()) @map("created_at")
knowledge BrandKnowledge @relation(fields: [knowledgeId], references: [id], onDelete: Cascade)
user User @relation(fields: [userId], references: [id], onDelete: Cascade)
@@unique([knowledgeId, userId])
@@index([knowledgeId])
@@index([userId])
@@map("brand_knowledge_favorites")
}
model ProductPackageUploadJob {
id String @id @default(uuid())
materialId String @map("material_id")

View File

@ -1514,6 +1514,7 @@ const expectedMigrationNames = new Set([
'20260903_add_work_review_brand',
'20260908_add_brand_knowledge',
'20260909_expand_brand_knowledge_upload',
'20260914_add_brand_knowledge_engagement',
]);
if (migrations.length !== expectedMigrationNames.size
|| migrations.some((item) => !expectedMigrationNames.has(item && item.name)

View File

@ -67,6 +67,7 @@ test('migration deployment gate recognizes the latest approved schema migration'
const gate = source.slice(gateStart, gateEnd)
assert.match(gate, /20260831_add_private_task_detail/)
assert.match(gate, /20260908_add_brand_knowledge/)
assert.match(gate, /20260914_add_brand_knowledge_engagement/)
})
test('brand knowledge upload stays bounded in the route and stable proxy', () => {

View File

@ -30,6 +30,7 @@ const TARGET_MIGRATIONS = Object.freeze([
'20260903_add_work_review_brand',
'20260908_add_brand_knowledge',
'20260909_expand_brand_knowledge_upload',
'20260914_add_brand_knowledge_engagement',
])
const VERIFIED_BACKUP_GENERATOR = 'scripts/create-verified-production-backup.mjs'
const VERIFIED_BACKUP_MAINTENANCE_CONFIRMATION = 'NO_WRITES_DURING_SNAPSHOT'
@ -102,6 +103,25 @@ function assertExactCheckConstraint(constraint, expectedTable, expectedName, exp
}
}
function assertExactForeignKeyConstraint(constraint, expectedTable, expectedName, expectedColumn, expectedReferencedTable, expectedReferencedColumn) {
if (
!constraint
|| String(constraint.tablename || '') !== expectedTable
|| String(constraint.constraint_name || '') !== expectedName
|| String(constraint.contype || '') !== 'f'
|| constraint.convalidated !== true
|| String(constraint.referenced_table || '') !== expectedReferencedTable
|| !Array.isArray(constraint.columns)
|| constraint.columns.length !== 1
|| String(constraint.columns[0]) !== expectedColumn
|| !Array.isArray(constraint.referenced_columns)
|| constraint.referenced_columns.length !== 1
|| String(constraint.referenced_columns[0]) !== expectedReferencedColumn
) {
fail(`Database foreign key mismatch: ${expectedName}`)
}
}
function normalizedPort(value) {
const port = String(value || '').trim()
if (!/^\d{1,5}$/.test(port) || Number(port) < 1 || Number(port) > 65535) {
@ -137,6 +157,25 @@ export function assertExactBtreeIndex(indexDefinition, expectedTable, expectedCo
}
}
function assertExactUniqueBtreeIndex(index, expectedTable, expectedName, expectedColumns) {
if (
!index
|| String(index.tablename || '') !== expectedTable
|| String(index.indexname || '') !== expectedName
|| index.indisunique !== true
|| index.indisprimary !== false
|| index.indisvalid !== true
|| index.indisready !== true
|| String(index.access_method || '') !== 'btree'
|| String(index.predicate || '') !== ''
|| !Array.isArray(index.columns)
|| index.columns.length !== expectedColumns.length
|| index.columns.some((column, position) => String(column).replaceAll('"', '') !== expectedColumns[position])
) {
fail(`Database unique index mismatch: ${expectedName}`)
}
}
function normalizedPredicate(value) {
return String(value || '')
.replace(/[()\"]/g, '')
@ -315,7 +354,8 @@ async function queryEvidence(prisma, localMigrations) {
OR (table_name = 'ding_workflow_sync_states' AND column_name IN ('id', 'status', 'source_cursor_raw', 'last_completed_at', 'lease_owner', 'lease_expires_at', 'current_ongoing_count'))
OR (table_name = 'task_detail_change_requests' AND column_name IN ('id', 'material_id', 'requester_user_id', 'manager_dingtalk_user_id', 'status', 'operations', 'base_material_updated_at', 'expires_at'))
OR (table_name = 'task_detail_change_notifications' AND column_name IN ('id', 'request_id', 'event_type', 'business_key', 'status', 'next_retry_at'))
OR (table_name = 'brand_knowledge' AND column_name IN ('id', 'title', 'knowledge_type', 'brand', 'product_category_name', 'file_name', 'file_path', 'mime_type', 'file_size', 'preview_image_name', 'preview_image_path', 'preview_image_mime_type', 'preview_image_size', 'uploaded_by', 'created_at', 'updated_at')))
OR (table_name = 'brand_knowledge' AND column_name IN ('id', 'title', 'knowledge_type', 'brand', 'product_category_name', 'file_name', 'file_path', 'mime_type', 'file_size', 'preview_image_name', 'preview_image_path', 'preview_image_mime_type', 'preview_image_size', 'uploaded_by', 'created_at', 'updated_at'))
OR (table_name IN ('brand_knowledge_likes', 'brand_knowledge_favorites') AND column_name IN ('id', 'knowledge_id', 'user_id', 'created_at')))
ORDER BY table_name, column_name`,
)
const indexes = await prisma.$queryRawUnsafe(
@ -344,6 +384,12 @@ async function queryEvidence(prisma, localMigrations) {
'materials_uploadId_key',
'materials_is_incomplete_shell_idx',
'brand_knowledge_product_category_name_idx',
'brand_knowledge_likes_knowledge_id_user_id_key',
'brand_knowledge_likes_knowledge_id_idx',
'brand_knowledge_likes_user_id_idx',
'brand_knowledge_favorites_knowledge_id_user_id_key',
'brand_knowledge_favorites_knowledge_id_idx',
'brand_knowledge_favorites_user_id_idx',
'product_package_upload_jobs_lease_idx',
'ding_workflow_snapshots_ongoing_updated_idx',
'ding_workflow_snapshots_brand_idx',
@ -363,6 +409,7 @@ async function queryEvidence(prisma, localMigrations) {
con.conname AS constraint_name,
con.contype::text AS contype,
con.convalidated,
ref.relname AS referenced_table,
ARRAY(
SELECT att.attname
FROM unnest(con.conkey) WITH ORDINALITY AS keys(attnum, ordinal)
@ -371,12 +418,27 @@ async function queryEvidence(prisma, localMigrations) {
AND att.attnum = keys.attnum
ORDER BY keys.ordinal
) AS columns,
ARRAY(
SELECT att.attname
FROM unnest(con.confkey) WITH ORDINALITY AS keys(attnum, ordinal)
JOIN pg_attribute att
ON att.attrelid = con.confrelid
AND att.attnum = keys.attnum
ORDER BY keys.ordinal
) AS referenced_columns,
pg_get_expr(con.conbin, con.conrelid, true) AS expression
FROM pg_constraint con
JOIN pg_class cls ON cls.oid = con.conrelid
LEFT JOIN pg_class ref ON ref.oid = con.confrelid
JOIN pg_namespace ns ON ns.oid = cls.relnamespace
WHERE ns.nspname = current_schema()
AND con.conname IN ('materials_private_optimization_check')
AND con.conname IN (
'materials_private_optimization_check',
'brand_knowledge_likes_knowledge_id_fkey',
'brand_knowledge_likes_user_id_fkey',
'brand_knowledge_favorites_knowledge_id_fkey',
'brand_knowledge_favorites_user_id_fkey'
)
ORDER BY con.conname`,
)
const brandRows = await prisma.$queryRawUnsafe(
@ -448,6 +510,12 @@ export function assertTargetMigrationEvidence(localMigrations, evidence) {
requireColumn('brand_knowledge', 'uploaded_by', 'text', 'NO')
requireColumn('brand_knowledge', 'created_at', 'timestamp without time zone', 'NO')
requireColumn('brand_knowledge', 'updated_at', 'timestamp without time zone', 'NO')
for (const table of ['brand_knowledge_likes', 'brand_knowledge_favorites']) {
requireColumn(table, 'id', 'text', 'NO')
requireColumn(table, 'knowledge_id', 'text', 'NO')
requireColumn(table, 'user_id', 'text', 'NO')
requireColumn(table, 'created_at', 'timestamp without time zone', 'NO')
}
requireColumn('task_detail_change_requests', 'status', 'text', 'NO')
requireColumn('task_detail_change_requests', 'operations', 'jsonb', 'NO')
requireColumn('task_detail_change_requests', 'base_material_updated_at', 'timestamp without time zone', 'NO')
@ -570,6 +638,16 @@ export function assertTargetMigrationEvidence(localMigrations, evidence) {
'brand_knowledge',
['product_category_name'],
)
for (const table of ['brand_knowledge_likes', 'brand_knowledge_favorites']) {
assertExactUniqueBtreeIndex(
evidence.indexes.find((row) => String(row.indexname) === `${table}_knowledge_id_user_id_key`),
table,
`${table}_knowledge_id_user_id_key`,
['knowledge_id', 'user_id'],
)
assertExactBtreeIndex(indexByName.get(`${table}_knowledge_id_idx`), table, ['knowledge_id'])
assertExactBtreeIndex(indexByName.get(`${table}_user_id_idx`), table, ['user_id'])
}
assertExactBtreeIndex(
indexByName.get('ding_workflow_snapshots_ongoing_updated_idx'),
'ding_workflow_snapshots',
@ -627,6 +705,24 @@ export function assertTargetMigrationEvidence(localMigrations, evidence) {
['materialType', 'task_detail_demand_type', 'task_detail_private'],
`NOT task_detail_private OR ((materialType = '任务-详情' AND task_detail_demand_type = '优化') IS TRUE)`,
)
for (const table of ['brand_knowledge_likes', 'brand_knowledge_favorites']) {
assertExactForeignKeyConstraint(
(evidence.constraints || []).find((row) => String(row.constraint_name) === `${table}_knowledge_id_fkey`),
table,
`${table}_knowledge_id_fkey`,
'knowledge_id',
'brand_knowledge',
'id',
)
assertExactForeignKeyConstraint(
(evidence.constraints || []).find((row) => String(row.constraint_name) === `${table}_user_id_fkey`),
table,
`${table}_user_id_fkey`,
'user_id',
'users',
'id',
)
}
const isTrustedBrandValue = (value, localDefault) => {
const normalized = String(value || '').trim()

View File

@ -346,6 +346,7 @@ test('target evidence rejects nullable logo columns and structurally wrong index
['20260903_add_work_review_brand', { checksum: 's' }],
['20260908_add_brand_knowledge', { checksum: 't' }],
['20260909_expand_brand_knowledge_upload', { checksum: 'u' }],
['20260914_add_brand_knowledge_engagement', { checksum: 'v' }],
])
const evidence = {
migrationRows: [
@ -370,6 +371,7 @@ test('target evidence rejects nullable logo columns and structurally wrong index
{ migration_name: '20260903_add_work_review_brand', checksum: 's', finished_at: 'now', rolled_back_at: null },
{ migration_name: '20260908_add_brand_knowledge', checksum: 't', finished_at: 'now', rolled_back_at: null },
{ migration_name: '20260909_expand_brand_knowledge_upload', checksum: 'u', finished_at: 'now', rolled_back_at: null },
{ migration_name: '20260914_add_brand_knowledge_engagement', checksum: 'v', finished_at: 'now', rolled_back_at: null },
],
columns: [
{ table_name: 'materials', column_name: 'transcode_lease_token', data_type: 'text', is_nullable: 'YES' },
@ -469,6 +471,12 @@ test('target evidence rejects nullable logo columns and structurally wrong index
{ table_name: 'brand_knowledge', column_name: 'uploaded_by', data_type: 'text', is_nullable: 'NO' },
{ table_name: 'brand_knowledge', column_name: 'created_at', data_type: 'timestamp without time zone', is_nullable: 'NO' },
{ table_name: 'brand_knowledge', column_name: 'updated_at', data_type: 'timestamp without time zone', is_nullable: 'NO' },
...['brand_knowledge_likes', 'brand_knowledge_favorites'].flatMap((table_name) => [
{ table_name, column_name: 'id', data_type: 'text', is_nullable: 'NO' },
{ table_name, column_name: 'knowledge_id', data_type: 'text', is_nullable: 'NO' },
{ table_name, column_name: 'user_id', data_type: 'text', is_nullable: 'NO' },
{ table_name, column_name: 'created_at', data_type: 'timestamp without time zone', is_nullable: 'NO' },
]),
{ table_name: 'system_settings', column_name: 'headerLogoUrl', data_type: 'text', is_nullable: 'NO', column_default: "'/brand/header-logo.png'::text" },
{ table_name: 'system_settings', column_name: 'loginLogoUrl', data_type: 'text', is_nullable: 'NO', column_default: "'/brand/login-logo.png'::text" },
{ table_name: 'system_settings', column_name: 'logoUrl', data_type: 'text', is_nullable: 'NO', column_default: "'/brand/header-logo.png'::text" },
@ -500,15 +508,53 @@ test('target evidence rejects nullable logo columns and structurally wrong index
{ indexname: 'api_key_reveal_audits_api_key_id_created_at_idx', indexdef: 'CREATE INDEX api_key_reveal_audits_api_key_id_created_at_idx ON public.api_key_reveal_audits USING btree (api_key_id, created_at)' },
{ indexname: 'api_key_reveal_audits_viewer_user_id_created_at_idx', indexdef: 'CREATE INDEX api_key_reveal_audits_viewer_user_id_created_at_idx ON public.api_key_reveal_audits USING btree (viewer_user_id, created_at)' },
{ indexname: 'brand_knowledge_product_category_name_idx', indexdef: 'CREATE INDEX brand_knowledge_product_category_name_idx ON public.brand_knowledge USING btree (product_category_name)' },
...['brand_knowledge_likes', 'brand_knowledge_favorites'].flatMap((table) => [
{
tablename: table,
indexname: `${table}_knowledge_id_user_id_key`,
indexdef: `CREATE UNIQUE INDEX ${table}_knowledge_id_user_id_key ON public.${table} USING btree (knowledge_id, user_id)`,
indisunique: true,
indisprimary: false,
indisvalid: true,
indisready: true,
access_method: 'btree',
columns: ['knowledge_id', 'user_id'],
predicate: '',
},
{ indexname: `${table}_knowledge_id_idx`, indexdef: `CREATE INDEX ${table}_knowledge_id_idx ON public.${table} USING btree (knowledge_id)` },
{ indexname: `${table}_user_id_idx`, indexdef: `CREATE INDEX ${table}_user_id_idx ON public.${table} USING btree (user_id)` },
]),
],
constraints: [
{
tablename: 'materials',
constraint_name: 'materials_private_optimization_check',
contype: 'c',
convalidated: true,
columns: ['task_detail_private', 'materialType', 'task_detail_demand_type'],
expression: `((NOT task_detail_private) OR (((materialType = '任务-详情'::text) AND (task_detail_demand_type = '优化'::text)) IS TRUE))`,
},
...['brand_knowledge_likes', 'brand_knowledge_favorites'].flatMap((table) => [
{
tablename: table,
constraint_name: `${table}_knowledge_id_fkey`,
contype: 'f',
convalidated: true,
columns: ['knowledge_id'],
referenced_table: 'brand_knowledge',
referenced_columns: ['id'],
},
{
tablename: table,
constraint_name: `${table}_user_id_fkey`,
contype: 'f',
convalidated: true,
columns: ['user_id'],
referenced_table: 'users',
referenced_columns: ['id'],
},
]),
],
constraints: [{
tablename: 'materials',
constraint_name: 'materials_private_optimization_check',
contype: 'c',
convalidated: true,
columns: ['task_detail_private', 'materialType', 'task_detail_demand_type'],
expression: `((NOT task_detail_private) OR (((materialType = '任务-详情'::text) AND (task_detail_demand_type = '优化'::text)) IS TRUE))`,
}],
brandRows: [
{ id: 'local', headerLogoUrl: '/brand/header-logo.png', loginLogoUrl: '/brand/login-logo.png' },
{ id: 'custom', headerLogoUrl: 'https://s3.jiansun.vip/gongxiangpan/header.png', loginLogoUrl: 'https://s3.jiansun.vip/gongxiangpan/login.png' },
@ -718,6 +764,7 @@ test('container supply chain and migrator image are immutable while SOP keeps co
'20260903_add_work_review_brand',
'20260908_add_brand_knowledge',
'20260909_expand_brand_knowledge_upload',
'20260914_add_brand_knowledge_engagement',
]) {
assert.match(dockerfile, new RegExp(migrationName))
assert.match(migratorSource, new RegExp(`'${migrationName}'`))
@ -737,6 +784,8 @@ test('container supply chain and migrator image are immutable while SOP keeps co
assert.ok(sop.includes('`20260908_add_brand_knowledge`'))
assert.match(deploymentSource, /'20260909_expand_brand_knowledge_upload'/)
assert.ok(sop.includes('`20260909_expand_brand_knowledge_upload`'))
assert.match(deploymentSource, /'20260914_add_brand_knowledge_engagement'/)
assert.ok(sop.includes('`20260914_add_brand_knowledge_engagement`'))
const indexesQueryStart = migratorSource.indexOf('const indexes = await prisma.$queryRawUnsafe(')
const indexesQueryEnd = migratorSource.indexOf('const constraints = await prisma.$queryRawUnsafe(', indexesQueryStart)
assert.ok(indexesQueryStart >= 0)
@ -745,6 +794,10 @@ test('container supply chain and migrator image are immutable while SOP keeps co
migratorSource.slice(indexesQueryStart, indexesQueryEnd),
/'brand_knowledge_product_category_name_idx'/,
)
assert.match(
migratorSource.slice(indexesQueryStart, indexesQueryEnd),
/'brand_knowledge_likes_knowledge_id_user_id_key'/,
)
assert.match(sop, /materials_private_optimization_check/)
assert.match(sop, /task_detail_private/)
assert.match(sop, /can_access_private/)
@ -812,8 +865,8 @@ test('container supply chain and migrator image are immutable while SOP keeps co
assert.match(sop, /-v "\$HOST_RESULT_DIR:\/audit"/)
assert.match(sop, /test -f "\$PREFLIGHT_AUDIT_FILE" && test ! -L "\$PREFLIGHT_AUDIT_FILE"/)
assert.doesNotMatch(sop, /-v \/root\/gongxiangp2-migration-audit:\/audit/)
assert.match(sop, /十九份目标 migration/)
assert.match(sop, /十九条目标 migration/)
assert.match(sop, /二十二份目标 migration/)
assert.match(sop, /二十二条目标 migration/)
const applyMigration = migratorSource.indexOf("['migrate', 'deploy'")
const postEvidence = migratorSource.indexOf('after = await queryEvidence(verifyClient, localMigrations)', applyMigration)