@octo-cyber/log-analysis 0.5.0

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@octo-cyber/log-analysis",
+  "version": "0.5.0",
+  "description": "Octo log-analysis module — operation log recording, querying, and statistical analysis",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./web": {
+      "types": "./web/index.ts",
+      "import": "./web/index.ts",
+      "default": "./web/index.ts"
+    },
+    "./web/pages/*": {
+      "types": "./web/pages/*.tsx",
+      "import": "./web/pages/*.tsx",
+      "default": "./web/pages/*.tsx"
+    }
+  },
+  "dependencies": {
+    "@octo-cyber/core": "^0.5.4",
+    "@octo-cyber/auth": "^0.5.6"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "next": "^16.0.0",
+    "next-intl": "^4.0.0",
+    "lucide-react": ">=0.400.0",
+    "@tanstack/react-table": "^8.0.0",
+    "zod": "^3.0.0",
+    "sonner": "^2.0.0",
+    "@octo-cyber/ui": "^0.5.3"
+  },
+  "peerDependenciesMeta": {
+    "@octo-cyber/ui": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "next": {
+      "optional": true
+    },
+    "next-intl": {
+      "optional": true
+    },
+    "lucide-react": {
+      "optional": true
+    },
+    "@tanstack/react-table": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    },
+    "sonner": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  },
+  "files": [
+    "dist",
+    "web"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/web/components/LogsTable.tsx

@@ -0,0 +1,69 @@
+'use client'
+
+import { useTranslations } from 'next-intl'
+import { Badge } from '@octo-cyber/ui/components/ui/badge'
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from '@octo-cyber/ui/components/ui/table'
+import type { OperationLog, LogLevel } from '../types/log-analysis'
+
+interface LogsTableProps {
+  logs: OperationLog[]
+}
+
+const levelVariant: Record<LogLevel, 'default' | 'secondary' | 'destructive'> = {
+  INFO: 'default',
+  WARN: 'secondary',
+  ERROR: 'destructive',
+}
+
+export function LogsTable({ logs }: LogsTableProps) {
+  const t = useTranslations('logAnalysis')
+
+  return (
+    <div className="rounded-md border dark:border-zinc-700">
+      <Table>
+        <TableHeader>
+          <TableRow>
+            <TableHead>{t('columns.createdAt')}</TableHead>
+            <TableHead>{t('columns.level')}</TableHead>
+            <TableHead>{t('columns.module')}</TableHead>
+            <TableHead>{t('columns.action')}</TableHead>
+            <TableHead>{t('columns.username')}</TableHead>
+            <TableHead>{t('columns.description')}</TableHead>
+            <TableHead>{t('columns.ip')}</TableHead>
+          </TableRow>
+        </TableHeader>
+        <TableBody>
+          {logs.length === 0 && (
+            <TableRow>
+              <TableCell colSpan={7} className="text-center text-muted-foreground py-8">
+                {t('empty')}
+              </TableCell>
+            </TableRow>
+          )}
+          {logs.map(log => (
+            <TableRow key={log.id}>
+              <TableCell className="text-xs text-muted-foreground whitespace-nowrap">
+                {new Date(log.createdAt).toLocaleString()}
+              </TableCell>
+              <TableCell>
+                <Badge variant={levelVariant[log.level]}>{log.level}</Badge>
+              </TableCell>
+              <TableCell className="font-mono text-xs">{log.module}</TableCell>
+              <TableCell className="text-xs">{log.action}</TableCell>
+              <TableCell className="text-sm">{log.username ?? '-'}</TableCell>
+              <TableCell className="max-w-xs truncate text-sm">{log.description}</TableCell>
+              <TableCell className="text-xs text-muted-foreground">{log.ip ?? '-'}</TableCell>
+            </TableRow>
+          ))}
+        </TableBody>
+      </Table>
+    </div>
+  )
+}

package/web/components/RetentionRulesTab.tsx

@@ -0,0 +1,187 @@
+'use client'
+
+import { useState } from 'react'
+import { useTranslations } from 'next-intl'
+import { toast } from 'sonner'
+import { Button } from '@octo-cyber/ui/components/ui/button'
+import { Badge } from '@octo-cyber/ui/components/ui/badge'
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from '@octo-cyber/ui/components/ui/table'
+import {
+  Dialog,
+  DialogContent,
+  DialogHeader,
+  DialogTitle,
+  DialogTrigger,
+} from '@octo-cyber/ui/components/ui/dialog'
+import { Input } from '@octo-cyber/ui/components/ui/input'
+import { Label } from '@octo-cyber/ui/components/ui/label'
+import { logAnalysisService } from '../services/log-analysis-service'
+import type { RetentionRule, CreateRetentionRuleDto } from '../types/log-analysis'
+
+interface RetentionRulesTabProps {
+  rules: RetentionRule[]
+  onRefresh: () => void
+}
+
+const emptyForm: CreateRetentionRuleDto = {
+  name: '',
+  module: null,
+  action: null,
+  retentionDays: 90,
+  enabled: true,
+}
+
+export function RetentionRulesTab({ rules, onRefresh }: RetentionRulesTabProps) {
+  const t = useTranslations('logAnalysis')
+  const [open, setOpen] = useState(false)
+  const [form, setForm] = useState<CreateRetentionRuleDto>(emptyForm)
+  const [saving, setSaving] = useState(false)
+  const [applying, setApplying] = useState(false)
+
+  const handleCreate = async () => {
+    if (!form.name.trim()) return
+    setSaving(true)
+    try {
+      await logAnalysisService.createRetentionRule(form)
+      toast.success(t('retention.created'))
+      setOpen(false)
+      setForm(emptyForm)
+      onRefresh()
+    } catch {
+      toast.error(t('retention.createError'))
+    } finally {
+      setSaving(false)
+    }
+  }
+
+  const handleDelete = async (id: number) => {
+    try {
+      await logAnalysisService.deleteRetentionRule(id)
+      toast.success(t('retention.deleted'))
+      onRefresh()
+    } catch {
+      toast.error(t('retention.deleteError'))
+    }
+  }
+
+  const handleApply = async () => {
+    setApplying(true)
+    try {
+      const result = await logAnalysisService.applyRetention()
+      toast.success(t('retention.applied', { count: result.deleted }))
+      onRefresh()
+    } catch {
+      toast.error(t('retention.applyError'))
+    } finally {
+      setApplying(false)
+    }
+  }
+
+  return (
+    <div className="space-y-4">
+      <div className="flex justify-end gap-2">
+        <Button variant="outline" onClick={handleApply} disabled={applying}>
+          {applying ? t('retention.applying') : t('retention.applyNow')}
+        </Button>
+        <Dialog open={open} onOpenChange={setOpen}>
+          <DialogTrigger asChild>
+            <Button>{t('retention.addRule')}</Button>
+          </DialogTrigger>
+          <DialogContent>
+            <DialogHeader>
+              <DialogTitle>{t('retention.addRule')}</DialogTitle>
+            </DialogHeader>
+            <div className="space-y-4 py-2">
+              <div className="space-y-1">
+                <Label>{t('retention.name')}</Label>
+                <Input
+                  value={form.name}
+                  onChange={e => setForm(f => ({ ...f, name: e.target.value }))}
+                  placeholder={t('retention.namePlaceholder')}
+                />
+              </div>
+              <div className="space-y-1">
+                <Label>{t('retention.module')}</Label>
+                <Input
+                  value={form.module ?? ''}
+                  onChange={e => setForm(f => ({ ...f, module: e.target.value || null }))}
+                  placeholder={t('retention.modulePlaceholder')}
+                />
+              </div>
+              <div className="space-y-1">
+                <Label>{t('retention.retentionDays')}</Label>
+                <Input
+                  type="number"
+                  min={0}
+                  value={form.retentionDays}
+                  onChange={e => setForm(f => ({ ...f, retentionDays: Number(e.target.value) }))}
+                />
+              </div>
+              <Button className="w-full" onClick={handleCreate} disabled={saving}>
+                {saving ? t('saving') : t('save')}
+              </Button>
+            </div>
+          </DialogContent>
+        </Dialog>
+      </div>
+
+      <div className="rounded-md border dark:border-zinc-700">
+        <Table>
+          <TableHeader>
+            <TableRow>
+              <TableHead>{t('retention.name')}</TableHead>
+              <TableHead>{t('retention.module')}</TableHead>
+              <TableHead>{t('retention.action')}</TableHead>
+              <TableHead>{t('retention.retentionDays')}</TableHead>
+              <TableHead>{t('retention.status')}</TableHead>
+              <TableHead className="w-24">{t('actions')}</TableHead>
+            </TableRow>
+          </TableHeader>
+          <TableBody>
+            {rules.length === 0 && (
+              <TableRow>
+                <TableCell colSpan={6} className="text-center text-muted-foreground py-8">
+                  {t('empty')}
+                </TableCell>
+              </TableRow>
+            )}
+            {rules.map(rule => (
+              <TableRow key={rule.id}>
+                <TableCell className="font-medium">{rule.name}</TableCell>
+                <TableCell className="font-mono text-xs">{rule.module ?? t('retention.all')}</TableCell>
+                <TableCell className="text-sm">{rule.action ?? t('retention.all')}</TableCell>
+                <TableCell>
+                  {rule.retentionDays === 0
+                    ? t('retention.forever')
+                    : t('retention.days', { count: rule.retentionDays })}
+                </TableCell>
+                <TableCell>
+                  <Badge variant={rule.enabled ? 'default' : 'secondary'}>
+                    {rule.enabled ? t('enabled') : t('disabled')}
+                  </Badge>
+                </TableCell>
+                <TableCell>
+                  <Button
+                    variant="ghost"
+                    size="sm"
+                    className="text-destructive hover:text-destructive"
+                    onClick={() => handleDelete(rule.id)}
+                  >
+                    {t('delete')}
+                  </Button>
+                </TableCell>
+              </TableRow>
+            ))}
+          </TableBody>
+        </Table>
+      </div>
+    </div>
+  )
+}

package/web/components/StatsOverview.tsx

@@ -0,0 +1,91 @@
+'use client'
+
+import { useTranslations } from 'next-intl'
+import { Card, CardContent, CardHeader, CardTitle } from '@octo-cyber/ui/components/ui/card'
+import { Badge } from '@octo-cyber/ui/components/ui/badge'
+import type { LogStats } from '../types/log-analysis'
+
+interface StatsOverviewProps {
+  stats: LogStats
+}
+
+export function StatsOverview({ stats }: StatsOverviewProps) {
+  const t = useTranslations('logAnalysis')
+
+  return (
+    <div className="grid gap-4 md:grid-cols-2 lg:grid-cols-4">
+      {/* 总计 */}
+      <Card className="dark:bg-zinc-900 dark:border-zinc-700">
+        <CardHeader className="pb-2">
+          <CardTitle className="text-sm font-medium text-muted-foreground">
+            {t('stats.total')}
+          </CardTitle>
+        </CardHeader>
+        <CardContent>
+          <div className="text-2xl font-bold">{stats.total.toLocaleString()}</div>
+        </CardContent>
+      </Card>
+
+      {/* 按级别 */}
+      <Card className="dark:bg-zinc-900 dark:border-zinc-700">
+        <CardHeader className="pb-2">
+          <CardTitle className="text-sm font-medium text-muted-foreground">
+            {t('stats.byLevel')}
+          </CardTitle>
+        </CardHeader>
+        <CardContent className="flex flex-wrap gap-2">
+          {stats.byLevel.map(item => (
+            <div key={item.level} className="flex items-center gap-1">
+              <Badge
+                variant={
+                  item.level === 'ERROR'
+                    ? 'destructive'
+                    : item.level === 'WARN'
+                    ? 'secondary'
+                    : 'default'
+                }
+              >
+                {item.level}
+              </Badge>
+              <span className="text-sm font-semibold">{item.count}</span>
+            </div>
+          ))}
+        </CardContent>
+      </Card>
+
+      {/* Top 5 模块 */}
+      <Card className="dark:bg-zinc-900 dark:border-zinc-700">
+        <CardHeader className="pb-2">
+          <CardTitle className="text-sm font-medium text-muted-foreground">
+            {t('stats.topModules')}
+          </CardTitle>
+        </CardHeader>
+        <CardContent className="space-y-1">
+          {stats.byModule.slice(0, 5).map(item => (
+            <div key={item.module} className="flex justify-between text-sm">
+              <span className="font-mono text-xs">{item.module}</span>
+              <span className="font-semibold">{item.count}</span>
+            </div>
+          ))}
+        </CardContent>
+      </Card>
+
+      {/* Top 5 动作 */}
+      <Card className="dark:bg-zinc-900 dark:border-zinc-700">
+        <CardHeader className="pb-2">
+          <CardTitle className="text-sm font-medium text-muted-foreground">
+            {t('stats.topActions')}
+          </CardTitle>
+        </CardHeader>
+        <CardContent className="space-y-1">
+          {stats.byAction.slice(0, 5).map(item => (
+            <div key={item.action} className="flex justify-between text-sm">
+              <span>{item.action}</span>
+              <span className="font-semibold">{item.count}</span>
+            </div>
+          ))}
+        </CardContent>
+      </Card>
+    </div>
+  )
+}

package/web/index.ts

@@ -0,0 +1,27 @@
+/**
+ * @octo-cyber/log-analysis — Frontend entry point.
+ */
+
+// Manifest
+export { logAnalysisFrontendManifest } from './manifest'
+
+// i18n Messages
+export { default as logAnalysisMessagesZhCN } from './messages/zh-CN.json'
+export { default as logAnalysisMessagesEnUS } from './messages/en-US.json'
+
+// Pages
+export { default as LogAnalysisPage } from './pages/LogAnalysisPage'
+
+// Services
+export { logAnalysisService } from './services/log-analysis-service'
+
+// Types
+export type {
+  OperationLog,
+  RetentionRule,
+  LogStats,
+  LogLevel,
+  LogAction,
+  QueryLogsParams,
+  CreateRetentionRuleDto,
+} from './types/log-analysis'

package/web/manifest.ts

@@ -0,0 +1,17 @@
+import type { IFrontendManifest } from '@octo-cyber/core'
+
+export const logAnalysisFrontendManifest: IFrontendManifest = {
+  moduleId: 'log-analysis',
+  icon: 'ScrollText',
+  color: 'slate',
+  position: 'main',
+  titleKey: 'logAnalysis.title',
+  descriptionKey: 'logAnalysis.description',
+  pages: [
+    {
+      path: '/log-analysis',
+      titleKey: 'logAnalysis.pages.home',
+      component: '@octo-cyber/log-analysis/web/pages/LogAnalysisPage',
+    },
+  ],
+}

package/web/messages/en-US.json

@@ -0,0 +1,70 @@
+{
+  "logAnalysis": {
+    "title": "Operation Logs",
+    "description": "View system operation records, analyze user behavior, and manage log retention rules",
+    "tabs": {
+      "logs": "Logs",
+      "stats": "Statistics",
+      "retention": "Retention Rules"
+    },
+    "columns": {
+      "createdAt": "Time",
+      "level": "Level",
+      "module": "Module",
+      "action": "Action",
+      "username": "User",
+      "description": "Description",
+      "ip": "IP"
+    },
+    "filter": {
+      "keyword": "Search description...",
+      "module": "Module",
+      "level": "Level",
+      "action": "Action",
+      "all": "All"
+    },
+    "stats": {
+      "total": "Total Logs",
+      "byLevel": "By Level",
+      "topModules": "Top Modules",
+      "topActions": "Top Actions"
+    },
+    "retention": {
+      "addRule": "Add Rule",
+      "name": "Rule Name",
+      "namePlaceholder": "e.g. Clean login logs",
+      "module": "Match Module",
+      "modulePlaceholder": "Empty = all modules",
+      "action": "Match Action",
+      "retentionDays": "Retention Days",
+      "status": "Status",
+      "all": "All",
+      "forever": "Keep Forever",
+      "days": "{count} days",
+      "applyNow": "Apply Retention Now",
+      "applying": "Applying...",
+      "applied": "Cleaned {count} logs",
+      "created": "Rule created",
+      "deleted": "Rule deleted",
+      "createError": "Failed to create rule",
+      "deleteError": "Failed to delete rule",
+      "applyError": "Failed to apply retention"
+    },
+    "empty": "No data",
+    "loading": "Loading...",
+    "fetchError": "Failed to load data",
+    "search": "Search",
+    "save": "Save",
+    "saving": "Saving...",
+    "delete": "Delete",
+    "actions": "Actions",
+    "enabled": "Enabled",
+    "disabled": "Disabled",
+    "prev": "Previous",
+    "next": "Next",
+    "pageInfo": "Page {page} of {totalPages}",
+    "pages": {
+      "home": "Operation Logs"
+    }
+  }
+}

package/web/messages/zh-CN.json

@@ -0,0 +1,70 @@
+{
+  "logAnalysis": {
+    "title": "操作日志",
+    "description": "查看系统操作记录，分析用户行为，管理日志保留规则",
+    "tabs": {
+      "logs": "日志列表",
+      "stats": "统计分析",
+      "retention": "保留规则"
+    },
+    "columns": {
+      "createdAt": "时间",
+      "level": "级别",
+      "module": "模块",
+      "action": "操作",
+      "username": "用户",
+      "description": "描述",
+      "ip": "IP"
+    },
+    "filter": {
+      "keyword": "搜索描述...",
+      "module": "模块",
+      "level": "级别",
+      "action": "操作",
+      "all": "全部"
+    },
+    "stats": {
+      "total": "总条数",
+      "byLevel": "按级别",
+      "topModules": "Top 模块",
+      "topActions": "Top 操作"
+    },
+    "retention": {
+      "addRule": "添加规则",
+      "name": "规则名称",
+      "namePlaceholder": "如：清理登录日志",
+      "module": "匹配模块",
+      "modulePlaceholder": "空表示全部模块",
+      "action": "匹配操作",
+      "retentionDays": "保留天数",
+      "status": "状态",
+      "all": "全部",
+      "forever": "永久保留",
+      "days": "{count} 天",
+      "applyNow": "立即执行清理",
+      "applying": "执行中...",
+      "applied": "已清理 {count} 条日志",
+      "created": "规则已创建",
+      "deleted": "规则已删除",
+      "createError": "创建失败",
+      "deleteError": "删除失败",
+      "applyError": "清理执行失败"
+    },
+    "empty": "暂无数据",
+    "loading": "加载中...",
+    "fetchError": "数据加载失败",
+    "search": "搜索",
+    "save": "保存",
+    "saving": "保存中...",
+    "delete": "删除",
+    "actions": "操作",
+    "enabled": "启用",
+    "disabled": "禁用",
+    "prev": "上一页",
+    "next": "下一页",
+    "pageInfo": "第 {page} / {totalPages} 页",
+    "pages": {
+      "home": "操作日志"
+    }
+  }
+}