QiuQiuTech 是一个面向品牌方、市场人、营销从业者、代理公司与独立操盘手的营销行业平台。
它不是传统资讯站、论坛或招聘站,而是一个:
以结构化内容为入口、以投稿审核为增长机制、以合作撮合为差异化价值的营销行业平台。
- 克隆
git clone https://github.com/alexll000/QiuQiuTech.git cd QiuQiuTech - 前台:进入
web/,复制环境模板并安装依赖(仓库内不包含node_modules):浏览器打开 http://localhost:3000。cd web cp .env.example .env.local # 按文件内注释填写 DIRECTUS 地址与令牌;详见下方文档链接 npm install npm run dev
- 后台(Directus + PostgreSQL):见
cms/README.md,常用命令:Directus:http://localhost:8055。可与任意路径的前端工程共用同一套 Docker,只需前端cd cms cp .env.example .env # 若尚无 .env docker compose up -d
.env.local指向同一地址。 - (可选)导入营销热度起始数据:仓库自带
cms/seed/submissions.seed.json,配置好 Directus 鉴权后可执行node scripts/seed/import-submissions-seed.mjs—— 详见 cms/seed/README.md。仅向数据库插入初始submissions行,不会把前端写成静态;持续更新仍靠抓取或后台录入。不导入也可运行,但趋势可能较空。 - 更长步骤与排障(换电脑、端口占用、营销热度无数据等):docs/setup-from-scratch.md。
- 营销热度趋势:业务文档 docs/features/marketing-heat-trend.md;技术栈 / 配置与数据源索引 docs/features/marketing-heat-trend-tech-and-sources.md;源码清单 docs/features/marketing-heat-trend-module-inventory.md。
说明:web/.env.local、cms/.env 含密钥,不会提交到 Git;他人克隆后须自行从 .env.example 生成并填写。根目录 data.db 为空占位文件,已被忽略,可不拷贝,不影响运行。
当前最新开发交接真值源:
- docs/Latest-conversation-brief.md(最短接棒入口)
- docs/ai-handoff.md
- docs/current-build-status.md
- docs/todo-live.md(任务拆分与状态真值源)
- docs/ui-workbench.md(前端体验工作台与 Storybook 工作流)
- docs/setup-from-scratch.md(换电脑从零搭建、与同机共用 Docker)
当前仓库已经完成的是:
- 一套可运行的前台站点框架
- 首页高保真方向稿
- 内容中心 / 合作对接 / 投稿中心的高保真 UI 方向稿
- 首页与核心频道页 SEO 元数据基础层
- 登录 / 用户中心 / 后台入口高保真骨架
- 基础内容详情 / 专题详情 / 合作详情演示数据
- 投稿草稿表单(可保存草稿)
- 合作申请表单(可提交申请)
- Directus 写入链路的鉴权与落库骨架(草稿与申请)
当前还没有完成的是:
- 真实后端 API
- Directus collections 与真实数据库落地
- 更完整的审核审计、权限细粒度与真实账号体系
- 抓取任务中心持久化与后台人工处理动作
- 合作申请的后台审核深化与联系方式保护策略落库
也就是说,现在是“可继续正式开发的产品框架阶段”,不是最终可上线版本。
当前后台相关开发已经到达:
- Directus 本地实例可启动、可登录
- 最小业务集合已完成本地初始化
- 后台品牌资源与中文语言基线已对齐
- 后台基础角色/策略基线已可脚本化初始化
/admin最小审核台已可用/admin抓取报告最小可视化已可用
当前后台“真实接通”和“静态占位”的边界是:
- 真实接通:投稿/合作审核队列读取、审核动作、抓取批次报告读取、导入摘要读取
- 静态占位:顶部运行状态卡、左侧大部分导航、展示位运营卡、运营备注、用户/认证/统计等模块入口
这意味着当前后台不是“开发偏了”,而是只完成了第一阶段最小运营闭环。
当前后台仍未完成:
- 真正的账号体系与操作者身份
- 更完整的审核审计与权限细粒度
- 抓取任务中心持久化与人工处理动作
- 展示位、标签、用户、认证、统计等后台模块的真实数据接入
- 将 Directus 初始化继续扩展到集合、字段与种子数据脚本
- Next.js 16
- React 19
- TypeScript
- Tailwind CSS v4
- App Router
- Storybook 10(frontend experience workbench)
- shadcn-compatible primitives(渐进接入)
设计规范(最新):
- docs/QiuQiuTech-design-system-v1.md — 包含阴影系统风格 A(深色投影浮起)、色彩、字体、圆角、动效等全量 token
当前代码集中在:
QiuQiuTech/
├─ cms/ # Directus 后台骨架与本地启动文件
├─ docs/ # 项目说明、brief、设计与交接文档
└─ web/ # 当前实际开发中的前台工程
QiuQiuTech 当前围绕三条主线展开:
- 营销内容
- 用户投稿并审核发布
- 品牌 / 市场人合作对接
当前前台一级导航已经对齐为:
- 首页
- 营销内容
- 营销事件
- 营销玩法
- 专题策展
- 合作对接
- 我要投稿
- 榜单趋势
- 登录 / 用户中心
QiuQiuTech 最终是一个对外公开发布的 Web 平台。
这意味着后续开发默认要按这些标准推进:
- 前台可公开访问
- 内容与专题页可索引
- 后台独立登录管理
- 站点支持 SEO 与内容发布
- 前后台职责分离
以下规则是当前仓库的系统级硬约束,后续前台开发默认必须遵守:
- 公开前台禁止暴露开发态、测试态、联调态、内部态信息。
- 登录、注册、账号与会话相关页面必须按用户任务组织,不按技术实现组织。
- 禁止把
mock、fallback、admin-mock、会话 ID、账号标识、体验账号这类内部语义直接展示给 C 端用户。 - 技术兜底可以存在于代码和服务层,但不能成为用户界面的说明内容。
- 已完成登录或已进入某状态的用户,应优先跳转或弱提示,不应让状态说明主导界面。
这条约束的直接背景是:公开前台曾出现开发语境泄漏与账户信息架构混乱问题,现已上升为长期执行规则,而不是一次性页面修补。
已存在的核心页面:
//contents/events/playbooks/topics/requests/submit/rankings/auth/me/admin
已存在的演示详情页:
/contents/[slug]/topics/[slug]/requests/[slug]
当前设计方向由以下约束主导:
- 高级感优先,这是当前最高设计约束
- 高级
- 简约
- 时尚
- 专业
- 内容平台优先,不做传统门户感
- 配色围绕 logo 的深蓝、青绿、暖黄
视觉参考来源包括:
- SocialBeta:整体调性、简洁和内容气质
- React Bits:局部动态效果与品牌化视觉增强
- 用户提供的首页拼贴 UI:作为版式方向,不直接照抄
- 用户补充的内容中心 / 趋势图 / 投稿页 / 合作页参考图:用于约束页面结构、比例和筛选布局
当前仓库里真正可运行的是 web/。
后台路线已经明确为 Directus。
当前仓库已补入:
cms/.env.examplecms/docker-compose.ymlcms/README.md
结论是:前台继续保留 Next.js,后台进入 Directus 路线推进。
进入前端工程:
cd web
npm install
npm run dev默认本地地址:
- http://localhost:3000
- Directus 后台:http://localhost:8055
常用检查命令:
cd web
npm run lint
npm run build
npm run storybook
npm run build-storybook前端体验开发约定(新增):
- 不再只在页面里直接堆样式;关键 UI 模块先进入
web的 Storybook workbench 再回接页面。
8000
web/components.json、web/src/lib/utils.ts和web/src/components/ui/*现在是后续基础组件扩展入口。- 公开前台的重要状态至少要能在 Storybook 里单独审:默认态、长文案态、空态、移动端可读性。
- 首页、列表页、详情页、登录页等关键页面不只审视觉,还要审信息层级、用户路径和 CTA 主次。
当前这套体系在仓库内统一命名为:
QiuQiuTech Frontend Experience Workbench
如果要给其他 AI 交接,请直接说明:
- 当前前端统一走
QiuQiuTech Frontend Experience Workbench - 先 Storybook,后页面
- 先 primitives,后业务模块
- 不要在页面里临时发明一套新 UI
- 不只管 UI,还要一起处理页面结构、状态设计、CTA 主次和用户路径
- 关键公开前台模块至少补默认态、长文案态、空态/弱数据态、移动端可读性
最后更新:2026-05-09(本轮)
本轮额外完成了一项系统级纠偏:
- 已将“公开前台不得暴露内部开发状态,账户流程必须按用户任务组织”写入
docs/engineering-rules.md、docs/ui-governance.md、docs/ai-collaboration-protocol.md,并同步到本文档与前端 README,后续开发默认按该原则执行。 - 首页 Hero 联调已继续推进:麦当劳案例位已从静态大卡改为真实轮播,采用浮动箭头切换;标签与说明层级已按“一个主类型 + 两个以内主题标签 + 一句辅助说明”收口,并继续向
/auth的品牌引导区 + 任务面板语言系统对齐。 - 前端体验工作台已接入:
web/新增 Storybook 10、shadcn-compatible 基础配置、品牌 token story、按钮 primitive story 与平台模式 story,后续前端改动不再只靠页面临场拼装。
本轮补齐了两条“可真实落库”的关键用户动作(支持灰度回退,保证前台不崩):
- 投稿保存草稿
- 页面:
/submit - API:
POST /api/submissions/drafts - Directus 落库(开启
NEXT_PUBLIC_USE_DIRECTUS=true且配置鉴权后):创建submissions(status=draft)
- 页面:
- 合作申请提交
- 页面:
/requests/[slug] - API:
POST /api/requests/[slug]/apply - Directus 落库:先按
slug查partnership_requests,再创建match_applications(status=pending)
- 页面:
并在后续补齐了另外两条动作:
-
收藏切换
- 页面:
/contents/[slug]的收藏按钮已带targetType/targetId/title/href - API:
POST /api/me/saved-items/toggle - Directus 落库:优先按
user_id + target_type + target_id查重,存在则删除(取消收藏),不存在则创建
- 页面:
-
通知全部已读
- 页面:
/me通知中心按钮 - API:
POST /api/me/notifications/read - Directus 落库:读取当前用户未读通知后逐条更新
is_read=true
- 页面:
-
用户中心多集合聚合读取(新增)
- 服务:
web/src/lib/account-service.ts - 优先读取
user_dashboard单例;若不存在则自动聚合:user_profilessubmissionssaved_itemsmatch_applicationsnotifications
- 聚合失败时继续回退 mock,保证
/me可用
- 服务:
-
合作需求发布草稿(新增)
- 页面:
/requests左侧新增“发布合作需求(草稿)”表单 - API:
POST /api/requests/drafts - Directus 落库:创建
partnership_requests的draft记录(自动生成 slug) - 失败时 fallback:mock 成功返回,保证单人运营流程不中断
- 页面:
-
最小登录会话层(新增)
- API:
POST /api/auth/session、DELETE /api/auth/session - 能力:写入/清理
qqt_uidcookie,并让/api/me/*与动作写链路优先使用请求用户 ID - 前台:
/auth登录按钮已接会话接口,登录后跳转/me;/me已接退出登录按钮
- API:
-
抓取管道 MVP(第一阶段,新增)
- 脚本:
scripts/crawl/fetch-url-to-json.mjs(单链接抓取并结构化)scripts/crawl/fetch-batch-from-list.mjs(按来源列表批量抓取)scripts/crawl/crawl-report-utils.mjs(质量评分与来源健康度汇总)scripts/import/import-submissions-to-directus.mjs(导入 Directussubmissions待审核池)scripts/import/retry-failed-imports.mjs(失败导入回放重试)scripts/sync/crawl-and-import.mjs(抓取+导入一键执行)scripts/sync/run-crawl-cron.sh(定时任务入口)scripts/sync/notify-failures.mjs(失败告警 webhook)
- 去重:导入前按
external_link+title去重 - 限速:批量抓取支持
--delayMs(默认 1200ms) - 质量评分:单条抓取结果新增
quality.score / grade / warnings - 健康度统计:批量抓取输出
_batch-report.json,导入输出_import-report.json - 失败队列:导入失败可输出到
--failLog(默认tmp/crawl-failures.json) - 样例来源:
scripts/crawl/sources.sample.txt - 实测:已导入
submissions.id=4/5,重复内容可跳过
- 脚本:
-
后台审核增强(并行子任务,已完成)
- API:
POST /api/admin/submissions/[id]/review、POST /api/admin/requests/[id]/review - 能力:审核动作会从请求 cookie 读取
qqt_uid作为reviewed_by,不再固定写入admin-mock - 前端:
/admin审核队列已支持批量通过/拒绝、驳回原因、审核说明展示、中文操作日志,并消费后端返回的reviewedBy/reviewedAt/reviewNote
- API:
抓取脚本快速用法:
node scripts/crawl/fetch-url-to-json.mjs --url=https://socialbeta.com/ --out=tmp/crawl/one.json
node scripts/crawl/fetch-batch-from-list.mjs --list=scripts/crawl/sources.sample.txt --outDir=tmp/crawl
DIRECTUS_ADMIN_EMAIL=admin@qiuqiutech.com DIRECTUS_ADMIN_PASSWORD=ChangeThisAdminPassword123! NEXT_PUBLIC_DIRECTUS_URL=http://127.0.0.1:8055 node scripts/sync/crawl-and-import.mjs --list=scripts/crawl/sources.sample.txt --outDir=tmp/crawl-sync
DIRECTUS_ADMIN_EMAIL=admin@qiuqiutech.com DIRECTUS_ADMIN_PASSWORD=ChangeThisAdminPassword123! node scripts/import/import-submissions-to-directus.mjs --inDir=tmp/crawl-sync --baseUrl=http://127.0.0.1:8055 --failLog=tmp/crawl-failures.json
DIRECTUS_ADMIN_EMAIL=admin@qiuqiutech.com DIRECTUS_ADMIN_PASSWORD=ChangeThisAdminPassword123! scripts/sync/run-crawl-cron.sh scripts/crawl/sources.sample.txt tmp/crawl-cron crawler-bot
DIRECTUS_ADMIN_EMAIL=admin@qiuqiutech.com DIRECTUS_ADMIN_PASSWORD=ChangeThisAdminPassword123! node scripts/import/retry-failed-imports.mjs --failLog=tmp/crawl-failures.json --sourceDir=tmp/crawl-sync --retryDir=tmp/crawl-retry
QQT_CRAWL_ALERT_WEBHOOK=https://example.com/webhook node scripts/sync/notify-failures.mjs --failLog=tmp/crawl-failures.json新增 Directus 写入鉴权封装:
web/src/lib/directus-auth.ts- 优先使用
DIRECTUS_STATIC_TOKEN;否则用DIRECTUS_ADMIN_EMAIL/DIRECTUS_ADMIN_PASSWORD调/auth/login获取 token(带缓存) - 已增加请求超时保护(6 秒),避免 Directus 不可达时页面长期阻塞
- 优先使用
补充稳定性修复(2026-05-08):
web/src/lib/cms-client.ts已增加 CMS 读取超时保护(6 秒)与失败快速 fallbackweb/src/lib/directus-auth.ts已增加登录/鉴权请求超时保护(6 秒)- 目的:避免首页 SSR 因上游不可达而持续 loading,保证 tab 可正常跳转
新增环境变量(见 web/.env.example):
NEXT_PUBLIC_USE_DIRECTUS=trueNEXT_PUBLIC_DIRECTUS_URL=http://localhost:8055DIRECTUS_STATIC_TOKEN=...(或 admin 邮箱/密码)QIUQIUTECH_CURRENT_USER_ID=me(当前未接真实登录态,写入用占位 user id)
本地验证方式(Directus 模式):
- 启动
cms/的 Directus(见cms/README.md) - 在 Directus 建好
submissions、partnership_requests、match_applications的核心字段(见docs/data-model.md) - 打开
NEXT_PUBLIC_USE_DIRECTUS=true并配置鉴权 - 访问:
/submit保存草稿 →submissions出现新draft/requests/brand-looking-for-popup-cocreation-team提交申请 →match_applications出现新pending
当前前端已经预置:
- 首页与频道页
title / description / keywords - canonical / Open Graph / Twitter metadata
robots.tssitemap.ts- 站点级 JSON-LD 结构化数据
- 标签展示按内容发布时写入的数据动态渲染,只有栏目类型这类 taxonomy 保持固定
web/src/
├─ app/
│ ├─ page.tsx # 首页
│ ├─ contents/ # 营销内容
│ ├─ events/ # 营销事件
│ ├─ playbooks/ # 营销玩法
│ ├─ topics/ # 专题策展
│ ├─ requests/ # 合作对接
│ ├─ submit/ # 我要投稿
│ ├─ rankings/ # 榜单趋势
│ ├─ auth/ # 登录
│ ├─ me/ # 用户中心
│ └─ admin/ # 后台入口骨架
├─ components/
│ ├─ site-shell.tsx # 全站导航、页脚、基础壳层
│ └─ platform-ui.tsx # 平台级页面骨架组件
└─ lib/
└─ site-data.ts # 当前演示数据与页面结构数据
建议后续接手严格按这个顺序推进:
- 固化信息架构与页面模块
- 抽离真实数据模型
- 确认后台底座方案
- 建 Directus collections / PostgreSQL
- 接内容系统
- 接投稿系统
- 接合作对接系统
- 接后台审核流
- 接抓取导入
- 最后再做 SEO、搜索、数据统计与体验细修
QiuQiuTech_Full_Development_Brief_v2.md(外部文件,建议放到仓库docs/brief/后再引用)- docs/ai-handoff.md
- docs/README.md
- web/README.md
- cms/README.md
- docs/deployment-plan.md
- docs/seo-content-publishing.md
- docs/directus-initialization-checklist.md
- docs/directus-collections-matrix.md
- 当前
docs/下有一批早期 v1 文档,它们仍有参考价值,但不能作为当前实现的最终真值源 - 当前真实实现以:
- 最新用户要求
QiuQiuTech_Full_Development_Brief_v2.md- 当前
web/src/代码状态 为准
- 现在还不是 monorepo,也还没拆成
web / admin / api三层工程,只是先把前台平台框架跑起来了 - 以后每次同步 Git,默认需要同步更新
docs/ai-handoff.md,把最新进展、当前状态、下一步和整体规划一起提交
- 不要把
docs/todo-live.md以外的文件当任务真值源。任务状态冲突时,只能以todo-live为准并同轮纠偏文档。 - 不要删除现有 fallback 机制(
source=directus/fallback+reason)。在 T07/T08 未完成前,fallback 是生产可用性的保护层。 - 不要绕过现有 SQL bootstrap 方案去强依赖
/collectionsAPI。当前已知该接口权限存在FORBIDDEN,会阻塞联调节奏。 - 不要把标签、趋势词、合作标签写死到页面常量。标签必须优先来自发布数据或 CMS 返回。
- 不要在未接真实认证前把
QIUQIUTECH_CURRENT_USER_ID相关兜底逻辑删掉。现阶段会话层是过渡态,删兜底会直接导致动作链路不可用。 - 不要在未完成审核流字段对齐前重构
submissions/partnership_requests字段名。字段漂移会破坏已有 5 条写链路 smoke。 - 不要只改代码不更新文档。每轮必须同步
README.md、web/README.md、docs/ai-handoff.md、docs/current-build-status.md、docs/README.md。 - 不要在未验证前宣称“可上线”。至少需要
npm --prefix web run lint、npm --prefix web run build、web/scripts/e2e-actions-smoke.sh三项通过。
后续任何 AI 接手后,每轮提交必须同时满足:
- 回报格式固定四段:
- 本轮完成
- 验证结果(命令 + 关键输出)
- 文档同步清单
- 下一步
- 文档必更清单:
docs/todo-live.mdREADME.mdweb/README.mddocs/current-build-status.mddocs/ai-handoff.mddocs/README.md(追加流水)
- 若本轮有联调或回归,必须更新:
docs/e2e-validation-log.md - 文档路径必须通过可移植性校验:
scripts/check-doc-portability.sh - 建议执行一键校验:
scripts/validate-handoff.sh
执行契约文档(建议接手前先读):
下一阶段最值得直接推进的是两件事:
- 起 Directus 本地实例并建立核心 collections
- 把前台演示数据换成真实 schema 与服务端数据流
在这之后建议立刻推进:
- 后台审核流(
draft -> pending_review -> approved/published)接口与最小运营面板 - 用户中心
/me继续细化 Directus 字段映射(公司、认证、状态文案、时间格式) - 再开始抓取 scripts 层(避免写入与审核未稳定就进入抓取复杂度)
按顺序执行即可:
- 起 CMS 并校验集合(状态:
⏳ 进行中)- 启动
cms/(Directus + PostgreSQL) - 确认集合至少存在:
submissions、partnership_requests、match_applications、saved_items、notifications、user_profiles
- 启动
- 验证写链路全通(状态:
⏳ 进行中)/submit-> 草稿写入submissions/requests-> 草稿写入partnership_requests/requests/[slug]-> 申请写入match_applications/contents/[slug]-> 收藏切换写入saved_items/me-> 通知已读更新notifications.is_read
- 联调记录模板:
docs/e2e-validation-log.md(已补)
- 做审核流 API(最小版)(状态:
✅ 已完成(最小版))- 新增后台 API:
submit review/approve/reject/publish - 先只处理
submissions与partnership_requests - 已完成:
POST /api/admin/submissions/[id]/review、POST /api/admin/requests/[id]/review - 验收标准(完成即改为
✅):- 在
web/src/app/api/admin/下落地可调用路由(建议:/submissions/[id]/review、/requests/[id]/review) - 至少支持状态流转:
draft -> pending_review -> approved/rejected -> published - 每次状态变更写入:
reviewed_by、reviewed_at、review_note(占位也可,但字段必须统一) - 失败返回统一错误结构:
{ success: false, message }
- 在
- 新增后台 API:
- 挂后台最小审核台(状态:
✅ 已完成(最小版))- 在
/admin增加待审核列表与状态切换按钮 - 确保每次状态变更有时间和操作者字段(即使先用占位)
- 已完成:
/admin页面已接最小审核队列组件并打通 API 调用 - 已完成:
GET /api/admin/submissions/review-queue、GET /api/admin/requests/review-queue(Directus 优先 + fallback) - 验收标准(完成即改为
✅):/admin至少可区分两类队列:submissions、partnership_requests- 每条记录可执行:
通过、拒绝、发布(不满足状态前置条件时按钮禁用) - 操作后有前端反馈:成功提示 / 失败提示 / fallback 提示
- 页面可见最新状态、更新时间、操作者(占位 user id 可接受)
- 在
- 反馈文案与运营可用性增强(状态:
✅ 已完成(当前轮))- 已完成:审核台支持状态筛选(全部/草稿/待审核/通过/拒绝/发布)
- 已完成:审核队列 API 支持
status服务端筛选参数 - 已完成:审核台默认视图调整为“待审核”
- 已完成:审核台支持分页(默认每页 4 条)
- 已完成:审核操作日志面板(success/fallback/error)
- 文档同步(必须)(状态:
✅ 已完成(本次))- 更新
README.md - 更新
web/README.md - 更新
docs/ai-handoff.md - 更新
docs/current-build-status.md
- 更新
以后每次你说“继续”或“同步进展”,默认都执行这 4 步:
- 对照根
README.md的 To Do 看板检查状态变化 - 更新
web/README.md的工程执行状态 - 对齐
docs/ai-handoff.md与docs/current-build-status.md - 回写本轮同步记录到
docs/README.md
最后更新:2026-05-09(本轮)
说明:详细任务拆分、实时进展、并行协作状态请以 docs/todo-live.md 为准;本节仅保留摘要。
状态说明:
✅ 已完成:本仓库已有实现与文档记录⏳ 进行中:已有部分实现,仍缺联调或稳定性验证⬜ 未开始:尚未进入开发
| 模块 | 当前状态 | 说明 |
|---|---|---|
投稿草稿写入 submissions |
✅ 已完成 | 已有 /submit 表单 + /api/submissions/drafts + Directus fallback |
合作申请写入 match_applications |
✅ 已完成 | 已有详情页申请表单 + /api/requests/[slug]/apply |
收藏切换写入 saved_items |
✅ 已完成 | 已支持 targetType/targetId 去重切换 |
通知全部已读写入 notifications |
✅ 已完成 | /me 已挂动作按钮与批量更新逻辑 |
合作需求草稿写入 partnership_requests |
✅ 已完成 | /requests 已有草稿发布表单 |
/me 多集合聚合读取 |
✅ 已完成 | user_dashboard 不存在时自动聚合 |
| CMS 本地实例 + 集合核验 | ✅ 已完成(本地方案) | 已通过 cms/sql/bootstrap-minimal-business-schema.sql 完成最小业务集合初始化 |
| 五条写链路端到端联调记录 | ✅ 已完成 | 二次复测 5/5 返回 source=directus,留痕见 docs/e2e-validation-log.md |
| 审核流 API(最小版) | ✅ 已完成 | 两条核心路由已落地并被 /admin 最小审核队列调用 |
/admin 最小审核台 |
✅ 已完成(增强版) | 队列读取与状态操作已打通,现支持批量通过/拒绝、驳回原因、审核说明展示、请求级操作者透传与中文操作日志 |
| 审核运营增强(筛选/分页/日志) | ✅ 已完成(增强版) | 后台审核台已具备状态筛选、分页、批量审核与操作留痕能力 |
/admin 抓取报告可视化(最小版) |
✅ 已完成(增强版) | 已可读取最新 _batch-report.json / _import-report.json,展示来源健康度、质量均分、导入摘要、异常提示、失败重试建议与导入失败样本 |
/admin 真实进展边界梳理 |
✅ 已完成 | 已明确只有审核流和抓取报告为真实接通,其余大块仍为静态占位说明层 |
| 首页样式加载 fallback | ✅ 已完成 | 已绕过 /_next/static/css/app/layout.css 404,恢复首页与频道页样式加载 |
| 后台中文化 / logo / 外链修正 | ✅ 已完成 | 后台可见英文已中文化,后台主 logo 改为“大鸟无文字”,合作申请默认作品集链接改为站内 /me |
| 前台站内搜索(增强版) | ✅ 已完成(增强版) | 已支持类型筛选计数、排序、分组空态引导与移动端搜索入口样式优化(仍基于现有内容服务层) |
| 前后台 Tab icon 统一 | ✅ 已完成 | 前台首页与 Directus 后台浏览器 Tab icon 已统一为同一套“仅鸟头”标;前端文件级 icon 与 metadata icon 已同步改为透明 64x64 输出 |
| 首页 Hero 与登录页语言系统统一 | ✅ 已完成 | 首页麦当劳案例位已改为真实 Hero 轮播,采用浮动箭头;标签规则收敛为“一个主类型 + 两个以内主题标签 + 一句辅助说明”,并继续向 /auth 的品牌引导区 + 任务面板语言系统对齐 |
| Directus 后台品牌/语言基线 | ✅ 已完成(本地实例) | 项目名/logo/favicon 已切为 QiuQiuTech,默认语言与管理员语言已切为 zh-CN |
| Directus 后台初始化脚本(品牌/语言) | ✅ 已完成 | node cms/scripts/apply-branding-and-language.mjs 可重复执行后台品牌与中文语言初始化 |
| Directus 后台初始化脚本(角色/策略基线) | ✅ 已完成 | node cms/scripts/seed-roles-and-policies.mjs 可创建/复用 Member、Verified Member、Operator 与对应 policy/access |
| Directus 后台基础初始化入口 | ✅ 已完成 | node cms/scripts/init-local-foundation.mjs 可一键串行执行品牌/语言与角色/策略基线初始化 |
| Directus 后台基础基线自检 | ✅ 已完成 | node cms/scripts/verify-local-foundation.mjs 可校验品牌/语言/角色/policy/access 是否已对齐 |
| 浏览器本地预览 | ✅ 已完成 | 开发服务可通过 http://127.0.0.1:3000 访问 |
| 内容读取链路(Directus 优先,第一阶段) | ✅ 已完成 | cms-client 已完成 snake_case 兼容映射,/ /contents /topics /requests 连通性复测均 200 |
| 最小会话登录链路(T07 第一阶段) | ⏳ 进行中 | 已有 GET/POST/DELETE /api/auth/session、请求级 userId 注入与升级后的高保真 /auth 登录界面;本轮已补 user_profiles 最小资料同步写入、注册面板“机构/城市”可选录入与 /me 私有聚合读取,待在 NEXT_PUBLIC_USE_DIRECTUS=true 下完成真实资料联调,并继续接微信扫码与真实账号体系 |
| 抓取管道 MVP(T08) | ✅ 已完成(MVP) | 已有链接抓取/批量抓取/导入待审核池/去重/失败重试/cron 入口/告警脚本,并补齐质量评分、来源健康度统计与批次报告输出 |
补充:
/auth本轮已按 C 端展示优先做收瘦,减少说明层与内部过程式表达,保留更轻量的登录动作与差异化价值信息/auth登录信息架构已重构为“直接登录 / 去注册”双入口;登录内部再区分账号密码、手机验证码、微信扫码- 首页 Hero 本轮已重构为真实轮播组件,采用浮动箭头切换,并把标签表达收束为“主类型 + 主题标签”两层,避免首页与登录页出现互相打架的语义体系
- 当前本地前端开发入口为 http://127.0.0.1:3000
- T07 本轮已继续向真实用户资料前进:
POST /api/auth/session在 Directus 模式下会同步user_profiles最小资料,/me聚合读取改为优先走带鉴权的私有查询;当前运行中的本地服务若仍为NEXT_PUBLIC_USE_DIRECTUS=false,则用户中心继续回退 mock 兜底
- 将审核台从当前最小 cookie 会话继续升级到真实登录态与后台账号体系
- 补齐联调截图与后台 UI 侧证据(当前已有 API + 数据留痕)
- 追踪
/collectionsAPI 的权限根因(不阻塞当前开发链路) - 将抓取报告从
tmp/读文件升级为可持久化任务中心与人工处理动作 - 将 Directus 初始化从“品牌/语言 + 角色/策略”继续扩展到集合、字段、细粒度权限与种子数据全套脚本
补充:
- 前台本地开发已切换为
webpack模式,原因是路径迁移后 Turbopack 对旧.next输出目录反复触发 HMR 写入异常,表现为首页持续刷新、tab 点击无响应。 - 首页标签页标题已参考 SocialBeta 调整为“品牌名|核心定位”,当前为
QiuQiuTech|营销行业实时洞察与合作对接平台;内页继续保持“页面名 | 品牌名”。 - 前台与后台品牌资源已进一步收敛为透明底版本:前台头部使用“鸟头 + 文字”,后台主 logo 使用“大鸟无文字”,Chrome Tab / favicon 使用“仅鸟头”。
- 前台搜索框此前是静态占位,不是 bug;当前已补成最小可用版,支持
/search?q=搜索contents/topics/requests。 - 本地 Directus 后台基础初始化当前推荐顺序为:SQL 最小业务集合 ->
node cms/scripts/init-local-foundation.mjs->node cms/scripts/verify-local-foundation.mjs。