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 体系完整
This commit is contained in:
selfrelease
2026-07-18 21:50:15 +08:00
parent f09aa33589
commit 51feae55ba
72 changed files with 8048 additions and 0 deletions
+41
View File
@@ -0,0 +1,41 @@
# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
# dependencies
/node_modules
/.pnp
.pnp.*
.yarn/*
!.yarn/patches
!.yarn/plugins
!.yarn/releases
!.yarn/versions
# testing
/coverage
# next.js
/.next/
/out/
# production
/build
# misc
.DS_Store
*.pem
# debug
npm-debug.log*
yarn-debug.log*
yarn-error.log*
.pnpm-debug.log*
# env files (can opt-in for committing if needed)
.env*
# vercel
.vercel
# typescript
*.tsbuildinfo
next-env.d.ts
+5
View File
@@ -0,0 +1,5 @@
<!-- BEGIN:nextjs-agent-rules -->
# This is NOT the Next.js you know
This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` before writing any code. Heed deprecation notices.
<!-- END:nextjs-agent-rules -->
+1
View File
@@ -0,0 +1 @@
@AGENTS.md
+21
View File
@@ -0,0 +1,21 @@
FROM node:22-alpine AS builder
WORKDIR /app
COPY package.json pnpm-lock.yaml ./
RUN npm install -g pnpm && pnpm install --frozen-lockfile
COPY . .
RUN pnpm build
FROM node:22-alpine AS runner
WORKDIR /app
COPY --from=builder /app/.next/standalone ./
COPY --from=builder /app/.next/static ./.next/static
COPY --from=builder /app/public ./public
EXPOSE 3000
CMD ["node", "server.js"]
+36
View File
@@ -0,0 +1,36 @@
This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
## Getting Started
First, run the development server:
```bash
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev
```
Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
## Learn More
To learn more about Next.js, take a look at the following resources:
- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
## Deploy on Vercel
The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
+18
View File
@@ -0,0 +1,18 @@
import { defineConfig, globalIgnores } from "eslint/config";
import nextVitals from "eslint-config-next/core-web-vitals";
import nextTs from "eslint-config-next/typescript";
const eslintConfig = defineConfig([
...nextVitals,
...nextTs,
// Override default ignores of eslint-config-next.
globalIgnores([
// Default ignores of eslint-config-next:
".next/**",
"out/**",
"build/**",
"next-env.d.ts",
]),
]);
export default eslintConfig;
+9
View File
@@ -0,0 +1,9 @@
import type { NextConfig } from "next";
const nextConfig: NextConfig = {
turbopack: {
root: __dirname,
},
};
export default nextConfig;
+35
View File
@@ -0,0 +1,35 @@
{
"name": "frontend",
"version": "0.1.0",
"private": true,
"scripts": {
"dev": "next dev",
"build": "next build",
"start": "next start",
"lint": "eslint"
},
"dependencies": {
"@radix-ui/react-dialog": "^1.1.19",
"@radix-ui/react-dropdown-menu": "^2.1.20",
"@radix-ui/react-slot": "^1.3.0",
"class-variance-authority": "^0.7.1",
"clsx": "^2.1.1",
"lucide-react": "^1.25.0",
"next": "16.2.10",
"react": "19.2.4",
"react-dom": "19.2.4",
"recharts": "^3.9.2",
"sonner": "^2.0.7",
"tailwind-merge": "^3.6.0"
},
"devDependencies": {
"@tailwindcss/postcss": "^4",
"@types/node": "^20",
"@types/react": "^19",
"@types/react-dom": "^19",
"eslint": "^9",
"eslint-config-next": "16.2.10",
"tailwindcss": "^4",
"typescript": "^5"
}
}
+5188
View File
File diff suppressed because it is too large Load Diff
+3
View File
@@ -0,0 +1,3 @@
ignoredBuiltDependencies:
- sharp
- unrs-resolver
+7
View File
@@ -0,0 +1,7 @@
const config = {
plugins: {
"@tailwindcss/postcss": {},
},
};
export default config;
+1
View File
@@ -0,0 +1 @@
<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

After

Width:  |  Height:  |  Size: 391 B

+1
View File
@@ -0,0 +1 @@
<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

After

Width:  |  Height:  |  Size: 1.0 KiB

+1
View File
@@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

After

Width:  |  Height:  |  Size: 1.3 KiB

+1
View File
@@ -0,0 +1 @@
<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

After

Width:  |  Height:  |  Size: 128 B

+1
View File
@@ -0,0 +1 @@
<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

After

Width:  |  Height:  |  Size: 385 B

@@ -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>
);
}
+44
View File
@@ -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>
);
}
+15
View File
@@ -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>
);
}
+12
View File
@@ -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>
);
}
Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

+12
View File
@@ -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>
);
}
+39
View File
@@ -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>
);
}
+15
View File
@@ -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>
);
}
+12
View File
@@ -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>
);
}
+72
View File
@@ -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;
}
}
+19
View File
@@ -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>
);
}
+20
View File
@@ -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>
);
}
+6
View File
@@ -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>
);
}
+44
View File
@@ -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;
}
+13
View File
@@ -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));
}
+34
View File
@@ -0,0 +1,34 @@
{
"compilerOptions": {
"target": "ES2017",
"lib": ["dom", "dom.iterable", "esnext"],
"allowJs": true,
"skipLibCheck": true,
"strict": true,
"noEmit": true,
"esModuleInterop": true,
"module": "esnext",
"moduleResolution": "bundler",
"resolveJsonModule": true,
"isolatedModules": true,
"jsx": "react-jsx",
"incremental": true,
"plugins": [
{
"name": "next"
}
],
"paths": {
"@/*": ["./src/*"]
}
},
"include": [
"next-env.d.ts",
"**/*.ts",
"**/*.tsx",
".next/types/**/*.ts",
".next/dev/types/**/*.ts",
"**/*.mts"
],
"exclude": ["node_modules"]
}