feat: Add import/export, document linking, data analytics, keyboard shortcuts, and share page permission checks

- Import: Support .md/.html/.docx file import with client-side parsing (markdown-it, mammoth)
- Export: Extract shared Tiptap extension list for generateJSON compatibility
- Document Link: [[ trigger for cross-document linking with suggestion popup
- Analytics: Space dashboard (/spaces/[id]/analytics) with growth trends, top docs/members, action distribution
- Analytics: Document read stats badge (UV/PV) in editor header
- Analytics: Personal productivity cards on Dashboard (weekly create/edit + total reads)
- Keyboard Shortcuts: Dialog accessible from editor more menu
- Share Page: Permission-aware document link clicks (login prompt / no-access dialog)
- Login: Support returnTo query parameter for post-login redirect
- Documents API: Permission guard on GET /documents/:id for non-space members
- Plan: Update stage-7 progress, add stage-8 AI writing plan, add stage-9 pre-launch checklist

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Jason-chen-coder

apps/api/src/activity/activity.controller.ts

@@ -60,4 +60,22 @@ export class ActivityController {
       limit ? parseInt(limit, 10) : 30,
     );
   }
+
+  @Get('space/:spaceId/stats')
+  @ApiOperation({ summary: '获取空间统计数据' })
+  getSpaceStats(@Param('spaceId') spaceId: string) {
+    return this.activityService.getSpaceStats(spaceId);
+  }
+
+  @Get('document/:documentId/stats')
+  @ApiOperation({ summary: '获取文档阅读统计' })
+  getDocumentStats(@Param('documentId') documentId: string) {
+    return this.activityService.getDocumentStats(documentId);
+  }
+
+  @Get('my/stats')
+  @ApiOperation({ summary: '获取个人生产力统计' })
+  getMyStats(@Req() req: any) {
+    return this.activityService.getUserProductivityStats(req.user.id);
+  }
 }

apps/api/src/activity/activity.service.ts

@@ -188,6 +188,258 @@ export class ActivityService {
     };
   }
 
+  // ==================== Stats / Analytics ====================
+
+  /**
+   * 空间级统计数据
+   */
+  async getSpaceStats(spaceId: string) {
+    const now = new Date();
+    const weekStart = new Date(now);
+    weekStart.setDate(now.getDate() - now.getDay());
+    weekStart.setHours(0, 0, 0, 0);
+
+    const thirtyDaysAgo = new Date(now);
+    thirtyDaysAgo.setDate(now.getDate() - 30);
+
+    const [
+      docCount,
+      memberCount,
+      totalVisitsAgg,
+      weeklyActions,
+      actionDistribution,
+      topDocuments,
+      topMembers,
+    ] = await Promise.all([
+      // 文档总数
+      this.prisma.document.count({
+        where: { spaceId, deletedAt: null },
+      }),
+      // 成员数
+      this.prisma.spacePermission.count({
+        where: { spaceId },
+      }),
+      // 总阅读量
+      this.prisma.documentVisit.aggregate({
+        where: { spaceId },
+        _sum: { visitCount: true },
+      }),
+      // 本周活跃操作数
+      this.prisma.activityLog.count({
+        where: { spaceId, createdAt: { gte: weekStart } },
+      }),
+      // 操作类型分布
+      this.prisma.activityLog.groupBy({
+        by: ['action'],
+        where: { spaceId },
+        _count: true,
+      }),
+      // 热门文档 Top 10
+      this.prisma.documentVisit.groupBy({
+        by: ['documentId'],
+        where: { spaceId },
+        _sum: { visitCount: true },
+        orderBy: { _sum: { visitCount: 'desc' } },
+        take: 10,
+      }),
+      // 活跃成员 Top 10（近 30 天）
+      this.prisma.activityLog.groupBy({
+        by: ['userId'],
+        where: { spaceId, createdAt: { gte: thirtyDaysAgo } },
+        _count: true,
+        orderBy: { _count: { userId: 'desc' } },
+        take: 10,
+      }),
+    ]);
+
+    // 30 天文档增长趋势
+    const docGrowth = await this.prisma.document.groupBy({
+      by: ['createdAt'],
+      where: {
+        spaceId,
+        deletedAt: null,
+        createdAt: { gte: thirtyDaysAgo },
+      },
+      _count: true,
+      orderBy: { createdAt: 'asc' },
+    });
+
+    // 按日聚合文档增长
+    const growthByDay: Record<string, number> = {};
+    for (const item of docGrowth) {
+      const day = new Date(item.createdAt).toISOString().slice(0, 10);
+      growthByDay[day] = (growthByDay[day] || 0) + item._count;
+    }
+    const docGrowthTrend = [];
+    for (let i = 29; i >= 0; i--) {
+      const d = new Date(now);
+      d.setDate(now.getDate() - i);
+      const key = d.toISOString().slice(0, 10);
+      docGrowthTrend.push({ date: key, count: growthByDay[key] || 0 });
+    }
+
+    // 填充热门文档标题
+    const docIds = topDocuments.map((d) => d.documentId);
+    const docs = docIds.length
+      ? await this.prisma.document.findMany({
+          where: { id: { in: docIds } },
+          select: { id: true, title: true },
+        })
+      : [];
+    const docMap = new Map(docs.map((d) => [d.id, d.title]));
+
+    // 填充活跃成员名称
+    const userIds = topMembers.map((m) => m.userId);
+    const users = userIds.length
+      ? await this.prisma.user.findMany({
+          where: { id: { in: userIds } },
+          select: { id: true, name: true, avatarUrl: true },
+        })
+      : [];
+    const userMap = new Map(users.map((u) => [u.id, u]));
+
+    return {
+      overview: {
+        docCount,
+        memberCount,
+        totalViews: totalVisitsAgg._sum.visitCount || 0,
+        weeklyActions,
+      },
+      docGrowthTrend,
+      topDocuments: topDocuments.map((d) => ({
+        documentId: d.documentId,
+        title: docMap.get(d.documentId) || '未知文档',
+        views: d._sum.visitCount || 0,
+      })),
+      topMembers: topMembers.map((m) => ({
+        userId: m.userId,
+        name: userMap.get(m.userId)?.name || '未知用户',
+        avatarUrl: userMap.get(m.userId)?.avatarUrl || null,
+        actions: m._count,
+      })),
+      actionDistribution: actionDistribution.map((a) => ({
+        action: a.action,
+        count: a._count,
+      })),
+    };
+  }
+
+  /**
+   * 文档级阅读统计
+   */
+  async getDocumentStats(documentId: string) {
+    const now = new Date();
+    const sevenDaysAgo = new Date(now);
+    sevenDaysAgo.setDate(now.getDate() - 7);
+
+    const [uvCount, pvAgg, recentVisits] = await Promise.all([
+      // UV：独立访客数
+      this.prisma.documentVisit.count({
+        where: { documentId },
+      }),
+      // PV：总访问次数
+      this.prisma.documentVisit.aggregate({
+        where: { documentId },
+        _sum: { visitCount: true },
+      }),
+      // 近 7 天访问记录（按最近访问时间过滤）
+      this.prisma.documentVisit.findMany({
+        where: {
+          documentId,
+          lastVisitAt: { gte: sevenDaysAgo },
+        },
+        select: { lastVisitAt: true, visitCount: true },
+      }),
+    ]);
+
+    // 按日聚合近 7 天访问
+    const visitsByDay: Record<string, number> = {};
+    for (const v of recentVisits) {
+      const day = new Date(v.lastVisitAt).toISOString().slice(0, 10);
+      visitsByDay[day] = (visitsByDay[day] || 0) + 1;
+    }
+    const dailyTrend = [];
+    for (let i = 6; i >= 0; i--) {
+      const d = new Date(now);
+      d.setDate(now.getDate() - i);
+      const key = d.toISOString().slice(0, 10);
+      dailyTrend.push({ date: key, count: visitsByDay[key] || 0 });
+    }
+
+    return {
+      uv: uvCount,
+      pv: pvAgg._sum.visitCount || 0,
+      dailyTrend,
+    };
+  }
+
+  /**
+   * 个人生产力统计
+   */
+  async getUserProductivityStats(userId: string) {
+    const now = new Date();
+
+    const thisWeekStart = new Date(now);
+    thisWeekStart.setDate(now.getDate() - now.getDay());
+    thisWeekStart.setHours(0, 0, 0, 0);
+
+    const lastWeekStart = new Date(thisWeekStart);
+    lastWeekStart.setDate(lastWeekStart.getDate() - 7);
+
+    const [
+      thisWeekCreated,
+      lastWeekCreated,
+      thisWeekEdited,
+      lastWeekEdited,
+      totalReadsAgg,
+    ] = await Promise.all([
+      this.prisma.activityLog.count({
+        where: {
+          userId,
+          action: 'CREATE',
+          entityType: 'DOCUMENT',
+          createdAt: { gte: thisWeekStart },
+        },
+      }),
+      this.prisma.activityLog.count({
+        where: {
+          userId,
+          action: 'CREATE',
+          entityType: 'DOCUMENT',
+          createdAt: { gte: lastWeekStart, lt: thisWeekStart },
+        },
+      }),
+      this.prisma.activityLog.count({
+        where: {
+          userId,
+          action: 'UPDATE',
+          entityType: 'DOCUMENT',
+          createdAt: { gte: thisWeekStart },
+        },
+      }),
+      this.prisma.activityLog.count({
+        where: {
+          userId,
+          action: 'UPDATE',
+          entityType: 'DOCUMENT',
+          createdAt: { gte: lastWeekStart, lt: thisWeekStart },
+        },
+      }),
+      this.prisma.documentVisit.aggregate({
+        where: { document: { createdBy: userId } },
+        _sum: { visitCount: true },
+      }),
+    ]);
+
+    return {
+      thisWeekCreated,
+      lastWeekCreated,
+      thisWeekEdited,
+      lastWeekEdited,
+      totalReads: totalReadsAgg._sum.visitCount || 0,
+    };
+  }
+
   /**
    * 清理超过 90 天的旧日志（可由定时任务调用）
    */

apps/api/src/documents/documents.controller.ts

@@ -58,10 +58,10 @@ export class DocumentsController {
   }
 
   /**
-   * Lightweight existence check — returns 204 if exists, 404 if not.
+   * Lightweight existence + permission check — returns 204 if exists and user has access, 403/404 otherwise.
    * No body, no side effects (no visit recording).
    */
-  @UseGuards(JwtAuthGuard)
+  @UseGuards(JwtAuthGuard, SpacePermissionGuard)
   @Get(':id/exists')
   @HttpCode(204)
   async checkExists(@Param('id') id: string) {

apps/api/src/documents/documents.service.ts

@@ -144,6 +144,7 @@ export class DocumentsService {
       select: {
         id: true,
         title: true,
+        spaceId: true,
         parentId: true,
         order: true,
         createdAt: true,

apps/web/package.json

@@ -71,6 +71,9 @@
     "lodash.throttle": "^4.1.1",
     "lowlight": "^3.3.0",
     "lucide-react": "^0.563.0",
+    "mammoth": "^1.12.0",
+    "markdown-it": "^14.1.1",
+    "markdown-it-task-lists": "^2.1.1",
     "motion": "^12.34.4",
     "next": "16.1.6",
     "next-themes": "^0.4.6",
@@ -96,6 +99,7 @@
     "@tailwindcss/typography": "^0.5.15",
     "@types/d3": "^7.4.3",
     "@types/lodash.throttle": "^4.1.9",
+    "@types/markdown-it": "^14.1.2",
     "@types/node": "^20.19.35",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19",