APP 登录门店对接

杨鑫
1 parent 0d4ee10b
Showing 17 changed files with 703 additions and 84 deletions
美国版/Food Labeling Management App UniApp/src/components/LocationPicker.vue
美国版/Food Labeling Management App UniApp/src/components/SideMenu.vue
美国版/Food Labeling Management App UniApp/src/env.d.ts
美国版/Food Labeling Management App UniApp/src/locales/en.ts
美国版/Food Labeling Management App UniApp/src/locales/zh.ts
美国版/Food Labeling Management App UniApp/src/pages/index/index.vue
美国版/Food Labeling Management App UniApp/src/pages/login/login.vue
美国版/Food Labeling Management App UniApp/src/pages/more/location.vue
美国版/Food Labeling Management App UniApp/src/pages/more/more.vue
美国版/Food Labeling Management App UniApp/src/pages/more/profile.vue
美国版/Food Labeling Management App UniApp/src/pages/store-select/store-select.vue
美国版/Food Labeling Management App UniApp/src/services/usAppAuth.ts
美国版/Food Labeling Management App UniApp/src/utils/apiBase.ts
美国版/Food Labeling Management App UniApp/src/utils/authSession.ts
美国版/Food Labeling Management App UniApp/src/utils/stores.ts
美国版/Food Labeling Management App UniApp/vite.config.ts
美国版App登录接口说明.md
 <template>
   <view class="loc-root">
-    <view class="loc-trigger" @click.stop="showPicker = true">
-      <text class="loc-text">LOC-{{ currentId }}</text>
+    <view class="loc-trigger" @click.stop="openPicker">
+      <text class="loc-text">{{ displayCode || '—' }}</text>
       <AppIcon name="chevronDown" size="sm" color="white" />
     </view>
  
@@ -25,8 +25,8 @@
               <AppIcon name="mapPin" size="sm" :color="currentId === s.id ? 'white' : 'gray'" />
             </view>
             <view class="picker-info">
-              <text class="picker-name">{{ t(s.nameKey) }}</text>
-              <text class="picker-addr">{{ s.address }}, {{ s.city }}</text>
+              <text class="picker-name">{{ s.locationName }}</text>
+              <text class="picker-addr">{{ s.fullAddress }}</text>
             </view>
             <view v-if="currentId === s.id" class="picker-check">
               <AppIcon name="check" size="sm" color="white" />
@@ -39,30 +39,57 @@
 </template>
  
 <script setup lang="ts">
-import { ref } from 'vue'
+import { ref, computed, watch } from 'vue'
 import { useI18n } from 'vue-i18n'
 import AppIcon from './AppIcon.vue'
-import { storeList, getCurrentStoreId, switchStore } from '../utils/stores'
+import {
+  getCurrentStoreId,
+  switchStore,
+  getBoundLocations,
+  getCurrentLocationCode,
+} from '../utils/stores'
+import type { UsAppBoundLocationDto } from '../services/usAppAuth'
  
 const { t } = useI18n()
-const stores = storeList
+const stores = ref<UsAppBoundLocationDto[]>([])
 const currentId = ref(getCurrentStoreId())
 const showPicker = ref(false)
  
-const handleSelect = (s: typeof stores[0]) => {
+function refreshList() {
+  stores.value = getBoundLocations().filter((s) => s.state !== false)
+}
+
+const displayCode = computed(() => {
+  if (currentId.value) {
+    const row = stores.value.find((x) => x.id === currentId.value)
+    if (row?.locationCode) return row.locationCode
+  }
+  return getCurrentLocationCode()
+})
+
+function openPicker() {
+  refreshList()
+  currentId.value = getCurrentStoreId()
+  showPicker.value = true
+}
+
+watch(showPicker, (v) => {
+  if (v) refreshList()
+})
+
+const handleSelect = (s: UsAppBoundLocationDto) => {
   if (s.id === currentId.value) {
     showPicker.value = false
     return
   }
-  const name = t(s.nameKey)
-  switchStore(s.id, name)
+  switchStore(s.id, s.locationName, s.locationCode)
   currentId.value = s.id
   showPicker.value = false
-  uni.showToast({ title: 'Switched to ' + name, icon: 'success' })
+  uni.showToast({ title: t('location.storeSwitched'), icon: 'success' })
   setTimeout(() => {
     const pages = getCurrentPages()
-    const cur = pages[pages.length - 1] as any
-    if (cur && cur.route) {
+    const cur = pages[pages.length - 1] as { route?: string }
+    if (cur?.route) {
       uni.redirectTo({ url: '/' + cur.route })
     }
   }, 800)
@@ -78,6 +78,7 @@ import { computed, ref, watch, nextTick } from &#39;vue&#39;
 import { useI18n } from 'vue-i18n'
 import AppIcon from './AppIcon.vue'
 import { getStatusBarHeight, getBottomSafeArea } from '../utils/statusBar'
+import { clearAuthSession } from '../utils/authSession'
  
 const props = defineProps<{
   modelValue: boolean
@@ -165,10 +166,7 @@ const currentPath = computed(() =&gt; {
 const isActive = (path: string) => !!path && path !== '__logout__' && currentPath.value === path
  
 const handleLogout = () => {
-  uni.removeStorageSync('isLoggedIn')
-  uni.removeStorageSync('userName')
-  uni.removeStorageSync('storeName')
-  uni.removeStorageSync('storeId')
+  clearAuthSession()
   uni.redirectTo({ url: '/pages/login/login' })
 }
  
 /// <reference types="vite/client" />
  
+interface ImportMetaEnv {
+  /** 美国版后端根地址，如 http://192.168.1.2:19001；H5 开发可留空走 Vite /api 代理 */
+  readonly VITE_US_API_BASE?: string
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv
+}
+
 declare module '*.vue' {
   import { DefineComponent } from 'vue'
   // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/ban-types
@@ -14,6 +14,10 @@ export default {
     signIn: 'Sign In',
     signingIn: 'Signing In...',
     loginSuccess: 'Login successful',
+    loginFailed: 'Login failed',
+    fillRequired: 'Please enter email and password',
+    noStoresBound: 'No stores are linked to this account',
+    refreshStoresFail: 'Could not refresh store list',
     copyright: '© 2026 Food Label System. All rights reserved.',
     selectStore: 'Select Store',
     welcomeUser: 'Welcome!',
@@ -14,6 +14,10 @@ export default {
     signIn: '登录',
     signingIn: '登录中...',
     loginSuccess: '登录成功',
+    loginFailed: '登录失败',
+    fillRequired: '请输入邮箱和密码',
+    noStoresBound: '当前账号未绑定门店',
+    refreshStoresFail: '门店列表刷新失败',
     copyright: '© 2026 食品标签系统。保留所有权利。',
     selectStore: '选择店铺',
     welcomeUser: '欢迎！',
@@ -41,10 +41,12 @@
 <script setup lang="ts">
 import { ref, computed } from 'vue'
 import { useI18n } from 'vue-i18n'
+import { onShow } from '@dcloudio/uni-app'
 import AppIcon from '../../components/AppIcon.vue'
 import SideMenu from '../../components/SideMenu.vue'
 import LocationPicker from '../../components/LocationPicker.vue'
 import { getStatusBarHeight } from '../../utils/statusBar'
+import { getAccessToken } from '../../utils/authSession'
  
 const { t } = useI18n()
 const statusBarHeight = getStatusBarHeight()
@@ -52,6 +54,16 @@ const statusBarHeight = getStatusBarHeight()
 const storeName = computed(() => uni.getStorageSync('storeName') || 'MedVantage')
 const isMenuOpen = ref(false)
  
+onShow(() => {
+  if (!getAccessToken()) {
+    uni.reLaunch({ url: '/pages/login/login' })
+    return
+  }
+  if (!uni.getStorageSync('storeId')) {
+    uni.redirectTo({ url: '/pages/store-select/store-select' })
+  }
+})
+
 const quickActions = computed(() => [
   {
     label: t('Labeling'),
@@ -32,7 +32,7 @@
         </view>
         <view class="form-row">
           <view class="remember-row">
-            <switch :checked="rememberMe" @change="rememberMe = $event.detail.value" :color="'#1F3A8A'" />
+            <switch :checked="rememberMe" color="#1F3A8A" @change="onRememberChange" />
             <text class="remember-text">{{ t('login.rememberMe') }}</text>
           </view>
           <text class="forgot-link">{{ t('login.forgotPassword') }}</text>
@@ -51,9 +51,16 @@
 </template>
  
 <script setup lang="ts">
-import { ref } from 'vue'
+import { ref, onMounted } from 'vue'
 import { useI18n } from 'vue-i18n'
 import { getStatusBarHeight } from '../../utils/statusBar'
+import { usAppLogin } from '../../services/usAppAuth'
+import {
+  saveAuthSession,
+  loadSavedCredentials,
+  saveRememberPreference,
+  isLoggedIn,
+} from '../../utils/authSession'
  
 const { t } = useI18n()
 const statusBarHeight = getStatusBarHeight()
@@ -62,15 +69,67 @@ const password = ref(&#39;&#39;)
 const rememberMe = ref(false)
 const isLoading = ref(false)
  
-const handleLogin = () => {
+function displayNameFromEmail(mail: string): string {
+  const m = mail.trim()
+  if (!m) return 'Employee'
+  const at = m.indexOf('@')
+  return at > 0 ? m.slice(0, at) : m
+}
+
+onMounted(() => {
+  if (isLoggedIn()) {
+    const sid = uni.getStorageSync('storeId')
+    if (sid) {
+      uni.reLaunch({ url: '/pages/index/index' })
+    } else {
+      uni.reLaunch({ url: '/pages/store-select/store-select' })
+    }
+    return
+  }
+  const saved = loadSavedCredentials()
+  if (saved.remember) {
+    rememberMe.value = true
+    email.value = saved.email
+    password.value = saved.password
+  }
+})
+
+function onRememberChange(e: { detail?: { value?: boolean } }) {
+  rememberMe.value = !!e.detail?.value
+}
+
+const handleLogin = async () => {
+  const em = email.value.trim()
+  const pw = password.value
+  if (!em || !pw) {
+    uni.showToast({ title: t('login.fillRequired'), icon: 'none' })
+    return
+  }
   isLoading.value = true
-  setTimeout(() => {
-    uni.setStorageSync('isLoggedIn', 'true')
-    uni.setStorageSync('userName', 'John Smith')
+  try {
+    const res = await usAppLogin({ email: em, password: pw })
+    if (!res.token) {
+      uni.showToast({ title: t('login.loginFailed'), icon: 'none' })
+      return
+    }
+    saveRememberPreference(rememberMe.value, em, pw)
+    saveAuthSession({
+      token: res.token,
+      refreshToken: res.refreshToken || '',
+      locations: res.locations ?? [],
+      displayName: displayNameFromEmail(em),
+      email: em,
+    })
     uni.showToast({ title: t('login.loginSuccess'), icon: 'success' })
-    uni.redirectTo({ url: '/pages/store-select/store-select' })
+    setTimeout(() => {
+      uni.redirectTo({ url: '/pages/store-select/store-select' })
+    }, 400)
+  } catch (e: unknown) {
+    const msg = e instanceof Error ? e.message : String(e)
+    uni.showToast({ title: msg || t('login.loginFailed'), icon: 'none', duration: 2500 })
+  } finally {
     isLoading.value = false
-  }, 1000)
+  }
 }
 </script>
  
@@ -23,12 +23,11 @@
           </view>
           <view class="store-highlight-texts">
             <text class="store-badge-label">{{ t('location.currentStore') }}</text>
-            <text class="store-highlight-name">{{ t(currentStore.nameKey) }}</text>
+            <text class="store-highlight-name">{{ currentStore.locationName }}</text>
           </view>
         </view>
         <view class="store-address-block">
-          <text class="store-address-line">{{ currentStore.address }}</text>
-          <text class="store-address-line">{{ currentStore.city }}</text>
+          <text class="store-address-line">{{ currentStore.fullAddress }}</text>
         </view>
       </view>
  
@@ -104,8 +103,8 @@
               <AppIcon name="mapPin" size="sm" :color="selectedId === s.id ? 'white' : 'gray'" />
             </view>
             <view class="store-info-col">
-              <text class="store-item-name">{{ t(s.nameKey) }}</text>
-              <text class="store-item-addr">{{ s.address }}, {{ s.city }}</text>
+              <text class="store-item-name">{{ s.locationName }}</text>
+              <text class="store-item-addr">{{ s.fullAddress }}</text>
             </view>
             <view v-if="selectedId === s.id" class="check-circle">
               <AppIcon name="check" size="sm" color="white" />
@@ -130,25 +129,52 @@
 <script setup lang="ts">
 import { ref, computed } from 'vue'
 import { useI18n } from 'vue-i18n'
+import { onShow } from '@dcloudio/uni-app'
 import AppIcon from '../../components/AppIcon.vue'
 import SideMenu from '../../components/SideMenu.vue'
 import LocationPicker from '../../components/LocationPicker.vue'
 import { getStatusBarHeight } from '../../utils/statusBar'
+import { getBoundLocations, switchStore, getCurrentStoreId } from '../../utils/stores'
  
 const { t } = useI18n()
 const statusBarHeight = getStatusBarHeight()
 const isMenuOpen = ref(false)
 const showDialog = ref(false)
-const selectedId = ref(uni.getStorageSync('storeId') || '1')
-
-const stores = [
-  { id: '1', nameKey: 'login.store1', address: '123 Main St', city: 'New York, NY 10001', phone: '(212) 555-0101', hours: 'Mon-Fri: 6:00 AM - 10:00 PM', manager: 'Sarah Johnson', managerPhone: '(212) 555-0111' },
-  { id: '2', nameKey: 'login.store2', address: '456 Oak Ave', city: 'Brooklyn, NY 11201', phone: '(718) 555-0102', hours: 'Mon-Fri: 7:00 AM - 11:00 PM', manager: 'Michael Chen', managerPhone: '(718) 555-0112' },
-  { id: '3', nameKey: 'login.store3', address: '789 Pine Rd', city: 'Queens, NY 11354', phone: '(718) 555-0103', hours: 'Mon-Sat: 6:00 AM - 9:00 PM', manager: 'Emily Rodriguez', managerPhone: '(718) 555-0113' },
-  { id: '4', nameKey: 'login.store4', address: '321 Elm St', city: 'Manhattan, NY 10002', phone: '(212) 555-0104', hours: 'Daily: 6:00 AM - 11:00 PM', manager: 'David Kim', managerPhone: '(212) 555-0114' },
-]
+const selectedId = ref(getCurrentStoreId())
+
+const stores = computed(() => getBoundLocations().filter((s) => s.state !== false))
+
+const EM = '—'
+
+const currentStore = computed(() => {
+  const list = stores.value
+  const id = selectedId.value || getCurrentStoreId()
+  const row = list.find((s) => s.id === id) || list[0]
+  if (!row) {
+    return {
+      id: '',
+      locationName: EM,
+      fullAddress: EM,
+      phone: EM,
+      hours: EM,
+      manager: EM,
+      managerPhone: EM,
+    }
+  }
+  return {
+    id: row.id,
+    locationName: row.locationName,
+    fullAddress: row.fullAddress || EM,
+    phone: EM,
+    hours: EM,
+    manager: EM,
+    managerPhone: EM,
+  }
+})
  
-const currentStore = computed(() => stores.find((s) => s.id === selectedId.value) || stores[0])
+onShow(() => {
+  selectedId.value = getCurrentStoreId()
+})
  
 const goBack = () => {
   const pages = getCurrentPages()
@@ -161,10 +187,9 @@ const goBack = () =&gt; {
  
 const handleSwitch = () => {
   if (selectedId.value === currentStore.value.id) return
-  const s = stores.find((x) => x.id === selectedId.value)
+  const s = stores.value.find((x) => x.id === selectedId.value)
   if (s) {
-    uni.setStorageSync('storeId', selectedId.value)
-    uni.setStorageSync('storeName', t(s.nameKey))
+    switchStore(s.id, s.locationName, s.locationCode)
     uni.showToast({ title: t('location.storeSwitched'), icon: 'success' })
     showDialog.value = false
   }
@@ -92,23 +92,21 @@
 </template>
  
 <script setup lang="ts">
-import { ref } from 'vue'
+import { ref, computed } from 'vue'
 import { useI18n } from 'vue-i18n'
 import AppIcon from '../../components/AppIcon.vue'
 import SideMenu from '../../components/SideMenu.vue'
+import { clearAuthSession } from '../../utils/authSession'
  
 const { t } = useI18n()
-const userName = 'John Smith'
+const userName = computed(() => uni.getStorageSync('userName') || 'Employee')
 const showLogout = ref(false)
 const isMenuOpen = ref(false)
  
 const navTo = (path: string) => uni.navigateTo({ url: path })
  
 const handleLogout = () => {
-  uni.removeStorageSync('isLoggedIn')
-  uni.removeStorageSync('userName')
-  uni.removeStorageSync('storeName')
-  uni.removeStorageSync('storeId')
+  clearAuthSession()
   uni.redirectTo({ url: '/pages/login/login' })
 }
 </script>
@@ -86,8 +86,8 @@ import { getStatusBarHeight } from &#39;../../utils/statusBar&#39;
 const { t } = useI18n()
 const statusBarHeight = getStatusBarHeight()
 const isMenuOpen = ref(false)
-const name = ref(uni.getStorageSync('userName') || 'John Smith')
-const email = ref('john.smith@company.com')
+const name = ref(uni.getStorageSync('userName') || 'Employee')
+const email = ref(uni.getStorageSync('user_email') || '')
 const phone = ref('+1 (555) 123-4567')
 const employeeId = ref('EMP-2024-001')
  
@@ -12,6 +12,9 @@
     </view>
  
     <view class="list">
+      <view v-if="!loading && stores.length === 0" class="empty-hint">
+        <text class="empty-text">{{ t('login.noStoresBound') }}</text>
+      </view>
       <view
         v-for="store in stores"
         :key="store.id"
@@ -23,13 +26,12 @@
           <AppIcon name="mapPin" size="md" :color="selectedStore === store.id ? 'white' : 'gray'" />
         </view>
         <view class="card-content">
-          <text class="card-title">{{ t(store.nameKey) }}</text>
+          <text class="card-title">{{ store.locationName }}</text>
           <view class="info-row">
             <AppIcon name="mapPin" size="sm" color="gray" />
-            <text class="info">{{ store.address }}</text>
+            <text class="info">{{ store.fullAddress }}</text>
           </view>
-          <text class="info">{{ t('location.storeManager') }}: {{ store.manager }}</text>
-          <text class="info">{{ t('location.storePhone') }}: {{ store.phone }}</text>
+          <text v-if="store.locationCode" class="info muted">{{ store.locationCode }}</text>
         </view>
         <view class="card-check">
           <AppIcon
@@ -51,44 +53,75 @@
     <view class="bottom-bar" :style="{ paddingBottom: (bottomSafeArea + 24) + 'px' }">
       <view
         class="confirm-btn"
-        :class="{ disabled: !selectedStore }"
+        :class="{ disabled: !selectedStore || loading }"
         @click="handleConfirm"
       >
-        <text class="confirm-btn-text">{{ t('common.confirm') }}</text>
+        <text class="confirm-btn-text">{{ loading ? '…' : t('common.confirm') }}</text>
       </view>
     </view>
   </view>
 </template>
  
 <script setup lang="ts">
-import { ref } from 'vue'
+import { ref, computed, onMounted } from 'vue'
 import { useI18n } from 'vue-i18n'
+import { onShow } from '@dcloudio/uni-app'
 import AppIcon from '../../components/AppIcon.vue'
 import { getStatusBarHeight, getBottomSafeArea } from '../../utils/statusBar'
+import { usAppFetchMyLocations, type UsAppBoundLocationDto } from '../../services/usAppAuth'
+import { setBoundLocations, getBoundLocations } from '../../utils/authSession'
+import { switchStore } from '../../utils/stores'
  
 const { t } = useI18n()
 const statusBarHeight = getStatusBarHeight()
 const bottomSafeArea = getBottomSafeArea()
-const userName = uni.getStorageSync('userName') || 'Employee'
+const userName = computed(() => uni.getStorageSync('userName') || 'Employee')
 const selectedStore = ref('')
+const stores = ref<UsAppBoundLocationDto[]>([])
+const loading = ref(false)
+
+function applyList(list: UsAppBoundLocationDto[]) {
+  const enabled = list.filter((s) => s.state !== false)
+  stores.value = enabled
+  setBoundLocations(enabled)
+}
+
+async function refreshFromApi() {
+  loading.value = true
+  try {
+    const list = await usAppFetchMyLocations()
+    applyList(list)
+  } catch {
+    applyList(getBoundLocations())
+    uni.showToast({ title: t('login.refreshStoresFail'), icon: 'none' })
+  } finally {
+    loading.value = false
+  }
+}
  
-const stores = [
-  { id: '1', nameKey: 'login.store1', address: '123 Main St, New York, NY 10001', manager: 'Sarah Johnson', phone: '(212) 555-0101' },
-  { id: '2', nameKey: 'login.store2', address: '456 Oak Ave, Brooklyn, NY 11201', manager: 'Michael Chen', phone: '(718) 555-0102' },
-  { id: '3', nameKey: 'login.store3', address: '789 Pine Rd, Queens, NY 11354', manager: 'Emily Rodriguez', phone: '(718) 555-0103' },
-  { id: '4', nameKey: 'login.store4', address: '321 Elm St, Manhattan, NY 10002', manager: 'David Kim', phone: '(212) 555-0104' },
-]
+onMounted(() => {
+  applyList(getBoundLocations())
+  refreshFromApi()
+})
+
+onShow(() => {
+  applyList(getBoundLocations())
+})
  
 const handleConfirm = () => {
-  if (!selectedStore.value) {
-    uni.showToast({ title: t('login.selectStoreError'), icon: 'none' })
+  if (loading.value || !selectedStore.value) {
+    if (!selectedStore.value) {
+      uni.showToast({ title: t('login.selectStoreError'), icon: 'none' })
+    }
     return
   }
-  const store = stores.find((s) => s.id === selectedStore.value)!
-  uni.setStorageSync('storeId', selectedStore.value)
-  uni.setStorageSync('storeName', t(store.nameKey))
+  const store = stores.value.find((s) => s.id === selectedStore.value)
+  if (!store) return
+  switchStore(store.id, store.locationName, store.locationCode)
   uni.showToast({ title: t('login.storeSelected'), icon: 'success' })
-  uni.redirectTo({ url: '/pages/index/index' })
+  setTimeout(() => {
+    uni.redirectTo({ url: '/pages/index/index' })
+  }, 400)
 }
 </script>
  
@@ -145,6 +178,16 @@ const handleConfirm = () =&gt; {
   padding-bottom: 24rpx;
 }
  
+.empty-hint {
+  padding: 48rpx 24rpx;
+  text-align: center;
+}
+
+.empty-text {
+  font-size: 28rpx;
+  color: #6b7280;
+}
+
 .card {
   padding: 32rpx;
   background: #ffffff;
@@ -204,6 +247,11 @@ const handleConfirm = () =&gt; {
   margin-bottom: 6rpx;
 }
  
+.info.muted {
+  color: #9ca3af;
+  font-size: 24rpx;
+}
+
 .card-check {
   width: 44rpx;
   height: 44rpx;
+import { buildApiUrl } from '../utils/apiBase'
+
+/** 与后端 UsAppBoundLocationDto 对齐 */
+export interface UsAppBoundLocationDto {
+  id: string
+  locationCode: string
+  locationName: string
+  fullAddress: string
+  state: boolean
+}
+
+export interface UsAppLoginInput {
+  email: string
+  password: string
+  uuid?: string
+  code?: string
+}
+
+export interface UsAppLoginOutputDto {
+  token: string
+  refreshToken: string
+  locations: UsAppBoundLocationDto[]
+}
+
+function normalizeLocation(raw: Record<string, unknown>): UsAppBoundLocationDto {
+  return {
+    id: String(raw.id ?? raw.Id ?? ''),
+    locationCode: String(raw.locationCode ?? raw.LocationCode ?? ''),
+    locationName: String(raw.locationName ?? raw.LocationName ?? ''),
+    fullAddress: String(raw.fullAddress ?? raw.FullAddress ?? ''),
+    state: raw.state !== false && raw.State !== false,
+  }
+}
+
+function normalizeLoginOutput(raw: unknown): UsAppLoginOutputDto {
+  const o = raw as Record<string, unknown>
+  const locs = o.locations ?? o.Locations
+  const arr = Array.isArray(locs) ? locs : []
+  return {
+    token: String(o.token ?? o.Token ?? ''),
+    refreshToken: String(o.refreshToken ?? o.RefreshToken ?? ''),
+    locations: arr.map((x) => normalizeLocation(x as Record<string, unknown>)),
+  }
+}
+
+function normalizeLocationList(raw: unknown): UsAppBoundLocationDto[] {
+  const arr = Array.isArray(raw) ? raw : []
+  return arr.map((x) => normalizeLocation(x as Record<string, unknown>))
+}
+
+/**
+ * 取出真实业务负载：支持 ABP `result`、以及项目统一包装 `{ succeeded, data }`（data 内为 token / 数组等）
+ */
+function unwrap<T>(data: unknown): T {
+  if (data == null || typeof data !== 'object') return data as T
+  const o = data as Record<string, unknown>
+  if ('result' in o && o.result !== undefined) {
+    return o.result as T
+  }
+  const payload = o.data ?? o.Data
+  if (payload !== undefined && payload !== null) {
+    return payload as T
+  }
+  return data as T
+}
+
+/** 统一解析后端错误文案（含统一返回体里的 errors、succeeded 等） */
+function parseErrorMessage(data: unknown): string {
+  if (data == null) return 'Request failed'
+  if (typeof data === 'string') return data
+  if (typeof data === 'object') {
+    const o = data as Record<string, unknown>
+    const errorsRaw = o.errors ?? o.Errors
+    if (typeof errorsRaw === 'string' && errorsRaw.trim()) return errorsRaw.trim()
+    if (Array.isArray(errorsRaw)) {
+      const parts = errorsRaw.map((x) => String(x)).filter(Boolean)
+      if (parts.length) return parts.join('; ')
+    }
+    const err = o.error as Record<string, unknown> | undefined
+    if (err && typeof err.message === 'string') return err.message
+    if (typeof o.message === 'string') return o.message
+    if (typeof o.error_description === 'string') return o.error_description
+  }
+  return 'Request failed'
+}
+
+/** HTTP 200 但业务失败（如 succeeded: false、体内 statusCode 403） */
+function isBusinessFailurePayload(data: unknown): boolean {
+  if (data == null || typeof data !== 'object') return false
+  const o = data as Record<string, unknown>
+  if (o.succeeded === false || o.Succeeded === false) return true
+  const inner = o.statusCode ?? o.StatusCode
+  if (typeof inner === 'number' && inner >= 400) return true
+  return false
+}
+
+function request<T>(options: {
+  path: string
+  method: 'GET' | 'POST'
+  data?: unknown
+  auth?: boolean
+}): Promise<T> {
+  const header: Record<string, string> = {
+    'Content-Type': 'application/json',
+    Accept: 'application/json',
+  }
+  if (options.auth) {
+    const token = uni.getStorageSync('access_token')
+    if (token) header.Authorization = `Bearer ${token}`
+  }
+
+  return new Promise((resolve, reject) => {
+    uni.request({
+      url: buildApiUrl(options.path),
+      method: options.method,
+      data: options.data,
+      header,
+      success: (res) => {
+        const status = res.statusCode ?? 0
+        if (status >= 400) {
+          reject(new Error(parseErrorMessage(res.data)))
+          return
+        }
+        if (isBusinessFailurePayload(res.data)) {
+          reject(new Error(parseErrorMessage(res.data)))
+          return
+        }
+        try {
+          const body = unwrap<T>(res.data as unknown)
+          resolve(body)
+        } catch {
+          reject(new Error('Invalid response'))
+        }
+      },
+      fail: (err) => {
+        reject(new Error(err.errMsg || 'Network error'))
+      },
+    })
+  })
+}
+
+/** POST /api/app/us-app-auth/login */
+export async function usAppLogin(input: UsAppLoginInput): Promise<UsAppLoginOutputDto> {
+  const raw = await request<unknown>({
+    path: '/api/app/us-app-auth/login',
+    method: 'POST',
+    data: {
+      email: input.email.trim(),
+      password: input.password,
+      ...(input.uuid ? { uuid: input.uuid } : {}),
+      ...(input.code != null ? { code: input.code } : {}),
+    },
+  })
+  return normalizeLoginOutput(raw)
+}
+
+/** GET /api/app/us-app-auth/my-locations */
+export async function usAppFetchMyLocations(): Promise<UsAppBoundLocationDto[]> {
+  const raw = await request<unknown>({
+    path: '/api/app/us-app-auth/my-locations',
+    method: 'GET',
+    auth: true,
+  })
+  return normalizeLocationList(raw)
+}
+/**
+ * 美国版后端 API 根地址（不含末尾 /）。
+ * - H5 开发：可在 .env.development 留空，配合 vite proxy 走同源 /api
+ * - App / 生产：在 .env 中设置 VITE_US_API_BASE，例如 http://192.168.1.10:19001
+ */
+export function getApiBaseUrl(): string {
+  const fromEnv = (import.meta.env.VITE_US_API_BASE as string | undefined)?.trim()
+  if (fromEnv) return fromEnv.replace(/\/$/, '')
+  if (import.meta.env.DEV && typeof window !== 'undefined') return ''
+  return 'http://flus-test.3ffoodsafety.com'
+}
+
+export function buildApiUrl(path: string): string {
+  const base = getApiBaseUrl()
+  const p = path.startsWith('/') ? path : `/${path}`
+  return base ? `${base}${p}` : p
+}
+import type { UsAppBoundLocationDto } from '../services/usAppAuth'
+
+const KEY_ACCESS = 'access_token'
+const KEY_REFRESH = 'refresh_token'
+const KEY_LOCATIONS = 'bound_locations_json'
+const KEY_LOGGED = 'isLoggedIn'
+const KEY_USER = 'userName'
+const KEY_EMAIL = 'user_email'
+const KEY_REMEMBER = 'login_remember_me'
+const KEY_SAVED_EMAIL = 'login_saved_email'
+const KEY_SAVED_PASSWORD = 'login_saved_password'
+
+export function saveAuthSession(payload: {
+  token: string
+  refreshToken: string
+  locations: UsAppBoundLocationDto[]
+  /** 展示用：无姓名接口时用邮箱本地部分或全文 */
+  displayName: string
+  email: string
+}): void {
+  uni.setStorageSync(KEY_ACCESS, payload.token)
+  uni.setStorageSync(KEY_REFRESH, payload.refreshToken)
+  uni.setStorageSync(KEY_LOCATIONS, JSON.stringify(payload.locations ?? []))
+  uni.setStorageSync(KEY_LOGGED, 'true')
+  uni.setStorageSync(KEY_USER, payload.displayName)
+  uni.setStorageSync(KEY_EMAIL, payload.email)
+}
+
+export function setBoundLocations(locations: UsAppBoundLocationDto[]): void {
+  uni.setStorageSync(KEY_LOCATIONS, JSON.stringify(locations ?? []))
+}
+
+export function getBoundLocations(): UsAppBoundLocationDto[] {
+  try {
+    const raw = uni.getStorageSync(KEY_LOCATIONS)
+    if (!raw || typeof raw !== 'string') return []
+    const parsed = JSON.parse(raw) as unknown
+    if (!Array.isArray(parsed)) return []
+    return parsed as UsAppBoundLocationDto[]
+  } catch {
+    return []
+  }
+}
+
+export function clearAuthSession(): void {
+  uni.removeStorageSync(KEY_ACCESS)
+  uni.removeStorageSync(KEY_REFRESH)
+  uni.removeStorageSync(KEY_LOCATIONS)
+  uni.removeStorageSync(KEY_LOGGED)
+  uni.removeStorageSync(KEY_USER)
+  uni.removeStorageSync(KEY_EMAIL)
+  uni.removeStorageSync('storeId')
+  uni.removeStorageSync('storeName')
+  uni.removeStorageSync('storeLocationCode')
+}
+
+export function isLoggedIn(): boolean {
+  return !!uni.getStorageSync(KEY_ACCESS) && uni.getStorageSync(KEY_LOGGED) === 'true'
+}
+
+export function getAccessToken(): string {
+  return uni.getStorageSync(KEY_ACCESS) || ''
+}
+
+export function saveRememberPreference(remember: boolean, email: string, password: string): void {
+  uni.setStorageSync(KEY_REMEMBER, remember ? '1' : '0')
+  if (remember) {
+    uni.setStorageSync(KEY_SAVED_EMAIL, email)
+    uni.setStorageSync(KEY_SAVED_PASSWORD, password)
+  } else {
+    uni.removeStorageSync(KEY_SAVED_EMAIL)
+    uni.removeStorageSync(KEY_SAVED_PASSWORD)
+  }
+}
+
+export function loadSavedCredentials(): { email: string; password: string; remember: boolean } {
+  const remember = uni.getStorageSync(KEY_REMEMBER) === '1'
+  return {
+    remember,
+    email: remember ? (uni.getStorageSync(KEY_SAVED_EMAIL) || '') : '',
+    password: remember ? (uni.getStorageSync(KEY_SAVED_PASSWORD) || '') : '',
+  }
+}
-export interface StoreInfo {
-  id: string
-  nameKey: string
-  address: string
-  city: string
-}
+import type { UsAppBoundLocationDto } from '../services/usAppAuth'
+import { getBoundLocations } from './authSession'
+
+export type StoreInfo = UsAppBoundLocationDto
  
-export const storeList: StoreInfo[] = [
-  { id: '1', nameKey: 'login.store1', address: '123 Main St', city: 'New York, NY 10001' },
-  { id: '2', nameKey: 'login.store2', address: '456 Oak Ave', city: 'Brooklyn, NY 11201' },
-  { id: '3', nameKey: 'login.store3', address: '789 Pine Rd', city: 'Queens, NY 11354' },
-  { id: '4', nameKey: 'login.store4', address: '321 Elm St', city: 'Manhattan, NY 10002' },
-]
+export { getBoundLocations } from './authSession'
  
 export function getCurrentStoreId(): string {
-  return uni.getStorageSync('storeId') || '1'
+  return uni.getStorageSync('storeId') || ''
 }
  
-export function switchStore(id: string, storeName: string) {
+export function switchStore(id: string, storeName: string, locationCode?: string) {
   uni.setStorageSync('storeId', id)
   uni.setStorageSync('storeName', storeName)
+  if (locationCode != null && locationCode !== '') {
+    uni.setStorageSync('storeLocationCode', locationCode)
+  }
+}
+
+/** 顶部药丸展示用，如 LOC-1 */
+export function getCurrentLocationCode(): string {
+  const saved = uni.getStorageSync('storeLocationCode')
+  if (saved) return saved
+  const id = getCurrentStoreId()
+  if (!id) return ''
+  const row = getBoundLocations().find((l) => l.id === id)
+  return row?.locationCode || ''
 }
@@ -8,5 +8,11 @@ export default defineConfig({
   plugins: [uni()],
   server: {
     open: "/",
+    proxy: {
+      "/api": {
+        target: "http://flus-test.3ffoodsafety.com",
+        changeOrigin: true,
+      },
+    },
   },
 });
+# 美国版 App 登录接口说明
+
+## 概述
+
+美国版移动端认证由 `food-labeling-us` 模块的 **`UsAppAuthAppService`** 提供，采用 ABP 约定式动态 API。宿主统一前缀为 **`/api/app`**，建议以 Swagger 为准核对路径（本地示例：`http://localhost:19001/swagger`，搜索 `UsAppAuth`）。
+
+| 说明 | 内容 |
+|------|------|
+| 账号标识 | 使用 **`User.Email`**（邮箱）登录，邮箱比对**忽略大小写** |
+| 密码 | 与 Web 共用 `User` 表，校验方式与 RBAC **`AccountManager`** 一致（盐值 + `MD5Helper.SHA2Encode`） |
+| 验证码 | 当配置 **`Rbac:EnableCaptcha`** 为 `true` 时，需先拉取图形验证码，本接口入参传 `uuid`、`code`；未开启时可传空或不传 |
+
+---
+
+## 接口 1：App 登录
+
+签发 **Access Token**、**Refresh Token**，并返回当前用户在 **`userlocation`** 中绑定的门店列表（关联 **`location`** 表详情）。
+
+### HTTP
+
+- **方法**：`POST`
+- **路径**：`/api/app/us-app-auth/login`
+- **Content-Type**：`application/json`
+- **鉴权**：无需登录（匿名）
+
+### 请求体参数（UsAppLoginInputVo）
+
+| 参数名（JSON） | 类型 | 必填 | 说明 |
+|----------------|------|------|------|
+| `email` | string | 是 | 登录邮箱，对应数据库 `User.Email` |
+| `password` | string | 是 | 明文密码 |
+| `uuid` | string | 条件 | 图形验证码 UUID；**开启验证码时必填** |
+| `code` | string | 条件 | 图形验证码；**开启验证码时必填** |
+
+### 传参示例（请求 Body）
+
+未开启图形验证码时：
+
+```json
+{
+  "email": "admin@example.com",
+  "password": "123456"
+}
+```
+
+开启图形验证码时（需与系统验证码接口返回的 `uuid`、用户输入的验证码一致）：
+
+```json
+{
+  "email": "test@example.com",
+  "password": "您的密码",
+  "uuid": "验证码接口返回的 uuid",
+  "code": "用户看到的验证码"
+}
+```
+
+### 响应体（UsAppLoginOutputDto）
+
+| 字段（JSON） | 类型 | 说明 |
+|--------------|------|------|
+| `token` | string | 访问令牌（Bearer），后续业务接口放在 Header `Authorization: Bearer {token}` |
+| `refreshToken` | string | 刷新令牌（与系统账号体系一致，用于刷新 access token，具体用法与 Web 一致） |
+| `locations` | array | 绑定门店列表，元素见下表 |
+
+#### `locations[]` 元素（UsAppBoundLocationDto）
+
+| 字段（JSON） | 类型 | 说明 |
+|--------------|------|------|
+| `id` | string | 门店主键（Guid 字符串） |
+| `locationCode` | string | 业务编码，如 LOC-1 |
+| `locationName` | string | 门店名称 |
+| `fullAddress` | string | 拼接后的完整地址（街道、城市、州、邮编等；无数据时可能为 `"无"`） |
+| `state` | bool | 门店是否启用 |
+
+### 响应示例
+
+```json
+{
+  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+  "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+  "locations": [
+    {
+      "id": "a2696b9e-2277-11f1-b4c6-00163e0c7c4f",
+      "locationCode": "LOC-1",
+      "locationName": "Downtown Kitchen",
+      "fullAddress": "123 Main St, New York, NY 10001",
+      "state": true
+    }
+  ]
+}
+```
+
+### 常见错误提示（业务异常文案）
+
+- 邮箱或密码为空：`请输入合理数据！`
+- 邮箱在库中不存在（未删除且启用用户中无匹配邮箱）：`登录失败！邮箱不存在！`
+- 密码错误：`登录失败！用户名或密码错误！`（与 `UserConst.Login_Error` 一致）
+- 验证码错误（开启验证码时）：`验证码错误`
+
+---
+
+## 接口 2：获取当前账号绑定门店
+
+无需重新登录即可刷新 **`userlocation`** 绑定门店列表（例如切换门店前先同步列表）。
+
+### HTTP
+
+- **方法**：`GET`
+- **路径**：`/api/app/us-app-auth/my-locations`
+- **鉴权**：需要登录，请求头携带 **`Authorization: Bearer {token}`**（使用接口 1 返回的 `token`）
+
+### 请求参数
+
+无 Query / Body 参数；用户身份由 JWT 解析。
+
+### 传参示例
+
+```http
+GET /api/app/us-app-auth/my-locations HTTP/1.1
+Host: localhost:19001
+Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
+```
+
+若前端统一约定 GET 使用 `data` 封装，可自行在客户端组装；本接口服务端**不读取额外 Query 参数**。
+
+### 响应体
+
+与登录接口中 **`locations`** 相同：**`UsAppBoundLocationDto[]`**（数组）。
+
+### 响应示例
+
+```json
+[
+  {
+    "id": "a2696b9e-2277-11f1-b4c6-00163e0c7c4f",
+    "locationCode": "LOC-1",
+    "locationName": "Downtown Kitchen",
+    "fullAddress": "123 Main St, New York, NY 10001",
+    "state": true
+  }
+]
+```
+
+### 常见错误
+
+- 未登录或 Token 无效：按网关/ABP 返回 401 及统一错误体
+- 无用户上下文：`用户未登录`
+
+---
+
+## 与其他登录方式的区别
+
+| 场景 | 说明 |
+|------|------|
+| Web 管理端 | 仍使用 RBAC **`AccountService.PostLoginAsync`**，一般为人 **`userName`** + 密码 |
+| 美国版 App | **仅**本模块 **`/api/app/us-app-auth/login`** 使用 **邮箱 + 密码** |
+
+两者共用同一 `User` 表与 JWT 体系；App 端需保证账号已维护 **`Email`** 字段，否则无法通过邮箱登录。