Initial Paprika Next.js implementation
This commit is contained in:
2
.env.example
Normal file
2
.env.example
Normal file
@@ -0,0 +1,2 @@
|
||||
DATABASE_URL="postgresql://paprika_app:REPLACE_WITH_SECURE_PASSWORD@127.0.0.1:5432/paprika"
|
||||
NEXT_PUBLIC_SITE_URL="https://paprikalaw.com"
|
||||
9
.gitignore
vendored
Normal file
9
.gitignore
vendored
Normal file
@@ -0,0 +1,9 @@
|
||||
.next/
|
||||
node_modules/
|
||||
dist/
|
||||
coverage/
|
||||
.env
|
||||
.env*.local
|
||||
*.log
|
||||
tsconfig.tsbuildinfo
|
||||
git.txt
|
||||
31
app/[page]/page.tsx
Normal file
31
app/[page]/page.tsx
Normal file
@@ -0,0 +1,31 @@
|
||||
import { notFound } from "next/navigation";
|
||||
import { LegacyPage } from "@/components/LegacyPage";
|
||||
import { legacyPages, type LegacyPageKey } from "@/lib/legacy-pages";
|
||||
|
||||
const routablePages = new Set(Object.keys(legacyPages));
|
||||
const replacedPages = new Set(["home", "start", "ask", "thanks"]);
|
||||
|
||||
export function generateStaticParams() {
|
||||
return Object.keys(legacyPages)
|
||||
.filter((page) => !replacedPages.has(page))
|
||||
.map((page) => ({ page }));
|
||||
}
|
||||
|
||||
export async function generateMetadata({ params }: { params: Promise<{ page: string }> }) {
|
||||
const { page: pageParam } = await params;
|
||||
if (!routablePages.has(pageParam)) return {};
|
||||
const page = legacyPages[pageParam as LegacyPageKey];
|
||||
return {
|
||||
title: page.title.replace("Paprika - ", "")
|
||||
};
|
||||
}
|
||||
|
||||
export default async function StaticPage({ params }: { params: Promise<{ page: string }> }) {
|
||||
const { page } = await params;
|
||||
|
||||
if (!routablePages.has(page) || replacedPages.has(page)) {
|
||||
notFound();
|
||||
}
|
||||
|
||||
return <LegacyPage pageKey={page as LegacyPageKey} />;
|
||||
}
|
||||
33
app/api/submissions/route.ts
Normal file
33
app/api/submissions/route.ts
Normal file
@@ -0,0 +1,33 @@
|
||||
import { NextResponse } from "next/server";
|
||||
import { ZodError } from "zod";
|
||||
import { createSubmission } from "@/lib/submissions";
|
||||
import { submissionSchema } from "@/lib/submission-schema";
|
||||
|
||||
export async function POST(request: Request) {
|
||||
try {
|
||||
const payload = await request.json();
|
||||
const input = submissionSchema.parse(payload);
|
||||
const submission = await createSubmission(input);
|
||||
|
||||
return NextResponse.json({
|
||||
submission_id: submission.id,
|
||||
created_at: submission.createdAt.toISOString()
|
||||
});
|
||||
} catch (error) {
|
||||
if (error instanceof ZodError) {
|
||||
return NextResponse.json(
|
||||
{
|
||||
error: "Validation failed",
|
||||
issues: error.flatten().fieldErrors
|
||||
},
|
||||
{ status: 400 }
|
||||
);
|
||||
}
|
||||
|
||||
console.error("Submission failed", error);
|
||||
return NextResponse.json(
|
||||
{ error: "Submission could not be saved. Please try again." },
|
||||
{ status: 500 }
|
||||
);
|
||||
}
|
||||
}
|
||||
29
app/ask/page.tsx
Normal file
29
app/ask/page.tsx
Normal file
@@ -0,0 +1,29 @@
|
||||
import Link from "next/link";
|
||||
import { SubmissionForm } from "@/components/forms/SubmissionForm";
|
||||
|
||||
export const metadata = {
|
||||
title: "Ask a Question"
|
||||
};
|
||||
|
||||
export default function AskPage() {
|
||||
return (
|
||||
<>
|
||||
<section className="hero subpage press-hero">
|
||||
<h1>Ask a question.</h1>
|
||||
<p className="subhead">
|
||||
Not ready to submit your full profile yet? Send us a quick question. We will help you
|
||||
understand whether Paprika may be a fit.
|
||||
</p>
|
||||
<div className="actions">
|
||||
<Link className="button primary" href="/start">
|
||||
Start Here
|
||||
</Link>
|
||||
<Link className="button secondary" href="/ask">
|
||||
Ask a Question
|
||||
</Link>
|
||||
</div>
|
||||
</section>
|
||||
<SubmissionForm type="ask" />
|
||||
</>
|
||||
);
|
||||
}
|
||||
2263
app/globals.css
Normal file
2263
app/globals.css
Normal file
File diff suppressed because it is too large
Load Diff
44
app/layout.tsx
Normal file
44
app/layout.tsx
Normal file
@@ -0,0 +1,44 @@
|
||||
import type { Metadata } from "next";
|
||||
import Link from "next/link";
|
||||
import { SiteHeader } from "@/components/SiteHeader";
|
||||
import "./globals.css";
|
||||
|
||||
export const metadata: Metadata = {
|
||||
metadataBase: new URL(process.env.NEXT_PUBLIC_SITE_URL || "https://paprikalaw.com"),
|
||||
title: {
|
||||
default: "Paprika",
|
||||
template: "Paprika - %s"
|
||||
},
|
||||
description:
|
||||
"Attorney-curated evidence building for O-1 talent through press, judging opportunities, scholarly articles, and documented profile strategy.",
|
||||
openGraph: {
|
||||
title: "Paprika",
|
||||
description:
|
||||
"Attorney-curated evidence building for O-1 talent through press, judging opportunities, scholarly articles, and documented profile strategy.",
|
||||
url: "/",
|
||||
siteName: "Paprika",
|
||||
type: "website"
|
||||
}
|
||||
};
|
||||
|
||||
export default function RootLayout({ children }: { children: React.ReactNode }) {
|
||||
return (
|
||||
<html lang="en">
|
||||
<body>
|
||||
<SiteHeader />
|
||||
<main>{children}</main>
|
||||
<footer>
|
||||
<div className="footer-links">
|
||||
<Link href="/why">About</Link>
|
||||
<Link href="/faq">FAQ</Link>
|
||||
<Link href="/terms">Terms</Link>
|
||||
<Link href="/privacy">Privacy</Link>
|
||||
<Link href="/disclaimer">Disclaimer</Link>
|
||||
</div>
|
||||
<div>Paprika is not a law firm and does not provide legal advice or immigration representation.</div>
|
||||
<div>Use of our services does not create an attorney-client relationship.</div>
|
||||
</footer>
|
||||
</body>
|
||||
</html>
|
||||
);
|
||||
}
|
||||
5
app/page.tsx
Normal file
5
app/page.tsx
Normal file
@@ -0,0 +1,5 @@
|
||||
import { LegacyPage } from "@/components/LegacyPage";
|
||||
|
||||
export default function HomePage() {
|
||||
return <LegacyPage pageKey="home" />;
|
||||
}
|
||||
13
app/robots.ts
Normal file
13
app/robots.ts
Normal file
@@ -0,0 +1,13 @@
|
||||
import type { MetadataRoute } from "next";
|
||||
|
||||
export default function robots(): MetadataRoute.Robots {
|
||||
const siteUrl = process.env.NEXT_PUBLIC_SITE_URL || "https://paprikalaw.com";
|
||||
|
||||
return {
|
||||
rules: {
|
||||
userAgent: "*",
|
||||
allow: "/"
|
||||
},
|
||||
sitemap: `${siteUrl}/sitemap.xml`
|
||||
};
|
||||
}
|
||||
28
app/sitemap.ts
Normal file
28
app/sitemap.ts
Normal file
@@ -0,0 +1,28 @@
|
||||
import type { MetadataRoute } from "next";
|
||||
|
||||
const routeOrder = [
|
||||
"home",
|
||||
"press",
|
||||
"judging",
|
||||
"scholarly",
|
||||
"services",
|
||||
"why",
|
||||
"resources",
|
||||
"faq",
|
||||
"start",
|
||||
"ask",
|
||||
"terms",
|
||||
"privacy",
|
||||
"disclaimer"
|
||||
] as const;
|
||||
|
||||
export default function sitemap(): MetadataRoute.Sitemap {
|
||||
const siteUrl = process.env.NEXT_PUBLIC_SITE_URL || "https://paprikalaw.com";
|
||||
|
||||
return routeOrder.map((key) => ({
|
||||
url: `${siteUrl}${key === "home" ? "" : `/${key}`}`,
|
||||
lastModified: new Date("2026-07-06"),
|
||||
changeFrequency: key === "home" ? "weekly" : "monthly",
|
||||
priority: key === "home" ? 1 : key === "start" ? 0.9 : 0.7
|
||||
}));
|
||||
}
|
||||
30
app/start/page.tsx
Normal file
30
app/start/page.tsx
Normal file
@@ -0,0 +1,30 @@
|
||||
import Link from "next/link";
|
||||
import { SubmissionForm } from "@/components/forms/SubmissionForm";
|
||||
|
||||
export const metadata = {
|
||||
title: "Start Here"
|
||||
};
|
||||
|
||||
export default function StartPage() {
|
||||
return (
|
||||
<>
|
||||
<section className="hero subpage press-hero">
|
||||
<h1>Start here.</h1>
|
||||
<p className="subhead">
|
||||
Tell us a little about your background, goals, and timeline, whether you are actively
|
||||
preparing or just starting to explore. No need to have everything figured out. A quick
|
||||
summary is enough to start.
|
||||
</p>
|
||||
<div className="actions">
|
||||
<Link className="button primary" href="/start">
|
||||
Start Here
|
||||
</Link>
|
||||
<Link className="button secondary" href="/ask">
|
||||
Ask a Question
|
||||
</Link>
|
||||
</div>
|
||||
</section>
|
||||
<SubmissionForm type="start" />
|
||||
</>
|
||||
);
|
||||
}
|
||||
29
app/thanks/page.tsx
Normal file
29
app/thanks/page.tsx
Normal file
@@ -0,0 +1,29 @@
|
||||
import Link from "next/link";
|
||||
|
||||
export const metadata = {
|
||||
title: "Thank You"
|
||||
};
|
||||
|
||||
export default function ThanksPage({
|
||||
searchParams
|
||||
}: {
|
||||
searchParams: { submission_id?: string };
|
||||
}) {
|
||||
return (
|
||||
<section className="notice">
|
||||
<h2>Thank you. We received your background.</h2>
|
||||
<p>
|
||||
The Paprika team will review your profile and follow up with next steps. If your timeline is
|
||||
urgent, mention that in your reply.
|
||||
</p>
|
||||
{searchParams.submission_id ? (
|
||||
<p className="form-success">Submission ID: {searchParams.submission_id}</p>
|
||||
) : null}
|
||||
<div className="actions">
|
||||
<Link className="button secondary" href="/">
|
||||
Back to Homepage
|
||||
</Link>
|
||||
</div>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
8
components/LegacyPage.tsx
Normal file
8
components/LegacyPage.tsx
Normal file
@@ -0,0 +1,8 @@
|
||||
import type { LegacyPageKey } from "@/lib/legacy-pages";
|
||||
import { legacyPages } from "@/lib/legacy-pages";
|
||||
|
||||
export function LegacyPage({ pageKey }: { pageKey: LegacyPageKey }) {
|
||||
const page = legacyPages[pageKey];
|
||||
|
||||
return <div dangerouslySetInnerHTML={{ __html: page.html }} />;
|
||||
}
|
||||
56
components/SiteHeader.tsx
Normal file
56
components/SiteHeader.tsx
Normal file
@@ -0,0 +1,56 @@
|
||||
"use client";
|
||||
|
||||
import Link from "next/link";
|
||||
import { usePathname } from "next/navigation";
|
||||
import { navItems, resourceItems } from "@/lib/navigation";
|
||||
|
||||
export function SiteHeader() {
|
||||
const pathname = usePathname();
|
||||
const current = pathname === "/" ? "home" : pathname.split("/")[1];
|
||||
const resourcesActive = current === "faq" || current === "resources";
|
||||
|
||||
return (
|
||||
<header className="site-header">
|
||||
<Link className="brand" href="/">
|
||||
<div className="brand-name">Paprika</div>
|
||||
<div className="brand-tag">Attorney Curated Evidence Building for O-1 Talent</div>
|
||||
</Link>
|
||||
<nav className="nav" id="nav">
|
||||
{navItems.map((item) => (
|
||||
<Link
|
||||
key={item.key}
|
||||
href={item.href}
|
||||
data-page={item.key}
|
||||
className={current === item.key ? "active" : undefined}
|
||||
>
|
||||
{item.label}
|
||||
</Link>
|
||||
))}
|
||||
<div className="nav-dropdown">
|
||||
<Link
|
||||
href="/resources"
|
||||
className={`nav-trigger${resourcesActive ? " active" : ""}`}
|
||||
data-page="resources"
|
||||
>
|
||||
Resources <span className="nav-chevron">⌄</span>
|
||||
</Link>
|
||||
<div className="resources-menu" aria-label="Resources menu">
|
||||
{resourceItems.map((item) => (
|
||||
<Link key={item.key} href={item.href} data-page={item.key}>
|
||||
<strong>{item.label}</strong>
|
||||
<span>{item.description}</span>
|
||||
</Link>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
<Link
|
||||
href="/start"
|
||||
className={`start${current === "start" ? " active" : ""}`}
|
||||
data-page="start"
|
||||
>
|
||||
Start Here <span className="button-arrow">→</span>
|
||||
</Link>
|
||||
</nav>
|
||||
</header>
|
||||
);
|
||||
}
|
||||
150
components/forms/SubmissionForm.tsx
Normal file
150
components/forms/SubmissionForm.tsx
Normal file
@@ -0,0 +1,150 @@
|
||||
"use client";
|
||||
|
||||
import { useRouter } from "next/navigation";
|
||||
import { useState, type FormEvent } from "react";
|
||||
|
||||
type FormType = "start" | "ask";
|
||||
|
||||
type FieldErrors = Record<string, string[] | undefined>;
|
||||
|
||||
export function SubmissionForm({ type }: { type: FormType }) {
|
||||
const router = useRouter();
|
||||
const [errors, setErrors] = useState<FieldErrors>({});
|
||||
const [status, setStatus] = useState<"idle" | "submitting" | "error">("idle");
|
||||
|
||||
async function handleSubmit(event: FormEvent<HTMLFormElement>) {
|
||||
event.preventDefault();
|
||||
setErrors({});
|
||||
setStatus("submitting");
|
||||
|
||||
const form = new FormData(event.currentTarget);
|
||||
const payload = Object.fromEntries(form.entries());
|
||||
|
||||
const response = await fetch("/api/submissions", {
|
||||
method: "POST",
|
||||
headers: { "Content-Type": "application/json" },
|
||||
body: JSON.stringify({
|
||||
...payload,
|
||||
type,
|
||||
consentAccepted: form.get("consentAccepted") === "on",
|
||||
sourcePath: type === "start" ? "/start" : "/ask"
|
||||
})
|
||||
});
|
||||
|
||||
const result = await response.json().catch(() => ({}));
|
||||
|
||||
if (!response.ok) {
|
||||
setErrors(result.issues || { form: [result.error || "Submission failed"] });
|
||||
setStatus("error");
|
||||
return;
|
||||
}
|
||||
|
||||
router.push(`/thanks?submission_id=${encodeURIComponent(result.submission_id)}`);
|
||||
}
|
||||
|
||||
return (
|
||||
<form className="form-wrap" onSubmit={handleSubmit}>
|
||||
<label className="field">
|
||||
Name <span className="req">*</span>
|
||||
<input className="field-control" name="name" autoComplete="name" required />
|
||||
<FieldError errors={errors} name="name" />
|
||||
</label>
|
||||
<label className="field">
|
||||
Email <span className="req">*</span>
|
||||
<input className="field-control" name="email" type="email" autoComplete="email" required />
|
||||
<FieldError errors={errors} name="email" />
|
||||
</label>
|
||||
<label className="field">
|
||||
LinkedIn {type === "ask" ? <span>(optional)</span> : null}
|
||||
<input className="field-control" name="linkedin" type="url" placeholder="https://linkedin.com/in/..." />
|
||||
<FieldError errors={errors} name="linkedin" />
|
||||
</label>
|
||||
|
||||
{type === "start" ? <StartFields errors={errors} /> : <AskFields errors={errors} />}
|
||||
|
||||
<label className="field large checkbox-field">
|
||||
<input name="consentAccepted" type="checkbox" required />
|
||||
<span>
|
||||
I understand that submitting this form does not create an attorney-client relationship or
|
||||
constitute legal advice. Paprika is not a law firm and does not provide legal services.
|
||||
</span>
|
||||
<FieldError errors={errors} name="consentAccepted" />
|
||||
</label>
|
||||
|
||||
{errors.form?.length ? <div className="form-error">{errors.form[0]}</div> : null}
|
||||
|
||||
<button className="button primary" type="submit" disabled={status === "submitting"}>
|
||||
{status === "submitting" ? "Submitting..." : type === "start" ? "Submit Profile" : "Send Question"}
|
||||
</button>
|
||||
<div className="form-note">
|
||||
File upload is intentionally disabled until storage, size limits, access control, and privacy
|
||||
handling are approved.
|
||||
</div>
|
||||
</form>
|
||||
);
|
||||
}
|
||||
|
||||
function StartFields({ errors }: { errors: FieldErrors }) {
|
||||
return (
|
||||
<>
|
||||
<label className="field">
|
||||
Company Website
|
||||
<input className="field-control" name="companyWebsite" type="url" placeholder="https://..." />
|
||||
<FieldError errors={errors} name="companyWebsite" />
|
||||
</label>
|
||||
<label className="field">
|
||||
Current Role / Company
|
||||
<input className="field-control" name="currentRoleCompany" />
|
||||
</label>
|
||||
<label className="field">
|
||||
Field or Industry
|
||||
<input className="field-control" name="fieldOrIndustry" />
|
||||
</label>
|
||||
<label className="field large start-question-field">
|
||||
<strong>
|
||||
What brings you to Paprika? <span className="req">*</span>
|
||||
</strong>
|
||||
<span>
|
||||
Tell us where you are in your O-1 journey. Whether you have a specific goal, are building
|
||||
evidence early, or are just exploring, a quick summary is enough.
|
||||
</span>
|
||||
<textarea className="field-control" name="reason" required />
|
||||
<FieldError errors={errors} name="reason" />
|
||||
</label>
|
||||
<label className="field large start-question-field">
|
||||
<strong>What recognition have you already built, if any?</strong>
|
||||
<span>
|
||||
Press, interviews, judging roles, awards, speaking, scholarly articles, patents, funding,
|
||||
major projects, or other recognition.
|
||||
</span>
|
||||
<textarea className="field-control" name="existingRecognition" />
|
||||
</label>
|
||||
<label className="field large start-question-field">
|
||||
<strong>Is there a timeline on your mind?</strong>
|
||||
<span>
|
||||
Whether it is urgent, months away, or just a future possibility, an approximate timeline
|
||||
helps us recommend the right pace.
|
||||
</span>
|
||||
<textarea className="field-control" name="timeline" />
|
||||
</label>
|
||||
</>
|
||||
);
|
||||
}
|
||||
|
||||
function AskFields({ errors }: { errors: FieldErrors }) {
|
||||
return (
|
||||
<label className="field large question-field">
|
||||
<strong>
|
||||
Your question <span className="req">*</span>
|
||||
</strong>
|
||||
<span>Ask us anything about our services, your situation, or where to start.</span>
|
||||
<textarea className="field-control" name="question" required />
|
||||
<FieldError errors={errors} name="question" />
|
||||
</label>
|
||||
);
|
||||
}
|
||||
|
||||
function FieldError({ errors, name }: { errors: FieldErrors; name: string }) {
|
||||
const message = errors[name]?.[0];
|
||||
return message ? <span className="form-error">{message}</span> : null;
|
||||
}
|
||||
27
doc/README.md
Normal file
27
doc/README.md
Normal file
@@ -0,0 +1,27 @@
|
||||
# Paprika Frontend Mockup
|
||||
|
||||
This repository contains the current Paprika website mockup.
|
||||
|
||||
## Open the mockup
|
||||
|
||||
Open `index.html` in a browser.
|
||||
|
||||
The mockup is a single self-contained HTML file with all page routes handled through query parameters, including:
|
||||
|
||||
- `?page=home`
|
||||
- `?page=press`
|
||||
- `?page=judging`
|
||||
- `?page=scholarly`
|
||||
- `?page=services`
|
||||
- `?page=why`
|
||||
- `?page=resources`
|
||||
- `?page=faq`
|
||||
- `?page=terms`
|
||||
- `?page=privacy`
|
||||
- `?page=disclaimer`
|
||||
- `?page=start`
|
||||
- `?page=ask`
|
||||
|
||||
## Upload rule
|
||||
|
||||
After each approved refinement is completed, commit the updated mockup and upload it to the cloud repository immediately.
|
||||
3423
doc/index.html
Normal file
3423
doc/index.html
Normal file
File diff suppressed because it is too large
Load Diff
10
eslint.config.mjs
Normal file
10
eslint.config.mjs
Normal file
@@ -0,0 +1,10 @@
|
||||
import nextVitals from "eslint-config-next/core-web-vitals";
|
||||
|
||||
const config = [
|
||||
...nextVitals,
|
||||
{
|
||||
ignores: [".next/**", "node_modules/**", "lib/legacy-pages.ts"]
|
||||
}
|
||||
];
|
||||
|
||||
export default config;
|
||||
15
lib/db.ts
Normal file
15
lib/db.ts
Normal file
@@ -0,0 +1,15 @@
|
||||
import { PrismaClient } from "@prisma/client";
|
||||
|
||||
const globalForPrisma = globalThis as unknown as {
|
||||
prisma?: PrismaClient;
|
||||
};
|
||||
|
||||
export const prisma =
|
||||
globalForPrisma.prisma ??
|
||||
new PrismaClient({
|
||||
log: process.env.NODE_ENV === "development" ? ["error", "warn"] : ["error"]
|
||||
});
|
||||
|
||||
if (process.env.NODE_ENV !== "production") {
|
||||
globalForPrisma.prisma = prisma;
|
||||
}
|
||||
83
lib/legacy-pages.ts
Normal file
83
lib/legacy-pages.ts
Normal file
File diff suppressed because one or more lines are too long
22
lib/navigation.ts
Normal file
22
lib/navigation.ts
Normal file
@@ -0,0 +1,22 @@
|
||||
export const navItems = [
|
||||
{ href: "/press", label: "Press", key: "press" },
|
||||
{ href: "/judging", label: "Judging", key: "judging" },
|
||||
{ href: "/scholarly", label: "Scholarly Articles", key: "scholarly" },
|
||||
{ href: "/services", label: "Services", key: "services" },
|
||||
{ href: "/why", label: "Why Paprika", key: "why" }
|
||||
] as const;
|
||||
|
||||
export const resourceItems = [
|
||||
{
|
||||
href: "/faq",
|
||||
key: "faq",
|
||||
label: "Frequently Asked Questions",
|
||||
description: "Common questions before you start"
|
||||
},
|
||||
{
|
||||
href: "/resources",
|
||||
key: "resources",
|
||||
label: "O-1A Criteria Overview",
|
||||
description: "All 8 O-1A criteria, explained"
|
||||
}
|
||||
] as const;
|
||||
46
lib/submission-schema.ts
Normal file
46
lib/submission-schema.ts
Normal file
@@ -0,0 +1,46 @@
|
||||
import { z } from "zod";
|
||||
|
||||
const emptyToUndefined = (value: unknown) => {
|
||||
if (typeof value !== "string") return value;
|
||||
const trimmed = value.trim();
|
||||
return trimmed.length ? trimmed : undefined;
|
||||
};
|
||||
|
||||
const optionalString = z.preprocess(emptyToUndefined, z.string().max(4000).optional());
|
||||
const optionalUrl = z.preprocess(
|
||||
emptyToUndefined,
|
||||
z.string().url("Enter a valid URL, including https://").max(500).optional()
|
||||
);
|
||||
|
||||
const baseSubmissionSchema = z.object({
|
||||
type: z.enum(["start", "ask"]),
|
||||
name: z.string().trim().min(1, "Name is required").max(160),
|
||||
email: z.string().trim().email("Enter a valid email").max(255),
|
||||
linkedin: optionalUrl,
|
||||
consentAccepted: z.literal(true, {
|
||||
errorMap: () => ({ message: "You must acknowledge the disclaimer before submitting" })
|
||||
}),
|
||||
sourcePath: z.string().max(200).optional()
|
||||
});
|
||||
|
||||
export const startSubmissionSchema = baseSubmissionSchema.extend({
|
||||
type: z.literal("start"),
|
||||
companyWebsite: optionalUrl,
|
||||
currentRoleCompany: optionalString,
|
||||
fieldOrIndustry: optionalString,
|
||||
reason: z.string().trim().min(1, "Tell us what brings you to Paprika").max(4000),
|
||||
existingRecognition: optionalString,
|
||||
timeline: optionalString
|
||||
});
|
||||
|
||||
export const askSubmissionSchema = baseSubmissionSchema.extend({
|
||||
type: z.literal("ask"),
|
||||
question: z.string().trim().min(1, "Question is required").max(4000)
|
||||
});
|
||||
|
||||
export const submissionSchema = z.discriminatedUnion("type", [
|
||||
startSubmissionSchema,
|
||||
askSubmissionSchema
|
||||
]);
|
||||
|
||||
export type SubmissionInput = z.infer<typeof submissionSchema>;
|
||||
26
lib/submissions.ts
Normal file
26
lib/submissions.ts
Normal file
@@ -0,0 +1,26 @@
|
||||
import { prisma } from "@/lib/db";
|
||||
import type { SubmissionInput } from "@/lib/submission-schema";
|
||||
|
||||
export async function createSubmission(input: SubmissionInput) {
|
||||
return prisma.submission.create({
|
||||
data: {
|
||||
type: input.type,
|
||||
name: input.name,
|
||||
email: input.email,
|
||||
linkedin: input.linkedin,
|
||||
companyWebsite: input.type === "start" ? input.companyWebsite : undefined,
|
||||
currentRoleCompany: input.type === "start" ? input.currentRoleCompany : undefined,
|
||||
fieldOrIndustry: input.type === "start" ? input.fieldOrIndustry : undefined,
|
||||
reason: input.type === "start" ? input.reason : undefined,
|
||||
existingRecognition: input.type === "start" ? input.existingRecognition : undefined,
|
||||
timeline: input.type === "start" ? input.timeline : undefined,
|
||||
question: input.type === "ask" ? input.question : undefined,
|
||||
consentAccepted: input.consentAccepted,
|
||||
sourcePath: input.sourcePath
|
||||
},
|
||||
select: {
|
||||
id: true,
|
||||
createdAt: true
|
||||
}
|
||||
});
|
||||
}
|
||||
6
next-env.d.ts
vendored
Normal file
6
next-env.d.ts
vendored
Normal file
@@ -0,0 +1,6 @@
|
||||
/// <reference types="next" />
|
||||
/// <reference types="next/image-types/global" />
|
||||
import "./.next/types/routes.d.ts";
|
||||
|
||||
// NOTE: This file should not be edited
|
||||
// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.
|
||||
4
next.config.mjs
Normal file
4
next.config.mjs
Normal file
@@ -0,0 +1,4 @@
|
||||
/** @type {import('next').NextConfig} */
|
||||
const nextConfig = {};
|
||||
|
||||
export default nextConfig;
|
||||
5783
package-lock.json
generated
Normal file
5783
package-lock.json
generated
Normal file
File diff suppressed because it is too large
Load Diff
30
package.json
Normal file
30
package.json
Normal file
@@ -0,0 +1,30 @@
|
||||
{
|
||||
"name": "meetpaprika",
|
||||
"version": "0.1.0",
|
||||
"private": true,
|
||||
"scripts": {
|
||||
"dev": "next dev",
|
||||
"build": "next build",
|
||||
"start": "next start",
|
||||
"lint": "eslint .",
|
||||
"generate:legacy": "node scripts/extract-legacy-pages.mjs",
|
||||
"prisma:generate": "prisma generate",
|
||||
"prisma:migrate": "prisma migrate dev"
|
||||
},
|
||||
"dependencies": {
|
||||
"@prisma/client": "^5.22.0",
|
||||
"next": "^16.2.10",
|
||||
"prisma": "^5.22.0",
|
||||
"react": "^19.2.7",
|
||||
"react-dom": "^19.2.7",
|
||||
"zod": "^3.23.8"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@types/node": "^20.14.10",
|
||||
"@types/react": "^19.2.17",
|
||||
"@types/react-dom": "^19.2.3",
|
||||
"eslint": "^9.39.4",
|
||||
"eslint-config-next": "^16.2.10",
|
||||
"typescript": "^5.5.3"
|
||||
}
|
||||
}
|
||||
39
prisma/migrations/20260706120000_init/migration.sql
Normal file
39
prisma/migrations/20260706120000_init/migration.sql
Normal file
@@ -0,0 +1,39 @@
|
||||
-- CreateTable
|
||||
CREATE TABLE "Submission" (
|
||||
"id" TEXT NOT NULL,
|
||||
"type" TEXT NOT NULL,
|
||||
"name" TEXT NOT NULL,
|
||||
"email" TEXT NOT NULL,
|
||||
"linkedin" TEXT,
|
||||
"companyWebsite" TEXT,
|
||||
"currentRoleCompany" TEXT,
|
||||
"fieldOrIndustry" TEXT,
|
||||
"reason" TEXT,
|
||||
"existingRecognition" TEXT,
|
||||
"timeline" TEXT,
|
||||
"question" TEXT,
|
||||
"consentAccepted" BOOLEAN NOT NULL DEFAULT false,
|
||||
"sourcePath" TEXT,
|
||||
"status" TEXT NOT NULL DEFAULT 'new',
|
||||
"createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||||
"updatedAt" TIMESTAMP(3) NOT NULL,
|
||||
|
||||
CONSTRAINT "Submission_pkey" PRIMARY KEY ("id")
|
||||
);
|
||||
|
||||
-- CreateTable
|
||||
CREATE TABLE "SubmissionFile" (
|
||||
"id" TEXT NOT NULL,
|
||||
"submissionId" TEXT NOT NULL,
|
||||
"fileName" TEXT NOT NULL,
|
||||
"mimeType" TEXT NOT NULL,
|
||||
"byteSize" INTEGER NOT NULL,
|
||||
"storageKey" TEXT NOT NULL,
|
||||
"createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||||
|
||||
CONSTRAINT "SubmissionFile_pkey" PRIMARY KEY ("id")
|
||||
);
|
||||
|
||||
-- AddForeignKey
|
||||
ALTER TABLE "SubmissionFile" ADD CONSTRAINT "SubmissionFile_submissionId_fkey" FOREIGN KEY ("submissionId") REFERENCES "Submission"("id") ON DELETE CASCADE ON UPDATE CASCADE;
|
||||
|
||||
40
prisma/schema.prisma
Normal file
40
prisma/schema.prisma
Normal file
@@ -0,0 +1,40 @@
|
||||
generator client {
|
||||
provider = "prisma-client-js"
|
||||
}
|
||||
|
||||
datasource db {
|
||||
provider = "postgresql"
|
||||
url = env("DATABASE_URL")
|
||||
}
|
||||
|
||||
model Submission {
|
||||
id String @id @default(cuid())
|
||||
type String
|
||||
name String
|
||||
email String
|
||||
linkedin String?
|
||||
companyWebsite String?
|
||||
currentRoleCompany String?
|
||||
fieldOrIndustry String?
|
||||
reason String?
|
||||
existingRecognition String?
|
||||
timeline String?
|
||||
question String?
|
||||
consentAccepted Boolean @default(false)
|
||||
sourcePath String?
|
||||
status String @default("new")
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
files SubmissionFile[]
|
||||
}
|
||||
|
||||
model SubmissionFile {
|
||||
id String @id @default(cuid())
|
||||
submissionId String
|
||||
fileName String
|
||||
mimeType String
|
||||
byteSize Int
|
||||
storageKey String
|
||||
createdAt DateTime @default(now())
|
||||
submission Submission @relation(fields: [submissionId], references: [id], onDelete: Cascade)
|
||||
}
|
||||
101
scripts/extract-legacy-pages.mjs
Normal file
101
scripts/extract-legacy-pages.mjs
Normal file
@@ -0,0 +1,101 @@
|
||||
import fs from "node:fs";
|
||||
import vm from "node:vm";
|
||||
|
||||
const sourcePath = "doc/index.html";
|
||||
const html = fs.readFileSync(sourcePath, "utf8");
|
||||
|
||||
const styleMatch = html.match(/<style>([\s\S]*?)<\/style>/);
|
||||
const scriptMatch = html.match(/<script>([\s\S]*?)<\/script>/);
|
||||
|
||||
if (!styleMatch || !scriptMatch) {
|
||||
throw new Error("Could not find inline style or script in doc/index.html");
|
||||
}
|
||||
|
||||
const css = styleMatch[1]
|
||||
.replaceAll("href=\"?page=", "href=\"/")
|
||||
.replace(/href="\/home"/g, "href=\"/\"");
|
||||
|
||||
const legacyScript = scriptMatch[1];
|
||||
const renderScript = legacyScript.replace(
|
||||
/const params = new URLSearchParams\(window\.location\.search\);[\s\S]*$/,
|
||||
"globalThis.__pageData = pageData;"
|
||||
);
|
||||
|
||||
const sandbox = {
|
||||
console,
|
||||
URLSearchParams,
|
||||
window: { location: { search: "" } },
|
||||
document: {
|
||||
title: "",
|
||||
getElementById() {
|
||||
return { innerHTML: "" };
|
||||
},
|
||||
querySelectorAll() {
|
||||
return [];
|
||||
},
|
||||
querySelector() {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
vm.createContext(sandbox);
|
||||
vm.runInContext(renderScript, sandbox, { filename: sourcePath });
|
||||
|
||||
const pageData = sandbox.__pageData;
|
||||
const routeMap = {
|
||||
home: "/",
|
||||
press: "/press",
|
||||
judging: "/judging",
|
||||
scholarly: "/scholarly",
|
||||
services: "/services",
|
||||
why: "/why",
|
||||
resources: "/resources",
|
||||
faq: "/faq",
|
||||
thanks: "/thanks",
|
||||
terms: "/terms",
|
||||
privacy: "/privacy",
|
||||
disclaimer: "/disclaimer"
|
||||
};
|
||||
|
||||
const pages = Object.fromEntries(
|
||||
Object.entries(routeMap).map(([key, path]) => {
|
||||
const page = pageData[key];
|
||||
if (!page?.body) {
|
||||
throw new Error(`Missing page body for ${key}`);
|
||||
}
|
||||
return [
|
||||
key,
|
||||
{
|
||||
key,
|
||||
path,
|
||||
title: key === "home" ? "Paprika" : `Paprika - ${key}`,
|
||||
html: normalizeLinks(page.body)
|
||||
}
|
||||
];
|
||||
})
|
||||
);
|
||||
|
||||
function normalizeLinks(value) {
|
||||
return value
|
||||
.replaceAll("href=\"?page=home\"", "href=\"/\"")
|
||||
.replace(/href="\?page=([a-z-]+)"/g, (_match, page) => {
|
||||
if (page === "home") return "href=\"/\"";
|
||||
return `href="/${page}"`;
|
||||
});
|
||||
}
|
||||
|
||||
fs.mkdirSync("app", { recursive: true });
|
||||
fs.mkdirSync("lib", { recursive: true });
|
||||
|
||||
fs.writeFileSync(
|
||||
"app/globals.css",
|
||||
`${css}\n\n.form-error { color: var(--deep-red); font-size: 14px; font-weight: 750; line-height: 1.4; }\n.form-success { color: var(--green); font-size: 14px; font-weight: 750; line-height: 1.4; }\n.field-control { width: 100%; border: 0; outline: 0; background: transparent; color: var(--ink); font: inherit; font-weight: 650; }\n.field-control::placeholder { color: var(--muted); opacity: .78; }\ntextarea.field-control { min-height: 126px; resize: vertical; line-height: 1.45; }\n.checkbox-field { align-items: flex-start; gap: 12px; text-align: left; color: var(--text); font-size: 14px; line-height: 1.45; }\n.checkbox-field input { margin-top: 3px; accent-color: var(--red); }\n.button[disabled] { cursor: not-allowed; opacity: .62; }\n`
|
||||
);
|
||||
|
||||
fs.writeFileSync(
|
||||
"lib/legacy-pages.ts",
|
||||
`export type LegacyPageKey = ${Object.keys(pages).map((key) => JSON.stringify(key)).join(" | ")};\n\nexport type LegacyPage = {\n key: LegacyPageKey;\n path: string;\n title: string;\n html: string;\n};\n\nexport const legacyPages = ${JSON.stringify(pages, null, 2)} as const satisfies Record<LegacyPageKey, LegacyPage>;\n`
|
||||
);
|
||||
|
||||
console.log(`Generated ${Object.keys(pages).length} pages from ${sourcePath}`);
|
||||
41
tsconfig.json
Normal file
41
tsconfig.json
Normal file
@@ -0,0 +1,41 @@
|
||||
{
|
||||
"compilerOptions": {
|
||||
"target": "es2017",
|
||||
"lib": [
|
||||
"dom",
|
||||
"dom.iterable",
|
||||
"esnext"
|
||||
],
|
||||
"allowJs": false,
|
||||
"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": {
|
||||
"@/*": [
|
||||
"./*"
|
||||
]
|
||||
}
|
||||
},
|
||||
"include": [
|
||||
"next-env.d.ts",
|
||||
"**/*.ts",
|
||||
"**/*.tsx",
|
||||
".next/types/**/*.ts",
|
||||
".next/dev/types/**/*.ts"
|
||||
],
|
||||
"exclude": [
|
||||
"node_modules"
|
||||
]
|
||||
}
|
||||
771
working/01-项目功能内容.md
Normal file
771
working/01-项目功能内容.md
Normal file
@@ -0,0 +1,771 @@
|
||||
# 01-项目功能内容
|
||||
|
||||
## 1. 项目基线
|
||||
|
||||
- 项目名称：MeetPaprika / Paprika
|
||||
- 当前对标文件：`/home/mes123456/MeetPaprika/doc/index.html`
|
||||
- 原始对标形态：单文件静态网站 mockup，HTML、CSS、页面数据、页面渲染脚本全部内联在 `doc/index.html`
|
||||
- 品牌主张：Attorney Curated Evidence Building for O-1 Talent
|
||||
- 业务定位：面向 O-1 人才的证据建设服务，帮助 founders、engineers、researchers、executives、creators 等提前建设媒体报道、评审机会、学术文章和完整证据包
|
||||
- 页面运行方式：读取 URL 查询参数 `?page=...`，将对应页面 HTML 字符串写入 `<main id="app"></main>`
|
||||
|
||||
## 2. 技术路线基准
|
||||
|
||||
### 当前静态实现
|
||||
|
||||
- 入口文件：`doc/index.html`
|
||||
- 样式：内联 `<style>`
|
||||
- 脚本：内联 `<script>`
|
||||
- 状态：作为旧版静态 mockup 和视觉对标基线保留；正式工程已在根目录新增
|
||||
- 路由：查询参数路由，不依赖 History API
|
||||
|
||||
### 已落地的正式开发技术架构
|
||||
|
||||
已明确采用：
|
||||
|
||||
- 前端框架：Next.js + React
|
||||
- 数据库：PostgreSQL
|
||||
- 数据访问层：Prisma ORM
|
||||
- 表单处理：Next.js Route Handler `POST /api/submissions` 承接 Start Here 和 Ask a Question
|
||||
- 部署端口：Next.js 服务或反向代理后的应用服务监听 `8082`
|
||||
- HTTPS：由 Nginx/Caddy/云服务反向代理终止 TLS，转发到本机 `8082`
|
||||
|
||||
架构目标：
|
||||
|
||||
- 将当前 `doc/index.html` 的视觉和内容完整迁移到 Next.js 页面/组件。
|
||||
- 将 `start` 和 `ask` 从视觉 mockup 改为真实表单。
|
||||
- 将提交数据保存到 PostgreSQL。
|
||||
- 预留 CV/resume 文件上传能力，但必须先明确存储方案、文件大小、访问权限和隐私规则。
|
||||
- 保留所有 legal disclaimer，防止用户误以为提交表单会创建 attorney-client relationship。
|
||||
|
||||
当前代码状态：
|
||||
|
||||
- 根目录已存在 Next.js App Router 工程。
|
||||
- `app/[page]/page.tsx` 渲染从 `doc/index.html` 抽取的静态页面内容。
|
||||
- `app/start/page.tsx` 和 `app/ask/page.tsx` 已替换为真实 React 表单。
|
||||
- `app/api/submissions/route.ts` 已实现 JSON 提交、Zod 校验和 Prisma 写入。
|
||||
- `prisma/schema.prisma` 和 `prisma/migrations/20260706120000_init/migration.sql` 已建立 `Submission`、`SubmissionFile` 表。
|
||||
- `.env.example` 已提供 `DATABASE_URL` 和 `NEXT_PUBLIC_SITE_URL` 模板，不包含真实密码。
|
||||
- 成功入库尚需生产或本地 PostgreSQL `DATABASE_URL`。
|
||||
|
||||
建议工程结构：
|
||||
|
||||
```text
|
||||
app/
|
||||
page.tsx
|
||||
press/page.tsx
|
||||
judging/page.tsx
|
||||
scholarly/page.tsx
|
||||
services/page.tsx
|
||||
why/page.tsx
|
||||
resources/page.tsx
|
||||
faq/page.tsx
|
||||
start/page.tsx
|
||||
ask/page.tsx
|
||||
thanks/page.tsx
|
||||
terms/page.tsx
|
||||
privacy/page.tsx
|
||||
disclaimer/page.tsx
|
||||
api/
|
||||
submissions/route.ts
|
||||
components/
|
||||
SiteHeader.tsx
|
||||
SiteFooter.tsx
|
||||
Hero.tsx
|
||||
ServiceCard.tsx
|
||||
ServicesCta.tsx
|
||||
LegalPage.tsx
|
||||
forms/
|
||||
StartForm.tsx
|
||||
AskForm.tsx
|
||||
lib/
|
||||
db.ts
|
||||
validators.ts
|
||||
submissions.ts
|
||||
prisma/
|
||||
schema.prisma
|
||||
```
|
||||
|
||||
### 目标发布环境
|
||||
|
||||
- 目标域名：`https://paprikalaw.com/`
|
||||
- 云服务器：`170.106.192.152`
|
||||
- 登录用户：`ubuntu`
|
||||
- 目标端口：`8082`
|
||||
- 可用端口段：`8080-8099`
|
||||
- PostgreSQL：用户确认已在服务器安装完成，待验证服务状态、版本、应用数据库和应用用户
|
||||
- SSH 凭据：用户已在交接信息中提供；长期文档不保存明文密码，后续应改为 SSH key、部署密钥或受控密钥库
|
||||
- 目标发布形态：HTTPS 对外访问，服务内部监听 `8082` 或由反向代理转发至 `8082`
|
||||
|
||||
### 邮箱系统需求
|
||||
|
||||
- 普通用户网页登录：`https://mail.paprikalaw.com/webmail/`
|
||||
- 管理员网页登录：`https://mail.paprikalaw.com/admin/`
|
||||
- 管理员邮箱：`admin@paprikalaw.com`
|
||||
- 普通公司邮箱：
|
||||
- `info@paprikalaw.com`
|
||||
- `contact@paprikalaw.com`
|
||||
- `support@paprikalaw.com`
|
||||
- `sales@paprikalaw.com`
|
||||
- `marketing@paprikalaw.com`
|
||||
- `hr@paprikalaw.com`
|
||||
- `finance@paprikalaw.com`
|
||||
- `billing@paprikalaw.com`
|
||||
- `legal@paprikalaw.com`
|
||||
- `service@paprikalaw.com`
|
||||
- 凭据规则：用户已提供统一初始密码；长期文档不保存明文密码。创建后应要求首次登录修改，或为每个邮箱生成独立强密码。
|
||||
|
||||
邮件系统与网站的关系：
|
||||
|
||||
- 表单通知邮箱建议使用 `support@paprikalaw.com` 或 `contact@paprikalaw.com`。
|
||||
- 法务和隐私页面中的联系邮箱目前是 `support@meetpaprika.com`，上线前需统一为 `paprikalaw.com` 域名邮箱或保留现状并记录理由。
|
||||
- 若 Next.js 表单提交后发送邮件通知，需要配置 SMTP 凭据、发件地址、收件地址和退信策略。
|
||||
|
||||
## 3. 当前页面路由清单
|
||||
|
||||
| 路由 | 页面 | 导航入口 | 当前用途 | 状态 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| `?page=home` | Home | 品牌 logo 默认入口 | 品牌主张、三大核心服务、提前建设证据、工作流程、价格起点 | 已实现 mockup |
|
||||
| `?page=press` | Press | 顶部导航 Press | 媒体报道服务、证据标准、应避免的 press 类型、代表性 outlet 网络 | 已实现 mockup |
|
||||
| `?page=judging` | Judging | 顶部导航 Judging | 评审机会服务、哪些 judging counts、judging network、证据包内容 | 已实现 mockup |
|
||||
| `?page=scholarly` | Scholarly Articles | 顶部导航 Scholarly Articles | 学术文章服务、发表策略、证据包价值 | 已实现 mockup |
|
||||
| `?page=services` | Services | 顶部导航 Services | 6 类服务卡片和服务转化 CTA | 已实现 mockup |
|
||||
| `?page=why` | Why Paprika | 顶部导航 Why Paprika、footer About | 差异化说明、证据质量、时间节奏、完整证据记录 | 已实现 mockup |
|
||||
| `?page=resources` | Resources / O-1A Criteria | Resources 下拉 | 8 项 O-1A criteria 的 plain-English overview | 已实现 mockup |
|
||||
| `?page=faq` | FAQ | Resources 下拉、footer FAQ | Paprika、O-1、timeline、pricing/refund FAQ | 已实现 mockup |
|
||||
| `?page=start` | Start Here | 顶部 CTA、各页面 CTA | 背景资料提交视觉 mockup | 已实现视觉，未实现提交 |
|
||||
| `?page=ask` | Ask a Question | 各页面 secondary CTA | 简短问题提交视觉 mockup | 已实现视觉，未实现提交 |
|
||||
| `?page=thanks` | Thank You | 提交按钮跳转 | 感谢页 | 已实现 mockup |
|
||||
| `?page=terms` | Terms | footer Terms | 服务条款草稿 | 已实现草稿，需法务确认 |
|
||||
| `?page=privacy` | Privacy | footer Privacy | 隐私政策草稿 | 已实现草稿，需法务确认 |
|
||||
| `?page=disclaimer` | Disclaimer | footer Disclaimer | 法律免责声明草稿 | 已实现草稿，需法务确认 |
|
||||
| `?page=blog` | Blog | 无公开导航 | Field notes 文章卡片占位 | 代码存在，未公开 |
|
||||
| `?page=about` | About | 无公开导航；footer About 实际指向 `why` | 公司说明占位 | 代码存在，未公开 |
|
||||
|
||||
未识别路由会回退到 `home`，页面标题为 `Paprika - ${selected}`。
|
||||
|
||||
## 4. 全站公共模块
|
||||
|
||||
### Header
|
||||
|
||||
- 品牌区：
|
||||
- `Paprika`
|
||||
- `Attorney Curated Evidence Building for O-1 Talent`
|
||||
- 顶部导航：
|
||||
- Press
|
||||
- Judging
|
||||
- Scholarly Articles
|
||||
- Services
|
||||
- Why Paprika
|
||||
- Resources 下拉
|
||||
- Start Here CTA
|
||||
- Resources 下拉：
|
||||
- Frequently Asked Questions -> `?page=faq`
|
||||
- O-1A Criteria Overview -> `?page=resources`
|
||||
- 当前页高亮：
|
||||
- 根据 `data-page` 和当前 `selected` 页面添加 `active`
|
||||
- 当 `selected` 为 `faq` 或 `resources` 时，Resources 触发器高亮
|
||||
|
||||
### Footer
|
||||
|
||||
- 链接：
|
||||
- About -> `?page=why`
|
||||
- FAQ -> `?page=faq`
|
||||
- Terms -> `?page=terms`
|
||||
- Privacy -> `?page=privacy`
|
||||
- Disclaimer -> `?page=disclaimer`
|
||||
- 固定声明：
|
||||
- Paprika is not a law firm and does not provide legal advice or immigration representation.
|
||||
- Use of our services does not create an attorney-client relationship.
|
||||
|
||||
## 5. 首页内容
|
||||
|
||||
### Hero
|
||||
|
||||
- H1：O-1 evidence should not be built in a panic.
|
||||
- Subhead：帮助高成就人才提前建设 credible public recognition
|
||||
- Primary CTA：Send Us Your Profile -> `?page=start`
|
||||
- Secondary CTA：Ask a Question -> `?page=ask`
|
||||
- Microcopy：提交 LinkedIn 或 CV 后 review background，并推荐 evidence path
|
||||
- 时间主张：The only thing you cannot buy later is time.
|
||||
|
||||
### Core services
|
||||
|
||||
三张服务卡片：
|
||||
|
||||
1. Press：Editorial feature in a recognized publication in your field.
|
||||
2. Judging：Opportunities to judge work that matters.
|
||||
3. Scholarly Articles：Scholarly articles in credible, peer-reviewed publications.
|
||||
|
||||
### Start Early
|
||||
|
||||
- 强调证据不能临近 filing 时集中出现
|
||||
- 目标是构建 natural publication and judging timeline
|
||||
- 输出给用户或 immigration attorney 使用的 stronger materials
|
||||
|
||||
### Our standard
|
||||
|
||||
提出推荐前要判断的 8 个问题：
|
||||
|
||||
1. 文章是否关于个人而不只是公司或产品
|
||||
2. 是否连接特定专业领域和 O-1 criteria
|
||||
3. outlet 是否 credible、independent、documentable
|
||||
4. timing 是否自然
|
||||
5. judging 是否真实 evaluative
|
||||
6. authorship 是否体现 expertise
|
||||
7. 是否能清晰整理进 evidence package
|
||||
8. 是否补强其他 existing criteria
|
||||
|
||||
### How it works
|
||||
|
||||
四步流程：
|
||||
|
||||
1. Send us your profile
|
||||
2. Assess background and recommend evidence path
|
||||
3. Build credible public record
|
||||
4. Receive documented evidence package
|
||||
|
||||
价格带：
|
||||
|
||||
- Packages start at `$1,699+`
|
||||
- final pricing depends on outlet level, timeline, field, evidence goals
|
||||
|
||||
## 6. Press 页面内容
|
||||
|
||||
### 核心主张
|
||||
|
||||
- Attorney-Curated Press for O-1 Talent
|
||||
- Press that works as evidence, not just visibility
|
||||
- 关注 outlet、format、field relevance、documentation
|
||||
|
||||
### Cadence note
|
||||
|
||||
- 避免 filing 前突然集中出现的 uncurated evidence
|
||||
- 构建 natural cadence of press over time
|
||||
|
||||
### What Paprika looks for
|
||||
|
||||
Press 推荐前检查：
|
||||
|
||||
1. 文章是否关于本人
|
||||
2. headline 是否出现姓名并连接领域
|
||||
3. 是否 genuine editorial coverage
|
||||
4. outlet 是否有真实 readership、editorial standards、clean track record
|
||||
5. 是否存在 contributor、sponsored、editorial-staff-not-involved 等 disclosure
|
||||
6. timing 是否自然
|
||||
7. 是否 complement other O-1 criteria
|
||||
|
||||
结论句：The outlet name is not the evidence. The editorial independence is.
|
||||
|
||||
### What to avoid
|
||||
|
||||
当前展示三类不推荐 press：
|
||||
|
||||
- Contributor content
|
||||
- Editorial staff not involved
|
||||
- Sponsored or promotional placement
|
||||
|
||||
原因：
|
||||
|
||||
- outlet 没有 editorially choose to cover this person
|
||||
- third party produced or paid for content
|
||||
- 不体现 independent recognition
|
||||
|
||||
### Representative outlets
|
||||
|
||||
页面列出代表性 outlet 网络，包括 Forbes、Bloomberg、Vogue、Business Insider、USA Today、TechCrunch、VentureBeat、Los Angeles Times、Newsweek、Fast Company Mexico、Time 等。正式上线前需要确认是否拥有真实合作网络、是否允许展示、是否需要增加免责声明。
|
||||
|
||||
## 7. Judging 页面内容
|
||||
|
||||
### 核心主张
|
||||
|
||||
- Judging roles should show that your field trusts your expertise.
|
||||
- 服务目标：source and vet selective evaluation opportunities
|
||||
|
||||
### What counts as judging
|
||||
|
||||
当前列出 6 类：
|
||||
|
||||
1. Startup pitch competitions
|
||||
2. Hackathon & innovation judging
|
||||
3. Industry award committees
|
||||
4. Academic & conference peer review
|
||||
5. Grant review panels
|
||||
6. Research competition judging
|
||||
|
||||
### Judging network examples
|
||||
|
||||
当前展示示例 chips：Y Combinator Demo Day Adjacent、TechCrunch Disrupt、SXSW Pitch、Web Summit、Slush、Collision、Startup Grind Global、MassChallenge、Plug and Play、500 Global、Berkeley SkyDeck、Techstars、Founder Institute、academic journal review、conference TPCs、design competition juries、arts award panels、research grant committees 等。
|
||||
|
||||
正式上线前需要确认名称使用风险、真实性、合作关系或改为“示例类型”。
|
||||
|
||||
### Evidence package
|
||||
|
||||
Judging package 当前包含：
|
||||
|
||||
- Signed organizer recommendation letter
|
||||
- Judge selection documentation
|
||||
- Organizer correspondence
|
||||
- Agenda & event page
|
||||
- Panel agenda & bio listing
|
||||
- Ready-to-use packet
|
||||
|
||||
## 8. Scholarly Articles 页面内容
|
||||
|
||||
核心内容：
|
||||
|
||||
- Scholarly articles in credible, peer-reviewed publications
|
||||
- 服务覆盖 peer-reviewed、Scopus-indexed、Google-verified journals
|
||||
- 两个 panel：
|
||||
- Attorney-curated strategy
|
||||
- Complete evidence packet
|
||||
|
||||
正式上线前需确认：
|
||||
|
||||
- 是否能承诺具体 indexing 或 journal 类型
|
||||
- 是否需要补充 publication ethics、authorship、conflict disclosure
|
||||
- 是否避免暗示 pay-to-publish 或不当 authorship arrangement
|
||||
|
||||
## 9. Services 页面内容
|
||||
|
||||
六张服务卡：
|
||||
|
||||
| 编号 | 服务 | 当前标题 | CTA |
|
||||
| --- | --- | --- | --- |
|
||||
| 01 | Press | Editorial feature in a recognized publication in your field. | Explore Press |
|
||||
| 02 | Judging | Opportunities to judge work that matters. | Explore Judging |
|
||||
| 03 | Scholarly Articles | Scholarly articles in credible, peer-reviewed publications. | Explore Articles |
|
||||
| 04 | Expert consultation | Know where you stand before you commit. | Start Here |
|
||||
| 05 | Agency representation | Useful when you have multiple engagements or no single employer. | Start Here |
|
||||
| 06 | Attorney Referral | The right attorney, when you need one. | Start Here |
|
||||
|
||||
注意：服务 04、05、06 曾经传入不存在的 `contact` 路由；R007 已改为 `start`。
|
||||
|
||||
## 10. Why Paprika 页面内容
|
||||
|
||||
五个差异化理由：
|
||||
|
||||
1. Attorney-curated. Built to matter.
|
||||
2. Built before you need it.
|
||||
3. A coherent profile, tailored to you.
|
||||
4. A complete evidence record.
|
||||
5. Everything in one place.
|
||||
|
||||
结尾 peace of mind：
|
||||
|
||||
- You do not have to second-guess what you are building.
|
||||
- You just build.
|
||||
|
||||
## 11. Resources / O-1A Criteria 页面内容
|
||||
|
||||
页面解释 O-1A 8 项 criteria：
|
||||
|
||||
1. Awards
|
||||
2. Memberships
|
||||
3. Published Material About You
|
||||
4. Judging the Work of Others
|
||||
5. Original Contributions of Major Significance
|
||||
6. Scholarly Articles
|
||||
7. Critical or Essential Role
|
||||
8. High Salary or Remuneration
|
||||
|
||||
每项都包含：
|
||||
|
||||
- subtitle
|
||||
- plain-English body
|
||||
- stronger examples
|
||||
- watch out for
|
||||
- bottom line
|
||||
|
||||
页面有 disclaimer：此 overview 是 general information，不是 legal advice，Paprika 不是 law firm。
|
||||
|
||||
## 12. FAQ 页面内容
|
||||
|
||||
FAQ 分组：
|
||||
|
||||
- About Paprika
|
||||
- O-1 Basics
|
||||
- Timeline
|
||||
- Pricing, scope, and refunds
|
||||
|
||||
关键问答覆盖：
|
||||
|
||||
- Paprika 是否 law firm
|
||||
- Paprika 做什么
|
||||
- 适合谁
|
||||
- process 如何工作
|
||||
- 何时开始
|
||||
- 是否 guarantee visa approval
|
||||
- 是否需要 immigration attorney
|
||||
- evidence-building 是否 legitimate
|
||||
- 信息安全
|
||||
- O-1A 基础
|
||||
- 更多证据是否总是更好
|
||||
- top-tier outlet 是否必须
|
||||
- hackathon judging 是否有帮助
|
||||
- timeline 和 rush concerns
|
||||
- pricing、refund、scope
|
||||
|
||||
## 13. Start Here 表单现状
|
||||
|
||||
当前不是实际 `<form>`，只是视觉字段。
|
||||
|
||||
字段视觉：
|
||||
|
||||
- Name required
|
||||
- Email required
|
||||
- LinkedIn
|
||||
- Company Website
|
||||
- Current Role / Company
|
||||
- Field or Industry
|
||||
- Attach Resume or CV optional
|
||||
- What brings you to Paprika? required
|
||||
- What recognition have you already built, if any?
|
||||
- Is there a timeline on your mind?
|
||||
|
||||
提交按钮：
|
||||
|
||||
- `<a class="button primary" href="?page=thanks">Submit Profile</a>`
|
||||
|
||||
边界：
|
||||
|
||||
- 无输入控件
|
||||
- 无校验
|
||||
- 无上传
|
||||
- 无提交接口
|
||||
- 无邮件通知
|
||||
- 无 CRM/数据库记录
|
||||
|
||||
## 14. Ask a Question 表单现状
|
||||
|
||||
当前不是实际 `<form>`，只是视觉字段。
|
||||
|
||||
字段视觉：
|
||||
|
||||
- Name required
|
||||
- Email required
|
||||
- LinkedIn optional
|
||||
- Attach Resume or CV optional
|
||||
- Your question required
|
||||
|
||||
提交按钮：
|
||||
|
||||
- `<a class="button primary" href="?page=thanks">Send Question</a>`
|
||||
|
||||
边界同 Start Here。
|
||||
|
||||
## 15. Legal 页面内容
|
||||
|
||||
已有页面：
|
||||
|
||||
- Terms of Service
|
||||
- Privacy Policy
|
||||
- Disclaimer
|
||||
|
||||
当前固定日期：
|
||||
|
||||
- `Last updated: July 6, 2026`
|
||||
|
||||
风险：
|
||||
|
||||
- 日期已修正为当前工作日期；正式发布前仍需确认是否应改为实际发布日期。
|
||||
- 法务文本涉及 immigration、attorney referral、not a law firm、privacy、refund、payment、third-party services 等高风险内容，必须由负责人或法律顾问确认。
|
||||
|
||||
## 16. 当前已知缺陷和风险
|
||||
|
||||
| 编号 | 问题 | 影响 | 建议 |
|
||||
| --- | --- | --- | --- |
|
||||
| RISK-001 | Services 中 04/05/06 CTA 指向不存在的 `contact` 页面 | 点击后回退首页，转化断点 | 改为 `start` 或新增 `contact` |
|
||||
| RISK-002 | Start/Ask 不是表单 | 无法收集线索 | 改成真实 `<form>` 并接后端或第三方表单服务 |
|
||||
| RISK-003 | 法务页面日期晚于当前日期 | 发布可信度和合规风险 | 发布前确认日期 |
|
||||
| RISK-004 | outlet/network 名称可能暗示合作关系 | 法律和商业陈述风险 | 确认授权或改为“representative examples/types” |
|
||||
| RISK-005 | 无 SEO/OG/sitemap/robots | 正式站收录和分享效果弱 | 上线前补齐 |
|
||||
| RISK-006 | 无截图回归和移动端验收 | 可能存在响应式问题 | 引入 Playwright 或人工截图台账 |
|
||||
| RISK-007 | 无部署配置 | 不能可重复发布 | 建立服务、反向代理、HTTPS 和部署脚本 |
|
||||
| RISK-008 | PostgreSQL schema 尚未设计 | 表单无法稳定入库和追踪 | 建立 `submissions`、`submission_files` 等数据表 |
|
||||
| RISK-009 | 文件上传存储未定 | CV/resume 涉及隐私和访问控制 | 先确定本地磁盘、对象存储或禁用上传 |
|
||||
| RISK-010 | 邮箱统一初始密码 | 多账号共用弱初始密码有安全风险 | 首次登录强制修改或生成独立强密码 |
|
||||
| RISK-011 | 网站联系邮箱域名不一致 | `support@meetpaprika.com` 与 `paprikalaw.com` 品牌不统一 | 上线前统一 contact/support/legal 邮箱 |
|
||||
|
||||
## 17. 视觉设计对标
|
||||
|
||||
`doc/index.html` 的视觉风格不是通用模板，而是一套完整的 Paprika 品牌 mockup。后续重构或拆分必须保持以下基线，除非在 `06-决策记录.md` 新增变更决策。
|
||||
|
||||
### 17.1 CSS 变量
|
||||
|
||||
| 变量 | 值 | 用途 |
|
||||
| --- | --- | --- |
|
||||
| `--red` | `#d9432f` | 主品牌红、按钮、kicker、编号 |
|
||||
| `--deep-red` | `#a9372d` | 深红强调、active、结论句 |
|
||||
| `--ink` | `#241b14` | 主文字色 |
|
||||
| `--text` | `#5c5249` | 正文灰褐色 |
|
||||
| `--muted` | `#8d847a` | 次级文字 |
|
||||
| `--line` | `#e9e1d8` | 边线 |
|
||||
| `--paper` | `#fffdfa` | 页面底色 |
|
||||
| `--panel` | `rgba(255,255,255,.86)` | 卡片背景 |
|
||||
| `--green` | `#4f7d61` | 少量绿色标签 |
|
||||
| `--header-text` | `#41505a` | 导航文字 |
|
||||
|
||||
### 17.2 字体和排版
|
||||
|
||||
- 全站主字体：`Avenir`, `"Avenir Next"`, system sans-serif。
|
||||
- 强调语句和 italic accent 使用 `Georgia`, `"Times New Roman"`, serif。
|
||||
- 页面不使用图片资源，视觉主要由排版、红色强调、浅纸色背景、网格纹理、卡片阴影组成。
|
||||
- `h1` 首页字号范围为 `clamp(54px, 6.3vw, 74px)`。
|
||||
- 子页 `h1` 字号范围为 `clamp(44px, 5.2vw, 66px)`。
|
||||
- 主要 section title 使用 `clamp(34px, 4vw, 46px)` 或更大的 `clamp(48px, 6vw, 74px)`。
|
||||
|
||||
### 17.3 背景和布局
|
||||
|
||||
- `body` 背景由两层浅网格线、中心 radial glow 和 `--paper` 组成。
|
||||
- Header 高度 `92px`，sticky top，半透明纸色背景，`backdrop-filter: blur(14px)`。
|
||||
- 主内容容器常用：
|
||||
- `.hero`：`width: min(1040px, calc(100% - 56px))`
|
||||
- `.cards/.section/.form-wrap`：`width: min(1160px, calc(100% - 72px))`
|
||||
- `.legal-doc`：`width: min(920px, calc(100% - 72px))`
|
||||
- 卡片圆角主要是 `4px` 或 `8px`，按钮和 chip 使用 `999px`。
|
||||
|
||||
### 17.4 响应式规则
|
||||
|
||||
唯一显式断点：`@media (max-width: 1080px)`。
|
||||
|
||||
断点内行为：
|
||||
|
||||
- Header 允许换行，`.nav` 占满宽度并 flex-wrap。
|
||||
- `.cards`、`.two-col`、`.grid`、`.split-feature`、`.avoid-grid`、`.why-v2-grid`、`.criteria-grid`、`.faq-section`、`.form-wrap`、`.questions`、`.steps` 等多列布局统一变为单列。
|
||||
- `.field.large`、`.form-note` 从跨两列改为单列。
|
||||
- `.pricing-band` 改为单列并居中。
|
||||
- `.press-check-item` 从 `46px 1fr` 调整为 `38px 1fr`。
|
||||
|
||||
注意：当前只有一个 1080px 断点，未针对窄屏 header 高度、FAQ hero nowrap、长 outlet chip、法务长段落做更细处理，移动端必须截图验收。
|
||||
|
||||
## 18. 组件和 CSS 类对标
|
||||
|
||||
| 模块 | 关键类 | 当前用途 |
|
||||
| --- | --- | --- |
|
||||
| Header | `.site-header`, `.brand`, `.brand-name`, `.brand-tag`, `.nav`, `.nav-dropdown`, `.resources-menu`, `.start` | 顶部品牌、导航、下拉和 CTA |
|
||||
| Hero | `.hero`, `.subpage`, `.hero-kicker`, `.subhead`, `.actions`, `.button`, `.microcopy`, `.time-line` | 首页和子页首屏 |
|
||||
| 服务卡 | `.cards`, `.card`, `.meta`, `.num`, `.label`, `.explore` | 首页和 Services 入口 |
|
||||
| 通用内容 | `.section`, `.section-head`, `.section-title`, `.section-copy`, `.two-col`, `.grid`, `.panel`, `.mini`, `.article` | 双栏、四栏、文章卡片 |
|
||||
| CTA | `.services-cta`, `.services-cta-inner`, `.button-arrow` | 服务转化横幅 |
|
||||
| Why | `.why-v2`, `.why-v2-grid`, `.why-card`, `.why-v2-peace`, `.why-card-line` | Why Paprika 页面 |
|
||||
| Resources | `.criteria-page`, `.criteria-intro`, `.criteria-grid`, `.criterion-card`, `.criterion-block`, `.criteria-disclaimer` | O-1A criteria 页面 |
|
||||
| FAQ | `.faq-page`, `.faq-section`, `.faq-section-head`, `.faq-list`, `.faq-item`, `.faq-num` | FAQ 页面 |
|
||||
| Press | `.press-cadence`, `.press-standard`, `.press-check-card`, `.outlet-network`, `.outlet-grid`, `.avoid-section`, `.avoid-card`, `.avoid-explain` | Press 页面 |
|
||||
| Judging | `.judging-counts`, `.judging-counts-grid`, `.judging-network`, `.judging-network-chip`, `.judging-package`, `.check-dot` | Judging 页面 |
|
||||
| Process | `.process-section`, `.steps`, `.step`, `.step-num`, `.pricing-band` | 首页四步流程和价格 |
|
||||
| Form mockup | `.form-wrap`, `.field`, `.upload`, `.upload-inline`, `.large`, `.question-field`, `.start-question-field`, `.form-note`, `.req` | Start/Ask 视觉表单 |
|
||||
| Legal | `.legal-doc`, `.legal-doc-head`, `.legal-date`, `.legal-sections`, `.legal-section` | Terms/Privacy/Disclaimer |
|
||||
| Footer | `footer`, `.footer-links` | 底部链接和固定声明 |
|
||||
|
||||
已存在但当前页面未使用或未公开使用的样式/函数相关模块：
|
||||
|
||||
- `.resource-hub`, `.resource-tabs`, `.resource-group`, `.resource-card`：对应 `resourcesHub()`，当前 `pageData.resources` 使用的是 `o1CriteriaPage()`，未使用 hub。
|
||||
- `.why-proof`, `.why-reason`, `.why-closing`：疑似旧版 Why 结构，当前 `whyPaprikaProof()` 使用 `.why-v2`。
|
||||
- `pressQuality()`：旧版 press 对比区块，当前 `pressPage()` 未调用。
|
||||
- `standardGrid()`：标准 mini grid，当前未调用。
|
||||
|
||||
## 19. JavaScript 函数对标
|
||||
|
||||
| 函数/常量 | 当前状态 | 作用 |
|
||||
| --- | --- | --- |
|
||||
| `serviceCards` | 使用中 | 首页三张服务卡 HTML 片段 |
|
||||
| `pageData` | 使用中 | 所有路由页面数据表 |
|
||||
| `hero()` | 使用中 | 通用子页 hero，含 Start/Ask CTA |
|
||||
| `heroWithKicker()` | 使用中 | 带 kicker 的 hero，可关闭 actions |
|
||||
| `servicesCta()` | 使用中 | 红色服务 CTA 横幅 |
|
||||
| `card()` | 使用中 | 服务卡片 |
|
||||
| `panel()` | 使用中 | 双栏 panel |
|
||||
| `productPage()` | 当前未调用 | 通用产品页工厂 |
|
||||
| `judgingPage()` | 使用中 | Judging 页面组合 |
|
||||
| `scholarlyPage()` | 使用中 | Scholarly 页面组合 |
|
||||
| `productPageWithKicker()` | 当前未调用 | 带 kicker 的产品页工厂 |
|
||||
| `pressPage()` | 使用中 | Press 页面组合 |
|
||||
| `pressHero()` | 使用中 | Press 专属 hero |
|
||||
| `judgingCounts()` | 使用中 | Judging counts 区块 |
|
||||
| `judgingCountCard()` | 使用中 | Judging count card |
|
||||
| `judgingNetwork()` | 使用中 | Judging network chips |
|
||||
| `judgingNetworkGroup()` | 当前未调用 | 分组 network chips |
|
||||
| `judgingPackage()` | 使用中 | Judging evidence package |
|
||||
| `judgingPackageCard()` | 使用中 | Package card |
|
||||
| `pressLookFor()` | 使用中 | Press standards checklist |
|
||||
| `outletNetwork()` | 使用中 | Representative outlet chips |
|
||||
| `pressCheck()` | 使用中 | Press checklist item |
|
||||
| `pressCadenceNote()` | 使用中 | Press cadence note |
|
||||
| `pressAvoidSection()` | 使用中 | Press avoid section |
|
||||
| `avoidCard()` | 使用中 | Avoid card |
|
||||
| `miniGrid()` | 使用中 | mini card grid |
|
||||
| `articleGrid()` | 使用中 | blog article grid |
|
||||
| `o1CriteriaPage()` | 使用中 | O-1A 8 criteria 页面 |
|
||||
| `criterionCard()` | 使用中 | Criteria card |
|
||||
| `faqPage()` | 使用中 | FAQ 页面 |
|
||||
| `faqGroup()` | 使用中 | FAQ 分组 |
|
||||
| `faqItem()` | 使用中 | FAQ 单项 |
|
||||
| `resourcesHub()` | 当前未调用 | Resource hub 草稿 |
|
||||
| `resourceGroup()` | 当前未调用 | Resource group 草稿 |
|
||||
| `legalPage()` | 当前未调用 | 旧版 legal page 工厂 |
|
||||
| `legalTermsPage()` | 使用中 | Terms 页面 |
|
||||
| `legalPrivacyPage()` | 使用中 | Privacy 页面 |
|
||||
| `legalDisclaimerPage()` | 使用中 | Disclaimer 页面 |
|
||||
| `disclaimerSection()` | 使用中 | Disclaimer section |
|
||||
| `disclaimerPart()` | 使用中 | Disclaimer p/ul 渲染 |
|
||||
| `whyEarlySection()` | 使用中 | 首页 Start Early |
|
||||
| `servicesIntro()` | 使用中 | 首页 Core services intro |
|
||||
| `standardPreview()` | 使用中 | 首页标准问题 |
|
||||
| `question()` | 使用中 | 标准问题 item |
|
||||
| `howItWorks()` | 使用中 | 首页四步流程和价格 |
|
||||
| `step()` | 使用中 | 流程 step |
|
||||
| `standardGrid()` | 当前未调用 | 标准 grid 草稿 |
|
||||
| `whyPaprikaProof()` | 使用中 | Why 页面 v2 内容 |
|
||||
| `whyV2Card()` | 使用中 | Why card |
|
||||
| `pressQuality()` | 当前未调用 | 旧版 Press quality 对比 |
|
||||
|
||||
最终渲染逻辑：
|
||||
|
||||
```js
|
||||
const params = new URLSearchParams(window.location.search);
|
||||
const page = params.get("page") || "home";
|
||||
const selected = pageData[page] ? page : "home";
|
||||
document.title = `Paprika - ${selected}`;
|
||||
document.getElementById("app").innerHTML = pageData[selected].body;
|
||||
```
|
||||
|
||||
active 逻辑：
|
||||
|
||||
- `[data-page]` 与 `selected` 相同时添加 `.active`。
|
||||
- `selected` 为 `faq` 或 `resources` 时，额外给 `.nav-trigger` 添加 `.active`。
|
||||
|
||||
## 20. CTA 和链接全量映射
|
||||
|
||||
| 位置 | 文案 | 目标 |
|
||||
| --- | --- | --- |
|
||||
| Header brand | Paprika | `?page=home` |
|
||||
| Header nav | Press | `?page=press` |
|
||||
| Header nav | Judging | `?page=judging` |
|
||||
| Header nav | Scholarly Articles | `?page=scholarly` |
|
||||
| Header nav | Services | `?page=services` |
|
||||
| Header nav | Why Paprika | `?page=why` |
|
||||
| Header Resources | Resources | `?page=resources` |
|
||||
| Resources menu | Frequently Asked Questions | `?page=faq` |
|
||||
| Resources menu | O-1A Criteria Overview | `?page=resources` |
|
||||
| Header CTA | Start Here | `?page=start` |
|
||||
| Footer | About | `?page=why` |
|
||||
| Footer | FAQ | `?page=faq` |
|
||||
| Footer | Terms | `?page=terms` |
|
||||
| Footer | Privacy | `?page=privacy` |
|
||||
| Footer | Disclaimer | `?page=disclaimer` |
|
||||
| Home hero | Send Us Your Profile | `?page=start` |
|
||||
| Home hero | Ask a Question | `?page=ask` |
|
||||
| 通用 hero | Start Here | `?page=start` |
|
||||
| 通用 hero | Ask a Question | `?page=ask` |
|
||||
| Services CTA | Send Us Your Profile | `?page=start` |
|
||||
| Home pricing band | See Services | `?page=services` |
|
||||
| Start mockup | Submit Profile | `?page=thanks` |
|
||||
| Ask mockup | Send Question | `?page=thanks` |
|
||||
| Thanks | Back to Homepage | `?page=home` |
|
||||
| Service card 01 | Explore Press | `?page=press` |
|
||||
| Service card 02 | Explore Judging | `?page=judging` |
|
||||
| Service card 03 | Explore Articles | `?page=scholarly` |
|
||||
| Service card 04 | Start Here | 原为 `?page=contact`，已修复为 `?page=start` |
|
||||
| Service card 05 | Start Here | 原为 `?page=contact`，已修复为 `?page=start` |
|
||||
| Service card 06 | Start Here | 原为 `?page=contact`，已修复为 `?page=start` |
|
||||
|
||||
## 21. FAQ 完整编号对标
|
||||
|
||||
当前 FAQ 共 4 组、20 个问题。
|
||||
|
||||
| 编号范围 | 分组 kicker | 分组标题 | 问题数量 |
|
||||
| --- | --- | --- | --- |
|
||||
| 01-09 | About Paprika | How Paprika works. | 9 |
|
||||
| 10-14 | O1 Visa | O-1 Basics | 5 |
|
||||
| 15-18 | Timeline | How long things take. | 4 |
|
||||
| 19-20 | Pricing Structure | Pricing, scope, and refunds | 2 |
|
||||
|
||||
需要注意的原文问题：
|
||||
|
||||
- `O1 Visa` kicker 少了 hyphen，是否改为 `O-1 Visa` 需产品确认。
|
||||
- FAQ 15 中原文 `Coverage spaced out over time demonstrate...` 主谓可能不一致。
|
||||
- FAQ 20 写了 “If we are unable to secure the agreed-upon media placements...” 可能只覆盖 media placements，不覆盖 judging/scholarly，应由法务或产品确认。
|
||||
|
||||
## 22. Legal 页面逐项结构对标
|
||||
|
||||
### Terms of Service
|
||||
|
||||
当前 Terms 共 18 个 section，但编号为 1-16、18、19，缺少 17。
|
||||
|
||||
| 编号 | 标题 |
|
||||
| --- | --- |
|
||||
| 1 | Agreement to These Terms |
|
||||
| 2 | What Paprika Provides |
|
||||
| 3 | Not a Law Firm — No Legal Advice |
|
||||
| 4 | No Attorney-Client Relationship |
|
||||
| 5 | No Guarantee of Immigration Outcomes |
|
||||
| 6 | Attorney Referrals |
|
||||
| 7 | Fees, Payment, and Refunds |
|
||||
| 8 | Client Responsibilities and Accuracy of Information |
|
||||
| 9 | Evidence Integrity |
|
||||
| 10 | Third-Party Decisions |
|
||||
| 11 | Your Materials |
|
||||
| 12 | Work Product |
|
||||
| 13 | Prohibited Uses |
|
||||
| 14 | Disclaimer of Warranties |
|
||||
| 15 | Limitation of Liability |
|
||||
| 16 | Changes to These Terms |
|
||||
| 18 | Governing Law |
|
||||
| 19 | Contact |
|
||||
|
||||
### Privacy Policy
|
||||
|
||||
当前 Privacy 共 12 个 section：
|
||||
|
||||
1. Introduction
|
||||
2. Information We Collect
|
||||
3. How We Use Your Information
|
||||
4. How We Share Your Information
|
||||
5. Data Storage and Security
|
||||
6. Data Retention
|
||||
7. Your Rights
|
||||
8. Cookies
|
||||
9. Children's Privacy
|
||||
10. International Users
|
||||
11. Changes to This Policy
|
||||
12. Contact
|
||||
|
||||
### Disclaimer
|
||||
|
||||
当前 Disclaimer 共 9 个 section：
|
||||
|
||||
1. Not a Law Firm
|
||||
2. What "Attorney-Curated" Means
|
||||
3. No Attorney-Client Relationship
|
||||
4. Independent Counsel
|
||||
5. Attorney Referral Disclosure
|
||||
6. No Outcome Guarantee
|
||||
7. User Responsibility
|
||||
8. General Information Only
|
||||
9. Questions
|
||||
|
||||
需要注意的原文问题：
|
||||
|
||||
- Disclaimer 中 `Paprika's evidence-building services is shaped...` 主谓不一致。
|
||||
- Disclaimer 中 `Use of Paprika's does not create...` 语句不完整。
|
||||
- 三个 legal 页面日期已由 `Last updated: July 10, 2026` 修正为 `Last updated: July 6, 2026`。
|
||||
- 当前日期为 `2026-07-06`，发布前仍需法务确认文本内容和最终发布日期。
|
||||
|
||||
## 23. 源码级对标结论
|
||||
|
||||
- `doc/index.html` 共 3423 行。
|
||||
- 前 2261 行主要是 CSS 和 HTML shell。
|
||||
- 2262 行后进入 body、header、main、footer、script。
|
||||
- 2300 行后定义 `serviceCards` 和 `pageData`。
|
||||
- 2428 行后定义组件/页面函数。
|
||||
- 3410 行后执行路由选择、渲染和 active 状态设置。
|
||||
- 当前没有外部依赖、图片、字体文件、构建脚本、后端接口或测试。
|
||||
|
||||
## 24. 后续推进入口
|
||||
|
||||
- 任务领取：`04-任务矩阵.md`
|
||||
- 每轮记录：`03-推进台账.md`
|
||||
- 验收证据：`05-验收证据.md`
|
||||
- 决策依据：`06-决策记录.md`
|
||||
- 开发步骤：`02-项目程序开发详细步骤.md`
|
||||
670
working/02-项目程序开发详细步骤.md
Normal file
670
working/02-项目程序开发详细步骤.md
Normal file
@@ -0,0 +1,670 @@
|
||||
# 02-项目程序开发详细步骤
|
||||
|
||||
## 1. 开发原则
|
||||
|
||||
1. 先完整对标 `doc/index.html`，再做工程化拆分。
|
||||
2. 每一轮开发只领取 `04-任务矩阵.md` 中明确编号的任务，避免重复做。
|
||||
3. 每一轮必须同步更新：
|
||||
- `03-推进台账.md`
|
||||
- `04-任务矩阵.md`
|
||||
- `05-验收证据.md`
|
||||
- 必要时更新 `06-决策记录.md`
|
||||
4. 涉及移民、法律、隐私、退款、attorney referral、表单收集的内容，必须留有验收证据和确认记录。
|
||||
5. 不把明文服务器密码写入长期文档；部署凭据用 SSH key、环境变量或受控密钥库。
|
||||
|
||||
## 2. 当前基线复现
|
||||
|
||||
目标：确认 `doc/index.html` 当前 mockup 可回溯、可打开、可作为工程化基准。
|
||||
|
||||
步骤：
|
||||
|
||||
1. 进入项目目录：
|
||||
|
||||
```bash
|
||||
cd /home/mes123456/MeetPaprika
|
||||
```
|
||||
|
||||
2. 确认文件存在：
|
||||
|
||||
```bash
|
||||
test -f doc/index.html && wc -l doc/index.html
|
||||
```
|
||||
|
||||
3. 检查当前页面路由和脚本入口：
|
||||
|
||||
```bash
|
||||
rg -n "pageData|URLSearchParams|data-page|page=start|page=ask|page=terms|page=privacy|page=disclaimer" doc/index.html
|
||||
```
|
||||
|
||||
4. 浏览器打开以下页面并记录截图：
|
||||
|
||||
- `doc/index.html?page=home`
|
||||
- `doc/index.html?page=press`
|
||||
- `doc/index.html?page=judging`
|
||||
- `doc/index.html?page=scholarly`
|
||||
- `doc/index.html?page=services`
|
||||
- `doc/index.html?page=why`
|
||||
- `doc/index.html?page=resources`
|
||||
- `doc/index.html?page=faq`
|
||||
- `doc/index.html?page=start`
|
||||
- `doc/index.html?page=ask`
|
||||
- `doc/index.html?page=terms`
|
||||
- `doc/index.html?page=privacy`
|
||||
- `doc/index.html?page=disclaimer`
|
||||
|
||||
验收标准：
|
||||
|
||||
- 所有公开路由能渲染。
|
||||
- 未识别 `?page=unknown` 回退 `home`。
|
||||
- 顶部导航 active 状态正确。
|
||||
- Resources 下拉可见且链接正确。
|
||||
- 证据记录写入 `05-验收证据.md`。
|
||||
|
||||
## 3. 阶段 A：静态 mockup 修复
|
||||
|
||||
目标：不引入构建系统，先修复当前单文件中影响体验和转化的明确问题。
|
||||
|
||||
任务：
|
||||
|
||||
1. 修复 Services 页面 04/05/06 卡片 CTA。
|
||||
- 已由 `contact` 改为 `start`。
|
||||
2. 明确 `blog` 和 `about` 是否保留。
|
||||
- 若保留，加入导航或 footer。
|
||||
- 若不保留，记录为隐藏路由。
|
||||
3. 检查 legal 页面日期。
|
||||
- 已由 `July 10, 2026` 改为 `July 6, 2026`。
|
||||
- 当前工作日期为 `2026-07-06`。
|
||||
4. 检查首页、Press、Judging、Services、FAQ、Legal 移动端布局。
|
||||
5. 补充基础 SEO：
|
||||
- description
|
||||
- canonical
|
||||
- Open Graph
|
||||
- favicon 占位或正式资源
|
||||
6. 将 mockup 表单明确标注为占位，或进入阶段 B 改为真实表单。
|
||||
|
||||
验收标准：
|
||||
|
||||
- 无明显死链。
|
||||
- 所有 CTA 指向存在页面。
|
||||
- 法务日期有明确确认。
|
||||
- 桌面和移动端核心页面无明显重叠。
|
||||
- 变更写入台账和证据。
|
||||
|
||||
## 4. 阶段 B：真实表单与线索收集
|
||||
|
||||
目标：Start Here 和 Ask a Question 从视觉 mockup 变成真实可提交入口。
|
||||
|
||||
### 推荐字段
|
||||
|
||||
Start Here：
|
||||
|
||||
- name required
|
||||
- email required
|
||||
- linkedin
|
||||
- company_website
|
||||
- current_role_company
|
||||
- field_or_industry
|
||||
- resume_cv optional upload
|
||||
- reason required
|
||||
- existing_recognition
|
||||
- timeline
|
||||
- consent/disclaimer acknowledgement
|
||||
|
||||
Ask a Question：
|
||||
|
||||
- name required
|
||||
- email required
|
||||
- linkedin optional
|
||||
- resume_cv optional upload
|
||||
- question required
|
||||
- consent/disclaimer acknowledgement
|
||||
|
||||
### 实现路径选项
|
||||
|
||||
| 方案 | 适用 | 优点 | 风险 |
|
||||
| --- | --- | --- | --- |
|
||||
| 第三方表单服务 | 快速上线 | 开发少，有后台记录 | 文件上传和隐私策略受限 |
|
||||
| 自建轻量 API | 需要控制数据 | 可控、可扩展 | 需要安全、日志、备份 |
|
||||
| CRM 直连 | 销售流程明确 | 直接进入业务系统 | 依赖第三方 API 和权限 |
|
||||
|
||||
建议优先级：
|
||||
|
||||
1. 若目标是快速 HTTPS 上线：先接第三方表单或 webhook。
|
||||
2. 若会收 CV/敏感信息：优先自建 API，加上传限制和访问控制。
|
||||
3. 若已有 CRM：按 CRM 字段建映射并保留 submission id。
|
||||
|
||||
### 表单验收标准
|
||||
|
||||
- 必填字段缺失时不能提交。
|
||||
- email 格式错误时提示。
|
||||
- 文件上传明确限制类型和大小。
|
||||
- 成功后有 submission id 或后台记录 id。
|
||||
- 失败时显示错误状态，不静默跳转。
|
||||
- disclaimer 可见：提交不创建 attorney-client relationship。
|
||||
- 验收证据包含页面截图、提交记录、job_id/report_id/submission id。
|
||||
|
||||
## 5. 阶段 C：Next.js + React + PostgreSQL 工程化
|
||||
|
||||
目标：把单文件 mockup 迁移为 Next.js + React 应用，并接入 PostgreSQL，形成可维护、可部署、可验收的正式工程。
|
||||
|
||||
### 5.1 技术架构
|
||||
|
||||
- 前端和服务端框架：Next.js + React
|
||||
- 语言：TypeScript
|
||||
- 样式：先使用全局 CSS / CSS Modules 迁移 `doc/index.html` 视觉；不强行引入 UI 框架
|
||||
- 数据库：PostgreSQL
|
||||
- ORM：Prisma
|
||||
- 表单校验：Zod 或等价 schema 校验
|
||||
- 部署：Node.js 进程监听 `8082`，Nginx/Caddy 提供 HTTPS 反向代理
|
||||
- 验收：Playwright 页面截图 + API/数据库写入验证
|
||||
|
||||
### 5.2 初始化工程
|
||||
|
||||
当前已完成初始化。保留建议命令供复建参考：
|
||||
|
||||
```bash
|
||||
npx create-next-app@latest paprika-site --ts --eslint --app --src-dir=false
|
||||
cd paprika-site
|
||||
npm install prisma @prisma/client zod
|
||||
npx prisma init
|
||||
```
|
||||
|
||||
本项目已直接在当前根目录工程化，并保留 `doc/index.html` 为对标基线。
|
||||
|
||||
### 5.3 页面迁移
|
||||
|
||||
从 `doc/index.html` 迁移为真实路由：
|
||||
|
||||
| 旧路由 | Next.js 路由 |
|
||||
| --- | --- |
|
||||
| `?page=home` | `/` |
|
||||
| `?page=press` | `/press` |
|
||||
| `?page=judging` | `/judging` |
|
||||
| `?page=scholarly` | `/scholarly` |
|
||||
| `?page=services` | `/services` |
|
||||
| `?page=why` | `/why` |
|
||||
| `?page=resources` | `/resources` |
|
||||
| `?page=faq` | `/faq` |
|
||||
| `?page=start` | `/start` |
|
||||
| `?page=ask` | `/ask` |
|
||||
| `?page=thanks` | `/thanks` |
|
||||
| `?page=terms` | `/terms` |
|
||||
| `?page=privacy` | `/privacy` |
|
||||
| `?page=disclaimer` | `/disclaimer` |
|
||||
|
||||
隐藏路由 `blog`、`about` 先不要公开，除非产品确认。
|
||||
|
||||
### 5.4 PostgreSQL 数据模型初稿
|
||||
|
||||
建议最小表：
|
||||
|
||||
```prisma
|
||||
model Submission {
|
||||
id String @id @default(cuid())
|
||||
type String
|
||||
name String
|
||||
email String
|
||||
linkedin String?
|
||||
companyWebsite String?
|
||||
currentRoleCompany String?
|
||||
fieldOrIndustry String?
|
||||
reason String?
|
||||
existingRecognition String?
|
||||
timeline String?
|
||||
question String?
|
||||
consentAccepted Boolean @default(false)
|
||||
sourcePath String?
|
||||
status String @default("new")
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
files SubmissionFile[]
|
||||
}
|
||||
|
||||
model SubmissionFile {
|
||||
id String @id @default(cuid())
|
||||
submissionId String
|
||||
fileName String
|
||||
mimeType String
|
||||
byteSize Int
|
||||
storageKey String
|
||||
createdAt DateTime @default(now())
|
||||
submission Submission @relation(fields: [submissionId], references: [id])
|
||||
}
|
||||
```
|
||||
|
||||
字段说明：
|
||||
|
||||
- `type`：`start` 或 `ask`
|
||||
- `sourcePath`：提交来源，如 `/start`、`/ask`
|
||||
- `status`：`new`、`reviewed`、`spam`、`archived`
|
||||
- 文件上传未落地前，可以先不创建 `SubmissionFile` 或禁用上传。
|
||||
|
||||
### 5.5 表单 API
|
||||
|
||||
建议 API：
|
||||
|
||||
```text
|
||||
POST /api/submissions
|
||||
```
|
||||
|
||||
请求类型：
|
||||
|
||||
- `type=start`
|
||||
- `type=ask`
|
||||
|
||||
验收：
|
||||
|
||||
- 必填字段缺失返回 400。
|
||||
- 邮箱格式错误返回 400。
|
||||
- 成功写入 PostgreSQL 并返回 `submission_id`。
|
||||
- 前端成功后跳转 `/thanks?submission_id=...` 或展示成功状态。
|
||||
- 失败时显示明确错误。
|
||||
|
||||
### 5.6 环境变量
|
||||
|
||||
`.env` 至少包含：
|
||||
|
||||
```bash
|
||||
DATABASE_URL="postgresql://USER:PASSWORD@HOST:5432/paprika"
|
||||
NEXT_PUBLIC_SITE_URL="https://paprikalaw.com"
|
||||
```
|
||||
|
||||
规则：
|
||||
|
||||
- `.env` 不提交。
|
||||
- 服务器凭据和数据库密码不写入 `working` 文档。
|
||||
- 生产数据库用户只授予应用所需权限。
|
||||
|
||||
### 5.7 服务器 PostgreSQL 验证
|
||||
|
||||
用户已确认 PostgreSQL 在服务器 `170.106.192.152` 安装完成。正式接入前需要在服务器上验证：
|
||||
|
||||
```bash
|
||||
ssh ubuntu@170.106.192.152
|
||||
systemctl status postgresql --no-pager
|
||||
psql --version
|
||||
sudo -u postgres psql -c '\l'
|
||||
```
|
||||
|
||||
建议创建应用数据库和受限应用用户：
|
||||
|
||||
```sql
|
||||
CREATE DATABASE paprika;
|
||||
CREATE USER paprika_app WITH ENCRYPTED PASSWORD 'REPLACE_WITH_SECURE_PASSWORD';
|
||||
GRANT CONNECT ON DATABASE paprika TO paprika_app;
|
||||
```
|
||||
|
||||
进入数据库后授予 schema 权限：
|
||||
|
||||
```sql
|
||||
\c paprika
|
||||
GRANT USAGE, CREATE ON SCHEMA public TO paprika_app;
|
||||
```
|
||||
|
||||
生产 `DATABASE_URL` 示例：
|
||||
|
||||
```bash
|
||||
DATABASE_URL="postgresql://paprika_app:REPLACE_WITH_SECURE_PASSWORD@127.0.0.1:5432/paprika"
|
||||
```
|
||||
|
||||
注意：
|
||||
|
||||
- 不使用 SSH 登录密码作为数据库密码。
|
||||
- 不把数据库密码写入仓库、`working` 文档或聊天后的可复制文档。
|
||||
- 如果 PostgreSQL 仅供本机 Next.js 使用，优先监听 `127.0.0.1`，不要对公网开放 5432。
|
||||
|
||||
### 5.8 构建和本地验证
|
||||
|
||||
```bash
|
||||
npm install
|
||||
npm run generate:legacy
|
||||
npm run prisma:generate
|
||||
npm run lint
|
||||
npx tsc --noEmit
|
||||
npm run build
|
||||
npm run start -- -p 8082
|
||||
```
|
||||
|
||||
本地生产服务冒烟：
|
||||
|
||||
```bash
|
||||
for p in / /press /judging /scholarly /services /why /resources /faq /start /ask /thanks /terms /privacy /disclaimer /robots.txt /sitemap.xml; do
|
||||
code=$(curl -s -o /dev/null -w '%{http_code}' http://localhost:8082$p)
|
||||
printf '%s %s\n' "$code" "$p"
|
||||
done
|
||||
```
|
||||
|
||||
生产数据库迁移：
|
||||
|
||||
```bash
|
||||
npx prisma migrate deploy
|
||||
```
|
||||
|
||||
验收标准：
|
||||
|
||||
- `npm run dev` 可本地启动。
|
||||
- `npm run build` 通过。
|
||||
- `npm run start -- -p 8082` 可在 8082 启动。
|
||||
- `npx prisma migrate deploy` 可在生产环境执行。
|
||||
- 核心页面内容、视觉和 CTA 与 `doc/index.html` 对标。
|
||||
- Start/Ask 提交能写入 PostgreSQL。当前本地未配置 `DATABASE_URL` 时只能验证 400 校验路径和 500 失败路径，不能关闭入库验收。
|
||||
|
||||
## 6. 阶段 D：部署到云服务器
|
||||
|
||||
目标：让 `https://paprikalaw.com/` 访问目标站点，内部服务端口使用 `8082`。
|
||||
|
||||
### 服务器信息
|
||||
|
||||
- Host：`170.106.192.152`
|
||||
- User：`ubuntu`
|
||||
- 端口范围：`8080-8099` 已开放
|
||||
- 本项目端口：`8082`
|
||||
- 密码：不写入文档；使用用户交接的临时凭据登录后立即配置 SSH key
|
||||
|
||||
### 建议部署结构
|
||||
|
||||
```text
|
||||
/opt/paprika/
|
||||
current/
|
||||
releases/
|
||||
shared/
|
||||
.env
|
||||
logs/
|
||||
```
|
||||
|
||||
### 基础命令模板
|
||||
|
||||
```bash
|
||||
ssh ubuntu@170.106.192.152
|
||||
sudo mkdir -p /opt/paprika/releases /opt/paprika/shared/logs
|
||||
sudo chown -R ubuntu:ubuntu /opt/paprika
|
||||
```
|
||||
|
||||
### Next.js 服务示例
|
||||
|
||||
构建并启动：
|
||||
|
||||
```bash
|
||||
npm ci
|
||||
npm run build
|
||||
npm run start -- -p 8082
|
||||
```
|
||||
|
||||
生产建议用 systemd：
|
||||
|
||||
```ini
|
||||
[Unit]
|
||||
Description=Paprika static site
|
||||
After=network.target
|
||||
|
||||
[Service]
|
||||
Type=simple
|
||||
User=ubuntu
|
||||
WorkingDirectory=/opt/paprika/current
|
||||
Environment=NODE_ENV=production
|
||||
EnvironmentFile=/opt/paprika/shared/.env
|
||||
ExecStart=/usr/bin/npm run start -- -p 8082
|
||||
Restart=always
|
||||
RestartSec=5
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
```
|
||||
|
||||
### Nginx 反向代理示例
|
||||
|
||||
```nginx
|
||||
server {
|
||||
listen 80;
|
||||
server_name paprikalaw.com www.paprikalaw.com;
|
||||
|
||||
location / {
|
||||
proxy_pass http://127.0.0.1:8082;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
HTTPS：
|
||||
|
||||
```bash
|
||||
sudo certbot --nginx -d paprikalaw.com -d www.paprikalaw.com
|
||||
```
|
||||
|
||||
验收标准：
|
||||
|
||||
- `curl -I http://127.0.0.1:8082` 在服务器上返回 200。
|
||||
- `curl -I https://paprikalaw.com/` 返回 200。
|
||||
- `https://paprikalaw.com/`、`/start`、`/faq` 可访问。
|
||||
- `POST /api/submissions` 能写入 PostgreSQL 并返回 `submission_id`。
|
||||
- systemd 服务 `active (running)`。
|
||||
- Nginx 配置通过 `sudo nginx -t`。
|
||||
- HTTPS 证书有效。
|
||||
|
||||
## 7. 阶段 E：回归验收
|
||||
|
||||
目标：上线前后能证明页面、表单、合规、部署都可用。
|
||||
|
||||
### 页面回归
|
||||
|
||||
必测页面：
|
||||
|
||||
- home
|
||||
- press
|
||||
- judging
|
||||
- scholarly
|
||||
- services
|
||||
- why
|
||||
- resources
|
||||
- faq
|
||||
- start
|
||||
- ask
|
||||
- thanks
|
||||
- terms
|
||||
- privacy
|
||||
- disclaimer
|
||||
|
||||
### 设备尺寸
|
||||
|
||||
- Desktop：1440x900
|
||||
- Tablet：768x1024
|
||||
- Mobile：390x844
|
||||
|
||||
### 验收内容
|
||||
|
||||
- 页面可访问。
|
||||
- 首屏品牌和 CTA 可见。
|
||||
- Header 不遮挡内容。
|
||||
- 文本无明显重叠。
|
||||
- CTA 链接可达。
|
||||
- 表单可提交或明确是 mockup。
|
||||
- Footer legal 链接可达。
|
||||
- Legal disclaimer 可见。
|
||||
|
||||
### 证据格式
|
||||
|
||||
每次验收写入 `05-验收证据.md`：
|
||||
|
||||
```text
|
||||
EV-YYYYMMDD-序号
|
||||
时间：
|
||||
任务：
|
||||
命令/页面：
|
||||
结果：
|
||||
证据文件：
|
||||
job_id/report_id/submission_id：
|
||||
结论：
|
||||
```
|
||||
|
||||
## 8. 阶段 F：后续产品增强
|
||||
|
||||
可选任务：
|
||||
|
||||
- 增加真实 Contact 页面。
|
||||
- 增加 Blog/Resources 内容系统。
|
||||
- 增加案例或证据包示例，但必须避免误导和隐私泄露。
|
||||
- 增加 analytics，并同步 Privacy Policy。
|
||||
- 增加 sitemap、robots、structured data。
|
||||
- 增加 Playwright screenshot regression。
|
||||
- 增加后台 leads 管理或 CRM 同步。
|
||||
|
||||
## 9. 阶段 G：邮箱系统配置与验证
|
||||
|
||||
目标：确认 `mail.paprikalaw.com` 邮件系统可用，管理员和普通公司邮箱能登录、收发和承接网站通知。
|
||||
|
||||
### 9.1 邮箱入口
|
||||
|
||||
- 普通用户网页登录：`https://mail.paprikalaw.com/webmail/`
|
||||
- 管理员网页登录：`https://mail.paprikalaw.com/admin/`
|
||||
- 管理员邮箱：`admin@paprikalaw.com`
|
||||
|
||||
### 9.2 需要创建或确认的普通邮箱
|
||||
|
||||
```text
|
||||
info@paprikalaw.com
|
||||
contact@paprikalaw.com
|
||||
support@paprikalaw.com
|
||||
sales@paprikalaw.com
|
||||
marketing@paprikalaw.com
|
||||
hr@paprikalaw.com
|
||||
finance@paprikalaw.com
|
||||
billing@paprikalaw.com
|
||||
legal@paprikalaw.com
|
||||
service@paprikalaw.com
|
||||
```
|
||||
|
||||
凭据规则：
|
||||
|
||||
- 用户已提供统一初始密码，但不写入长期文档。
|
||||
- 建议创建后立即为每个邮箱设置独立强密码。
|
||||
- 如果邮件系统支持，启用首次登录改密、2FA、登录审计和反垃圾策略。
|
||||
|
||||
### 9.3 DNS 和投递验证
|
||||
|
||||
需要确认：
|
||||
|
||||
- `mail.paprikalaw.com` A/AAAA 记录正确。
|
||||
- `paprikalaw.com` MX 记录指向邮件服务器。
|
||||
- SPF 记录包含授权发件源。
|
||||
- DKIM 已生成并加入 DNS。
|
||||
- DMARC 已配置，至少先从 `p=none` 观察。
|
||||
- 反向 DNS/PTR 与邮件服务器发信域名匹配。
|
||||
|
||||
建议验证：
|
||||
|
||||
```bash
|
||||
dig MX paprikalaw.com
|
||||
dig TXT paprikalaw.com
|
||||
dig TXT default._domainkey.paprikalaw.com
|
||||
dig TXT _dmarc.paprikalaw.com
|
||||
```
|
||||
|
||||
### 9.4 网站表单通知接入
|
||||
|
||||
Next.js 表单写入 PostgreSQL 后，可选邮件通知：
|
||||
|
||||
- 发件邮箱：建议 `support@paprikalaw.com` 或专用 `no-reply@paprikalaw.com`
|
||||
- 收件邮箱：建议 `support@paprikalaw.com`、`contact@paprikalaw.com`
|
||||
- 表单类型：
|
||||
- `/start` 提交通知
|
||||
- `/ask` 提交通知
|
||||
- 邮件内容不得包含完整敏感 CV 文件，只发送 submission id 和后台查看提示。
|
||||
|
||||
环境变量示例：
|
||||
|
||||
```bash
|
||||
SMTP_HOST="mail.paprikalaw.com"
|
||||
SMTP_PORT="587"
|
||||
SMTP_USER="support@paprikalaw.com"
|
||||
SMTP_PASSWORD="REPLACE_WITH_SECURE_PASSWORD"
|
||||
LEADS_NOTIFY_TO="support@paprikalaw.com,contact@paprikalaw.com"
|
||||
```
|
||||
|
||||
验收标准：
|
||||
|
||||
- 管理员能登录 admin。
|
||||
- 10 个普通邮箱能登录 webmail。
|
||||
- 至少完成一封内部互发、一封外部收信、一封外部发信测试。
|
||||
- SPF/DKIM/DMARC 检查通过或有明确待处理项。
|
||||
- 表单邮件通知如启用，必须记录 message id 或测试截图。
|
||||
|
||||
## 10. 每轮工作固定流程
|
||||
|
||||
1. 查看 `04-任务矩阵.md`，领取一个或一组任务。
|
||||
2. 查看相关决策：`06-决策记录.md`。
|
||||
3. 修改代码或文档。
|
||||
4. 执行对应验证。
|
||||
5. 将证据写入 `05-验收证据.md`。
|
||||
6. 更新任务状态。
|
||||
7. 在 `03-推进台账.md` 记录：
|
||||
- 本轮做了什么
|
||||
- 改了哪些文件
|
||||
- 验证了什么
|
||||
- 下一步是什么
|
||||
|
||||
## 11. 完全对标核验清单
|
||||
|
||||
每次声称“已完全对标 `doc/index.html`”时，至少执行以下核验。
|
||||
|
||||
### 10.1 源文件结构核验
|
||||
|
||||
```bash
|
||||
wc -l doc/index.html
|
||||
rg -n 'function [A-Za-z0-9_]+\(|const [A-Za-z0-9_]+ =|href="\?page=|Last updated|Packages start|@media|--[a-z-]+:' doc/index.html
|
||||
```
|
||||
|
||||
验收：
|
||||
|
||||
- 记录 `doc/index.html` 行数。
|
||||
- 记录 CSS token、断点、路由、CTA、函数、法务日期、价格文案。
|
||||
|
||||
### 10.2 页面和函数映射核验
|
||||
|
||||
```bash
|
||||
rg -n 'pageData|home:|press:|judging:|scholarly:|services:|why:|resources:|faq:|blog:|start:|ask:|thanks:|about:|terms:|privacy:|disclaimer:' doc/index.html
|
||||
rg -n 'function (hero|heroWithKicker|servicesCta|card|pressPage|judgingPage|scholarlyPage|o1CriteriaPage|faqPage|legalTermsPage|legalPrivacyPage|legalDisclaimerPage)' doc/index.html
|
||||
```
|
||||
|
||||
验收：
|
||||
|
||||
- `01-项目功能内容.md` 中的路由清单与 `pageData` 保持一致。
|
||||
- 使用中函数、未调用函数都有记录。
|
||||
- 隐藏路由 `blog`、`about` 不被误删。
|
||||
|
||||
### 10.3 链接和 CTA 核验
|
||||
|
||||
```bash
|
||||
rg -n 'href="\?page=|card\("' doc/index.html
|
||||
```
|
||||
|
||||
验收：
|
||||
|
||||
- Header、footer、hero、services CTA、form mockup、thanks、service card 链接全部登记。
|
||||
- 不存在的 `contact` 路由历史缺陷必须保留在风险和任务矩阵中；修复后记录验收证据。
|
||||
|
||||
### 10.4 Legal 和 FAQ 核验
|
||||
|
||||
```bash
|
||||
sed -n '2870,3035p' doc/index.html
|
||||
sed -n '3070,3228p' doc/index.html
|
||||
```
|
||||
|
||||
验收：
|
||||
|
||||
- FAQ 4 组 20 个问题记录完整。
|
||||
- Terms、Privacy、Disclaimer section 数量和标题记录完整。
|
||||
- Terms 缺少 17、legal 日期晚于当前日期、原文语法风险均进入任务矩阵。
|
||||
|
||||
### 10.5 视觉样式核验
|
||||
|
||||
```bash
|
||||
rg -n '^\\s*\\.[A-Za-z0-9_-]+|@media|grid-template-columns|width: min|border-radius|background:' doc/index.html
|
||||
```
|
||||
|
||||
验收：
|
||||
|
||||
- CSS token、布局宽度、卡片、表单、Press、Judging、FAQ、Legal、响应式断点在文档中有对应说明。
|
||||
- 后续工程化拆分不能只迁移内容，必须迁移视觉规则。
|
||||
253
working/03-推进台账.md
Normal file
253
working/03-推进台账.md
Normal file
@@ -0,0 +1,253 @@
|
||||
# 03-推进台账
|
||||
|
||||
本文件按轮次记录工作。每轮结束必须写清楚：做了什么、改了哪些文件、验证了什么、下一步是什么。
|
||||
|
||||
## R001 - 建立 working 文档体系
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 任务编号：T001、T002
|
||||
- 做了什么：
|
||||
- 阅读 `doc/index.html` 的页面结构、导航、路由、表单 mockup、服务模块、FAQ、O-1A criteria、法务页面和渲染脚本。
|
||||
- 建立 `working` 目录下 6 份编号文档和 README 索引。
|
||||
- 初步记录当前项目是自包含静态 HTML mockup。
|
||||
- 改了哪些文件：
|
||||
- `working/README.md`
|
||||
- `working/01-项目功能内容.md`
|
||||
- `working/02-项目程序开发详细步骤.md`
|
||||
- `working/03-推进台账.md`
|
||||
- `working/04-任务矩阵.md`
|
||||
- `working/05-验收证据.md`
|
||||
- `working/06-决策记录.md`
|
||||
- 验证了什么：
|
||||
- 确认 `doc/index.html` 是自包含静态 HTML。
|
||||
- 确认页面通过 `?page=...` 查询参数切换。
|
||||
- 确认 Start Here 和 Ask a Question 当前是视觉 mockup，不是真实表单。
|
||||
- 证据链接或编号：E001、E002、E003
|
||||
- 遗留问题：
|
||||
- 未做浏览器截图验收。
|
||||
- 未做移动端回归。
|
||||
- 未实现表单和部署。
|
||||
- 下一步：
|
||||
- 按 `04-任务矩阵.md` 从 `VERIFY` 与 `TODO` 任务继续推进。
|
||||
|
||||
## R002 - 完全对标 doc/index.html 补强 working 文档
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 任务编号：T028
|
||||
- 做了什么：
|
||||
- 复读 `doc/index.html` 中 header、footer、`pageData`、页面组合函数、Press/Judging/Resources/FAQ/Legal/Form 模块。
|
||||
- 补充 `01-项目功能内容.md`，把页面路由、内容模块、表单字段、服务卡片、O-1A criteria、法律页面、已知缺陷和发布环境写完整。
|
||||
- 补充 `02-项目程序开发详细步骤.md`，形成阶段化路线：基线复现、静态修复、真实表单、工程化拆分、8082 端口部署、HTTPS、回归验收。
|
||||
- 补强任务矩阵，新增服务器部署、凭据处理、contact 死链、outlet/network 陈述风险、README 索引维护等任务。
|
||||
- 补强验收证据，记录本轮命令、源码发现和后续证据清单。
|
||||
- 补强决策记录，明确不在长期文档保存明文密码、服务默认走 8082、Services 的 `contact` 路由是缺陷。
|
||||
- 改了哪些文件：
|
||||
- `working/README.md`
|
||||
- `working/01-项目功能内容.md`
|
||||
- `working/02-项目程序开发详细步骤.md`
|
||||
- `working/03-推进台账.md`
|
||||
- `working/04-任务矩阵.md`
|
||||
- `working/05-验收证据.md`
|
||||
- `working/06-决策记录.md`
|
||||
- 验证了什么：
|
||||
- `rg --files` 确认项目当前主要文件为 `doc/index.html`、`doc/README.md` 和 `working/*.md`。
|
||||
- `rg -n` 确认公开路由、隐藏路由、表单 mockup、legal 页面、动态路由逻辑均在 `doc/index.html`。
|
||||
- `sed` 分段读取源文件，确认 Services 04/05/06 卡片指向不存在的 `contact` 页面。
|
||||
- `git status --short` 失败，确认当前目录不是 Git 仓库或未在 Git 工作树内。
|
||||
- 证据链接或编号：E004、E005、E006、E007
|
||||
- 遗留问题：
|
||||
- 尚未改 `doc/index.html`。
|
||||
- 尚未启动本地服务器或做截图。
|
||||
- 尚未登录远端服务器。
|
||||
- 用户提供了密码，但长期文档未写入明文密码。
|
||||
- 下一步：
|
||||
- 优先处理 T029：修复 Services 页面不存在的 `contact` 路由。
|
||||
- 继续 T003-T011：对核心页面做浏览器截图验收。
|
||||
- 之后按产品选择推进 T012/T013 表单落地或 T022 工程化拆分。
|
||||
|
||||
## R003 - 源码级对标附录完善
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 任务编号：T034
|
||||
- 做了什么：
|
||||
- 重新扫描 `doc/index.html` 的 CSS token、响应式断点、路由链接、函数列表、FAQ、Legal sections 和渲染逻辑。
|
||||
- 在 `01-项目功能内容.md` 增加视觉设计、组件 CSS 类、JavaScript 函数、CTA 全量映射、FAQ 完整编号、Legal 逐项结构和源码级结论。
|
||||
- 在 `02-项目程序开发详细步骤.md` 增加“完全对标核验清单”，规定以后如何证明文档与源 HTML 对齐。
|
||||
- 更新任务矩阵、验收证据和决策记录。
|
||||
- 改了哪些文件：
|
||||
- `working/01-项目功能内容.md`
|
||||
- `working/02-项目程序开发详细步骤.md`
|
||||
- `working/03-推进台账.md`
|
||||
- `working/04-任务矩阵.md`
|
||||
- `working/05-验收证据.md`
|
||||
- `working/06-决策记录.md`
|
||||
- 验证了什么：
|
||||
- `doc/index.html` 共 3423 行。
|
||||
- CSS 只有一个显式响应式断点：`@media (max-width: 1080px)`。
|
||||
- `pageData` 包含公开路由、隐藏路由和 legal 页面。
|
||||
- FAQ 共 4 组 20 个问题。
|
||||
- Terms 编号缺少 17，Legal 日期均为 `July 10, 2026`。
|
||||
- 多个函数和 CSS 模块存在但当前未调用。
|
||||
- 证据链接或编号：E016
|
||||
- 遗留问题：
|
||||
- 仍未修改 `doc/index.html` 源码。
|
||||
- 仍未做浏览器截图和真实部署验收。
|
||||
- 下一步：
|
||||
- 按 T029 修复 `contact` 缺陷，或按 T003-T011 做页面截图验收。
|
||||
|
||||
## R004 - 明确正式开发技术架构
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 任务编号：T035
|
||||
- 做了什么：
|
||||
- 根据用户确认，将正式开发路线从候选方案收敛为 Next.js + React + PostgreSQL。
|
||||
- 将默认数据访问层定为 Prisma ORM。
|
||||
- 补充 Next.js 路由迁移表、PostgreSQL 数据模型初稿、表单 API、环境变量、8082 启动方式和部署验收标准。
|
||||
- 更新任务矩阵和决策记录。
|
||||
- 改了哪些文件：
|
||||
- `working/01-项目功能内容.md`
|
||||
- `working/02-项目程序开发详细步骤.md`
|
||||
- `working/03-推进台账.md`
|
||||
- `working/04-任务矩阵.md`
|
||||
- `working/05-验收证据.md`
|
||||
- `working/06-决策记录.md`
|
||||
- `working/README.md`
|
||||
- 验证了什么：
|
||||
- 文档已不再把 Vite/静态拆分作为推荐路线。
|
||||
- 部署命令已调整为 Next.js `npm run start -- -p 8082`。
|
||||
- 数据库任务已进入矩阵。
|
||||
- 证据链接或编号：E017
|
||||
- 遗留问题：
|
||||
- 尚未实际创建 Next.js 工程。
|
||||
- 尚未创建 PostgreSQL 数据库或 Prisma migration。
|
||||
- 文件上传存储方案仍需单独确认。
|
||||
- 下一步：
|
||||
- 执行 T036 初始化 Next.js 工程。
|
||||
- 执行 T037 设计并迁移 PostgreSQL schema。
|
||||
|
||||
## R005 - 记录服务器 PostgreSQL 安装状态
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 任务编号：T040
|
||||
- 做了什么：
|
||||
- 根据用户反馈，记录 PostgreSQL 已在服务器 `170.106.192.152` 安装完成。
|
||||
- 补充服务器 PostgreSQL 验证命令、应用数据库和受限用户创建建议。
|
||||
- 保持凭据安全规则：不把明文 SSH 密码写入长期文档。
|
||||
- 改了哪些文件：
|
||||
- `working/01-项目功能内容.md`
|
||||
- `working/02-项目程序开发详细步骤.md`
|
||||
- `working/03-推进台账.md`
|
||||
- `working/04-任务矩阵.md`
|
||||
- `working/05-验收证据.md`
|
||||
- `working/06-决策记录.md`
|
||||
- 验证了什么：
|
||||
- 本轮未登录服务器验证，仅记录用户确认。
|
||||
- 证据链接或编号：E018
|
||||
- 遗留问题：
|
||||
- 需要远程执行 `systemctl status postgresql`、`psql --version`、数据库列表检查。
|
||||
- 需要创建或确认 `paprika` 数据库和 `paprika_app` 应用用户。
|
||||
- 下一步：
|
||||
- 执行 T040 远程验证 PostgreSQL。
|
||||
- 执行 T037 接入 Prisma schema 和 migration。
|
||||
|
||||
## R006 - 记录邮箱系统账号需求
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 任务编号：T041
|
||||
- 做了什么：
|
||||
- 记录普通用户 webmail 入口、管理员入口和 `admin@paprikalaw.com` 管理员账号。
|
||||
- 记录 10 个普通公司邮箱账号清单。
|
||||
- 补充邮件 DNS、收发验证、表单通知接入和凭据安全要求。
|
||||
- 明确用户提供的统一初始密码不写入长期文档。
|
||||
- 改了哪些文件：
|
||||
- `working/01-项目功能内容.md`
|
||||
- `working/02-项目程序开发详细步骤.md`
|
||||
- `working/03-推进台账.md`
|
||||
- `working/04-任务矩阵.md`
|
||||
- `working/05-验收证据.md`
|
||||
- `working/06-决策记录.md`
|
||||
- `working/README.md`
|
||||
- 验证了什么：
|
||||
- 本轮只记录需求，未登录邮件后台，未验证 DNS/MX/SPF/DKIM/DMARC。
|
||||
- 证据链接或编号：E019
|
||||
- 遗留问题：
|
||||
- 需要登录 `https://mail.paprikalaw.com/admin/` 确认账号是否已创建。
|
||||
- 需要测试 webmail 登录、内外部收发和 DNS 记录。
|
||||
- 需要决定网站表单通知使用哪个邮箱。
|
||||
- 下一步：
|
||||
- 执行 T041 邮箱账号创建/确认。
|
||||
- 执行 T042 邮件 DNS 和收发测试。
|
||||
- 执行 T043 Next.js 表单邮件通知配置。
|
||||
|
||||
## R007 - 落地 Next.js 工程、Prisma 和真实表单
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 任务编号：T012、T013、T017、T020、T022、T029、T036、T037、T038、T039、T044
|
||||
- 做了什么：
|
||||
- 修复 `doc/index.html` 中 Services 04/05/06 CTA 指向不存在 `contact` 的缺陷，统一改为 `start`。
|
||||
- 将 legal 页面日期从未来日期 `July 10, 2026` 改为当前工作日期 `July 6, 2026`。
|
||||
- 在项目根目录初始化 Next.js + React + TypeScript App Router 工程。
|
||||
- 编写 `scripts/extract-legacy-pages.mjs`，从 `doc/index.html` 抽取 CSS 和静态页面 HTML，生成 `app/globals.css` 与 `lib/legacy-pages.ts`。
|
||||
- 建立 `app/[page]/page.tsx` 静态路由，迁移公开页面到 `/press`、`/judging`、`/services` 等路径路由。
|
||||
- 建立 `/start`、`/ask` 真实 React 表单，提交到 `POST /api/submissions`。
|
||||
- 建立 Prisma schema、初始化 migration、`.env.example`、数据库访问层和 Zod 校验。
|
||||
- 增加基础 SEO metadata、`robots.txt` 和 `sitemap.xml`。
|
||||
- 升级到 Next `16.2.10`、React `19.2.7`，并配置 ESLint 9 flat config。
|
||||
- 改了哪些文件：
|
||||
- `doc/index.html`
|
||||
- `.env.example`
|
||||
- `.gitignore`
|
||||
- `package.json`
|
||||
- `package-lock.json`
|
||||
- `tsconfig.json`
|
||||
- `next-env.d.ts`
|
||||
- `next.config.mjs`
|
||||
- `eslint.config.mjs`
|
||||
- `scripts/extract-legacy-pages.mjs`
|
||||
- `app/*`
|
||||
- `components/*`
|
||||
- `lib/*`
|
||||
- `prisma/schema.prisma`
|
||||
- `prisma/migrations/20260706120000_init/migration.sql`
|
||||
- `working/README.md`
|
||||
- `working/01-项目功能内容.md`
|
||||
- `working/02-项目程序开发详细步骤.md`
|
||||
- `working/03-推进台账.md`
|
||||
- `working/04-任务矩阵.md`
|
||||
- `working/05-验收证据.md`
|
||||
- `working/06-决策记录.md`
|
||||
- 验证了什么：
|
||||
- `npm run generate:legacy` 成功生成 12 个旧页面数据。
|
||||
- `npm run prisma:generate` 成功生成 Prisma Client。
|
||||
- `npm run lint` 通过。
|
||||
- `npx tsc --noEmit` 通过。
|
||||
- `npm run build` 通过，生成 19 个 app route。
|
||||
- `npm run start -- -p 8082` 本地生产服务可启动。
|
||||
- `/`、`/press`、`/judging`、`/scholarly`、`/services`、`/why`、`/resources`、`/faq`、`/start`、`/ask`、`/thanks`、`/terms`、`/privacy`、`/disclaimer`、`/robots.txt`、`/sitemap.xml` 本地生产服务均返回 200。
|
||||
- `/api/submissions` 对缺失必填字段和错误 email 返回 400 校验错误。
|
||||
- 有效提交在未配置 `DATABASE_URL` 时返回 500，确认入库成功仍需真实 PostgreSQL。
|
||||
- 证据链接或编号：E022、E023、E024、E025、E026
|
||||
- 遗留问题：
|
||||
- 本地未配置 PostgreSQL `DATABASE_URL`，尚不能完成真实入库验收。
|
||||
- 远程 PostgreSQL、应用数据库、应用用户、migration deploy 尚未验证。
|
||||
- 邮箱后台、DNS、SMTP 通知未验证。
|
||||
- 法务内容审核、outlet/network 名称确认、文件上传策略仍需外部确认。
|
||||
- 尚未做浏览器截图/PDF 归档。
|
||||
- 下一步：
|
||||
- 执行 T040/T044：远程验证 PostgreSQL，配置生产 `DATABASE_URL`，执行 migration，并提交 Start/Ask 获取 `submission_id`。
|
||||
- 执行 T039/T024：部署 Next.js 到服务器 `8082` 并配置 systemd。
|
||||
- 执行 T041-T043：验证邮箱和 SMTP 通知。
|
||||
- 执行 T018/T026：补桌面和移动端截图证据。
|
||||
|
||||
## 后续轮次模板
|
||||
|
||||
### RXXX - 标题
|
||||
|
||||
- 日期：
|
||||
- 任务编号：
|
||||
- 做了什么：
|
||||
- 改了哪些文件：
|
||||
- 验证了什么：
|
||||
- 证据链接或编号：
|
||||
- 遗留问题：
|
||||
- 下一步：
|
||||
81
working/04-任务矩阵.md
Normal file
81
working/04-任务矩阵.md
Normal file
@@ -0,0 +1,81 @@
|
||||
# 04-任务矩阵
|
||||
|
||||
状态定义：
|
||||
|
||||
- `DONE`：已完成并有证据。
|
||||
- `VERIFY`：源码看起来具备，但缺浏览器、截图、端到端或人工确认。
|
||||
- `TODO`：尚未实现。
|
||||
- `BLOCKED`：被外部输入、账号、法律审核、DNS 或产品决策阻塞。
|
||||
- `DEFER`：暂缓，不影响当前阶段交付。
|
||||
|
||||
## 任务总表
|
||||
|
||||
| 编号 | 任务 | 状态 | 验收标准 | 依赖 | 备注 |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| T001 | 建立 working 文档体系 | DONE | 6 份编号文档和 README 索引存在 | 无 | R001 |
|
||||
| T002 | 盘点当前页面路由 | DONE | 路由清单覆盖公开路由、隐藏路由和回退逻辑 | T001 | 见 01 |
|
||||
| T003 | 顶部导航可用 | VERIFY | 点击 Press/Judging/Scholarly/Services/Why/Start 能进入对应页面，active 状态正确 | T002 | 需截图 |
|
||||
| T004 | Resources 下拉可用 | VERIFY | hover/focus 显示 FAQ 和 O-1A Criteria Overview，链接正确 | T002 | 需桌面验证 |
|
||||
| T005 | 首页内容完整 | VERIFY | hero、三大服务、Start Early、标准问题、四步流程、价格 band 渲染正常 | T002 | 需截图 |
|
||||
| T006 | Services 页面完整 | VERIFY | 6 张服务卡片和说明渲染正常 | T002 | 存在 T029 缺陷 |
|
||||
| T007 | Press 页面完整 | VERIFY | press hero、cadence、standards、avoid、outlet network、CTA 渲染正常 | T002 | 需截图 |
|
||||
| T008 | Judging 页面完整 | VERIFY | judging counts、network、evidence package、CTA 渲染正常 | T002 | 需截图 |
|
||||
| T009 | Scholarly 页面完整 | VERIFY | hero、两栏说明、CTA 渲染正常 | T002 | 需截图 |
|
||||
| T010 | Resources/O-1A criteria 页面完整 | VERIFY | 8 项 criteria 全部展示，免责声明展示 | T002 | 需内容抽查 |
|
||||
| T011 | FAQ 页面完整 | VERIFY | FAQ 分组和问题渲染正常 | T002 | 需内容抽查 |
|
||||
| T012 | Start Here 表单真实可用 | VERIFY | 真实 `<form>` 或等价组件；必填校验；提交后产生可追踪记录 | T037/T044 | React 表单和 API 已实现，待真实 PostgreSQL 入库证据 |
|
||||
| T013 | Ask a Question 表单真实可用 | VERIFY | 真实 `<form>` 或等价组件；必填校验；提交后产生可追踪记录 | T037/T044 | React 表单和 API 已实现，待真实 PostgreSQL 入库证据 |
|
||||
| T014 | 文件上传策略 | DEFER | 明确支持或不支持上传；若支持，限制类型、大小、存储、访问权限 | T012/T013 | 当前代码禁用上传，待隐私/存储方案确认 |
|
||||
| T015 | Thanks 页面流程验收 | VERIFY | 成功提交后进入 thanks；直接访问 thanks 不造成误导 | T012/T013 | 当前仅链接跳转 |
|
||||
| T016 | 法务页面内容审核 | BLOCKED | Terms、Privacy、Disclaimer 经负责人或律师确认 | 法务输入 | 当前为草稿 |
|
||||
| T017 | 法务日期修正 | DONE | 页面日期不晚于实际发布日，或明确未来生效逻辑 | T016 | 已改为 `July 6, 2026`，内容审核仍见 T016 |
|
||||
| T018 | 响应式布局验证 | TODO | 1440、768、390 宽度核心页面无重叠、溢出、不可读 | T003-T011 | 需截图 |
|
||||
| T019 | 无障碍基础检查 | TODO | heading 层级合理；交互元素可聚焦；颜色对比和表单标签达标 | T012/T013 | 当前表单不是 input |
|
||||
| T020 | SEO 基础 | VERIFY | 每页 title/description、OG、favicon、robots/sitemap 有明确策略 | 内容确认 | 已有 metadata、robots、sitemap；favicon/逐页文案待确认 |
|
||||
| T021 | 分析和隐私策略 | DEFER | 若添加 analytics，Privacy 同步说明并记录供应商 | T016 | 当前未添加 analytics |
|
||||
| T022 | 工程化拆分 | DONE | 从单文件拆为可维护结构，或明确保持单文件的理由 | T002-T011 | 已新增 Next.js App Router 工程，保留 doc 基线 |
|
||||
| T023 | 自动化测试 | TODO | 至少覆盖核心路由冒烟、表单提交、未知路由回退 | T022 | 当前无测试框架 |
|
||||
| T024 | 部署到云服务器 8082 | TODO | 服务器 `127.0.0.1:8082` 返回 200，systemd 或等价进程可自恢复 | T022 或静态服务 | 目标主机 170.106.192.152 |
|
||||
| T025 | HTTPS 域名发布 | BLOCKED | `https://paprikalaw.com/` 返回 200，证书有效 | DNS/服务器权限/T024 | 需确认 DNS 指向 |
|
||||
| T026 | 截图/PDF 验收资产 | TODO | 核心页面截图或 PDF 存档，路径写入 `05-验收证据.md` | T018 | 用于回归比较 |
|
||||
| T027 | `blog` 和 `about` 去留确认 | TODO | 明确保留、隐藏或删除；导航和 footer 一致 | 产品输入 | 当前代码存在但未公开 |
|
||||
| T028 | 完全对标补强 working 文档 | DONE | 01-06 和 README 覆盖页面、开发步骤、台账、任务矩阵、证据、决策 | T001/T002 | R002 |
|
||||
| T029 | 修复 Services 中不存在的 `contact` 路由 | DONE | Services 04/05/06 CTA 指向存在页面，点击不回退首页 | T006 | 已改 `start`，Next `/services` 产物确认 href `/start` |
|
||||
| T030 | 服务器凭据安全处理 | TODO | 不在仓库保存明文密码；配置 SSH key 或受控密钥交接 | T024 | 用户已提供临时凭据 |
|
||||
| T031 | Outlet/network 陈述风险确认 | BLOCKED | 负责人确认可展示 outlet/network 名称或改成示例类型 | 产品/法务输入 | Press/Judging 涉及名称 |
|
||||
| T032 | README 索引维护 | DONE | README 能指向 01-06，并说明后续入口 | T028 | 本轮更新 |
|
||||
| T033 | Git 仓库状态确认 | TODO | 明确项目是否应纳入 Git；若是，初始化或进入正确仓库后记录 commit hash | 用户/仓库输入 | 当前 `git status` 失败 |
|
||||
| T034 | 源码级对标附录完善 | DONE | 文档覆盖 CSS token、组件类、函数清单、CTA 映射、FAQ 编号、Legal 结构、核验命令 | T028 | R003 |
|
||||
| T035 | 明确正式技术架构 | DONE | 文档明确采用 Next.js + React + PostgreSQL，并记录 ORM、路由、API、部署方式 | 用户确认 | R004 |
|
||||
| T036 | 初始化 Next.js + React 工程 | DONE | `npm run dev`、`npm run build` 可用，基础页面路由建立 | T035 | TypeScript + App Router，Next 16 + React 19 |
|
||||
| T037 | PostgreSQL + Prisma 接入 | VERIFY | `schema.prisma`、`.env.example`、migration 存在，能连接数据库 | T035/T040 | 本地代码完成；真实连接待生产 `DATABASE_URL` |
|
||||
| T038 | 表单入库实现 | VERIFY | `/start`、`/ask` 提交写入 PostgreSQL，并返回 `submission_id` | T036/T037/T044 | API 写入代码完成；缺真实 DB 成功提交证据 |
|
||||
| T039 | Next.js 部署到 8082 | VERIFY | `npm run start -- -p 8082` 生产可运行，systemd 管理 | T036/T037 | 本地生产 8082 通过；远程 systemd 未做 |
|
||||
| T040 | 远程验证 PostgreSQL 安装 | TODO | 服务器上 `systemctl status postgresql` 正常，`psql --version` 可用，应用数据库/用户确认 | 用户已确认安装 | 不记录明文密码 |
|
||||
| T041 | 邮箱账号创建/确认 | TODO | admin 入口可登录，10 个普通邮箱可通过 webmail 登录 | 邮件后台权限 | 不记录统一初始密码 |
|
||||
| T042 | 邮件 DNS 与收发验证 | TODO | MX/SPF/DKIM/DMARC 检查完成，内外部收发测试通过 | T041/DNS 权限 | 记录 dig 输出和测试截图 |
|
||||
| T043 | 表单邮件通知配置 | TODO | `/start`、`/ask` 入库后向指定邮箱发送通知，记录 message id | T038/T041 | SMTP 密码放环境变量 |
|
||||
| T044 | 真实 PostgreSQL 入库验收 | TODO | 配置 `DATABASE_URL` 后，Start/Ask 成功返回 `submission_id`，数据库可查记录 | T037/T040 | 本地未配置数据库，远程待执行 migration |
|
||||
|
||||
## 优先级建议
|
||||
|
||||
| 优先级 | 任务 | 原因 |
|
||||
| --- | --- | --- |
|
||||
| P0 | T029 | 明确死链，改动小，影响转化 |
|
||||
| P0 | T017/T016 | 法务日期和文本影响正式发布可信度 |
|
||||
| P0 | T012/T013/T014 | 当前无法真实收集线索 |
|
||||
| P0 | T035/T036/T037/T038 | 正式架构已明确，需落地工程和数据库 |
|
||||
| P0 | T040 | PostgreSQL 已安装，需验证后才能接 Prisma |
|
||||
| P0 | T041/T042 | 公司邮箱是对外联系和表单通知基础设施 |
|
||||
| P1 | T003-T011/T018/T026 | 页面上线前必须有截图证据 |
|
||||
| P1 | T024/T025/T030 | 服务器发布和凭据安全 |
|
||||
| P2 | T020/T021/T023 | SEO、analytics、自动化测试 |
|
||||
| P2 | T022 | 工程化拆分取决于上线节奏 |
|
||||
|
||||
## 防重复规则
|
||||
|
||||
1. 开始任务前先查本表编号。
|
||||
2. 已是 `DONE` 的任务不得重复做，除非新建变更任务并说明原因。
|
||||
3. `VERIFY` 任务完成验证后改为 `DONE`，并在 `05-验收证据.md` 填证据。
|
||||
4. 涉及法务、隐私、表单数据、部署凭据的任务必须有明确验收证据，不能只凭页面看起来正常关闭。
|
||||
5. 每次新增任务必须使用下一个编号，并补齐状态、验收标准和依赖。
|
||||
374
working/05-验收证据.md
Normal file
374
working/05-验收证据.md
Normal file
@@ -0,0 +1,374 @@
|
||||
# 05-验收证据
|
||||
|
||||
本文件记录可复查证据：命令、页面、job_id、report_id、PDF、截图、部署链接、提交记录等。
|
||||
|
||||
## E001 - 文档基线盘点
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 关联任务：T001、T002
|
||||
- 类型：命令输出摘要
|
||||
- 命令：
|
||||
|
||||
```bash
|
||||
pwd
|
||||
rg --files -g '!*node_modules*' -g '!*.png' -g '!*.jpg' -g '!*.jpeg' -g '!*.gif' -g '!*.pdf' | sed -n '1,160p'
|
||||
sed -n '1,260p' doc/index.html
|
||||
find working -maxdepth 2 -type f -print | sort
|
||||
```
|
||||
|
||||
- 结果摘要：
|
||||
- 当前工作目录为 `/home/mes123456/MeetPaprika`。
|
||||
- 参考文件存在：`doc/index.html`。
|
||||
- `working` 目录存在。
|
||||
- `doc/index.html` 包含 `<main id="app"></main>`、内联 CSS、内联 JS。
|
||||
- 页面通过 `?page=...` 查询参数选择内容。
|
||||
|
||||
## E002 - 当前路由证据
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 关联任务：T002
|
||||
- 类型：源码证据
|
||||
- 命令：
|
||||
|
||||
```bash
|
||||
rg -n "const pages|function|data-page|render|page:|title:|href=|main.innerHTML|case|pages\\[|\\?page=|<body|<script|</html>|Services|Resources|FAQ|Privacy|Terms|Get Started|Application|Contact" doc/index.html
|
||||
```
|
||||
|
||||
- 结果摘要：
|
||||
- 导航显式链接：`press`、`judging`、`scholarly`、`services`、`why`、`resources`、`faq`、`start`。
|
||||
- Footer 链接：`why`、`faq`、`terms`、`privacy`、`disclaimer`。
|
||||
- `pageData` 中定义：`home`、`press`、`judging`、`scholarly`、`services`、`why`、`resources`、`faq`、`blog`、`start`、`ask`、`thanks`、`about`、`terms`、`privacy`、`disclaimer`。
|
||||
- 路由选择逻辑：未识别页面回退为 `home`。
|
||||
|
||||
## E003 - 表单 mockup 证据
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 关联任务：T012、T013、T014、T015
|
||||
- 类型：源码证据
|
||||
- 文件：`doc/index.html`
|
||||
- 结果摘要：
|
||||
- `start` 页面字段使用 `<div class="field">`，提交入口是 `<a class="button primary" href="?page=thanks">Submit Profile</a>`。
|
||||
- `ask` 页面字段使用 `<div class="field">`，提交入口是 `<a class="button primary" href="?page=thanks">Send Question</a>`。
|
||||
- 当前没有 `<form>`、`input`、`textarea`、`file`、`method`、`action` 或提交接口。
|
||||
- 因此当前只能证明视觉流程存在，不能证明真实提交能力。
|
||||
|
||||
## E004 - R002 源码复核证据
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 关联任务：T028
|
||||
- 类型：命令输出摘要
|
||||
- 命令：
|
||||
|
||||
```bash
|
||||
sed -n '2262,2468p' doc/index.html
|
||||
sed -n '2469,2765p' doc/index.html
|
||||
sed -n '2766,3428p' doc/index.html
|
||||
```
|
||||
|
||||
- 结果摘要：
|
||||
- 复核 header、footer、`serviceCards`、`pageData`、`hero`、`heroWithKicker`、`pressPage`、`judgingPage`、`o1CriteriaPage`、`faqPage`、legal 页面和最终渲染逻辑。
|
||||
- `document.getElementById("app").innerHTML = pageData[selected].body;`
|
||||
- `if (["faq", "resources"].includes(selected))` 会高亮 Resources trigger。
|
||||
- legal 页面当时日期写为 `Last updated: July 10, 2026`；后续已在 E024 修复。
|
||||
|
||||
## E005 - Services contact 路由缺陷证据
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 关联任务：T029
|
||||
- 类型：源码证据
|
||||
- 文件：`doc/index.html`
|
||||
- 结果摘要：
|
||||
- Services 页面卡片 04、05、06 调用：
|
||||
- `card("04", ..., "Start Here", "contact")`
|
||||
- `card("05", ..., "Start Here", "contact")`
|
||||
- `card("06", ..., "Start Here", "contact")`
|
||||
- `pageData` 没有 `contact`。
|
||||
- 当前路由逻辑会把未知 `contact` 回退到 `home`。
|
||||
- 结论：这是明确死链/误跳转缺陷；后续已在 E024 修复。
|
||||
|
||||
## E006 - Git 状态证据
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 关联任务：T033
|
||||
- 类型：命令输出摘要
|
||||
- 命令：
|
||||
|
||||
```bash
|
||||
git status --short
|
||||
```
|
||||
|
||||
- 结果摘要：
|
||||
- 输出：`fatal: not a git repository (or any of the parent directories): .git`
|
||||
- 结论：当前路径不是 Git 仓库，暂时无法记录 commit hash。
|
||||
|
||||
## E007 - Working 文档更新证据
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 关联任务：T028、T032
|
||||
- 类型：文件证据
|
||||
- 文件：
|
||||
- `working/README.md`
|
||||
- `working/01-项目功能内容.md`
|
||||
- `working/02-项目程序开发详细步骤.md`
|
||||
- `working/03-推进台账.md`
|
||||
- `working/04-任务矩阵.md`
|
||||
- `working/05-验收证据.md`
|
||||
- `working/06-决策记录.md`
|
||||
- 结果摘要：
|
||||
- 已形成 README 索引。
|
||||
- 已形成从项目功能、开发步骤、推进台账、任务矩阵、验收证据到决策记录的闭环。
|
||||
|
||||
## E016 - 源码级对标扫描证据
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 关联任务：T034
|
||||
- 类型：命令输出摘要
|
||||
- 命令：
|
||||
|
||||
```bash
|
||||
wc -l doc/index.html working/*.md
|
||||
rg -n 'function [A-Za-z0-9_]+\(|const [A-Za-z0-9_]+ =|^[[:space:]]+[A-Za-z0-9_]+: \{|href="\?page=|Last updated|Packages start|@media|--[a-z-]+:' doc/index.html
|
||||
rg -n '^\s*\.[A-Za-z0-9_-]+|^\s*#[A-Za-z0-9_-]+|^\s*[a-z]+\s*\{|@media|grid-template-columns|width: min|border-radius|background:' doc/index.html
|
||||
sed -n '2870,3035p' doc/index.html
|
||||
sed -n '3070,3228p' doc/index.html
|
||||
```
|
||||
|
||||
- 结果摘要：
|
||||
- `doc/index.html` 共 3423 行。
|
||||
- CSS token 包含 `--red`、`--deep-red`、`--ink`、`--text`、`--muted`、`--line`、`--paper`、`--panel`、`--green`、`--header-text`。
|
||||
- 唯一显式断点为 `@media (max-width: 1080px)`。
|
||||
- `pageData` 包含 `home`、`press`、`judging`、`scholarly`、`services`、`why`、`resources`、`faq`、`blog`、`start`、`ask`、`thanks`、`about`、`terms`、`privacy`、`disclaimer`。
|
||||
- FAQ 共 4 组 20 个问题。
|
||||
- Terms 共 18 个 section，但编号缺少 17。
|
||||
- Privacy 共 12 个 section。
|
||||
- Disclaimer 共 9 个 section。
|
||||
- Legal 页面当时日期均为 `Last updated: July 10, 2026`；后续已在 E024 修复。
|
||||
- 发现未调用函数/模块：`productPage`、`productPageWithKicker`、`judgingNetworkGroup`、`resourcesHub`、`resourceGroup`、`legalPage`、`standardGrid`、`pressQuality`。
|
||||
|
||||
## E017 - 技术架构确认记录
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 关联任务：T035
|
||||
- 类型：用户确认 + 文档证据
|
||||
- 用户确认：
|
||||
|
||||
```text
|
||||
Next+ React ，数据库使用 PostGreSQL
|
||||
```
|
||||
|
||||
- 结果摘要：
|
||||
- 正式开发技术架构已收敛为 Next.js + React + PostgreSQL。
|
||||
- 文档默认 ORM 为 Prisma。
|
||||
- 表单提交目标改为 Next.js API/Server Actions 写入 PostgreSQL。
|
||||
- 生产启动方式改为 `npm run start -- -p 8082`。
|
||||
- 新增任务 T036-T039，覆盖工程初始化、数据库接入、表单入库、Next.js 部署。
|
||||
|
||||
## E018 - 服务器 PostgreSQL 安装用户确认
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 关联任务：T040
|
||||
- 类型：用户确认
|
||||
- 用户确认摘要：
|
||||
- PostgreSQL 已在云服务器安装完成。
|
||||
- 服务器：`170.106.192.152`
|
||||
- SSH 用户：`ubuntu`
|
||||
- 可用端口：`8080-8099`
|
||||
- 应用目标端口：`8082`
|
||||
- 凭据处理：
|
||||
- 用户在对话中提供了 SSH 密码。
|
||||
- 长期文档不保存明文密码。
|
||||
- 待验证命令：
|
||||
|
||||
```bash
|
||||
ssh ubuntu@170.106.192.152
|
||||
systemctl status postgresql --no-pager
|
||||
psql --version
|
||||
sudo -u postgres psql -c '\l'
|
||||
```
|
||||
|
||||
- 结论：
|
||||
- 当前状态为“用户确认已安装，待远程验证”。
|
||||
|
||||
## E019 - 邮箱系统账号需求用户确认
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 关联任务：T041、T042、T043
|
||||
- 类型：用户确认
|
||||
- 用户确认摘要：
|
||||
- 普通用户入口：`https://mail.paprikalaw.com/webmail/`
|
||||
- 管理员入口：`https://mail.paprikalaw.com/admin/`
|
||||
- 管理员账号：`admin@paprikalaw.com`
|
||||
- 普通邮箱账号：
|
||||
- `info@paprikalaw.com`
|
||||
- `contact@paprikalaw.com`
|
||||
- `support@paprikalaw.com`
|
||||
- `sales@paprikalaw.com`
|
||||
- `marketing@paprikalaw.com`
|
||||
- `hr@paprikalaw.com`
|
||||
- `finance@paprikalaw.com`
|
||||
- `billing@paprikalaw.com`
|
||||
- `legal@paprikalaw.com`
|
||||
- `service@paprikalaw.com`
|
||||
- 凭据处理：
|
||||
- 用户在对话中提供了统一初始密码。
|
||||
- 长期文档不保存明文密码。
|
||||
- 待验证：
|
||||
- 管理员登录。
|
||||
- 普通邮箱 webmail 登录。
|
||||
- MX/SPF/DKIM/DMARC。
|
||||
- 内部互发、外部收信、外部发信。
|
||||
- Next.js 表单通知 SMTP 配置。
|
||||
|
||||
## E022 - Next.js 工程初始化和构建证据
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 关联任务：T036、T022
|
||||
- 类型：命令输出摘要
|
||||
- 命令：
|
||||
|
||||
```bash
|
||||
npm install
|
||||
npm run generate:legacy
|
||||
npm run lint
|
||||
npx tsc --noEmit
|
||||
npm run build
|
||||
```
|
||||
|
||||
- 结果摘要：
|
||||
- 依赖安装完成。
|
||||
- `generate:legacy` 从 `doc/index.html` 生成 12 个页面数据。
|
||||
- `lint` 通过。
|
||||
- TypeScript `--noEmit` 通过。
|
||||
- `next build` 通过，生成 `/`、`/[page]`、`/api/submissions`、`/ask`、`/start`、`/thanks`、`/robots.txt`、`/sitemap.xml`。
|
||||
|
||||
## E023 - Prisma schema 和 migration 证据
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 关联任务：T037
|
||||
- 类型：文件和命令证据
|
||||
- 文件：
|
||||
- `prisma/schema.prisma`
|
||||
- `prisma/migrations/20260706120000_init/migration.sql`
|
||||
- `.env.example`
|
||||
- 命令：
|
||||
|
||||
```bash
|
||||
npm run prisma:generate
|
||||
npx prisma migrate diff --from-empty --to-schema-datamodel prisma/schema.prisma --script
|
||||
```
|
||||
|
||||
- 结果摘要：
|
||||
- Prisma Client 生成成功。
|
||||
- schema 包含 `Submission` 和 `SubmissionFile`。
|
||||
- `.env.example` 只保留占位 `DATABASE_URL`，未写入真实密码。
|
||||
- 待补：
|
||||
- 生产 PostgreSQL 执行 `npx prisma migrate deploy`。
|
||||
- 成功入库后记录 `submission_id`。
|
||||
|
||||
## E024 - Services CTA 和 legal 日期修复证据
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 关联任务：T017、T029
|
||||
- 类型：源码和 HTTP 产物证据
|
||||
- 命令：
|
||||
|
||||
```bash
|
||||
rg -n "contact|Last updated" doc/index.html
|
||||
curl -s http://localhost:8082/services | rg -n 'href="/start"|Expert consultation|Attorney Referral'
|
||||
curl -s http://localhost:8082/terms | rg -n "Last updated: July 6, 2026"
|
||||
```
|
||||
|
||||
- 结果摘要：
|
||||
- `doc/index.html` 中 Services 04/05/06 已不再指向不存在的 `contact`。
|
||||
- `/services` 产物中 Expert consultation、Agency representation、Attorney Referral 的 CTA 均为 `href="/start"`。
|
||||
- legal 页面显示 `Last updated: July 6, 2026`。
|
||||
|
||||
## E025 - 本地生产 8082 路由冒烟证据
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 关联任务：T003-T011、T015、T020、T039
|
||||
- 类型：HTTP 状态码证据
|
||||
- 命令：
|
||||
|
||||
```bash
|
||||
npm run start -- -p 8082
|
||||
for p in / /press /judging /scholarly /services /why /resources /faq /start /ask /thanks /terms /privacy /disclaimer /robots.txt /sitemap.xml; do
|
||||
code=$(curl -s -o /dev/null -w '%{http_code}' http://localhost:8082$p)
|
||||
printf '%s %s\n' "$code" "$p"
|
||||
done
|
||||
```
|
||||
|
||||
- 结果摘要：
|
||||
- 所有列出的路径均返回 `200`。
|
||||
- `robots.txt` 输出 `Sitemap: https://paprikalaw.com/sitemap.xml`。
|
||||
- `sitemap.xml` 包含核心公开路径。
|
||||
- 备注：
|
||||
- 这是本地生产服务验收，不等同于远程服务器和 HTTPS 验收。
|
||||
|
||||
## E026 - 表单 API 校验证据
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 关联任务：T012、T013、T038、T044
|
||||
- 类型：API 响应证据
|
||||
- 命令：
|
||||
|
||||
```bash
|
||||
curl -s -X POST http://localhost:8082/api/submissions \
|
||||
-H 'Content-Type: application/json' \
|
||||
-d '{"type":"ask","name":"","email":"bad","question":"","consentAccepted":false}'
|
||||
```
|
||||
|
||||
- 结果摘要：
|
||||
- 返回 `Validation failed`。
|
||||
- 字段错误包含 `name`、`email`、`consentAccepted`、`question`。
|
||||
- 待补：
|
||||
- 配置 `DATABASE_URL` 后提交有效 `/start` 和 `/ask` 表单，记录 `submission_id` 和数据库查询结果。
|
||||
- 未配置 `DATABASE_URL` 时，有效提交会返回 500，不能作为入库成功证据。
|
||||
|
||||
## E027 - npm audit 结果
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 关联任务：T023、T036
|
||||
- 类型：安全扫描摘要
|
||||
- 命令：
|
||||
|
||||
```bash
|
||||
npm audit --audit-level=moderate --json
|
||||
```
|
||||
|
||||
- 结果摘要：
|
||||
- 剩余 2 个 `moderate` vulnerability。
|
||||
- 来源为 `next` 依赖链中的 `postcss <8.5.10` 公告。
|
||||
- 当前项目已使用 registry 当前稳定版本 Next `16.2.10`。
|
||||
- npm 给出的 `fixAvailable` 会降级到 `next@9.3.3`，属于不合理破坏性修复，未执行。
|
||||
- 后续：
|
||||
- 等待 Next/PostCSS 依赖链发布可用修复版本后升级。
|
||||
|
||||
## 待补证据清单
|
||||
|
||||
| 编号 | 关联任务 | 需要补充的证据 |
|
||||
| --- | --- | --- |
|
||||
| E008 | T003-T011 | 桌面浏览器截图，覆盖 home、press、judging、scholarly、services、why、resources、faq |
|
||||
| E009 | T018 | 移动端截图，至少 390px 宽度覆盖 home、services、faq、start |
|
||||
| E010 | T012/T013 | 表单提交成功记录、submission id、后台记录截图或 webhook job_id |
|
||||
| E011 | T016/T017 | 法务审核记录、确认人、确认日期 |
|
||||
| E012 | T023 | 自动化测试命令和结果 |
|
||||
| E013 | T024/T025 | 部署 URL、systemd 状态、Nginx 测试、证书、job_id、commit hash |
|
||||
| E014 | T026 | PDF 或截图归档路径 |
|
||||
| E015 | T030 | SSH key 或密钥管理方式确认，不能包含明文密码 |
|
||||
| E020 | T041/T042 | 邮箱后台截图、DNS 查询输出、收发测试截图 |
|
||||
| E021 | T043 | 表单通知邮件 message id 或测试截图 |
|
||||
| E028 | T044 | PostgreSQL `DATABASE_URL` 配置后的真实表单提交、`submission_id` 和数据库查询结果 |
|
||||
|
||||
## 证据模板
|
||||
|
||||
### EXXX - 标题
|
||||
|
||||
- 日期：
|
||||
- 关联任务：
|
||||
- 类型：
|
||||
- 命令或页面：
|
||||
- 结果：
|
||||
- 文件或链接：
|
||||
- job_id/report_id/submission_id：
|
||||
- 备注：
|
||||
195
working/06-决策记录.md
Normal file
195
working/06-决策记录.md
Normal file
@@ -0,0 +1,195 @@
|
||||
# 06-决策记录
|
||||
|
||||
本文件记录已经做出的工程、产品和流程决策。后续若要改变决策，需要新增记录说明原因，不直接覆盖旧记录。
|
||||
|
||||
## D001 - 当前基线按静态单文件 mockup 记录
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 决策：当前以 `doc/index.html` 作为项目基线，而不是假设已有完整前端工程。
|
||||
- 原因：
|
||||
- 当前目录未发现 `package.json`、构建配置或后端代码。
|
||||
- `doc/index.html` 已包含页面、样式和路由脚本。
|
||||
- 用户本轮要求是在 `working` 中编写推进文档。
|
||||
- 影响：
|
||||
- 当前验收以静态页面可打开、路由可渲染、视觉可检查为主。
|
||||
- 表单、部署、测试、工程化都作为后续任务单独推进。
|
||||
|
||||
## D002 - 表单不按真实功能验收
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 决策：`start` 和 `ask` 当前只能记为表单视觉 mockup，不能记为真实线索收集功能。
|
||||
- 原因：
|
||||
- 字段是 `<div>`，不是输入控件。
|
||||
- 提交按钮是跳转链接，不会提交数据。
|
||||
- 没有后端、第三方表单服务、文件上传或校验逻辑。
|
||||
- 影响：
|
||||
- `T012`、`T013`、`T014` 保持 `TODO`。
|
||||
- 上线前必须实现真实提交，或在页面明确标注不可提交。
|
||||
|
||||
## D003 - 任务推进以任务矩阵为唯一入口
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 决策：后续开发先查 `04-任务矩阵.md`，每个任务必须有编号、状态、验收标准和依赖。
|
||||
- 原因：
|
||||
- 用户明确要求防止重复做。
|
||||
- 当前项目范围包含内容、前端、表单、法务、部署和证据留存，容易混线。
|
||||
- 影响：
|
||||
- 新工作不得只写在聊天记录里。
|
||||
- 完成任务必须同步推进台账和验收证据。
|
||||
|
||||
## D004 - 法务内容按草稿处理
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 决策：Terms、Privacy、Disclaimer 当前按草稿记录，正式上线前需要法务或负责人确认。
|
||||
- 原因：
|
||||
- 页面涉及 non-law-firm statement、attorney-client relationship、refund、privacy、file upload、attorney referral、immigration outcome guarantee 等高风险内容。
|
||||
- 页面曾使用 `Last updated: July 10, 2026`，晚于当前日期 `2026-07-06`；R007 已修正日期，但内容仍需审核。
|
||||
- 影响：
|
||||
- `T016` 标为 `BLOCKED`，等待法务/负责人输入。
|
||||
- `T017` 后续已完成日期修正；法务内容审核仍不关闭。
|
||||
|
||||
## D005 - 本轮不改 doc/index.html
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 决策：R002 只补强 `working` 文档，不修改 `doc/index.html`。
|
||||
- 原因：
|
||||
- 用户要求是在 `working` 中编写文档体系。
|
||||
- 当前还没有要求开始代码修复或工程化迁移。
|
||||
- 影响：
|
||||
- `T029` 虽已识别，但仍为 `TODO`。
|
||||
- 后续修复死链时应单独开一轮并记录证据。
|
||||
|
||||
## D006 - 长期文档不保存明文服务器密码
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 决策：用户提供的 SSH 密码只视为临时交接信息，不写入 `working` 长期文档。
|
||||
- 原因：
|
||||
- `working` 文档会作为后续推进资料，可能被复制、上传或纳入版本控制。
|
||||
- 明文密码进入项目文件会扩大泄露面。
|
||||
- 影响：
|
||||
- 服务器信息保留 host、user、port、domain。
|
||||
- `T030` 要求改用 SSH key、部署密钥或受控密钥库。
|
||||
|
||||
## D007 - 目标部署端口采用 8082
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 决策：部署方案默认内部服务监听 `8082`，HTTPS 由域名和反向代理对外提供。
|
||||
- 原因：
|
||||
- 用户明确给出端口号 `8082`。
|
||||
- 用户说明 `8080-8099` 已开放。
|
||||
- HTTPS 通常由 Nginx/Caddy/负载均衡终止，再转发到本地应用端口。
|
||||
- 影响：
|
||||
- `T024` 验收服务器本地 `127.0.0.1:8082`。
|
||||
- `T025` 验收 `https://paprikalaw.com/`。
|
||||
|
||||
## D008 - Services 的 contact 路由判定为缺陷
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 决策：Services 页面 04/05/06 CTA 指向 `contact` 是缺陷，不按设计接受。
|
||||
- 原因：
|
||||
- `pageData` 没有 `contact` 页面。
|
||||
- 当前路由逻辑会把未知页面回退到 `home`。
|
||||
- CTA 文案是 Start Here，合理目标应为 `start`，除非新增真实 Contact 页面。
|
||||
- 影响：
|
||||
- 新增 `T029`。
|
||||
- 修复前 `T006` 只能保持 `VERIFY`，不能标为 `DONE`。
|
||||
|
||||
## D009 - Outlet/network 名称正式发布前需确认
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 决策：Press 和 Judging 页面中的 outlet/network 名称上线前必须由负责人确认，或改成示例类型表达。
|
||||
- 原因：
|
||||
- 页面列出大量媒体和 judging/network 名称，可能被理解为合作关系、可保证 placement 或背书。
|
||||
- 这类陈述涉及商业真实性和法律风险。
|
||||
- 影响：
|
||||
- 新增 `T031`，状态 `BLOCKED`。
|
||||
- 未确认前不建议直接正式上线。
|
||||
|
||||
## D010 - 完全对标必须包含视觉和源码结构
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 决策：后续提到“完全对标 `doc/index.html`”时，不能只记录页面文案，还必须覆盖 CSS token、组件类、函数清单、CTA 映射、FAQ 编号、Legal section、未调用模块和源码缺陷。
|
||||
- 原因：
|
||||
- `doc/index.html` 是 3423 行单文件 mockup，页面内容、视觉规范和路由逻辑耦合在一起。
|
||||
- 如果只记录页面功能，工程化拆分时容易丢失视觉细节或保留隐藏缺陷。
|
||||
- 影响：
|
||||
- `01-项目功能内容.md` 增加源码级对标附录。
|
||||
- `02-项目程序开发详细步骤.md` 增加完全对标核验清单。
|
||||
- 新增 `T034` 和 `E016`。
|
||||
|
||||
## D011 - 正式开发架构采用 Next.js + React + PostgreSQL
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 决策：正式开发技术架构采用 Next.js + React，数据库使用 PostgreSQL。
|
||||
- 默认补充决策：
|
||||
- 使用 TypeScript。
|
||||
- 使用 Next.js App Router。
|
||||
- 使用 Prisma 作为 PostgreSQL ORM。
|
||||
- 使用 Next.js Route Handlers 或 Server Actions 处理表单提交。
|
||||
- 生产服务监听 `8082`，HTTPS 由反向代理处理。
|
||||
- 原因：
|
||||
- 用户明确指定 `Next+ React` 和 `PostGreSQL`。
|
||||
- 项目需要真实表单、数据持久化、后续可能的文件上传和后台线索管理，单纯静态站不够。
|
||||
- Next.js 可同时承接页面、API、SEO、构建和生产服务。
|
||||
- 影响：
|
||||
- `02-项目程序开发详细步骤.md` 中工程化路线改为 Next.js + PostgreSQL。
|
||||
- 新增 `T035-T039`。
|
||||
- 后续不再优先推进 Vite/纯静态拆分，除非另有新决策。
|
||||
|
||||
## D012 - PostgreSQL 已安装但仍需远程验证
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 决策：将服务器 PostgreSQL 状态记录为“用户确认已安装，待远程验证”，不直接视为已完成数据库接入。
|
||||
- 原因：
|
||||
- 用户已明确说明 PostgreSQL 在服务器安装完成。
|
||||
- 但尚未执行服务状态、版本、数据库列表、应用数据库、应用用户和连接字符串验证。
|
||||
- 影响：
|
||||
- 新增 `T040` 远程验证 PostgreSQL 安装。
|
||||
- `T037` PostgreSQL + Prisma 接入仍保持 `TODO`。
|
||||
- 继续执行不保存明文密码的凭据规则。
|
||||
|
||||
## D013 - 邮箱账号统一记录但不保存初始密码
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 决策：记录 `paprikalaw.com` 邮箱入口、管理员账号和 10 个普通邮箱账号，但不在长期文档保存用户提供的统一初始密码。
|
||||
- 原因：
|
||||
- 邮箱账号属于项目基础设施，网站联系、表单通知和法务联系需要引用。
|
||||
- 多账号共用初始密码存在安全风险，进入文档会扩大泄露面。
|
||||
- 影响：
|
||||
- 新增 `T041-T043`。
|
||||
- 创建或确认邮箱后，应尽快改为独立强密码并记录验证证据。
|
||||
- Next.js SMTP 凭据只能放服务器环境变量或受控密钥库。
|
||||
|
||||
## D014 - 保留 doc/index.html 作为对标基线，同时以 Next.js 为正式工程
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 决策：不删除 `doc/index.html`，正式代码在根目录 Next.js 工程中维护。
|
||||
- 原因：
|
||||
- `doc/index.html` 是既有视觉、文案和路由逻辑的完整基线。
|
||||
- 新工程需要持续对标旧 mockup，避免内容迁移漂移。
|
||||
- `scripts/extract-legacy-pages.mjs` 可从旧基线重新生成静态页面 CSS 和 HTML 数据。
|
||||
- 影响：
|
||||
- 静态内容页面暂由 `lib/legacy-pages.ts` 和 `LegacyPage` 渲染。
|
||||
- `/start`、`/ask`、`/thanks` 已由 React 页面接管，不再使用旧 mockup 表单。
|
||||
|
||||
## D015 - 文件上传暂不启用
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 决策：Start/Ask 表单当前不启用 CV/resume 上传。
|
||||
- 原因：
|
||||
- 文件上传涉及存储位置、大小限制、访问权限、隐私保留期限和删除策略。
|
||||
- 未确认前收集 CV 会扩大敏感数据风险。
|
||||
- 影响：
|
||||
- `SubmissionFile` 表作为未来能力预留。
|
||||
- 前端表单明确说明 file upload 暂停，直到存储和隐私方案获批。
|
||||
|
||||
## D016 - 表单入库任务不在缺少 DATABASE_URL 时关闭
|
||||
|
||||
- 日期：2026-07-06
|
||||
- 决策：虽然 `/api/submissions` 已实现 Prisma 写入代码，但在没有真实 PostgreSQL `DATABASE_URL` 和成功 `submission_id` 证据前，T038/T044 不标为 `DONE`。
|
||||
- 原因：
|
||||
- API 代码通过构建不等于数据已经成功持久化。
|
||||
- 生产数据库连接、migration、权限和网络策略都可能导致运行时失败。
|
||||
- 影响：
|
||||
- T012/T013/T038 保持 `VERIFY`。
|
||||
- 新增 T044，专门记录真实 PostgreSQL 入库验收。
|
||||
54
working/README.md
Normal file
54
working/README.md
Normal file
@@ -0,0 +1,54 @@
|
||||
# MeetPaprika Working Index
|
||||
|
||||
本目录用于承接 Paprika 网站后续开发推进。所有后续工作优先从 `04-任务矩阵.md` 领取任务，并在完成后同步更新 `03-推进台账.md`、`05-验收证据.md` 和必要的 `06-决策记录.md`。
|
||||
|
||||
## 文档索引
|
||||
|
||||
1. [01-项目功能内容.md](01-项目功能内容.md)
|
||||
对标 `/home/mes123456/MeetPaprika/doc/index.html`，说明当前 Paprika 静态网站 mockup 的页面、功能、内容模块、交互方式、视觉规范、CSS 类、JS 函数、CTA 映射、表单边界、服务器目标和已知风险。
|
||||
|
||||
2. [02-项目程序开发详细步骤.md](02-项目程序开发详细步骤.md)
|
||||
说明从当前单文件 mockup 到可维护、可上线版本的开发步骤，包括静态修复、真实表单、工程化拆分、8082 部署、HTTPS、回归验收和完全对标核验命令。
|
||||
|
||||
3. [03-推进台账.md](03-推进台账.md)
|
||||
记录每轮做了什么、改了哪些文件、验证了什么、下一步是什么。
|
||||
|
||||
4. [04-任务矩阵.md](04-任务矩阵.md)
|
||||
统一维护任务编号、状态、验收标准和依赖，防止重复做同一件事。
|
||||
|
||||
5. [05-验收证据.md](05-验收证据.md)
|
||||
记录命令、页面、截图、PDF、job_id、report_id、submission_id、部署链接等证据。
|
||||
|
||||
6. [06-决策记录.md](06-决策记录.md)
|
||||
记录关键设计、工程、部署和安全决策，后续变更时先查这里，避免反复争论同一个问题。
|
||||
|
||||
## 当前基线
|
||||
|
||||
- 参考文件：`/home/mes123456/MeetPaprika/doc/index.html`
|
||||
- 当前形态：已新增 Next.js + React 工程；`doc/index.html` 保留为静态 mockup 对标基线。
|
||||
- 静态基线：`doc/index.html` 仍通过查询参数 `?page=...` 渲染不同页面。
|
||||
- Next 路由：`/`、`/press`、`/judging`、`/scholarly`、`/services`、`/why`、`/resources`、`/faq`、`/start`、`/ask`、`/thanks`、`/terms`、`/privacy`、`/disclaimer`。
|
||||
- 当前表单：`/start` 和 `/ask` 已改为真实 React 表单，提交到 `POST /api/submissions`；成功入库依赖生产 `DATABASE_URL`。
|
||||
- 数据访问层：Prisma ORM；已存在 `prisma/schema.prisma` 和初始化 migration。
|
||||
- 目标域名：`https://paprikalaw.com/`
|
||||
- 目标服务器：`ubuntu@170.106.192.152`
|
||||
- 目标端口：`8082`
|
||||
- 邮箱普通入口：`https://mail.paprikalaw.com/webmail/`
|
||||
- 邮箱管理员入口：`https://mail.paprikalaw.com/admin/`
|
||||
- 凭据规则：长期文档不保存明文密码，后续部署改用 SSH key 或受控密钥交接。
|
||||
|
||||
## 下一步建议
|
||||
|
||||
1. 配置生产 `.env` 的 `DATABASE_URL`，在服务器 PostgreSQL 上执行 Prisma migration。
|
||||
2. 远程验证 `170.106.192.152` 的 PostgreSQL、应用数据库和应用用户。
|
||||
3. 将 Next.js 应用部署到服务器 `8082`，再配置 HTTPS 反向代理到 `https://paprikalaw.com/`。
|
||||
4. 登录邮件后台确认邮箱、DNS 和收发，再接入表单通知。
|
||||
5. 完成法务文本、outlet/network 名称、文件上传策略和截图验收。
|
||||
|
||||
## 工作规则
|
||||
|
||||
1. 开始前查 `04-任务矩阵.md`。
|
||||
2. 完成后写 `03-推进台账.md`。
|
||||
3. 有命令、截图、部署、表单提交、PDF、job_id、report_id 时写 `05-验收证据.md`。
|
||||
4. 有路线、合规、安全、部署、架构取舍时写 `06-决策记录.md`。
|
||||
5. 不把 SSH 密码、API key、表单 webhook secret、CRM token 写入本目录。
|
||||
Reference in New Issue
Block a user