update docs

Author: wu-clan

docs/.vuepress/components/BannerTop.vue

@@ -2,10 +2,12 @@
   <div class="banner">
     <p class="vp-banner-text">
       <span class="vp-text-primary">FBA </span>
-      <span class="vp-tagline">· FasAPI</span>
-      <span class="vp-place"> 最佳架构</span>
-      <span class="vp-date"> · 插件系统已发布</span>
-      <a class="vp-primary-action" href="/fastapi_best_architecture_docs/plugin/before.html"> 甩起来 </a>
+      <span class="vp-tagline">企业级</span>
+      <span class="vp-place"> 后端架构解决方案</span>
+      <span class="vp-date"> · 架构源码全量开源</span>
+      <a class="vp-primary-action"
+         href="/fastapi_best_architecture_docs/backend/summary/quick-start.html"
+      >体验反馈</a>
     </p>
     <button @click="dismiss">
       <Icon name="mingcute:close-fill" />

docs/.vuepress/components/Planet.vue

@@ -6,7 +6,7 @@
 
     <div class="qr-section">
       <button class="qr-toggle" @click="toggleQrOpen">
-        <span class="qr-toggle-icon" :class="{ 'open': qrOpen }"></span>
+        <span :class="{ 'open': qrOpen }" class="qr-toggle-icon"></span>
         扫码订阅
         <span v-if="qrOpen">收起</span>
         <span v-else>展开</span>
@@ -15,7 +15,7 @@
         <p>
           加入 <a href="https://discord.gg/Sdg6dT5kjz" target="_blank">Discord</a> 社区，可领取免费体验资格
         </p>
-        <img src="https://wu-clan.github.io/picx-images-hosting/知识星球.png" alt="知识星球" class="qr-image" />
+        <img alt="知识星球" class="qr-image" src="https://wu-clan.github.io/picx-images-hosting/知识星球.png" />
       </div>
     </div>
 
@@ -27,8 +27,8 @@
       <button
           v-for="tab in tabs"
           :key="tab.id"
-          @click="activeTab = tab.id"
           :class="{ active: activeTab === tab.id }"
+          @click="activeTab = tab.id"
       >
         {{ tab.label }}
       </button>
@@ -49,17 +49,17 @@
         <LinkCard
             v-for="card in tabs.find((tab) => tab.id === activeTab)!.cards"
             :key="card.href"
-            :title="card.title"
-            :icon="card.icon"
-            :href="card.href"
             :description="card.description"
+            :href="card.href"
+            :icon="card.icon"
+            :title="card.title"
         />
       </CardGrid>
     </div>
   </div>
 </template>
 
-<script setup lang="ts">
+<script lang="ts" setup>
 import { ref } from 'vue';
 import { Card, fastapiCards, fbaCards, pluginCards } from "../data/planet";
 

docs/.vuepress/components/PluginMarket.vue

@@ -3,28 +3,28 @@
   <div class="search-container">
     <input
         v-model="searchQuery"
-        type="text"
-        placeholder="🔍 搜索插件..."
         class="search-input"
+        placeholder="🔍 搜索插件..."
+        type="text"
     />
   </div>
   <div class="plugin-card-container">
     <div
         v-for="(item, index) in filteredItems"
         :key="index"
-        class="plugin-card"
         :class="{ 'clickable': item.link }"
+        class="plugin-card"
         @click="handleCardClick(item)"
     >
       <div class="card-image">
         <img
             v-if="item.image"
-            :src="item.image"
             :alt="item.title"
+            :src="item.image"
             class="image-content"
         />
         <div v-else class="image-placeholder">
-          <Icon :name="item.icon" size="5em" color="var(--vp-c-text-1)" />
+          <Icon :name="item.icon" color="var(--vp-c-text-1)" size="5em" />
         </div>
         <div
             v-if="item.free?.valueOf() === false"
@@ -40,8 +40,8 @@
           <div class="card-title-link">
             <a
                 :href="item.link"
-                target="_blank"
                 rel="noopener noreferrer"
+                target="_blank"
                 @click.stop
             />
             <span class="label-inline">{{ item.label || '内置' }}</span>
@@ -52,17 +52,17 @@
           <Badge
               v-for="(tag, tagIndex) in item.tags"
               :key="tagIndex"
-              :text="tag"
               :style="colors[tag]"
+              :text="tag"
           />
         </div>
       </div>
     </div>
   </div>
 </template>
 
-<script setup lang="ts">
-import { ref, computed } from 'vue'
+<script lang="ts" setup>
+import { computed, ref } from 'vue'
 
 export interface PluginItem {
   icon: string

docs/.vuepress/components/SponsorHome.vue

@@ -1,5 +1,5 @@
 <template>
-  <section v-if="shouldShowSponsor(homeSponsor)" id="special-spsr">
+  <section v-if="shouldShowSponsor(homeSponsor.expiryTime)" id="special-spsr">
     <span>特别赞助商</span>
     <a :href="homeSponsor.href" target="_blank">
       <img :alt="homeSponsor.alt" :src="homeSponsor.link" width="208" />

docs/.vuepress/components/SponsorPanel.vue

@@ -10,7 +10,7 @@
     <div class="gold-sponsors">
       <div
           v-for="(brand, index) in processedGoldSponsors"
-          v-show="!isCollapsed || (isCollapsed && shouldShowSponsor(brand))"
+          v-show="!isCollapsed || (isCollapsed && shouldShowSponsor(brand.expiryTime))"
           :key="'gold-' + index"
           :class="{ 'collapsed-mode': isCollapsed }"
           class="brand-item gold"
@@ -28,7 +28,7 @@
     <div class="general-sponsors">
       <div
           v-for="(brand, index) in processedGeneralSponsors"
-          v-show="!isCollapsed || (isCollapsed && shouldShowSponsor(brand))"
+          v-show="!isCollapsed || (isCollapsed && shouldShowSponsor(brand.expiryTime))"
           :key="'general-' + index"
           :class="{ 'collapsed-mode': isCollapsed }"
           class="brand-item"
@@ -69,19 +69,19 @@ const isCollapsed = useStorage('fba-docs-sponsor-collapsed', false);
 
 const processedGoldSponsors = computed(() => {
   return goldSponsors.map(brand => {
-    return shouldShowSponsor(brand) ? brand : defaultSponsor;
+    return shouldShowSponsor(brand.expiryTime) ? brand : defaultSponsor;
   });
 });
 
 const processedGeneralSponsors = computed(() => {
   return generalSponsors.map(brand => {
-    return shouldShowSponsor(brand) ? brand : defaultSponsor;
+    return shouldShowSponsor(brand.expiryTime) ? brand : defaultSponsor;
   });
 });
 
 const shouldShowExtraBecomeSponsor = computed(() => {
-  return (goldSponsors.filter(brand => brand.link && shouldShowSponsor(brand)).length +
-      generalSponsors.filter(brand => brand.link && shouldShowSponsor(brand)).length) < 9;
+  return (goldSponsors.filter(brand => brand.link && shouldShowSponsor(brand.expiryTime)).length +
+      generalSponsors.filter(brand => brand.link && shouldShowSponsor(brand.expiryTime)).length) < 9;
 });
 
 const toggleCollapse = () => {

docs/.vuepress/components/SponsorSidebar.vue

@@ -9,7 +9,7 @@
           @click="openSponsorLink(homeSponsor.href)"
       >
         <img
-            v-if="shouldShowSponsor(homeSponsor)"
+            v-if="shouldShowSponsor(homeSponsor.expiryTime)"
             :alt="homeSponsor.alt"
             :src="homeSponsor.link"
             class="brand-image"

docs/.vuepress/components/Swiper.vue

@@ -25,22 +25,10 @@ import "swiper/css/effect-flip";
 import "swiper/css/effect-coverflow";
 import "swiper/css/effect-cards";
 import "swiper/css/effect-creative";
-import { defaultSponsor, shouldShowSponsor } from "../data/sponsors";
-
-interface SlideItem {
-  /**
-   * 图片地址
-   */
-  link?: string;
-  /**
-   * 跳转链接
-   */
-  href?: string;
-  alt?: string;
-}
+import { defaultSponsor, shouldShowSponsor, Sponsor } from "../data/sponsors";
 
 interface Props {
-  items?: SlideItem[];
+  items?: Sponsor[];
   width?: number | string; // 轮播区域宽度，单位 px
   height?: number | string; // 轮播区域高度，单位 px
   mode?: "banner" | "carousel" | "broadcast"; // banner: 轮播图模式; carousel: 走马灯模式; broadcast: 信息展播模式
@@ -68,19 +56,10 @@ const props = withDefaults(defineProps<Props>(), {
 
 const sponsors = computed(() => {
   return props.items.map(brand => {
-    return shouldShowSponsor(brand) ? brand : defaultSponsor;
+    return shouldShowSponsor(brand.expiryTime) ? brand : defaultSponsor;
   });
 });
 
-const slideList = computed<SlideItem[]>(() => {
-  return (
-      sponsors.value?.map((link) => {
-        if (typeof link === "string") return { link };
-        return link;
-      }) ?? []
-  );
-});
-
 function parseSize(size: number | string) {
   if (typeof size === "number") {
     return `${ size }px`;
@@ -182,7 +161,7 @@ onMounted(() => {
         v-bind="$attrs"
         @swiper="onSwiper"
     >
-      <SwiperSlide v-for="(item, index) in slideList" :key="'general-' + index">
+      <SwiperSlide v-for="(item, index) in sponsors" :key="'general-' + index">
         <a
             v-if="item.href && item.link"
             :href="item.href"

docs/.vuepress/data/sponsors.ts

@@ -1,8 +1,8 @@
 export const sponsorUrl: string = typeof window !== 'undefined' ? window.location.origin + '/fastapi_best_architecture_docs/sponsors.html' : 'https://fastapi-practices.github.io/fastapi_best_architecture_docs/sponsors.html';
 
-interface Sponsor {
+export interface Sponsor {
+    link: string;
     href?: string;
-    link?: string;
     alt?: string;
     expiryTime: string; // ISO 格式日期：2099-12-31T23:59:59
 }
@@ -11,58 +11,40 @@ export const defaultSponsor: Sponsor = {
     link: '',
     href: sponsorUrl,
     alt: '成为赞助商',
-    expiryTime: '2099-12-31T23:59:59',
+    expiryTime: '',
 };
 
 export const homeSponsor: Sponsor = { ...defaultSponsor };
 
 
 export const goldSponsors: Sponsor[] = [
-    {
-        link: 'https://dscache.tencent-cloud.cn/upload//rhino-design-800x450-fea2ea55b7b63624628bf9bb22454cb8f91b7d69.png',
-        href: 'https://curl.qcloud.com/f9VMAii8',
-        alt: '2核2G云服务器低至 68元/年',
-        expiryTime: '2025-12-31T23:59:59',
-    },
     {
         link: 'https://img14.360buyimg.com/ddimg/jfs/t1/284966/5/22913/37242/68023351Faddd8304/6337ad52ea02ad10.jpg',
         href: 'https://share.302.ai/LJojhb',
         alt: '302.AI',
         expiryTime: '2025-06-18T16:35:00',
-    },
-    { ...defaultSponsor }
+    }
 ]
 
 export const generalSponsors: Sponsor[] = [
     {
-        link: 'https://user.by.ltd/templates/lagom2/assets/img/logo/logo_big_inverse.1753622506.png',
+        link: 'https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQQImbvY5S8IbJ1iL6yHfExtHiAhUtLIoi7AQ&s',
         href: 'https://user.by.ltd/aff.php?aff=12215',
         alt: 'Bywave',
         expiryTime: '2099-12-31T23:59:59',
     },
-    { ...defaultSponsor },
-    { ...defaultSponsor },
-    { ...defaultSponsor },
-    { ...defaultSponsor },
     { ...defaultSponsor }
 ]
 
 export const openSponsorLink = (href: string) => {
     window.open(href);
 };
 
-export function shouldShowSponsor(sponsor: {
-    href?: string;
-    link?: string;
-    expiryTime?: string;
-}): boolean {
-    if (!sponsor.link) return false;
-
-    if (sponsor.expiryTime) {
+export function shouldShowSponsor(expiryTime?: string): boolean {
+    if (expiryTime) {
         const now = new Date();
-        const expiryDate = new Date(sponsor.expiryTime);
+        const expiryDate = new Date(expiryTime);
         return now < expiryDate;
     }
-
-    return true;
+    return false;
 }