feat(backend): Phase 0 项目骨架完成 — 后端/前端/数据库/Docker

- 后端：FastAPI + SQLAlchemy + Alembic，7 张核心表迁移成功 - 前端：Next.js 16 + TailwindCSS 4 + 三端布局（投资人/创始人/Admin） - 数据库：PostgreSQL 16，7 张核心实体表（tenants/users/companies/monthly_reports/health_scores/risk_events/audit_logs） - Docker：docker-compose.yml + 前后端 Dockerfile - 测试：健康检查 4 个测试全部 GREEN - 文档：README/run.md/AGENTS.md/docs 体系完整
2026-07-18 21:50:15 +08:00
parent f09aa33589
commit 51feae55ba
72 changed files with 8048 additions and 0 deletions
@@ -0,0 +1,15 @@
+/** 投资人端驾驶舱首页 — 占位页面。 */
+
+import { LoadingSpinner } from "@/components/shared/LoadingSpinner";
+
+export default function InvestorHomePage() {
+  return (
+    <div className="space-y-6">
+      <div>
+        <h1 className="text-2xl font-bold text-foreground">投资机构驾驶舱</h1>
+        <p className="mt-1 text-sm text-muted-foreground">Portfolio 全局健康度与风险概览</p>
+      </div>
+      <LoadingSpinner className="py-20" size={32} />
+    </div>
+  );
+}
@@ -0,0 +1,44 @@
+/** 投资人端布局 — B 端专业风格：左 Sidebar + 灰色内容区。 */
+
+import { LayoutDashboard, Building2, FileText, AlertTriangle, Settings } from "lucide-react";
+import Link from "next/link";
+
+const navItems = [
+  { href: "/dashboard", label: "驾驶舱", icon: LayoutDashboard },
+  { href: "/companies", label: "企业档案", icon: Building2 },
+  { href: "/reports", label: "月报管理", icon: FileText },
+  { href: "/risks", label: "风险工作台", icon: AlertTriangle },
+  { href: "/settings", label: "设置", icon: Settings },
+];
+
+export default function InvestorLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <div className="flex min-h-screen">
+      {/* 左侧 Sidebar */}
+      <aside className="sticky top-0 hidden h-screen w-52 shrink-0 bg-[var(--investor-sidebar-bg)] text-white md:block">
+        <div className="flex h-14 items-center px-4 font-bold">AIPortPilot</div>
+        <nav className="flex flex-col gap-1 px-3 py-2">
+          {navItems.map((item) => (
+            <Link
+              key={item.href}
+              href={item.href}
+              className="flex items-center gap-2 rounded-md px-3 py-2 text-sm text-white/70 transition-colors hover:bg-white/10 hover:text-white"
+            >
+              <item.icon size={16} aria-hidden="true" />
+              {item.label}
+            </Link>
+          ))}
+        </nav>
+      </aside>
+
+      {/* 内容区 */}
+      <main className="flex-1 bg-[var(--investor-content-bg)]">
+        {/* 移动端顶部 Header */}
+        <header className="sticky top-0 z-10 flex h-14 items-center bg-[var(--investor-sidebar-bg)] px-4 text-white md:hidden">
+          <span className="font-bold">AIPortPilot</span>
+        </header>
+        <div className="container mx-auto max-w-7xl px-4 py-6">{children}</div>
+      </main>
+    </div>
+  );
+}
@@ -0,0 +1,15 @@
+/** Admin 端布局 — 警示风格：slate-950 Header + amber 主色。 */
+
+export default function AdminLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <div className="min-h-screen bg-slate-100">
+      <header className="sticky top-0 z-10 flex h-14 items-center bg-[var(--admin-header-bg)] px-4">
+        <span className="font-bold text-[var(--admin-primary)]">AIPortPilot</span>
+        <span className="ml-2 inline-flex items-center rounded bg-[var(--admin-primary)]/20 px-1.5 py-0.5 text-xs font-medium text-[var(--admin-primary)]">
+          ADMIN
+        </span>
+      </header>
+      <main className="container mx-auto max-w-7xl px-4 py-6">{children}</main>
+    </div>
+  );
+}
@@ -0,0 +1,12 @@
+/** Admin 端首页 — 占位页面。 */
+
+import { EmptyState } from "@/components/shared/EmptyState";
+
+export default function AdminHomePage() {
+  return (
+    <div className="space-y-6">
+      <h1 className="text-2xl font-bold text-foreground">管理后台</h1>
+      <EmptyState title="暂无数据" description="租户管理与权限配置功能开发中" />
+    </div>
+  );
+}
@@ -0,0 +1,12 @@
+/** 创始人端 AI 副驾驶页面 — 占位。 */
+
+import { EmptyState } from "@/components/shared/EmptyState";
+
+export default function FounderCopilotPage() {
+  return (
+    <div className="space-y-6">
+      <h1 className="text-2xl font-bold text-foreground">AI 副驾驶</h1>
+      <EmptyState title="AI 副驾驶" description="对话功能开发中" />
+    </div>
+  );
+}
@@ -0,0 +1,39 @@
+/** 创始人端布局 — C 端温暖风格：顶部 Header + indigo 主色。 */
+
+import { Home, FileText, Sparkle } from "lucide-react";
+import Link from "next/link";
+
+const navItems = [
+  { href: "/founder", label: "概览", icon: Home },
+  { href: "/founder/reports", label: "月报", icon: FileText },
+  { href: "/founder/copilot", label: "AI 副驾驶", icon: Sparkle },
+];
+
+export default function FounderLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <div className="min-h-screen bg-gradient-to-b from-indigo-50 to-white">
+      {/* 顶部 Header */}
+      <header className="sticky top-0 z-10 flex h-14 items-center bg-white/95 px-4 backdrop-blur md:px-6">
+        <span className="font-bold text-[var(--founder-primary)]">AIPortPilot</span>
+        <span className="ml-2 text-xs text-muted-foreground">创始人端</span>
+      </header>
+
+      {/* 内容区 */}
+      <main className="container mx-auto max-w-7xl px-4 py-6 pb-20 md:pb-6">{children}</main>
+
+      {/* 移动端底部导航 */}
+      <nav className="fixed bottom-0 left-0 right-0 flex h-14 border-t bg-white md:hidden">
+        {navItems.map((item) => (
+          <Link
+            key={item.href}
+            href={item.href}
+            className="flex flex-1 flex-col items-center justify-center gap-0.5 text-xs text-muted-foreground"
+          >
+            <item.icon size={20} aria-hidden="true" />
+            {item.label}
+          </Link>
+        ))}
+      </nav>
+    </div>
+  );
+}
@@ -0,0 +1,15 @@
+/** 创始人端经营概览 — 占位页面。 */
+
+import { LoadingSpinner } from "@/components/shared/LoadingSpinner";
+
+export default function FounderHomePage() {
+  return (
+    <div className="space-y-6">
+      <div>
+        <h1 className="text-2xl font-bold text-foreground">企业经营概览</h1>
+        <p className="mt-1 text-sm text-muted-foreground">关键指标与健康度一览</p>
+      </div>
+      <LoadingSpinner className="py-20" size={32} />
+    </div>
+  );
+}
@@ -0,0 +1,12 @@
+/** 创始人端月报页面 — 占位。 */
+
+import { EmptyState } from "@/components/shared/EmptyState";
+
+export default function FounderReportsPage() {
+  return (
+    <div className="space-y-6">
+      <h1 className="text-2xl font-bold text-foreground">月报管理</h1>
+      <EmptyState title="暂无月报" description="月报提交功能开发中" />
+    </div>
+  );
+}
@@ -0,0 +1,72 @@
+@import "tailwindcss";
+
+/* ===== 设计 Token ===== */
+:root {
+  /* 圆角 */
+  --radius: 0.625rem;
+
+  /* 通用色彩 - oklch 体系 */
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.21 0.006 285.885);
+  --muted: oklch(0.97 0 0);
+  --muted-foreground: oklch(0.55 0.006 285.885);
+  --border: oklch(0.92 0.004 286.32);
+  --input: oklch(0.92 0.004 286.32);
+  --ring: oklch(0.55 0.006 285.885);
+
+  /* 状态色三件套 */
+  --success: oklch(0.7 0.17 162.48);
+  --warning: oklch(0.77 0.18 70.08);
+  --destructive: oklch(0.64 0.21 25.77);
+
+  /* 投资人端主色 - gray-900 */
+  --investor-primary: oklch(0.21 0.006 285.885);
+  --investor-sidebar-bg: oklch(0.21 0.006 285.885);
+  --investor-content-bg: oklch(0.97 0.001 286.32);
+
+  /* 创始人端主色 - indigo-600 */
+  --founder-primary: oklch(0.546 0.245 262.881);
+  --founder-header-bg: oklch(1 0 0);
+
+  /* Admin 端主色 - amber-400 + slate-950 */
+  --admin-primary: oklch(0.769 0.188 70.08);
+  --admin-header-bg: oklch(0.21 0.006 285.885);
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --color-success: var(--success);
+  --color-warning: var(--warning);
+  --color-destructive: var(--destructive);
+  --font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif;
+  --font-mono: "SF Mono", "Cascadia Code", "Fira Code", "JetBrains Mono", monospace;
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 4px);
+}
+
+body {
+  background: var(--background);
+  color: var(--foreground);
+  font-family: var(--font-sans);
+}
+
+/* ===== 打印样式 ===== */
+@media print {
+  header,
+  nav,
+  .no-print {
+    display: none !important;
+  }
+  .print-card {
+    box-shadow: none !important;
+    border: 1px solid #ccc !important;
+  }
+}
@@ -0,0 +1,19 @@
+import type { Metadata } from "next";
+import "./globals.css";
+
+export const metadata: Metadata = {
+  title: "AIPortPilot — AI+ 投后管理平台",
+  description: "投资人和创始人的共同操作系统",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="zh-CN" className="h-full antialiased">
+      <body className="min-h-full flex flex-col">{children}</body>
+    </html>
+  );
+}
@@ -0,0 +1,20 @@
+/** 登录页 — 占位页面。 */
+
+import { Lock } from "lucide-react";
+
+export default function LoginPage() {
+  return (
+    <div className="flex min-h-screen items-center justify-center bg-gradient-to-b from-indigo-50 to-white">
+      <div className="w-full max-w-sm rounded-lg border bg-white p-8 shadow-sm">
+        <div className="mb-6 flex flex-col items-center">
+          <div className="mb-3 flex h-12 w-12 items-center justify-center rounded-full bg-[var(--founder-primary)]/10">
+            <Lock className="text-[var(--founder-primary)]" size={24} aria-hidden="true" />
+          </div>
+          <h1 className="text-xl font-bold">AIPortPilot</h1>
+          <p className="mt-1 text-sm text-muted-foreground">AI+ 投后管理平台</p>
+        </div>
+        <p className="text-center text-sm text-muted-foreground">登录功能开发中</p>
+      </div>
+    </div>
+  );
+}
@@ -0,0 +1,6 @@
+import { redirect } from "next/navigation";
+
+/** 根路径重定向到投资人端驾驶舱。 */
+export default function Home() {
+  redirect("/dashboard");
+}
@@ -0,0 +1,28 @@
+/** 空状态占位组件。 */
+
+import { Inbox } from "lucide-react";
+import { cn } from "@/lib/utils";
+
+/**
+ * 空状态占位。
+ * @param title - 标题
+ * @param description - 描述
+ * @param className - 额外类名
+ */
+export function EmptyState({
+  title = "暂无数据",
+  description,
+  className,
+}: {
+  title?: string;
+  description?: string;
+  className?: string;
+}) {
+  return (
+    <div className={cn("flex flex-col items-center justify-center py-12 text-center", className)}>
+      <Inbox className="mb-3 text-muted-foreground" size={40} aria-hidden="true" />
+      <p className="text-sm font-medium text-foreground">{title}</p>
+      {description && <p className="mt-1 text-xs text-muted-foreground">{description}</p>}
+    </div>
+  );
+}
@@ -0,0 +1,29 @@
+/** 健康度评分徽章组件。 */
+
+import { cn } from "@/lib/utils";
+
+/**
+ * 健康度评分徽章。
+ * @param score - 分数（0-100）
+ * @param label - 标签文字
+ */
+export function HealthScoreBadge({ score, label }: { score: number; label?: string }) {
+  const level = score >= 80 ? "good" : score >= 60 ? "fair" : "poor";
+  const colors = {
+    good: "bg-[var(--success)]/10 text-[var(--success)] border-[var(--success)]/30",
+    fair: "bg-[var(--warning)]/10 text-[var(--warning)] border-[var(--warning)]/30",
+    poor: "bg-[var(--destructive)]/10 text-[var(--destructive)] border-[var(--destructive)]/30",
+  };
+
+  return (
+    <span
+      className={cn(
+        "inline-flex items-center rounded-md border px-2 py-0.5 text-xs font-medium",
+        colors[level],
+      )}
+    >
+      {label && <span className="mr-1">{label}</span>}
+      {score}
+    </span>
+  );
+}
@@ -0,0 +1,17 @@
+/** 加载中旋转图标组件。 */
+
+import { Loader2 } from "lucide-react";
+import { cn } from "@/lib/utils";
+
+/**
+ * 加载中旋转图标。
+ * @param className - 额外类名
+ * @param size - 图标尺寸（像素）
+ */
+export function LoadingSpinner({ className, size = 24 }: { className?: string; size?: number }) {
+  return (
+    <div className={cn("flex items-center justify-center", className)} role="status">
+      <Loader2 className="animate-spin text-muted-foreground" size={size} aria-label="加载中" />
+    </div>
+  );
+}
@@ -0,0 +1,44 @@
+/** API 客户端：统一请求封装。 */
+
+const API_BASE_URL = process.env.NEXT_PUBLIC_API_URL || "http://localhost:8000/api/v1";
+
+/**
+ * 统一 API 响应壳。
+ */
+export interface ApiResponse<T = unknown> {
+  code: number;
+  message: string;
+  data: T | null;
+  trace_id: string;
+  timestamp: string;
+}
+
+/**
+ * 发起 API 请求。
+ * @param path - API 路径（不含 base URL）
+ * @param options - fetch 选项
+ * @returns 解析后的响应数据
+ */
+export async function apiFetch<T = unknown>(
+  path: string,
+  options: RequestInit = {},
+): Promise<ApiResponse<T>> {
+  const token = typeof window !== "undefined" ? localStorage.getItem("token") : null;
+
+  const response = await fetch(`${API_BASE_URL}${path}`, {
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...(token ? { Authorization: `Bearer ${token}` } : {}),
+      ...options.headers,
+    },
+  });
+
+  const json: ApiResponse<T> = await response.json();
+
+  if (!response.ok || json.code !== 0) {
+    throw new Error(json.message || `请求失败: ${response.status}`);
+  }
+
+  return json;
+}
@@ -0,0 +1,13 @@
+/** 工具函数：合并 TailwindCSS 类名。 */
+
+import { clsx, type ClassValue } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+/**
+ * 合并 TailwindCSS 类名，解决冲突。
+ * @param inputs - 类名列表
+ * @returns 合并后的类名字符串
+ */
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}