@nexttylabs/echo 0.2.0

package/app/(public)/[organizationSlug]/changelog/page.tsx

@@ -0,0 +1,109 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import { notFound } from "next/navigation";
+import { PortalLayout } from "@/components/portal/portal-layout";
+import { ChangelogList } from "@/components/portal/changelog-list";
+import type { ChangelogItem } from "@/components/portal/changelog-entry";
+import { Button } from "@/components/ui/button";
+import { getPortalPublicContext, getPortalSections } from "@/lib/portal/public-context";
+import { getTranslations } from "next-intl/server";
+
+type PageProps = {
+  params: Promise<{ organizationSlug: string }>;
+};
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+async function getChangelogEntries(_organizationId: string): Promise<ChangelogItem[]> {
+  // TODO: Implement actual changelog query from database
+  // For now, return sample data
+  return [
+    {
+      id: "1",
+      title: "New Feedback Portal Design",
+      content: "<p>We've completely redesigned the feedback portal with a modern, clean interface. The new design features improved navigation, better organization of content, and enhanced readability.</p>",
+      type: "feature",
+      publishedAt: new Date().toISOString(),
+    },
+    {
+      id: "2", 
+      title: "Roadmap Kanban View",
+      content: "<p>You can now view the product roadmap in a beautiful Kanban-style board with columns for Backlog, Next Up, In Progress, and Done.</p>",
+      type: "feature",
+      publishedAt: new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString(),
+    },
+    {
+      id: "3",
+      title: "Performance Improvements",
+      content: "<p>Significant performance improvements across the entire portal. Pages now load 40% faster.</p>",
+      type: "improvement",
+      publishedAt: new Date(Date.now() - 14 * 24 * 60 * 60 * 1000).toISOString(),
+    },
+  ];
+}
+
+export async function generateMetadata({ params }: PageProps) {
+  const { organizationSlug } = await params;
+  const context = await getPortalPublicContext(organizationSlug);
+  const organization = context?.organization;
+
+  if (!organization || !context?.portalEnabled) {
+    return { title: "Not Found" };
+  }
+
+  return {
+    title: `Changelog - ${organization.name}`,
+    description: `Latest updates and announcements from ${organization.name}`,
+  };
+}
+
+export default async function OrganizationChangelogPage({ params }: PageProps) {
+  const t = await getTranslations("portal.changelog");
+  const { organizationSlug } = await params;
+
+  const context = await getPortalPublicContext(organizationSlug);
+  const organization = context?.organization;
+
+  if (!organization || !context?.portalEnabled || !context.modules.changelog) {
+    notFound();
+  }
+
+  const entries = await getChangelogEntries(organization.id);
+  const sections = getPortalSections(organizationSlug, context.modules);
+
+  return (
+    <PortalLayout
+      organizationName={organization.name}
+      organizationSlug={organizationSlug}
+      sections={sections}
+    >
+      <div className="space-y-8">
+        <div className="flex flex-col gap-4 sm:flex-row sm:items-end sm:justify-between">
+          <div>
+            <h1 className="text-3xl font-bold tracking-tight">{t("title")}</h1>
+            <p className="text-muted-foreground mt-2">
+              Stay up to date with the latest updates and improvements.
+            </p>
+          </div>
+          <Button size="lg">{t("subscribeToUpdates")}</Button>
+        </div>
+
+        <ChangelogList entries={entries} />
+      </div>
+    </PortalLayout>
+  );
+}

package/app/(public)/[organizationSlug]/feedback/[id]/page.tsx

@@ -0,0 +1,146 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import Link from "next/link";
+import { notFound } from "next/navigation";
+import { headers } from "next/headers";
+import { getTranslations } from "next-intl/server";
+import { PortalLayout } from "@/components/portal/portal-layout";
+import { FeedbackDetail } from "@/components/feedback/feedback-detail";
+import { PublicComments } from "@/components/comment/public-comments";
+import { Button } from "@/components/ui/button";
+import { getPortalPublicContext, getPortalSections } from "@/lib/portal/public-context";
+import { getFeedbackById } from "@/lib/feedback/get-feedback-by-id";
+import { auth } from "@/lib/auth/config";
+
+export const dynamic = "force-dynamic";
+
+interface PageProps {
+  params: Promise<{ organizationSlug: string; id: string }>;
+}
+
+export async function generateMetadata({ params }: PageProps) {
+  const t = await getTranslations("feedback.detail");
+  const { organizationSlug, id } = await params;
+  const context = await getPortalPublicContext(organizationSlug);
+  const organization = context?.organization;
+
+  if (!organization || !context?.portalEnabled) {
+    return { title: t("publicTitle") };
+  }
+
+  const feedbackId = Number(id);
+  if (Number.isNaN(feedbackId)) {
+    return { title: t("publicTitle") };
+  }
+
+  const { db } = await import("@/lib/db");
+  if (!db) {
+    return { title: t("publicTitle") };
+  }
+
+  const result = await getFeedbackById(db, feedbackId);
+  if (!result || "deleted" in result) {
+    return { title: t("publicTitle") };
+  }
+
+  if (result.feedback.organizationId !== organization.id) {
+    return { title: t("publicTitle") };
+  }
+
+  return {
+    title: t("publicTitle"),
+    description: t("publicDescription"),
+    robots: context.seo?.noIndex ? { index: false, follow: false } : undefined,
+    openGraph: {
+      title: t("publicTitle"),
+      description: t("publicDescription"),
+      type: "website",
+    },
+  };
+}
+
+export default async function OrganizationFeedbackDetailPage({ params }: PageProps) {
+  const t = await getTranslations("feedback.detail");
+  const { organizationSlug, id } = await params;
+  const feedbackId = Number(id);
+
+  if (Number.isNaN(feedbackId)) {
+    notFound();
+  }
+
+  const context = await getPortalPublicContext(organizationSlug);
+  const organization = context?.organization;
+
+  if (!organization || !context?.portalEnabled || !context.modules.feedback) {
+    notFound();
+  }
+
+  const { db } = await import("@/lib/db");
+  if (!db) {
+    notFound();
+  }
+
+  const result = await getFeedbackById(db, feedbackId);
+  if (!result || "deleted" in result) {
+    notFound();
+  }
+
+  if (result.feedback.organizationId !== organization.id) {
+    notFound();
+  }
+
+  const session = await auth.api.getSession({ headers: await headers() });
+  const isAuthenticated = !!session?.user;
+
+  const sections = getPortalSections(organizationSlug, context.modules);
+
+  return (
+    <PortalLayout
+      organizationName={organization.name}
+      organizationSlug={organizationSlug}
+      sections={sections}
+    >
+      <div className="mx-auto max-w-3xl space-y-6">
+        <div className="flex flex-wrap items-center justify-between gap-3">
+          <h2 className="text-sm text-muted-foreground">{t("publicHeader")}</h2>
+          <div className="flex flex-wrap gap-2">
+            <Button asChild variant="outline" size="sm">
+              <Link href={`/${organizationSlug}`}>{t("publicBackHome")}</Link>
+            </Button>
+            <Button asChild size="sm">
+              <Link href={`/${organizationSlug}`}>{t("publicContinueSubmit")}</Link>
+            </Button>
+          </div>
+        </div>
+        <FeedbackDetail
+          feedback={{
+            ...result.feedback,
+            attachments: [],
+          }}
+        />
+        <PublicComments
+          feedbackId={feedbackId}
+          isAuthenticated={isAuthenticated}
+          organizationId={organization.id}
+          allowPublicComments={context.sharing.allowPublicComments}
+          className="mt-6"
+        />
+      </div>
+    </PortalLayout>
+  );
+}

package/app/(public)/[organizationSlug]/page.tsx

@@ -0,0 +1,160 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import { notFound } from "next/navigation";
+import { headers } from "next/headers";
+import { and, desc, eq, isNull, sql } from "drizzle-orm";
+import { PortalLayout } from "@/components/portal/portal-layout";
+import { FeedbackBoard } from "@/components/portal/feedback-board";
+import type { FeedbackPost } from "@/components/portal/feedback-post-card";
+import type { Contributor } from "@/components/portal/contributors-sidebar";
+import { getPortalPublicContext, getPortalSections } from "@/lib/portal/public-context";
+import { auth } from "@/lib/auth/config";
+
+type PageProps = {
+  params: Promise<{ organizationSlug: string }>;
+  searchParams: Promise<{ sort?: string }>;
+};
+
+async function getFeedbackPosts(
+  organizationId: string,
+  sort: string = "new"
+): Promise<FeedbackPost[]> {
+  const { db } = await import("@/lib/db");
+  if (!db) return [];
+
+  // Import feedback schema
+  const { feedback } = await import("@/lib/db/schema");
+
+  const voteCountSubquery = sql<number>`(
+    SELECT COUNT(*)::int
+    FROM "votes"
+    WHERE "votes"."feedbackId" = "feedback"."feedbackId"
+  )`;
+
+  // Count only public comments (isInternal = false)
+  const commentCountSubquery = sql<number>`(
+    SELECT COUNT(*)::int
+    FROM "comments"
+    WHERE "comments"."feedbackId" = "feedback"."feedbackId"
+    AND "comments"."isInternal" = false
+  )`;
+
+  const orderByClause =
+    sort === "top"
+      ? desc(voteCountSubquery)
+      : sort === "trending"
+        ? desc(voteCountSubquery) // Simplified: could add time weight
+        : desc(feedback.createdAt);
+
+  const results = await db
+    .select({
+      id: feedback.feedbackId,
+      title: feedback.title,
+      description: feedback.description,
+      type: feedback.type,
+      status: feedback.status,
+      voteCount: voteCountSubquery,
+      commentCount: commentCountSubquery,
+      createdAt: feedback.createdAt,
+    })
+    .from(feedback)
+    .where(
+      and(
+        eq(feedback.organizationId, organizationId),
+        isNull(feedback.deletedAt),
+      ),
+    )
+    .orderBy(orderByClause)
+    .limit(50);
+
+  return results.map((r) => ({
+    id: r.id,
+    title: r.title,
+    description: r.description,
+    type: r.type,
+    status: r.status,
+    voteCount: r.voteCount ?? 0,
+    commentCount: r.commentCount ?? 0,
+    createdAt: r.createdAt?.toISOString() ?? new Date().toISOString(),
+    author: null, // TODO: Add author info
+  }));
+}
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+async function getTopContributors(_organizationId: string): Promise<Contributor[]> {
+  // TODO: Implement actual contributor query
+  // For now, return empty array
+  return [];
+}
+
+export async function generateMetadata({ params }: PageProps) {
+  const { organizationSlug } = await params;
+  const context = await getPortalPublicContext(organizationSlug);
+  const organization = context?.organization;
+
+  if (!organization || !context?.portalEnabled) {
+    return { title: "Not Found" };
+  }
+
+  return {
+    title: `${organization.name} - Feedback Portal`,
+    description: organization.description || `${organization.name} feedback portal`,
+    robots: context.seo.noIndex ? { index: false, follow: false } : undefined,
+  };
+}
+
+export default async function OrganizationPortalPage({ params, searchParams }: PageProps) {
+  const { organizationSlug } = await params;
+  const { sort = "new" } = await searchParams;
+
+  const context = await getPortalPublicContext(organizationSlug);
+  const organization = context?.organization;
+
+  if (!organization || !context?.portalEnabled || !context.modules.feedback) {
+    notFound();
+  }
+
+  const [posts, contributors] = await Promise.all([
+    getFeedbackPosts(organization.id, sort),
+    getTopContributors(organization.id),
+  ]);
+
+  const sections = getPortalSections(organizationSlug, context.modules);
+  const session = await auth.api.getSession({ headers: await headers() });
+  const isAuthenticated = !!session?.user;
+
+  return (
+    <PortalLayout
+      organizationName={organization.name}
+      organizationSlug={organizationSlug}
+      sections={sections}
+    >
+      <FeedbackBoard
+        organizationId={organization.id}
+        organizationSlug={organizationSlug}
+        posts={posts}
+        isAuthenticated={isAuthenticated}
+        contributors={contributors}
+        totalCount={posts.length}
+        showVoteCount={context.sharing.showVoteCount}
+        showAuthor={context.sharing.showAuthor}
+        allowPublicVoting={context.sharing.allowPublicVoting}
+      />
+    </PortalLayout>
+  );
+}

package/app/(public)/[organizationSlug]/roadmap/page.tsx

@@ -0,0 +1,142 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import Link from "next/link";
+import { notFound } from "next/navigation";
+import { and, desc, eq, isNull, sql } from "drizzle-orm";
+import { headers } from "next/headers";
+import { auth } from "@/lib/auth/config";
+import { PortalLayout } from "@/components/portal/portal-layout";
+import { RoadmapBoard, type RoadmapStatus } from "@/components/portal/roadmap-board";
+import type { RoadmapItem } from "@/components/portal/roadmap-column";
+import { Button } from "@/components/ui/button";
+import { getPortalPublicContext, getPortalSections } from "@/lib/portal/public-context";
+import { getTranslations } from "next-intl/server";
+
+type PageProps = {
+  params: Promise<{ organizationSlug: string }>;
+};
+
+async function getRoadmapItems(organizationId: string): Promise<RoadmapItem[]> {
+  const { db } = await import("@/lib/db");
+  if (!db) return [];
+
+  // Import feedback schema and get items with roadmap-related statuses
+  const { feedback } = await import("@/lib/db/schema");
+
+  // Map feedback statuses to roadmap statuses
+  const statusMap: Record<string, RoadmapStatus> = {
+    new: "backlog",
+    planned: "next-up",
+    "in-progress": "in-progress",
+    completed: "done",
+    closed: "done",
+  };
+
+  const voteCountSubquery = sql<number>`(
+    SELECT COUNT(*)::int
+    FROM "votes"
+    WHERE "votes"."feedbackId" = "feedback"."feedbackId"
+  )`;
+
+  const results = await db
+    .select({
+      id: feedback.feedbackId,
+      title: feedback.title,
+      type: feedback.type,
+      status: feedback.status,
+      voteCount: voteCountSubquery,
+    })
+    .from(feedback)
+    .where(
+      and(
+        eq(feedback.organizationId, organizationId),
+        isNull(feedback.deletedAt),
+      ),
+    )
+    .orderBy(desc(voteCountSubquery))
+    .limit(100);
+
+  return results.map((r) => ({
+    id: r.id,
+    title: r.title,
+    category: r.type,
+    voteCount: r.voteCount ?? 0,
+    status: statusMap[r.status] ?? "backlog",
+  }));
+}
+
+export async function generateMetadata({ params }: PageProps) {
+  const { organizationSlug } = await params;
+  const context = await getPortalPublicContext(organizationSlug);
+  const organization = context?.organization;
+
+  if (!organization || !context?.portalEnabled) {
+    return { title: "Not Found" };
+  }
+
+  return {
+    title: `Roadmap - ${organization.name}`,
+    description: `View the product roadmap for ${organization.name}`,
+  };
+}
+
+export default async function OrganizationRoadmapPage({ params }: PageProps) {
+  const t = await getTranslations("portal.roadmap");
+  const { organizationSlug } = await params;
+
+  const context = await getPortalPublicContext(organizationSlug);
+  const organization = context?.organization;
+
+  if (!organization || !context?.portalEnabled || !context.modules.roadmap) {
+    notFound();
+  }
+
+  // Check if user is admin
+  const session = await auth.api.getSession({ headers: await headers() });
+  const isAdmin = session?.user?.role === "admin" || session?.user?.role === "owner";
+
+  const items = await getRoadmapItems(organization.id);
+  const sections = getPortalSections(organizationSlug, context.modules);
+
+  return (
+    <PortalLayout
+      organizationName={organization.name}
+      organizationSlug={organizationSlug}
+      sections={sections}
+    >
+      <div className="space-y-6">
+        <div className="flex flex-col gap-4 sm:flex-row sm:items-end sm:justify-between">
+          <div>
+            <h1 className="text-3xl font-bold tracking-tight">{t("title")}</h1>
+            <p className="text-muted-foreground mt-2">
+              See what we&apos;re working on and what&apos;s coming next.
+            </p>
+          </div>
+          <div className="flex flex-col gap-2 sm:flex-row">
+            <Button size="lg">{t("subscribeToUpdates")}</Button>
+            <Button variant="secondary" size="lg" asChild>
+              <Link href={`/${organizationSlug}`}>{t("submitFeedback")}</Link>
+            </Button>
+          </div>
+        </div>
+
+        <RoadmapBoard items={items} isAdmin={isAdmin} />
+      </div>
+    </PortalLayout>
+  );
+}

package/app/(public)/docs/page.tsx

@@ -0,0 +1,48 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+'use client';
+
+import dynamic from 'next/dynamic';
+import 'swagger-ui-react/swagger-ui.css';
+import { useEffect, useState } from 'react';
+
+const SwaggerUI = dynamic(() => import('swagger-ui-react'), { ssr: false });
+
+export default function ApiDocsPage() {
+  const [spec, setSpec] = useState<Record<string, unknown> | null>(null);
+
+  useEffect(() => {
+    fetch('/api/docs')
+      .then((res) => res.json())
+      .then(setSpec);
+  }, []);
+
+  if (!spec) {
+    return (
+      <div className="min-h-screen flex items-center justify-center">
+        <div className="animate-spin rounded-full h-8 w-8 border-b-2 border-primary" />
+      </div>
+    );
+  }
+
+  return (
+    <div className="min-h-screen bg-background">
+      <SwaggerUI spec={spec} />
+    </div>
+  );
+}

package/app/(public)/feedback/[id]/not-found.tsx

@@ -0,0 +1,33 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import Link from "next/link";
+import { Button } from "@/components/ui/button";
+import { useTranslations } from "next-intl";
+
+export default function NotFound() {
+  const t = useTranslations("errors.notFound");
+  return (
+    <div className="container mx-auto py-16 text-center">
+      <h1 className="text-4xl font-bold mb-4">{t("title")}</h1>
+      <p className="text-muted-foreground mb-8">该反馈不存在或已被删除。</p>
+      <Button asChild>
+        <Link href="/">返回首页</Link>
+      </Button>
+    </div>
+  );
+}