fix(#338): Gate mock data behind NODE_ENV check

- Create ComingSoon component for production placeholders
- Federation connections page shows Coming Soon in production
- Workspaces settings page shows Coming Soon in production
- Teams page shows Coming Soon in production
- Add comprehensive tests for environment-based rendering

Refs #338

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

apps/web/src/app/settings/workspaces/[id]/teams/page.test.tsx

@@ -0,0 +1,118 @@
+/**
+ * Teams Page Tests
+ * Tests for page structure and component integration
+ */
+
+import { describe, it, expect, vi } from "vitest";
+import { render, screen } from "@testing-library/react";
+
+// Mock next/navigation
+vi.mock("next/navigation", () => ({
+  useParams: (): { id: string } => ({ id: "workspace-1" }),
+}));
+
+// Mock next/link
+vi.mock("next/link", () => ({
+  default: ({ children, href }: { children: React.ReactNode; href: string }): React.JSX.Element => (
+    <a href={href}>{children}</a>
+  ),
+}));
+
+// Mock the TeamCard component
+vi.mock("@/components/team/TeamCard", () => ({
+  TeamCard: (): React.JSX.Element => <div data-testid="team-card">TeamCard</div>,
+}));
+
+// Mock @mosaic/ui components
+vi.mock("@mosaic/ui", () => ({
+  Button: ({
+    children,
+    onClick,
+    disabled,
+  }: {
+    children: React.ReactNode;
+    onClick?: () => void;
+    disabled?: boolean;
+  }): React.JSX.Element => (
+    <button onClick={onClick} disabled={disabled}>
+      {children}
+    </button>
+  ),
+  Input: ({
+    label,
+    value,
+    onChange,
+    placeholder,
+    disabled,
+  }: {
+    label: string;
+    value: string;
+    onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
+    placeholder?: string;
+    disabled?: boolean;
+  }): React.JSX.Element => (
+    <div>
+      <label>{label}</label>
+      <input value={value} onChange={onChange} placeholder={placeholder} disabled={disabled} />
+    </div>
+  ),
+  Modal: ({
+    isOpen,
+    onClose,
+    title,
+    children,
+  }: {
+    isOpen: boolean;
+    onClose: () => void;
+    title: string;
+    children: React.ReactNode;
+  }): React.JSX.Element | null =>
+    isOpen ? (
+      <div data-testid="modal">
+        <h2>{title}</h2>
+        <button onClick={onClose}>Close</button>
+        {children}
+      </div>
+    ) : null,
+}));
+
+describe("TeamsPage", (): void => {
+  // Note: NODE_ENV is "test" during test runs, which triggers the Coming Soon view
+  // This tests the production-like behavior where mock data is hidden
+
+  it("should render the Coming Soon view in non-development environments", async (): Promise<void> => {
+    const { default: TeamsPage } = await import("./page");
+    render(<TeamsPage />);
+
+    // In test mode (non-development), should show Coming Soon
+    expect(screen.getByText("Coming Soon")).toBeInTheDocument();
+    expect(screen.getByText("Team Management")).toBeInTheDocument();
+  });
+
+  it("should display appropriate description for team feature", async (): Promise<void> => {
+    const { default: TeamsPage } = await import("./page");
+    render(<TeamsPage />);
+
+    expect(
+      screen.getByText(/organize workspace members into teams for better collaboration/i)
+    ).toBeInTheDocument();
+  });
+
+  it("should not render mock team data in Coming Soon view", async (): Promise<void> => {
+    const { default: TeamsPage } = await import("./page");
+    render(<TeamsPage />);
+
+    // Should not show team cards or create button in non-development mode
+    expect(screen.queryByTestId("team-card")).not.toBeInTheDocument();
+    expect(screen.queryByRole("button", { name: /create team/i })).not.toBeInTheDocument();
+  });
+
+  it("should include link back to settings", async (): Promise<void> => {
+    const { default: TeamsPage } = await import("./page");
+    render(<TeamsPage />);
+
+    const link = screen.getByRole("link", { name: /back to settings/i });
+    expect(link).toBeInTheDocument();
+    expect(link).toHaveAttribute("href", "/settings");
+  });
+});

apps/web/src/app/settings/workspaces/[id]/teams/page.tsx

@@ -5,10 +5,19 @@ import type { ReactElement } from "react";
 import { useState } from "react";
 import { useParams } from "next/navigation";
 import { TeamCard } from "@/components/team/TeamCard";
+import { ComingSoon } from "@/components/ui/ComingSoon";
 import { Button, Input, Modal } from "@mosaic/ui";
 import { mockTeams } from "@/lib/api/teams";
+import Link from "next/link";
 
-export default function TeamsPage(): ReactElement {
+// Check if we're in development mode
+const isDevelopment = process.env.NODE_ENV === "development";
+
+/**
+ * Teams Page Content - Development Only
+ * Shows mock team data for development purposes
+ */
+function TeamsPageContent(): ReactElement {
   const params = useParams();
   const workspaceId = params.id as string;
 
@@ -160,3 +169,26 @@ export default function TeamsPage(): ReactElement {
     </main>
   );
 }
+
+/**
+ * Teams Page Entry Point
+ * Shows development content or Coming Soon based on environment
+ */
+export default function TeamsPage(): ReactElement {
+  // In production, show Coming Soon placeholder
+  if (!isDevelopment) {
+    return (
+      <ComingSoon
+        feature="Team Management"
+        description="Organize workspace members into teams for better collaboration. Team management is currently under development."
+      >
+        <Link href="/settings" className="text-sm text-blue-600 hover:text-blue-700">
+          Back to Settings
+        </Link>
+      </ComingSoon>
+    );
+  }
+
+  // In development, show the full page with mock data
+  return <TeamsPageContent />;
+}