StackMIREA-0014 // Unify track metadata, fix edit/source links and social preview, enable real theme switching, remove client-side deployment fetches, and improve author stats and search UX

Author: minkinad

app/authors/page.tsx

@@ -3,6 +3,7 @@ import type { Metadata } from "next";
 import { GitHubUserBadge } from "@/components/ui/GitHubUserBadge";
 import { getDevTeamMembers } from "@/lib/authors";
 import { getAllDocs } from "@/lib/navigation";
+import { getTrackTitle } from "@/lib/tracks";
 
 export const dynamic = "force-static";
 
@@ -19,16 +20,8 @@ interface AuthorWithSummary {
   summary: string;
 }
 
-const SECTION_TITLES: Record<string, string> = {
-  ai: "AI",
-  bigdata: "BigData",
-  java: "Java",
-  python: "Python",
-  algorithms: "Algorithms"
-};
-
 function formatSectionName(section: string) {
-  return SECTION_TITLES[section.toLowerCase()] ?? section;
+  return getTrackTitle(section.toLowerCase());
 }
 
 function buildSummary(sectionStats: Array<{ section: string; count: number }>) {
@@ -51,7 +44,7 @@ function buildSummary(sectionStats: Array<{ section: string; count: number }>) {
 }
 
 function getAuthorsWithSummary() {
-  const docs = getAllDocs();
+  const docs = getAllDocs().filter((doc) => !doc.isSectionIndex);
   const authorsMap = new Map<
     string,
     {
@@ -122,7 +115,7 @@ export default function AuthorsPage() {
       </header>
 
       <section className="mb-10">
-        <h2 className="mb-4 text-xl font-semibold tracking-tight">Authors</h2>
+        <h2 className="mb-4 text-xl font-semibold tracking-tight">Авторы публикаций</h2>
         <div className="grid gap-4 lg:grid-cols-2">
           {authors.map((author) => (
             <article key={author.github} className="rounded-xl border border-border/80 bg-card/70 p-4">
@@ -134,7 +127,7 @@ export default function AuthorsPage() {
       </section>
 
       <section>
-        <h2 className="mb-4 text-xl font-semibold tracking-tight">devTeam</h2>
+        <h2 className="mb-4 text-xl font-semibold tracking-tight">Команда разработки</h2>
         <div className="grid gap-3 sm:grid-cols-2 lg:grid-cols-3">
           {devTeam.map((member) => (
             <GitHubUserBadge key={member.github} person={member} description={member.role} />
@@ -143,7 +136,7 @@ export default function AuthorsPage() {
       </section>
 
       <section className="mt-10 rounded-xl border border-border/80 bg-card/70 p-5">
-        <h2 className="text-xl font-semibold tracking-tight">Контакты devTeam</h2>
+        <h2 className="text-xl font-semibold tracking-tight">Контакты команды</h2>
         <p className="mt-3 text-sm text-muted-foreground">
           Для связи с командой разработки:{" "}
           <a href="mailto:[email protected]" className="text-primary transition-opacity hover:opacity-80">

app/docs/[...slug]/page.tsx

@@ -3,6 +3,7 @@ import Link from "next/link";
 import { PenSquare } from "lucide-react";
 import { notFound } from "next/navigation";
 
+import { getBuildInfo } from "@/lib/build-info";
 import { MobileDocsMenu } from "@/components/layout/MobileDocsMenu";
 import { Sidebar } from "@/components/layout/Sidebar";
 import { Toc } from "@/components/layout/Toc";
@@ -47,18 +48,19 @@ export default async function DocPage({ params }: DocPageProps) {
     notFound();
   }
 
+  const buildInfo = getBuildInfo();
   const sidebarGroups = getSidebarGroups();
   const toc = extractTableOfContents(doc.body);
   const pagination = getDocPagination(params.slug);
   const content = await compileDocMdx(doc.body);
-  const editUrl = `${GITHUB_EDIT_ROOT}/${doc.sourcePath}`;
+  const editUrl = doc.editPath ? `${GITHUB_EDIT_ROOT}/${doc.editPath}` : null;
 
   return (
     <>
-      <MobileDocsMenu groups={sidebarGroups} currentPath={doc.href} />
+      <MobileDocsMenu buildInfo={buildInfo} groups={sidebarGroups} currentPath={doc.href} />
 
       <div className="mx-auto grid w-full max-w-[1440px] gap-8 px-4 py-8 sm:px-6 lg:grid-cols-[260px_minmax(0,1fr)] lg:px-8 xl:grid-cols-[280px_minmax(0,1fr)_220px]">
-        <Sidebar groups={sidebarGroups} currentPath={doc.href} />
+        <Sidebar buildInfo={buildInfo} groups={sidebarGroups} currentPath={doc.href} />
 
         <article className="min-w-0 pb-16">
           <Breadcrumbs slug={params.slug} currentTitle={doc.title} />
@@ -69,15 +71,21 @@ export default async function DocPage({ params }: DocPageProps) {
             <div className="mt-5">
               <GitHubUserBadge person={doc.author} description="Автор публикации" />
             </div>
-            <Link
-              href={editUrl}
-              target="_blank"
-              rel="noreferrer"
-              className="mt-5 inline-flex items-center gap-2 text-sm text-primary transition-opacity hover:opacity-80"
-            >
-              <PenSquare className="size-4" />
-              Edit on GitHub
-            </Link>
+            {editUrl ? (
+              <Link
+                href={editUrl}
+                target="_blank"
+                rel="noreferrer"
+                className="mt-5 inline-flex items-center gap-2 text-sm text-primary transition-opacity hover:opacity-80"
+              >
+                <PenSquare className="size-4" />
+                Редактировать источник
+              </Link>
+            ) : (
+              <p className="mt-5 text-sm text-muted-foreground">
+                Эта страница собрана автоматически, поэтому редактирование доступно через исходные материалы раздела.
+              </p>
+            )}
           </header>
 
           <div className="docs-prose">{content}</div>

app/docs/page.tsx

@@ -2,20 +2,22 @@ import Link from "next/link";
 import { ArrowRight } from "lucide-react";
 
 import { MobileDocsMenu } from "@/components/layout/MobileDocsMenu";
+import { getBuildInfo } from "@/lib/build-info";
 import { getSidebarGroups } from "@/lib/navigation";
 
 export const dynamic = "force-static";
 
 export default function DocsIndexPage() {
+  const buildInfo = getBuildInfo();
   const groups = getSidebarGroups();
 
   return (
     <>
-      <MobileDocsMenu groups={groups} currentPath="/docs" />
+      <MobileDocsMenu buildInfo={buildInfo} groups={groups} currentPath="/docs" />
 
       <div className="mx-auto w-full max-w-[1440px] px-4 py-12 sm:px-6 lg:px-8">
         <header className="mb-10">
-          <h1 className="text-balance text-3xl font-semibold tracking-tight sm:text-4xl">StackMIREA Doc - Актуальные треки</h1>
+          <h1 className="text-balance text-3xl font-semibold tracking-tight sm:text-4xl">StackMIREA Docs - актуальные треки</h1>
           <p className="mt-3 max-w-2xl text-base text-muted-foreground">
             Структурированные треки по основным ИТ-дисциплинам с масштабируемой архитектурой статической документации.
           </p>

app/layout.tsx

@@ -8,7 +8,7 @@ import { BASE_PATH, SITE_DESCRIPTION, SITE_NAME, SITE_ORIGIN } from "@/lib/utils
 
 import "./globals.css";
 
-const socialImage = `${SITE_ORIGIN}${BASE_PATH}/social-card.svg`;
+const socialImage = `${SITE_ORIGIN}${BASE_PATH}/preview.png`;
 
 export const metadata: Metadata = {
   metadataBase: new URL(`${SITE_ORIGIN}${BASE_PATH}/`),
@@ -48,7 +48,7 @@ export default function RootLayout({ children }: { children: ReactNode }) {
   return (
     <html lang="ru" suppressHydrationWarning>
       <body className="site-background font-sans antialiased">
-        <ThemeProvider attribute="class" forcedTheme="light" disableTransitionOnChange>
+        <ThemeProvider attribute="class" defaultTheme="system" enableSystem disableTransitionOnChange>
           <div className="flex min-h-screen flex-col">
             <Header />
             <main className="flex-1">{children}</main>

app/page.tsx

@@ -3,126 +3,25 @@ import { ArrowRight, Bot, Brain, BrainCircuit, Code2, Database, ExternalLink, Gi
 
 import { buttonVariants } from "@/components/ui/button";
 import { cn } from "@/lib/utils";
+import { getTrackDefinitions, type TrackIconKey } from "@/lib/tracks";
 
 export const dynamic = "force-static";
 
-const tracks = [
-  // Keep cards in the same order as sidebar section ordering for predictable navigation.
-  {
-    title: "Python",
-    subtitle: "Практики по OOP, тестированию и функциональному стилю",
-    href: "/docs/python",
-    icon: Code2
-  },
-  {
-    title: "AI",
-    subtitle: "Ноутбуки Notebook1..Notebook8 по курсу ИИ",
-    href: "/docs/ai",
-    icon: Bot
-  },
-  {
-    title: "BigData",
-    subtitle: "Практики по анализу данных, классификации и кластеризации",
-    href: "/docs/bigdata",
-    icon: Database
-  },
-  {
-    title: "Java",
-    subtitle: "24 практики по ООП, коллекциям, MVC и паттернам",
-    href: "/docs/java",
-    icon: Brain
-  },
-  {
-    title: "Algorithms",
-    subtitle: "Методические материалы и структурированные разборы",
-    href: "/docs/algorithms",
-    icon: Sigma
-  },
-  {
-    title: "Процедурное программирование",
-    subtitle: "Базовые конструкции, декомпозиция и процедурный стиль",
-    href: "/docs/procedural-programming",
-    icon: Code2
-  },
-  {
-    title: "Объектно ориентированное программирование",
-    subtitle: "Классы, инкапсуляция, наследование и полиморфизм",
-    href: "/docs/object-oriented-programming",
-    icon: Brain
-  },
-  {
-    title: "Структуры и алгоритмы обработки данных (часть 1)",
-    subtitle: "Введение в структуры данных и базовые алгоритмы",
-    href: "/docs/data-structures-and-algorithms-part-1",
-    icon: Sigma
-  },
-  {
-    title: "React",
-    subtitle: "Компонентная разработка и построение интерфейсов",
-    href: "/docs/react",
-    icon: Bot
-  },
-  {
-    title: "Структуры и алгоритмы обработки данных (часть 2)",
-    subtitle: "Продвинутые алгоритмы и анализ производительности",
-    href: "/docs/data-structures-and-algorithms-part-2",
-    icon: Sigma
-  },
-  {
-    title: "Конфигурационное управление",
-    subtitle: "Версионирование, окружения и управление изменениями",
-    href: "/docs/configuration-management",
-    icon: GitPullRequest
-  },
-  {
-    title: "Анализ и концептуальное моделирование систем (часть 1)",
-    subtitle: "Системный анализ, требования и концептуальные модели",
-    href: "/docs/systems-analysis-and-conceptual-modeling-part-1",
-    icon: Database
-  },
-  {
-    title: "Технология разработки программных приложений (часть 1)",
-    subtitle: "Процессы, паттерны и практики разработки приложений",
-    href: "/docs/software-application-development-part-1",
-    icon: Code2
-  },
-  {
-    title: "Интернет вещей",
-    subtitle: "IoT-архитектуры, обмен данными и интеграции устройств",
-    href: "/docs/internet-of-things",
-    icon: Bot
-  },
-  {
-    title: "Моделирование бизнес процессов",
-    subtitle: "Модели процессов, роли, события и оптимизация",
-    href: "/docs/business-process-modeling",
-    icon: Database
-  },
-  {
-    title: "Разработка баз данных",
-    subtitle: "Проектирование схем, SQL и практика работы с БД",
-    href: "/docs/database-development",
-    icon: Database
-  },
-  {
-    title: "Тестирование и верификация ПО",
-    subtitle: "Unit/Integration тестирование и контроль качества",
-    href: "/docs/software-testing-and-verification",
-    icon: ListChecks
-  },
-  {
-    title: "Системное администрирование",
-    subtitle: "Серверы, сервисы, сети и эксплуатация инфраструктуры",
-    href: "/docs/system-administration",
-    icon: Brain
-  },
-  {
-    title: "Управление проектами",
-    subtitle: "Планирование, сроки, риски и командные процессы",
-    href: "/docs/project-management",
-    icon: GitPullRequest
-  }
-];
+const iconByKey: Record<TrackIconKey, typeof Bot> = {
+  bot: Bot,
+  brain: Brain,
+  code2: Code2,
+  database: Database,
+  gitPullRequest: GitPullRequest,
+  listChecks: ListChecks,
+  sigma: Sigma
+};
+
+const tracks = getTrackDefinitions().map((track) => ({
+  ...track,
+  href: `/docs/${track.id}`,
+  icon: iconByKey[track.iconKey]
+}));
 
 const publicationRules = [
   {
@@ -255,8 +154,8 @@ export default function HomePage() {
               <div className="mb-4 inline-flex rounded-lg border border-border/70 bg-background/70 p-2 text-muted-foreground transition-colors group-hover:text-primary">
                 <Icon className="size-5" />
               </div>
-              <h2 className="text-base font-semibold leading-snug tracking-tight break-words">{track.title}</h2>
-              <p className="mt-2 break-words text-sm leading-6 text-muted-foreground">{track.subtitle}</p>
+              <h2 className="break-words text-base font-semibold leading-snug tracking-tight">{track.title}</h2>
+              <p className="mt-2 break-words text-sm leading-6 text-muted-foreground">{track.homeSubtitle}</p>
               <span className="mt-auto pt-5 inline-flex items-center gap-1.5 text-sm text-primary">
                 Перейти
                 <ArrowRight className="size-3.5" />