docs: 更新优惠券相关文档- 新增优惠券API集成文档

- 新增优惠券卡片对齐修复文档
- 新增优惠券状态显示调试文档
- 新增优惠券组件警告修复文档- 更新用ShopInfo Hook字段迁移文档
- 更新Arguments关键字修复文档

src/pages/index/Header.tsx

@@ -2,21 +2,23 @@ import {useEffect, useState} from "react";
 import Taro from '@tarojs/taro';
 import {Button, Space} from '@nutui/nutui-react-taro'
 import {TriangleDown} from '@nutui/icons-react-taro'
-import {Popup, Avatar, NavBar} from '@nutui/nutui-react-taro'
-import {getShopInfo, getUserInfo, getWxOpenId} from "@/api/layout";
+import {Avatar, NavBar} from '@nutui/nutui-react-taro'
+import {getUserInfo, getWxOpenId} from "@/api/layout";
 import {TenantId} from "@/config/app";
 import {getOrganization} from "@/api/system/organization";
 import {myUserVerify} from "@/api/system/userVerify";
-import {CmsWebsite} from "@/api/cms/cmsWebsite/model";
-import {User} from "@/api/system/user/model";
+import { useShopInfo } from '@/hooks/useShopInfo';
 import MySearch from "./MySearch";
 import './Header.scss';
 
 const Header = (props: any) => {
-  const [userInfo, setUserInfo] = useState<User>()
+  // 使用新的useShopInfo Hook
+  const {
+    getWebsiteName,
+    getWebsiteLogo
+  } = useShopInfo();
+
   const [IsLogin, setIsLogin] = useState<boolean>(true)
-  const [config, setConfig] = useState<CmsWebsite>()
-  const [showBasic, setShowBasic] = useState(false)
   const [statusBarHeight, setStatusBarHeight] = useState<number>()
 
   const reload = async () => {
@@ -25,16 +27,11 @@ const Header = (props: any) => {
         setStatusBarHeight(res.statusBarHeight)
       },
     })
-    // 获取站点信息
-    getShopInfo().then((data) => {
-      setConfig(data);
-      console.log(userInfo)
-    })
+    // 注意：商店信息现在通过useShopInfo自动管理，不需要手动获取
     // 获取用户信息
     getUserInfo().then((data) => {
       if (data) {
         setIsLogin(true);
-        setUserInfo(data)
         console.log('用户信息>>>', data.phone)
         // 保存userId
         Taro.setStorageSync('UserId', data.userId)
@@ -87,7 +84,7 @@ const Header = (props: any) => {
   }
 
   /* 获取用户手机号 */
-  const handleGetPhoneNumber = ({detail}) => {
+  const handleGetPhoneNumber = ({detail}: {detail: {code?: string, encryptedData?: string, iv?: string}}) => {
     const {code, encryptedData, iv} = detail
     Taro.login({
       success: function () {
@@ -157,9 +154,9 @@ const Header = (props: any) => {
                 <Space>
                   <Avatar
                     size="22"
-                    src={config?.websiteLogo}
+                    src={getWebsiteLogo()}
                   />
-                  <span style={{color: '#000'}}>{config?.websiteName}</span>
+                  <span style={{color: '#000'}}>{getWebsiteName()}</span>
                 </Space>
               </Button>
               <TriangleDown size={9}/>
@@ -168,23 +165,13 @@ const Header = (props: any) => {
             <div style={{display: 'flex', alignItems: 'center', gap: '8px'}}>
               <Avatar
                 size="22"
-                src={config?.websiteLogo}
+                src={getWebsiteLogo()}
               />
-              <span className={'text-white'}>{config?.websiteName}</span>
+              <span className={'text-white'}>{getWebsiteName()}</span>
               <TriangleDown className={'text-white'} size={9}/>
             </div>
           )}>
       </NavBar>
-      <Popup
-        visible={showBasic}
-        position="bottom"
-        style={{width: '100%', height: '100%'}}
-        onClose={() => {
-          setShowBasic(false)
-        }}
-      >
-        <div style={{padding: '12px 0', fontWeight: 'bold', textAlign: 'center'}}>车辆信息</div>
-      </Popup>
     </>
   )
 }

src/pages/index/HeaderWithHook.tsx

@@ -0,0 +1,205 @@
+import {useEffect, useState} from "react";
+import Taro from '@tarojs/taro';
+import {Button, Space} from '@nutui/nutui-react-taro'
+import {TriangleDown} from '@nutui/icons-react-taro'
+import {Popup, Avatar, NavBar} from '@nutui/nutui-react-taro'
+import {getUserInfo, getWxOpenId} from "@/api/layout";
+import {TenantId} from "@/config/app";
+import {getOrganization} from "@/api/system/organization";
+import {myUserVerify} from "@/api/system/userVerify";
+import {User} from "@/api/system/user/model";
+import { useShopInfo } from '@/hooks/useShopInfo';
+import { useUser } from '@/hooks/useUser';
+import MySearch from "./MySearch";
+import './Header.scss';
+
+const Header = (props: any) => {
+  // 使用新的hooks
+  const { 
+    shopInfo, 
+    loading: shopLoading, 
+    getWebsiteName, 
+    getWebsiteLogo 
+  } = useShopInfo();
+  
+  const { 
+    user, 
+    isLoggedIn, 
+    loading: userLoading 
+  } = useUser();
+
+  const [showBasic, setShowBasic] = useState(false)
+  const [statusBarHeight, setStatusBarHeight] = useState<number>()
+
+  const reload = async () => {
+    Taro.getSystemInfo({
+      success: (res) => {
+        setStatusBarHeight(res.statusBarHeight)
+      },
+    })
+    
+    // 注意：商店信息现在通过useShopInfo自动管理，不需要手动获取
+    // 用户信息现在通过useUser自动管理，不需要手动获取
+    
+    // 如果需要获取openId，可以在用户登录后处理
+    if (user && !user.openid) {
+      Taro.login({
+        success: (res) => {
+          getWxOpenId({code: res.code}).then(() => {
+            console.log('OpenId获取成功');
+          })
+        }
+      })
+    }
+
+    // 检查用户认证状态
+    if (user?.userId) {
+      // 获取组织信息
+      getOrganization({userId: user.userId}).then((data) => {
+        console.log('组织信息>>>', data)
+      }).catch(() => {
+        console.log('获取组织信息失败')
+      });
+
+      // 检查用户认证
+      myUserVerify({userId: user.userId}).then((data) => {
+        console.log('认证信息>>>', data)
+      }).catch(() => {
+        console.log('获取认证信息失败')
+      });
+    }
+  }
+
+  // 获取手机号授权
+  const handleGetPhoneNumber = ({detail}: {detail: {code?: string, encryptedData?: string, iv?: string}}) => {
+    const {code, encryptedData, iv} = detail
+    Taro.login({
+      success: function () {
+        if (code) {
+          Taro.request({
+            url: 'https://server.websoft.top/api/wx-login/loginByMpWxPhone',
+            method: 'POST',
+            data: {
+              code,
+              encryptedData,
+              iv,
+              notVerifyPhone: true,
+              refereeId: 0,
+              sceneType: 'save_referee',
+              tenantId: TenantId
+            },
+            success: function (res) {
+              if (res.data.code == 1) {
+                Taro.showToast({
+                  title: res.data.message,
+                  icon: 'error',
+                  duration: 2000
+                })
+                return false;
+              }
+              // 登录成功
+              Taro.setStorageSync('access_token', res.data.data.access_token)
+              Taro.setStorageSync('UserId', res.data.data.user.userId)
+              
+              // 重新加载小程序
+              Taro.reLaunch({
+                url: '/pages/index/index'
+              })
+            }
+          })
+        } else {
+          console.log('登录失败！')
+        }
+      }
+    })
+  }
+
+  useEffect(() => {
+    reload().then()
+  }, [])
+
+  // 显示加载状态
+  if (shopLoading || userLoading) {
+    return (
+      <div className={'fixed top-0 header-bg'} style={{
+        height: !props.stickyStatus ? '180px' : '148px',
+      }}>
+        <div style={{padding: '20px', textAlign: 'center', color: '#fff'}}>
+          加载中...
+        </div>
+      </div>
+    );
+  }
+
+  return (
+    <>
+      <div className={'fixed top-0 header-bg'} style={{
+        height: !props.stickyStatus ? '180px' : '148px',
+      }}>
+        <MySearch/>
+      </div>
+      <NavBar
+        style={{marginTop: `${statusBarHeight}px`, marginBottom: '0px', backgroundColor: 'transparent'}}
+        onBackClick={() => {
+        }}
+        left={
+          !isLoggedIn ? (
+            <div style={{display: 'flex', alignItems: 'center'}}>
+              <Button style={{color: '#000'}} open-type="getPhoneNumber" onGetPhoneNumber={handleGetPhoneNumber}>
+                <Space>
+                  <Avatar
+                    size="22"
+                    src={getWebsiteLogo()}
+                  />
+                  <span style={{color: '#000'}}>{getWebsiteName()}</span>
+                </Space>
+              </Button>
+              <TriangleDown size={9}/>
+            </div>
+          ) : (
+            <div style={{display: 'flex', alignItems: 'center', gap: '8px'}}>
+              <Avatar
+                size="22"
+                src={getWebsiteLogo()}
+              />
+              <span className={'text-white'}>{getWebsiteName()}</span>
+              <TriangleDown className={'text-white'} size={9}/>
+            </div>
+          )}>
+      </NavBar>
+      <Popup
+        visible={showBasic}
+        position="bottom"
+        style={{width: '100%', height: '100%'}}
+        onClose={() => {
+          setShowBasic(false)
+        }}
+      >
+        <div style={{padding: '20px'}}>
+          <h3>商店信息</h3>
+          <div>网站名称: {getWebsiteName()}</div>
+          <div>Logo: <img src={getWebsiteLogo()} alt="logo" style={{width: '50px', height: '50px'}} /></div>
+          
+          <h3>用户信息</h3>
+          <div>登录状态: {isLoggedIn ? '已登录' : '未登录'}</div>
+          {user && (
+            <>
+              <div>用户ID: {user.userId}</div>
+              <div>手机号: {user.phone}</div>
+              <div>昵称: {user.nickname}</div>
+            </>
+          )}
+          
+          <button 
+            onClick={() => setShowBasic(false)}
+            style={{marginTop: '20px', padding: '10px 20px'}}
+          >
+            关闭
+          </button>
+        </div>
+      </Popup>
+    </>
+  )
+}
+
+export default Header;

src/pages/index/IndexWithHook.tsx

@@ -0,0 +1,189 @@
+import Header from './Header';
+import BestSellers from './BestSellers';
+import Taro from '@tarojs/taro';
+import {useShareAppMessage, useShareTimeline} from "@tarojs/taro"
+import {useEffect, useState} from "react";
+import {Sticky} from '@nutui/nutui-react-taro'
+import { useShopInfo } from '@/hooks/useShopInfo';
+import { useUser } from '@/hooks/useUser';
+import Menu from "./Menu";
+import Banner from "./Banner";
+import './index.scss'
+
+const Home = () => {
+  const [stickyStatus, setStickyStatus] = useState(false);
+
+  // 使用新的hooks
+  const {
+    shopInfo,
+    loading: shopLoading,
+    error: shopError,
+    getWebsiteName,
+    getWebsiteLogo,
+    refreshShopInfo
+  } = useShopInfo();
+
+  const {
+    user,
+    isLoggedIn,
+    loading: userLoading
+  } = useUser();
+
+  const onSticky = (args: any) => {
+    setStickyStatus(args[0].isFixed);
+  };
+
+  const showAuthModal = () => {
+    Taro.showModal({
+      title: '授权提示',
+      content: '需要获取您的用户信息',
+      confirmText: '去授权',
+      cancelText: '取消',
+      success: (res) => {
+        if (res.confirm) {
+          // 用户点击确认，打开授权设置页面
+          Taro.openSetting({
+            success: (settingRes) => {
+              if (settingRes.authSetting['scope.userInfo']) {
+                console.log('用户已授权');
+              } else {
+                console.log('用户拒绝授权');
+              }
+            }
+          });
+        }
+      }
+    });
+  };
+
+  // 分享给好友
+  useShareAppMessage(() => {
+    return {
+      title: `${getWebsiteName()} - 精选商城`,
+      path: '/pages/index/index',
+      imageUrl: getWebsiteLogo(),
+      success: function (res: any) {
+        console.log('分享成功', res);
+        Taro.showToast({
+          title: '分享成功',
+          icon: 'success',
+          duration: 2000
+        });
+      },
+      fail: function (res: any) {
+        console.log('分享失败', res);
+        Taro.showToast({
+          title: '分享失败',
+          icon: 'none',
+          duration: 2000
+        });
+      }
+    };
+  });
+
+  // 分享到朋友圈
+  useShareTimeline(() => {
+    return {
+      title: `${getWebsiteName()} - 精选商城`,
+      imageUrl: getWebsiteLogo(),
+      success: function (res: any) {
+        console.log('分享到朋友圈成功', res);
+      },
+      fail: function (res: any) {
+        console.log('分享到朋友圈失败', res);
+      }
+    };
+  });
+
+  useEffect(() => {
+    // 设置页面标题
+    if (shopInfo?.appName) {
+      Taro.setNavigationBarTitle({
+        title: shopInfo.appName
+      });
+    }
+  }, [shopInfo]);
+
+  useEffect(() => {
+    // 检查用户授权状态
+    Taro.getSetting({
+      success: (res) => {
+        if (res.authSetting['scope.userInfo']) {
+          console.log('用户已经授权过，可以直接获取用户信息');
+        } else {
+          console.log('用户未授权，需要弹出授权窗口');
+          showAuthModal();
+        }
+      }
+    });
+
+    // 获取用户基本信息（头像、昵称等）
+    Taro.getUserInfo({
+      success: (res) => {
+        const avatar = res.userInfo.avatarUrl;
+        console.log('用户头像:', avatar);
+      },
+      fail: (err) => {
+        console.log('获取用户信息失败:', err);
+      }
+    });
+  }, []);
+
+  // 处理错误状态
+  if (shopError) {
+    return (
+      <div style={{padding: '20px', textAlign: 'center'}}>
+        <div>加载商店信息失败: {shopError}</div>
+        <button
+          onClick={refreshShopInfo}
+          style={{marginTop: '10px', padding: '10px 20px'}}
+        >
+          重试
+        </button>
+      </div>
+    );
+  }
+
+  // 显示加载状态
+  if (shopLoading) {
+    return (
+      <div style={{padding: '20px', textAlign: 'center'}}>
+        <div>加载中...</div>
+      </div>
+    );
+  }
+
+  return (
+    <>
+      <Sticky threshold={0} onChange={(args) => onSticky(args)}>
+        <Header stickyStatus={stickyStatus}/>
+      </Sticky>
+      <div className={'flex flex-col mt-12'}>
+        <Menu/>
+        <Banner/>
+        <BestSellers/>
+
+        {/* 调试信息面板 - 仅在开发环境显示 */}
+        {process.env.NODE_ENV === 'development' && (
+          <div style={{
+            position: 'fixed',
+            bottom: '10px',
+            right: '10px',
+            background: 'rgba(0,0,0,0.8)',
+            color: 'white',
+            padding: '10px',
+            borderRadius: '5px',
+            fontSize: '12px',
+            maxWidth: '200px'
+          }}>
+            <div>商店: {getWebsiteName()}</div>
+            <div>用户: {isLoggedIn ? (user?.nickname || '已登录') : '未登录'}</div>
+            <div>加载: {userLoading ? '用户加载中' : '已完成'}</div>
+          </div>
+        )}
+      </div>
+    </>
+  )
+}
+
+export default Home;

src/pages/index/index.tsx

@@ -26,11 +26,11 @@ function Home() {
     return {
       title: '网宿小店 - 网宿软件',
       path: `/pages/index/index`,
-      success: function (res) {
-        console.log('分享成功', res);
+      success: function () {
+        console.log('分享成功');
       },
-      fail: function (res) {
-        console.log('分享失败', res);
+      fail: function () {
+        console.log('分享失败');
       }
     };
   });
@@ -72,7 +72,7 @@ function Home() {
     });
   };
 
-  const onSticky = (item) => {
+  const onSticky = (item: IArguments) => {
     if(item){
       setStickyStatus(!stickyStatus)
     }