+
+
+ )
+}
+
+/* 详情页路径不在导航表里，给它们一批前缀标题，免得浏览器标签只剩系统名 */
+const DETAIL_TITLES = [
+ ['/customers/', '客户详情'],
+ ['/inquiries/', '询盘详情'],
+ ['/products/', '产品详情'],
+ ['/suppliers/', '供应商详情']
+]
+
+function pageTitleFor(pathname) {
+ if (PAGE_LABELS[pathname]) return PAGE_LABELS[pathname]
+ const hit = DETAIL_TITLES.find(([prefix]) => pathname.startsWith(prefix))
+ return hit ? hit[1] : ''
+}
+
+/** 路由懒加载时的过渡态：不白屏，给一条顶部进度线 + 一句提示 */
+function RouteFallback() {
+ return (
+ 正在载入 {brand.name}…
+
+
+
+ )
+}
+
+function NoPermission() {
+ return (
+ 正在载入…
+
+
+ )
+}
+
+/** 路由级权限守卫：与侧栏用的是同一份 ROUTE_PERMISSIONS，不会两处不一致 */
+function Guarded({ permission, children }) {
+ const { user } = useAuth()
+ if (permission && !hasPermission(user, permission)) return
+
+ 无访问权限
+ + 当前角色所属的权限组没有该模块的查看权限。请让管理员在「权限组管理」里把该角色指派到有权限的组。 +
+
- {/* 只有设置是模态；「小皮」是浮窗，不能再 inert 主界面，否则没法边聊边操作 */}
-
- {/* 顶栏横跨整宽，压在侧边栏之上 */}
- setAssistantOpen(true)} />
+
-
+ {/* 只有设置是模态；「小皮」是浮窗，不能再 inert 主界面，否则没法边聊边操作 */}
+
+
+ )
+ }
+ return
+
+
+
)
}
export default App
-
-
-
-
-
diff --git a/frontend/src/amountInWords.js b/frontend/src/amountInWords.js
new file mode 100644
index 0000000..e3f0658
--- /dev/null
+++ b/frontend/src/amountInWords.js
@@ -0,0 +1,142 @@
+/**
+ * 金额英文大写（外贸单证用）
+ *
+ * 目标格式与信用证 / 发票上的写法一致：
+ * 255.36 USD → SAY US DOLLARS TWO HUNDRED AND FIFTY-FIVE AND THIRTY-SIX CENTS ONLY
+ * 1000 CNY → SAY CHINESE YUAN ONE THOUSAND ONLY
+ * 0.5 EUR → SAY EUROS ZERO AND FIFTY CENTS ONLY
+ *
+ * 几条实务约定（不是「随便翻译一下」）：
+ * 1. 整句以 SAY 开头、以 ONLY 结尾，这是单证上的固定套路。
+ * 2. 百位与十位之间用 AND（英式写法），如 TWO HUNDRED AND FIFTY-FIVE。
+ * 「组」与「组」之间不重复加 AND，避免 ONE THOUSAND AND TWO HUNDRED AND ... 这种啰嗦写法。
+ * 3. 货币名固定用复数形式（US DOLLARS / EUROS），因为这里是货币名称而非计量词，
+ * 单证上不写 ONE US DOLLAR。
+ * 4. 日元等无小数币种不带辅币段；小数位按币种配置取。
+ */
+
+/* 0-19 单独记，20 以上由十位 + 个位拼 */
+const ONES = [
+ '', 'ONE', 'TWO', 'THREE', 'FOUR', 'FIVE', 'SIX', 'SEVEN', 'EIGHT', 'NINE',
+ 'TEN', 'ELEVEN', 'TWELVE', 'THIRTEEN', 'FOURTEEN', 'FIFTEEN', 'SIXTEEN',
+ 'SEVENTEEN', 'EIGHTEEN', 'NINETEEN'
+]
+const TENS = ['', '', 'TWENTY', 'THIRTY', 'FORTY', 'FIFTY', 'SIXTY', 'SEVENTY', 'EIGHTY', 'NINETY']
+const SCALES = ['', 'THOUSAND', 'MILLION', 'BILLION', 'TRILLION']
+
+/**
+ * 币种配置。
+ * head —— 大写句里跟在 SAY 后面的货币名（固定复数）
+ * centsHead —— 辅币名（固定复数）
+ * decimals —— 该币种的小数位（日元等为 0）
+ */
+const CURRENCY_WORDS = {
+ USD: { head: 'US DOLLARS', centsHead: 'CENTS', decimals: 2 },
+ CNY: { head: 'CHINESE YUAN', centsHead: 'FEN', decimals: 2 },
+ EUR: { head: 'EUROS', centsHead: 'CENTS', decimals: 2 },
+ GBP: { head: 'POUNDS STERLING', centsHead: 'PENCE', decimals: 2 },
+ HKD: { head: 'HONG KONG DOLLARS', centsHead: 'CENTS', decimals: 2 },
+ JPY: { head: 'JAPANESE YEN', centsHead: 'SEN', decimals: 0 },
+ AUD: { head: 'AUSTRALIAN DOLLARS', centsHead: 'CENTS', decimals: 2 },
+ CAD: { head: 'CANADIAN DOLLARS', centsHead: 'CENTS', decimals: 2 },
+ SGD: { head: 'SINGAPORE DOLLARS', centsHead: 'CENTS', decimals: 2 },
+ NZD: { head: 'NEW ZEALAND DOLLARS', centsHead: 'CENTS', decimals: 2 },
+ CHF: { head: 'SWISS FRANCS', centsHead: 'CENTIMES', decimals: 2 },
+ KRW: { head: 'SOUTH KOREAN WON', centsHead: 'JEON', decimals: 0 },
+ TWD: { head: 'NEW TAIWAN DOLLARS', centsHead: 'CENTS', decimals: 2 },
+ MOP: { head: 'MACAO PATACAS', centsHead: 'AVOS', decimals: 2 },
+ AED: { head: 'UAE DIRHAMS', centsHead: 'FILS', decimals: 2 },
+ SAR: { head: 'SAUDI RIYALS', centsHead: 'HALALAS', decimals: 2 },
+ MYR: { head: 'MALAYSIAN RINGGIT', centsHead: 'SEN', decimals: 2 },
+ THB: { head: 'THAI BAHT', centsHead: 'SATANG', decimals: 2 },
+ VND: { head: 'VIETNAMESE DONG', centsHead: 'XU', decimals: 0 },
+ IDR: { head: 'INDONESIAN RUPIAH', centsHead: 'SEN', decimals: 0 },
+ PHP: { head: 'PHILIPPINE PESOS', centsHead: 'CENTAVOS', decimals: 2 },
+ INR: { head: 'INDIAN RUPEES', centsHead: 'PAISE', decimals: 2 },
+ RUB: { head: 'RUSSIAN RUBLES', centsHead: 'KOPECKS', decimals: 2 },
+ BRL: { head: 'BRAZILIAN REALS', centsHead: 'CENTAVOS', decimals: 2 },
+ MXN: { head: 'MEXICAN PESOS', centsHead: 'CENTAVOS', decimals: 2 },
+ ZAR: { head: 'SOUTH AFRICAN RAND', centsHead: 'CENTS', decimals: 2 },
+ TRY: { head: 'TURKISH LIRA', centsHead: 'KURUS', decimals: 2 },
+ PLN: { head: 'POLISH ZLOTYS', centsHead: 'GROSZY', decimals: 2 },
+ SEK: { head: 'SWEDISH KRONOR', centsHead: 'ORE', decimals: 2 },
+ NOK: { head: 'NORWEGIAN KRONER', centsHead: 'ORE', decimals: 2 },
+ DKK: { head: 'DANISH KRONER', centsHead: 'ORE', decimals: 2 },
+ CZK: { head: 'CZECH KORUNAS', centsHead: 'HALERU', decimals: 2 },
+ HUF: { head: 'HUNGARIAN FORINTS', centsHead: 'FILLER', decimals: 2 },
+ EGP: { head: 'EGYPTIAN POUNDS', centsHead: 'PIASTRES', decimals: 2 }
+}
+
+/** 1–999 转英文。百位后若有非零余数，按英式写法补 AND。 */
+function belowThousand(n) {
+ const parts = []
+ const hundreds = Math.floor(n / 100)
+ const rest = n % 100
+ if (hundreds) parts.push(`${ONES[hundreds]} HUNDRED`)
+ if (rest) {
+ if (hundreds) parts.push('AND')
+ if (rest < 20) parts.push(ONES[rest])
+ else {
+ const ten = Math.floor(rest / 10)
+ const one = rest % 10
+ parts.push(one ? `${TENS[ten]}-${ONES[one]}` : TENS[ten])
+ }
+ }
+ return parts.join(' ')
+}
+
+/** 非负整数转英文，按千分位分组。 */
+function integerToWords(value) {
+ if (!Number.isFinite(value) || value <= 0) return 'ZERO'
+ const groups = []
+ let rest = Math.floor(value)
+ let scale = 0
+ while (rest > 0) {
+ const group = rest % 1000
+ if (group) {
+ const words = belowThousand(group)
+ groups.unshift(SCALES[scale] ? `${words} ${SCALES[scale]}` : words)
+ }
+ rest = Math.floor(rest / 1000)
+ scale += 1
+ }
+ return groups.join(' ')
+}
+
+/** 取币种配置；没登记的币种按 2 位小数 + 代码本身当货币名处理。 */
+export function currencyWordsMeta(code) {
+ const key = String(code || 'USD').toUpperCase()
+ return CURRENCY_WORDS[key] || { head: key, centsHead: 'CENTS', decimals: 2 }
+}
+
+/**
+ * 金额转英文大写。
+ * @param {number|string} amount 金额
+ * @param {string} currency 币种代码
+ * @returns {string} 形如 "SAY US DOLLARS ... ONLY"；输入无法识别时返回空串
+ */
+export function amountToWords(amount, currency = 'USD') {
+ const num = typeof amount === 'number' ? amount : Number(String(amount ?? '').replace(/[,\s]/g, ''))
+ if (!Number.isFinite(num)) return ''
+
+ const meta = currencyWordsMeta(currency)
+ const factor = Math.pow(10, meta.decimals)
+ /* 先四舍五入到「最小单位」，避免 255.36 这类浮点误差把小数位算成 35.999… */
+ const total = Math.round(Math.abs(num) * factor)
+ const major = Math.floor(total / factor)
+ const minor = total % factor
+
+ const parts = [`SAY ${meta.head}`]
+ if (major > 0 || minor === 0) parts.push(integerToWords(major))
+ if (minor > 0) {
+ // 有辅币时，主币为 0 也要读作 ZERO（单证上不会省略）
+ if (major === 0) parts.push('ZERO')
+ parts.push('AND')
+ parts.push(integerToWords(minor))
+ parts.push(meta.centsHead)
+ }
+ parts.push('ONLY')
+
+ /* 负数在贸易单证里没有位置，但真出现了也别把符号吞掉 */
+ return (num < 0 ? 'MINUS ' : '') + parts.join(' ')
+}
diff --git a/frontend/src/auth.jsx b/frontend/src/auth.jsx
new file mode 100644
index 0000000..42b5198
--- /dev/null
+++ b/frontend/src/auth.jsx
@@ -0,0 +1,103 @@
+import React, { createContext, useCallback, useContext, useEffect, useMemo, useState } from 'react'
+import axios from 'axios'
+
+/**
+ * 会话上下文：全局唯一的「当前用户是谁」答案来源。
+ *
+ * 为什么不把用户信息塞进 localStorage：
+ * 改了个人资料 / 换了角色之后，前端必须立刻拿到新值。所以只依赖后端的会话 cookie，
+ * 启动时打一次 /api/auth/me，之后由各处的 setUser / refresh 回写。
+ */
+const AuthContext = createContext(null)
+
+export function AuthProvider({ children }) {
+ const [user, setUser] = useState(null)
+ const [loading, setLoading] = useState(true)
+
+ /* 启动时确定登录态 */
+ useEffect(() => {
+ let alive = true
+ ;(async () => {
+ try {
+ const { data } = await axios.get('/api/auth/me')
+ if (alive) setUser(data?.user || null)
+ } catch {
+ if (alive) setUser(null)
+ } finally {
+ if (alive) setLoading(false)
+ }
+ })()
+ return () => { alive = false }
+ }, [])
+
+ /* 任何接口返回 401（会话过期 / 被踢），就地清空登录态，界面自然回登录页 */
+ useEffect(() => {
+ const id = axios.interceptors.response.use(
+ response => response,
+ error => {
+ const status = error?.response?.status
+ const url = String(error?.config?.url || '')
+ const isAuthProbe = url.includes('/api/auth/login') || url.includes('/api/auth/me')
+ if (status === 401 && !isAuthProbe) setUser(null)
+ return Promise.reject(error)
+ }
+ )
+ return () => axios.interceptors.response.eject(id)
+ }, [])
+
+ const refresh = useCallback(async () => {
+ try {
+ const { data } = await axios.get('/api/auth/me')
+ setUser(data?.user || null)
+ return data?.user || null
+ } catch {
+ setUser(null)
+ return null
+ }
+ }, [])
+
+ const login = useCallback(async (username, password) => {
+ const { data } = await axios.post('/api/auth/login', { username, password })
+ setUser(data.user)
+ return data.user
+ }, [])
+
+ const logout = useCallback(async () => {
+ try {
+ await axios.post('/api/auth/logout')
+ } catch { /* 会话可能已过期，忽略 */ }
+ setUser(null)
+ }, [])
+
+ const value = useMemo(
+ () => ({ user, loading, login, logout, refresh, setUser }),
+ [user, loading, login, logout, refresh]
+ )
+ return {children}
+}
+
+export function useAuth() {
+ const context = useContext(AuthContext)
+ if (!context) throw new Error('useAuth 必须在 AuthProvider 内使用')
+ return context
+}
+
+/** 权限判断：系统管理员兜底全通过，其余按角色所属权限组的权限点判断 */
+export function hasPermission(user, key) {
+ if (!user) return false
+ if (user.role === 'admin') return true
+ return Array.isArray(user.permissions) && user.permissions.includes(key)
+}
+
+/** 角色英文值 → 中文标签 */
+export const ROLE_LABELS = {
+ admin: '系统管理员',
+ chairman: '董事长',
+ general_manager: '总经理',
+ sales_manager: '销售经理',
+ sales_rep: '销售业务员'
+}
+
+export function roleLabel(role) {
+ return ROLE_LABELS[role] || role || '—'
+}
diff --git a/frontend/src/branding.js b/frontend/src/branding.js
new file mode 100644
index 0000000..77e3e5e
--- /dev/null
+++ b/frontend/src/branding.js
@@ -0,0 +1,73 @@
+import { useEffect, useState } from 'react'
+import axios from 'axios'
+
+/**
+ * 系统标识与公司名 —— 全局唯一来源。
+ *
+ * 口径（Wayne 2026-09-15 定）：
+ * - **系统名固定不可改**：`name` / `subtitle` 恒为后端给的固定署名，
+ * 登录页、顶栏、启动页、浏览器标题全用它，也**不跟随组织名**（引流用）。
+ * - **公司名（组织名）可改**：只在设置页与组织下拉里出现，不影响界面牌子。
+ *
+ * 用法：
+ * 组件里 const brand = useBranding() ← brand.name / brand.subtitle 是只读的
+ * 设置页标题 setPageTitle('用户管理') ← 页面别自己拼 document.title
+ */
+
+const FALLBACK = {
+ name: 'happy出口通',
+ subtitle: 'Ai Export System',
+ system_locked: true,
+ org_name: '',
+ org_id: null
+}
+
+let state = { ...FALLBACK }
+let currentPage = null
+let loading = null
+const listeners = new Set()
+
+function emit() {
+ for (const listener of listeners) {
+ try { listener(state) } catch { /* 某个订阅者出错不该拖垮其他订阅者 */ }
+ }
+}
+
+/** 页面标题统一在这里拼：品牌名变了，标题里的旧名也会跟着更新 */
+export function setPageTitle(page) {
+ currentPage = page || null
+ document.title = currentPage ? `${currentPage} · ${state.name}` : state.name
+}
+
+export function getBranding() {
+ return state
+}
+
+/** 保存成功后立刻套用，不用等下次刷新 */
+export function applyBranding(patch) {
+ state = { ...state, ...(patch || {}) }
+ setPageTitle(currentPage)
+ emit()
+ return state
+}
+
+/** 启动时拉一次；失败就用兜底值（后端挂了也不该白屏） */
+export function loadBranding() {
+ if (loading) return loading
+ loading = axios
+ .get('/api/system/branding')
+ .then(({ data }) => applyBranding(data))
+ .catch(() => state)
+ return loading
+}
+
+export function useBranding() {
+ const [value, setValue] = useState(state)
+ useEffect(() => {
+ setValue(state)
+ listeners.add(setValue)
+ loadBranding()
+ return () => listeners.delete(setValue)
+ }, [])
+ return value
+}
diff --git a/frontend/src/components/AIAssistant.jsx b/frontend/src/components/AIAssistant.jsx
index cd54e84..0e8c2f4 100644
--- a/frontend/src/components/AIAssistant.jsx
+++ b/frontend/src/components/AIAssistant.jsx
@@ -1,9 +1,9 @@
import React, { useEffect, useMemo, useRef, useState } from 'react'
import axios from 'axios'
-import { BotIcon, CloseIcon, MinusIcon, SendIcon, SparkIcon } from './Icons'
+import { AIBotIcon, CloseIcon, MinusIcon, SendIcon, UserIcon } from './Icons'
const POS_KEY = 'happy.aiPos'
-const WIN_WIDTH = 348
+const WIN_WIDTH = 440
const starterMessages = [
{ role: 'assistant', text: '我是小皮，你的外贸业务助理。可以帮你查客户、产品、供应商、订单、商机和待办，也能代你发起系统内的操作。' },
@@ -135,22 +135,27 @@ function AIAssistant({ isOpen, onClose }) {
onDoubleClick={() => setMinimized(value => !value)}
>
@@ -159,11 +164,11 @@ function AIAssistant({ isOpen, onClose }) {
+ {/* 顶栏横跨整宽，压在侧边栏之上 */}
+ setAssistantOpen(true)} onNavigate={guardedNavigate} />
-
+ )
+}
+
+/* -------------------------------------------------------------- 分流 */
+
+function AppRoutes({ theme, onThemeChange }) {
+ const { user, loading } = useAuth()
+
+ if (loading) return
-
-
+
-
[COPILOT]
+ 小皮
+ BUSINESS COPILOT
+
小皮
+ 你的外贸业务助理 +
- {!minimized && }
+ {!minimized && 在线}
-
已连接系统业务层可读取模块数据，敏感写操作会先请求确认
✓{capability}
)}我能帮你
{capabilities.map(capability => ✓{capability}
)}当前数据快照{context.stats?.customers || 0} 客户{context.stats?.products || 0} 产品{context.stats?.orders || 0} 订单
}
- {messages.map((message, index) => )}
- {loading &&
{message.role === 'assistant' ?
{message.text}
{message.meta && {message.meta}}{message.role === 'assistant' ?
{message.text}
{message.meta && {message.meta}}
+
+ )
+ }
+
+ const { overview = {} } = config
+
+ /* 编辑弹窗里跟着「接口兼容模式」走派生值：示例、后缀说明、填错提示 */
+ const activeMode = editor
+ ? (config.modes || []).find(item => item.value === editor.form.mode) || null
+ : null
+ const baseAdvice = editor ? baseUrlAdvice(editor.form.mode, editor.form.base_url) : null
+
+ return (
+ 智能配置
+正在读取模型接入配置…
+
+
智能配置
++ 接入一家或多家大模型服务，再把不同用途派给不同模型 —— 合同解析用长文本强的， + 图片识别用多模态的，日常对话用便宜的。全部配置存在本机数据库，换电脑登录即生效。 +
+ +
+
+
+ {notice && {overview.provider_count || 0}已接入
+ {overview.healthy_count || 0}测试通过
+ {overview.assigned_purposes?.length || 0}/{config.purposes.length}用途已分配
+ {overview.last_test_at ? fmtTime(overview.last_test_at).slice(5, 16) : '—'}最近测试
+
+
+
+ {/* ---------------- 用途分配 ---------------- */}
+
+
+
+ {config.providers.length === 0
+ ? 模型接入
+
+
+
+
+ + 还没有接入任何模型服务。可以从下面的常用预设开始（DeepSeek / 通义 / Kimi / Claude / 本地 Ollama 等）， + 也可以完全自定义。不接也能用系统 —— 只是「小皮」会退回到本地规则直答。 +
+ : ( +-
+ {config.providers.map(provider => {
+ const test = provider.last_test
+ return (
+
-
+ +++ {provider.name} + {provider.preset_label} + {provider.mode === 'anthropic' ? 'Anthropic 协议' : 'OpenAI 兼容'} + {!provider.enabled && 已停用} ++++ {test && ( +
{provider.base_url}+ 密钥 {provider.has_key ? provider.key_masked : '（未填写，本地服务可留空）'} + {provider.models.length} 个可用模型 ++ {test.ok ?+ )} +: } + {test.detail} + {fmtTime(test.at)} · {test.latency_ms}ms + + + + + + ++ + {modelPanel?.providerId === provider.id && ( +++ )} ++ 可用模型（{modelPanel.models.length}） + {modelPanel.detail}{modelPanel.source === 'preset' ? ' · 预设推荐' : ''} +++ {modelPanel.models.map(model => { + const checked = modelPanel.selected.includes(model) + return ( + + ) + })} +++ + ++
+ )
+ })}
+
+
+
+
+ )}
+
+
+ {/* ---------------- 试跑 ---------------- */}
+
+
+
+ {config.providers.length === 0
+ ? 按用途分配模型
+
+ 已分配 {assignedCount}/{config.purposes.length}
+
+
+ 先在上面接入至少一家模型服务，这里就能选了。
+ : ( +| 用途 | 说明 | 使用的模型 | |
|---|---|---|---|
| + {purpose.label} + {purpose.vision && 需多模态} + | +{purpose.hint} | ++ + | ++ {draft[purpose.key] && ( + + )} + | +
+
+
+ 验证一下
++ 用「智能助手对话」分配到的模型发一句话，确认配置真的通了。未分配时会提示先去做分配。 +
+
+ setProbe(current => ({ ...current, prompt: event.target.value }))}
+ onKeyDown={event => { if (event.key === 'Enter') runProbe() }}
+ />
+
+
+ {probe.reply && {probe.reply}}
+ {probe.error &&
+
!busy && setEditor(null)}>
+
event.stopPropagation()}>
+
+
+