持續更新中的雲端 POS

系統更新日誌

我們會持續為 VibePOS 加入新功能、修正問題與優化使用體驗。 在這裡,你可以清楚看到每一個版本的改變,讓系統演進一目了然。

版本 1.8.02026-04最新版本

新增

  • 交易風險告警:訂單交易風險偵測與告警流程、專用設定頁與模組整合、過期紀錄清理,以及頁面功能與視覺優化。
  • 功能模組與金鑰體系:功能模組註冊表與商家隔離、模組守門框架與擴充說明頁;模組金鑰生成/雜湊、兌換、發行與列表;健身房產業包與方案檢查;信用卡等支付方式依模組與方案顯示或停用。
  • 街口支付(JkoPay):線下交易整合。
  • 關帳單列印:關帳單出單機/熱感列印支援,並強化列印錯誤訊息。
  • 商品、圖片與顯示:商品軟刪除與定時清理;圖片上傳前處理與批次上傳(壓縮、格式、HEIC/HEIF 檢查、安全路徑、EXIF 與邊長限制);後端媒體 URL 解析以穩定載入;顯示設定可選隱藏零庫存商品;訂單面板支援規格專屬圖片。
  • 排班與時間:時間選擇元件、日期選擇器與班次時間選擇,銜接排班/考勤流程與載入狀態(含 PageLoading)。
  • 超級管理與小印:超級管理後台 VibePOS 小印裝置管理與錯誤處理;商家即時通知 WebSocket 消費者;小印服務版本與 mDNS 廣播對齊 package 版本。
  • 系統操作日誌:操作日誌報表與權限、過濾與顯示強化、清理任務與 Celery 排程指定調度檔。
  • 品牌識別:VibePOS 標誌 SVG、側邊欄 Logo 響應式邏輯,以及清單/應用程式圖示更新。

改進

  • 權限與角色:大規模權限鍵與頁面檢查整合(訂單、商品、庫存、採購、類別、標籤、折扣、發票、顧客、金流、關帳、考勤、報表等);角色權限動態更新與模組權限自動填充;報表查看、庫存異動匯出、開啟錢箱等細部權限;簡化部分權限結構(如終端機相關權限移除)。
  • 訂單與結帳:退貨流程與體驗、訂單面板折扣與儲值邏輯、結帳流程體驗;請求取消時錯誤靜默處理。
  • 商品列表與搜尋:桌面虛擬化與效能、載入狀態與圖片載入、分頁與快取、排序與前端設定同步、SKU 篩選搜尋、產品圖片顯示優化。
  • 採購與方案:AI 採購單配額依方案與配額查詢;標籤佈局預覽;計劃功能與商品列表顯示聯動。
  • 硬體與報表:硬體服務門市參數與錯誤碼、標籤/硬體權限;報告頁操作標籤;移除 30×40 標籤模板;Print Hub 頁面狀態與樣式。
  • 基礎設施:Nginx CORS/預檢與超時、Docker Compose 與前端照片上傳銜接;SWR 強制重新驗證;庫存調整與退貨流程冗餘日誌精簡。

修正

  • 圖片上傳路徑、目錄重複與共同根目錄處理;批次上傳錯誤提示。
  • 產品變體建立邏輯(避免誤刪新建變體)、產品詳情庫存編輯與圖片樣式。
  • 日期時間以台灣時區顯示、Windows 路徑大小寫、頁籤標題格式、Excel 空白列判斷。
  • 類別選項資料格式、商家設定與權限中介層、用戶電話欄位與錯誤訊息、模組搜尋布局與金鑰兌換說明等細節。
版本 1.7.02026-03

新增

  • AI 採購單解析:後端解析任務、管線與稽核;採購面板與 AI 採購導入對話框整合;支援以 opencc-js 進行繁體中文轉換及對應型別定義。
  • AI 成本中心與加購:超級管理後台 AI 成本中心頁面與導航;加購模組、配額管理,以及 AI 一鍵建檔相關權限擴充。
  • 顧客儲值:儲值功能與對應權限管理。
  • 進貨單成本與合併:進貨成本驗證與合併相關後端與前端支援。

改進

  • 庫存與採購體驗:庫存頁與採購面板銜接 AI 解析;庫存表格與各類列表對話框的顯示與互動優化。
  • 系統統計:管理端統計視圖支援動態欄位選擇。
  • 標籤版面:標籤佈局頁支援倉庫 ID 解析。
  • AI 一鍵建檔與商品狀態:解析管線、快速創建對話框與錯誤處理/樣式;產品狀態與新產品狀態顯示邏輯。
  • 商家與商品詳情:商家設定合併流程與產品詳細頁更新。
  • 登入與帳號資料:登入表單錯誤處理與 API 連線錯誤日誌;Google 頭像 URL 欄位擴充與截斷邏輯。
  • 介面細節:PageBackButton 文字顯示;對話框組件樣式調整。
版本 1.6.02026-03

新增

  • AI 一鍵新增商品:新增拍照裁切 OCR 與高精度商品解析流程,並補齊後端處理邏輯,提升商品建檔自動化效率。
  • LINE Pay Offline API v4:新增 v4 客戶端與多種支付操作支援,包含更完整的參數帶入與授權/查詢流程串接。
  • LINE Pay 後台能力:擴充 PaymentsPage 與管理介面設定能力,補強上線環境配置與操作入口。
  • 標籤列印能力擴充:新增更多商品欄位與條碼元素支援,強化預設版面、動態尺寸計算與商家資訊處理。
  • 顧客報表與試用資料欄位:新增顧客報表儲值統計分析能力,並加入試用商家使用時間欄位與相關邏輯。

改進

  • 標籤版面設定體驗:重構標籤版面設定頁,優化拖曳調整、元素管理、用語一致性、響應式佈局與操作清晰度。
  • 訂單與報表頁體驗:改善訂單退款流程、日期選擇初始化、報告頁資料處理與頁面載入狀態,提升互動穩定性。
  • LINE Pay 操作流程:優化操作介面、離線操作錯誤處理與交易紀錄查詢邏輯,降低支付流程中斷機率。
  • 行動端可用性:調整手機版標籤編輯頁面的限制與提示,讓小螢幕操作更一致。

修正

  • 修正 LINE Pay 授權與付款明細查詢、交易紀錄查詢與支付方式回退提示等流程細節。
  • 修正 LINE Pay 參數空白字元與 Offline API v4 `product_name` 參數處理問題,避免請求異常。
  • 修正標籤列印條碼驗證與格式(含英數與連字號)、條碼寬高參數與按鈕可見性問題。
  • 修正 CheckoutDialog 提示文案與相關前端互動細節,提升結帳操作一致性。
版本 1.5.02026-03

新增

  • 電子發票處理與列印強化:新增電子發票證明聯與銷貨明細單列印、PDF 匯出、折讓單開立與作廢、折讓期限檢查、隨機碼顯示、字軌狀態查詢,以及手動開立發票與統編/愛心碼查詢等功能,使發票流程更完整。
  • 收據與 ESC/POS 列印:新增 ESC/POS 收據生成與列印、58mm 收據排版、QR Code 與條碼列印、收據預覽與補印功能,並支援圖片轉熱感列印點陣圖與縮放,統一前後端收據顯示效果。
  • VibePOS 小印與標籤列印:擴充 VibePOS 小印裝置管理與診斷功能,新增商品/採購單標籤列印對話框、自訂標籤模板與尺寸、標籤狀態檢查與測試列印,並整合 TSPL SDK 及硬體識別/配對金鑰機制。
  • 多終端與班次管理:新增多終端機管理與檢視、班次關帳摘要查詢、自動生成開班/結班點錢紀錄,以及智能找零建議等功能,優化收銀與結帳作業。
  • 商家與供應商管理:新增商家加入申請與審核流程、商家擁有者刪除保護、公司名稱查詢與預設發票課稅別設定,並在商品資料中加入供應商關聯欄位以支援進貨與標籤列印場景。

改進

  • 結帳與庫存流程:優化 CheckoutDialog 與 OrderPanel 的緩存與錯誤處理邏輯,支援混合付款與現金支付流程調整,改善庫存更新與負庫存檢查,確保訂單與庫存狀態一致。
  • 電子發票體驗:重構 InvoicePreviewModal 與相關前端頁面,統一按鈕與版面配置,改善 B2C/B2B 顯示模式切換、補印標籤與隨機碼呈現。
  • 硬體與小印服務:優化硬體錯誤碼對應、設備節點解析與日誌內容,新增硬體診斷資料回傳與私有 IP 檢查,使問題排查更容易。
  • 多終端與班次體驗:強化多終端機列表與操作介面,優化排程與班次頁面樣式與響應式設計,讓班次管理與日結更直覺。
  • 後台設定與商家管理:統一刪除與確認對話框樣式、調整員工與顧客頁面的 Sheet/Drawer 使用方式,改善商家設定頁面與電子發票設定的表單與錯誤處理。
  • 報表與快取:新增報表圖表匯出 PDF/圖片的能力,並改進商品列表快取失效與 SWR 全域更新邏輯,提升資料一致性與效能。

修正

  • 修正 EInvoiceSettingsViewSet 權限檢查、電子發票日期與標題處理邏輯,以及多處與光貿 API 互動的細節問題。
  • 修正收據與發票按鈕事件與狀態更新邏輯,確保補印、預覽與下載流程正確。
  • 修正負庫存查詢與庫存緩存更新邏輯,排除軟刪除商品並避免庫存不足錯誤。
  • 修正 Docker 部署過程中的設定檔備份與還原、cron 任務執行權限與文件路徑等問題,提升部署穩定性。
  • 修正多處樣式與佈局細節(標籤頁、設定頁、排程頁、產品詳情與列表等),提升桌面與手機版的一致性與可用性。
版本 1.4.32026-03

新增

  • VibePOS 小印(Print Hub):小印服務架構、裝置管理與 API、雲端連線、裝置配對與友好名稱、位址管理、樹莓派安裝與配置指南
  • WebSocket/ASGI:Django 設定支援 ASGI 與 WebSocket;Nginx 配置支援 WebSocket 通訊
  • 硬體設備管理:硬體設備管理功能與 API 端點、硬體測試頁面重構、小印設定頁面
  • 預設主店:預設主店功能及相關邏輯
  • 商品規格:商品規格選項 API 與前端支援、SpecGenerator 選項切換、快速操作以提升規格管理
  • 驗證與資料:倉庫名稱重複驗證、供應商名稱驗證;庫存顯示顏色邏輯與狀態反饋
  • 緩存與還原:結帳對話框與訂單面板緩存管理、訂單還原邏輯、商家資料備份與還原增強

改進

  • 訂單計算邏輯:支援優惠碼與手動折扣、調整折扣順序
  • 批量編輯與變體表格:標題與價格標籤統一用語;生成變體回調支援追加新變體;產品詳情頁變體 ID 處理
  • SpecGenerator:選項切換、樣式與文案
  • Print Hub 頁:配對裝置邏輯、商家與權限檢查、使用 get_current_business_safe;UI 與用戶體驗
  • storesService 改為使用新 API 封裝
  • 庫存/商品緩存管理與即時性改進
  • 批量編輯顏色對話框體驗改進
  • 打卡確認對話框改為 Sheet 以適應手機;移除出勤統計卡片以簡化界面

修正

  • 伺服器啟動日誌顯示區網 IP 與端口
  • 移除 WebSocket 的 AllowedHostsOriginValidator 包裝
  • 方案資訊獲取錯誤處理
  • TransferPanel 新增倉庫或門市選項樣式
  • 產品變體價格驗證邏輯
版本 1.4.22026-03

新增

  • 規格生成器(SpecGenerator):依維度一鍵生成產品變體,提升變體管理效率
  • 商家設定上下文(BusinessSettingsProvider):統一商家設定狀態與 API,支援業務邏輯
  • 庫存調整功能:支援產品變體建立時的初始庫存、自動產生庫存調整記錄
  • 庫存編輯增強:批次導入/編輯頁支援庫存數量編輯與可編輯性控制(allowStockEdit)
  • 今日出勤統計卡片:顯示今日出勤、遲到、早退、缺勤人數
  • 產品名稱編輯:批次變體表格內可即時編輯產品名稱
  • 批次導入按鈕邏輯:查看商品列表時標記快取失效並帶刷新參數
  • 條碼生成邏輯:統一條碼格式(顏色碼、尺寸碼、隨機碼)、`buildUniqueBarcode` 從 utils 匯入

改進

  • 產品數據緩存:無篩選且緩存 0 筆時改為即時 API,避免過時緩存;背景更新時正確處理 `total_product_count`
  • 折扣頁:後端折扣數值轉為「優惠% off」顯示、表單提交折扣計算與提示文案
  • GridLayout 類型擴展與 `handleGridLayoutChange` 支援更靈活佈局、類型安全
  • 圖片上傳邏輯簡化(移除多餘 Content-Type、ProductDetailPage 一致化)
  • SpecGenerator:標題與按鈕樣式、維度選擇間距與字體、自訂欄位樣式

修正

  • 批次導入:價格可為 0 不可為負、庫存≥0、空值處理;售價必填且不可為負之提示
  • 產品變體價格驗證(ProductDetailPage、VariantTable 數字與空值)
  • 庫存編輯可編輯性:VariantTable 依 `allowStockEdit` 控制庫存/圖片欄位
  • 庫存調整業務上下文:序列化與導入任務改為 `task.business`/`product.business`,前端新增「系統調整」原因
  • 語音識別錯誤提示:依瀏覽器/作業系統提供具體解法(含 Safari、Mac)
  • 錢箱開啟失敗提示:僅在非手機設備顯示
  • VariantCell 數字類型檢查,確保 0 被正確處理

樣式

  • 批次導入頁按鈕樣式(繼續導入邊框與背景過渡)
  • 考勤頁:手機/桌面顯示、打卡地點與重新定位按鈕
  • 排班頁:手機/桌面、班次顏色與員工姓名顯示
  • 顧客頁、OnboardingBanner、BusinessTypeSelect 按鈕與可讀性
版本 1.4.12026-02

改進

  • 多處響應式與樣式調整(發票、折扣、顧客、訂單、庫存、金流、分頁、DatePicker 等)
  • 平板/移動設備體驗:底部導航、側邊欄觸控、浮動購物車、網格佈局選項
  • 強制淺色主題;上傳遮罩與頭像按鈕樣式;類別/標籤唯一性與匯入邏輯

修正

  • 搜尋框焦點檢查、平板報表標籤、產品篩選與網格佈局描述

其他

  • 移除採購面板 Excel 匯入按鈕;刪除色彩與樣式規劃說明文件
版本 1.4.02026-02

新增

  • 支付處理引擎與第三方支付提供者架構、支付方式與圖標擴充
  • 全頁載入模板組件、VariantTable/商品詳情頁載入體驗改善
  • 色彩與樣式規劃說明文件

改進

  • 結帳對話框與訂單詳情按鈕、發票與明細設定版面與一致性
  • 結帳區域間距、電話輸入框、徽章與取消按鈕樣式統一
  • 手機版購物車與玻璃效果導航列樣式

修正

  • 過期優惠券與折扣的啟用檢查
  • 價格標籤與價格顯示格式本地化
版本 1.3.02026-02

新增

  • 公開版本 API:`GET /api/version/`,供官網與各端顯示「VibePOS X.X」
  • 單一版本來源:後端 `vibepos/version.py`,發版時只需更新一處
  • 本更新紀錄(CHANGELOG)
  • 批次匯入:軟刪除恢復、更多屬性、自動生成條碼、Excel 解析、儲存變更按鈕
  • 忘記密碼功能
  • 優惠券與優惠券使用記錄模型

改進

  • 版本號統一由後端版本模組提供;官網可透過版本 API 取得即時版本
  • 電子發票、庫存盤點、折扣、試用註冊、隱私與服務條款、登入表單等響應式與手機版
  • 顧客管理手機版與批量刪除、SheetContent 支援禁用下滑關閉
  • 幫助中心與訂單處理指南、離線模式響應式;產品列表自訂圖標

修正

  • 用戶頁月費顯示計算、供應商無資料提示、商家設置標籤佈局
  • display_id 重複問題與唯一約束;批次編輯返回與商品請求/預載中止機制
版本 1.2.32026-01

新增

  • 電子發票管理(B2C/B2B)、載具、愛心捐贈、發票預覽、作廢/補印
  • 顏色管理(名稱、別名、代碼、重複檢查)
  • 方案權限與功能限制(入門版、試用版)、試用版方案與試用註冊、體驗商家
  • 訂單詳情紅利點數顯示、快速新增客戶鍵盤支援、智慧折扣顯示與移除
  • 手機版結帳/退款/作廢訂單對話框、訂單詳情抽屜、訂單卡片列表、匯出選單
  • InvoiceTrack 新增 business 欄位並回填;角色商家關聯與商家隔離唯一約束

改進

  • 結帳流程(OrderPanel)、退款邏輯(顧客欠點數與紅利)、退貨邏輯、折扣計算(0 或負數 final_amount)
  • 訂單匯出更詳細統計與格式化、發票預覽手機版
  • Google 登入/註冊彈出視窗與錯誤處理、商家擴展與試用狀態驗證
  • 排班與考勤、現金流、報表、硬體測試頁面權限與錯誤處理

修正

  • 已刪除訂單計數、訂單刪除與發票狀態檢查、作廢待處理訂單邏輯
  • 台灣統一編號驗證、訂單金額與發票開立檢查、DialogDescription 與 showToast、hasFeature/usePlanFeatures
版本 1.2.22025-12

新增

  • 商家資料備份與還原(版本 2.0)、紅利點數紀錄、顧客消費紀錄與詳情
  • 允許負庫存設定、庫存原子更新;商品欄位擴展與彈性欄位、自訂變體欄位、包裝欄位
  • 報表擴充:銷售趨勢、商品分析、調整單/調撥單、金流、每週銷售、顧客分析
  • 排班班表與打卡記錄、庫存盤點與掃描頁面
  • 統一分頁組件、每頁筆數設定、日期狀態持久化(localStorage)
  • 系統健康監控 API、效能監控、系統使用日誌;商家統計與儲存空間計算
  • 本地開發環境設置指南、啟動腳本(含 Celery)

改進

  • 訂單列表欄位選擇、日期模式切換、緩存與輪詢;離線 IndexedDB、商品預載、快取管理
  • 商家選擇與側邊欄導航、Sidebar 與 Next.js 路由;備份腳本台灣時區與權限
  • 批量匯入類別/標籤處理、圖片轉 WebP、負庫存與庫存變化邏輯
  • 多業態(100+ 商家類型)、BusinessTypeSelect、側邊欄 Logo、主題色與動態主題

修正

  • 商家切換後卡死與導航失效、localStorage 與 current_business、OfflineSyncProvider 初始化
  • 庫存 expand 參數、成本可為 null、備份還原 created_at 與訂單順序
版本 1.2.12025-11

新增

  • 網域遷移與 vibepos.org、pgAdmin 服務與 Nginx 反向代理
  • 密碼重設與郵件(自簽名 SSL、Roundcube、SMTP/IMAP 配置)
  • 資料庫備份與還原腳本、Docker 支援、清理舊備份
  • display_id 欄位與自動生成(訂單、庫存、商品、顧客類型、支付方式)
  • 離線模式增強:IndexedDB、快取、同步、衝突處理、OfflineIndicator
  • 顏色管理、庫存條碼顯示、商家統計與系統日誌頁、商品重置與壓縮檔上傳
  • 調整/採購/調撥面板數量編輯與表格結構;環境變數與媒體路徑、孤兒檔案清理

改進

  • 商品緩存與標籤頁同步、登入登出與商家關聯、圖片權限與請求大小、CORS
  • 庫存與訂單數據載入、錯誤處理與緩存降級;條碼聚焦與焦點管理
  • Nginx(Trojan-Go、多域名 SSL、Host 分流)、內容安全政策
  • 商家完全重置、刪除與發票/資料一致性;顧客類型與支付方式 display_id 與商家隔離

修正

  • 焦點管理與頁面滾動、StockEntryItem 查詢與 business、顧客刪除與標籤關聯
  • ALLOWED_HOSTS、ProductVariant 可選欄位、備份還原 variant/ CustomerType/ 倉庫欄位
版本 1.2.02025-08

新增

  • 條碼搜尋與掃描、條碼快取與預載、條碼自動聚焦
  • 訂單與商品效能優化(索引、分頁、預載、中止機制)、商品圖片亮度與 CORS
  • 批次圖片上傳、圖片上傳資料夾與大小上限
  • 折扣 TenantModel、類別樹狀、UserProfileSerializer、收據本地化與找零建議
  • 「記住我」登入、BusinessSettingsPage 與 RedirectHandler 優化

改進

  • 訂單查詢與統計、結帳與收據格式、庫存面板商品過濾與權限(get_current_business_safe)
  • 登入與商家關聯檢查、重定向、錯誤處理與超時;權限檢查 BasePermissionMixin
  • 統一載入組件、訂單請求取消、匯出與批次匯入說明、類別載入與 TypeScript
  • 顧客/發票/付款/供應商/倉庫錯誤處理;通知設定權限;訂單作廢與點數差額

修正

  • 條碼掃描與快取、訂單作廢與點數、庫存紀錄筆數、健康檢查 HTTPS
  • 顧客點數負數與 points_deficit、遷移重複、部署後首次登入與登入速度
版本 1.1.32025-07

新增

  • Docker 化後端部署、docker-compose.prod、Nginx、SSL、健康檢查、GitHub Actions 部署
  • 硬體控制與測試頁面(列印、錢箱、VibePOS Local Agent)
  • 收據列印與預覽、結帳對話框收據格式
  • 採購單/調撥單/調整單/結帳/商品篩選設定記憶功能
  • PWA(Service Worker、manifest、離線頁、安裝提示)、OnboardingBanner 與引導步驟
  • SpeechInput 語音輸入、Google OAuth 回調與 state、favicon 與 Logo 更新
  • 設定結構分離(base/development/production)、API 路徑 stores/warehouse

改進

  • 商家設定營業時間、Google 登入驗證與 token、商家設定權限與 403 處理
  • 媒體與頭像 CORS、資料庫重置腳本、環境變數與 dj-database-url
  • 支付方法視圖、引導步驟與數據刷新、Next.js 與 PWA 配置

修正

  • 登入 405 與 URL 順序、商品路徑 /products/products/、中間件與權限、hydration、頭像 URL
  • API 路徑改為相對(避免雙重 /api/)、StoreViewSet get_current_business、pgAdmin 與 Nginx
版本 1.1.22025-06 底~07 初

新增

  • 幫助中心、訂單處理指南、報表分析指南、快速入門指南
  • 密碼設定(Google 用戶無需舊密碼)、電話/信箱/用戶名唯一性、多方式登入
  • 商品批次匯入(Celery、範本下載、Excel、圖片、安全函數)、匯入結果輪詢
  • 多租戶資料隔離(get_current_business)、商品/變體 business 與軟刪除、條碼部分唯一
  • 資料庫重置與超級用戶、隱私政策與服務條款、刪除確認對話框統一
  • 商家代號 8 位、商家選擇與創建、Google OAuth 註冊與 token、申請審核與郵件

改進

  • 批量匯入錯誤處理與類型、商家創建與 UserBusiness、權限組與 Admin 群組
  • 前端 API 路徑統一為相對、權限檢查簡化(view/add/change/delete 等)
  • 用戶頭像與 date_joined、商家設定載入與 403、重定向與商家設定導向
  • 角色描述與前端、庫存/排程權限、商品數量與擴展資訊

修正

  • Hydration、隨機背景與客戶端、商品權限與標籤、門市/倉庫、圖片路徑、多標籤篩選、庫存不足篩選
  • 採購單 API 失敗不創建、token 刷新、調撥單總金額與 record.type、類別篩選
版本 1.1.12025-06 中下旬

新增

  • 多租戶系統(中間件、模型、API、商家創建命令)、商家選擇與創建頁、Google OAuth 註冊
  • 超級管理後台(商家、用戶、申請、方案、日誌、擴展、客服工單)、獨立佈局
  • 金流管理(日收款、收款方式統計、錢箱、班次開始/結束、交易記錄)
  • 訂單狀態與結帳整合、庫存異動、退貨退款、作廢、軟刪除、分頁(最多 10000)
  • 訂單匯出服務(非同步、Excel 樣式)、庫存匯出服務與進度
  • 批次匯入商品頁(上傳、進度、驗證)、結帳對話框付款方式與找零
  • 登入動畫與背景、Google One Tap 說明、商家設置與背景隨機、資料庫重置腳本

改進

  • 訂單總營收扣除退款、智慧折扣欄位、作廢檢查、刪除提示
  • 訂單列表樣式(Glassmorphism)、商品列表與 Table、變體排序、低庫存與缺貨規格
  • 側邊欄與金流入口、API 路徑與權限(支付、排程)、商家創建與 UserBusiness、群組權限
  • 用戶刪除確認、商家創建請求驗證、前端授權標頭、Google 超時與 postMessage

修正

  • 修復多處 API 路徑(/api/xxx/ → xxx/)、商品/分類/標籤/庫存/訂單/排程等 404
  • 權限與 StoreViewSet、批次匯入頁邊距、Google 回調與關閉
版本 1.1.02025-06 上中旬

新增

  • 訂單狀態常數、結帳對話框多種付款、訂單狀態變更時庫存異動
  • 退貨原因快速選擇、訂單詳情退貨資訊、台灣電話驗證與客戶輸入
  • 智慧折扣計算、訂單折扣與紅利、商品/訂單折扣關聯調整、折扣精度與前端計算
  • 訂單作廢(庫存恢復、紅利回收)、訂單退款(按比例、可退數量)、訂單軟刪除
  • 訂單分頁(10~1000)、金流管理前端、現金付款與錢箱記錄、混合付款圖標
  • 日期格子加號、用戶頭像、Toast 重構、考勤地理位置與照片、基本資料與幫助中心、排班班表
  • 商品變體排序、低庫存篩選、缺貨規格提示、訂單匯出與庫存匯出

改進

  • 訂單序列化器與標籤、showToast 統一、訂單計算與紅利、訂單詳情按鈕與指示線
  • 庫存頁 Glassmorphism、訂單頁樣式、商品列表與匯出、採購退回與類型、標籤獨立(商品/訂單/顧客)
  • API 路由優化、庫存項目類型與備註、庫存篩選類型、匯出欄寬、低庫存過濾
  • 側邊欄連結、README、顧客類型與公司名稱查詢、付款管理、設定頁、角色權限、電子發票、用戶管理

修正

  • 登入 URL、商品路徑重複、遷移與中間件、權限與商品頁、圖片與額外圖片、多標籤與搜尋
  • 庫存還原與採購單、調撥單總金額與 record.type、類別篩選、基本資料與修改密碼
版本 1.0.32025-05 底~06 初

新增

  • 角色與權限管理(Django 內建權限)、權限分組 API、新建資料表紀錄
  • 自訂 admin、權限驗證、用戶註冊與 POS PIN、refresh readme
  • 訂單管理模組(日期選擇、搜尋、訂單詳情、退貨退款介面、新增訂單前端)
  • 訂單提交與重置、Liquid Glass 與 tailwindcss-animate、標籤建議、顏色十六進制與訂單計算
  • 訂單狀態與選項、結帳對話框、庫存異動、Toast、退貨原因、訂單詳情退貨與已退數量
  • 台灣電話驗證、客戶輸入、訂單分頁與軟刪除篩選

改進

  • 角色權限前端、商品/庫存/標籤/門市/發票/折扣/顧客權限問題、DEBUG 移除
  • 權限細節重構、登入 405 與 URL 順序、商品路徑、中間件、權限與圖片、批次編輯與即時更新
  • 多標籤與庫存不足篩選、搜尋、採購單、token 刷新、調撥單備註格式、庫存過濾
  • 類別篩選、基本資料、修改密碼、幫助中心、通知設定、打卡與排班前端、時區

修正

  • 員工管理與架構大改、角色列表備註與更新日期、商品/庫存/標籤/門市/發票/折扣/顧客權限
  • 商品頁與庫存頁權限、登入問題、採購單 API、庫存 type/reason 優先
版本 1.0.22025-05 中下旬

新增

  • 付款管理、交易記錄、設定頁(商家、商品、訂單相關)、角色與權限、電子發票管理
  • 用戶管理(CRUD、群組、狀態、日期)、完整姓名、電話、POS PIN、權限檢查、初始化角色權限
  • 折扣功能(訂單/商品折扣、描述、使用次數、適用顧客、已使用次數)、前端折扣頁
  • 自訂管理後台、權限驗證、用戶註冊與角色選擇、POS PIN 驗證
  • 顧客類型管理、公司名稱查詢(統編)、完整卡片標題
  • 訂單管理文件、標籤獨立(商品/訂單/顧客)、OrderTag、API 路由調整、商店頁
  • 庫存項目類型與備註、庫存重置命令、採購退回、進退貨類型、匯出選單、標籤頁樣式
  • 階層式類別、供應商 API、動態下拉、商品標籤管理頁、假資料與 migration

改進

  • 主畫面與側邊欄布局(flex)、Hello World 避免 404、商家管理美化、標籤與類別完善
  • 商品路徑與 API、庫存序列化與變體價格、庫存異動備註、前端庫存過濾與顯示
  • 商品序列化與標籤可選、批次編輯提交、價格顯示最低價、調撥單備註、匯出欄寬、低庫存過濾
  • 啟用停用順序、訂單折扣會員選擇、商品折扣編輯、switch 顏色、折扣頁動態欄位
  • Admin 改中文、員工管理顯示、角色列表、門市/發票/折扣/顧客權限

修正

  • 標題與 badge、排序、供應商分頁格式、商品路徑、庫存數量與備註、採購單操作人與進退貨顯示
  • 欄位比例、遷移與 InventoryItem 類型、商品價格與小計、批次編輯標籤
版本 1.0.12025-04 底~05 初

新增

  • 商品列表、篩選與排序、每頁筆數、搜尋與篩選、庫存不足篩選、匯出與末列總計
  • 新增/編輯商品、圖片與主圖、商品名稱/分類/標籤/描述、商品詳情標籤與分類
  • 採購單雛形、窄 sidebar、商品卡片分頁、新增採購單 UI、條碼輸入、分頁控制與 switch
  • 進退貨/頁碼、假資料、快速設定窗格、顏色列表與別名、選擇規格視窗
  • 庫存頁資料、備註呈現、金額與商品名稱、採購單數量、操作人、分頁、類別篩選、採購單列表
  • 新增/完成調整單、調撥單、倉庫/門市管理、類別/供應商/標籤管理介面、admin 中文
  • 調撥單功能、調整日期精確、門市顯示與提交、原因選取、供應商/倉庫/調整原因互斥
  • 調整前後數量、匯出該頁/全部、採購退回、採購與調整類型、匯出選單、標籤獨立

改進

  • 側邊欄、商品詳情編輯、新增商品與變數名、產品列表圖片、核取方塊與 ID、批次刪除與編輯
  • 庫存管理、sidebar 捲動、選單 focus/hover、單位欄位、供應商 API、Hello World 頁
  • 日期選擇器、搜尋介面、元件貼底、分頁省略、成本與庫存計算、快速設定關閉
  • 庫存記錄過濾、導出欄寬、低庫存過濾、側邊欄連結與樣式
  • README、訂單管理文件、顧客類型與公司名稱查詢、付款與金流、設定頁、角色權限、發票、用戶、折扣

修正

  • 圖片中文路徑、匯出所有商品、sidebar、選單透明、表格對齊、假資料單位、調撥單列表、採購單操作人
  • 一堆 BUG、商品/訂單/顧客標籤 API、get_category_name/get_tag_names、商品 API 路徑
版本 1.0.02025-03~04

新增

  • 初版:紅利系統、Admin 訂單總金額、折扣業務邏輯、最終金額呈現
  • 商品 CRUD API、軟刪除、複製、主圖;換貨;訂單與退貨 API
  • 商品統計報表下載(Excel)、三大報表匯出、Dashboard API(即時庫存、熱門、低庫存)
  • 進貨模組、Dashboard 進貨單、存貨趨勢、一鍵匯入預設顧客分級與標籤、標籤建議 API
  • 重構 inventory、商品入庫與低庫存查詢、requirements.txt
  • 登入(JWT)、註冊、目前使用者、修改密碼、編輯個人資訊、登出、老闆後台編輯
  • 前端專案、完成登入、登出、過期登出、續約、dashboard 主框架、商品頁面、側邊欄
  • 商品列表、分類/標籤、卡片與表格、庫存條圖、排序、每頁筆數、條碼、搜尋與篩選
  • 新增/編輯商品、圖片、主圖、名稱/分類/標籤/描述、詳情編輯
  • 付款方式、退貨模型、金流紀錄 app、條碼補齊與顏色代號
  • 匯出 models、採購單、調撥單、倉庫/門市、調整單、調撥單、庫存管理頁面
  • 庫存紀錄、採購單列表、商品類別篩選、進階搜尋、excel 字型與匯出全部
  • 庫存項目類型、備註、調整前後數量、匯出該頁/全部、採購退回、類型、操作人
  • 交易模組移除、顧客類型、公司名稱查詢、完整卡片標題、訂單管理文件
  • 設定頁(商家、商品、訂單)、付款管理、角色與權限、電子發票、用戶、折扣說明

改進

  • 折扣 Fix、商品與訂單 API、報表字體欄寬檔名、進貨與存貨趨勢、標籤與類別
  • 登入註冊與 JWT、前端登入與過期、dashboard、商品頁、側邊欄、安全庫存移除
  • 商品詳情與規格、垃圾桶可見、單位、顏色、庫存頁、採購單、調整單、調撥單
  • 假資料、API 路由、庫存導出、低庫存過濾、側邊欄與 README

修正

  • 折扣、遷移、line endings、requirements、migration、dup db、標籤篩選、商品總數、商品詳情連結
  • 展開箭頭範圍、新增商品與變數名、Product id null、圖片正方形
  • 清空庫存紀錄、sidebar 捲動、庫存列表樣式、單位、下拉 focus/hover
  • 供應商 API 分頁、主畫面與側邊欄、Hello World 避免 404、標題與 badge、卡片 hover、排序
  • 類別階層、日期選擇器、搜尋介面、元件貼底、採購單 UI、分頁與 switch、進退貨與成本
  • 假資料、快速設定、顏色、庫存顯示、備註、金額、採購單數量、操作人、分頁、類別篩選
  • 商品編輯、單位、分頁、調撥單、門市與提交、原因、供應商/倉庫/調整原因、匯出
  • 調撥單備註、庫存過濾、導出欄寬、低庫存過濾、側邊欄、README、訂單管理文件
  • 顧客類型與公司名稱、付款與金流、設定頁、角色權限、發票、用戶、折扣
  • 啟用停用、會員選擇、商品折扣編輯、switch、折扣頁動態欄位
  • Admin 中文、員工管理、角色列表、權限(標籤/類別/門市/發票/折扣/顧客)
  • 登入 405、商品路徑、中間件、權限與商品頁、圖片、批次編輯、多標籤、庫存不足、搜尋
  • 採購單、調撥單總金額、庫存 type/reason、類別篩選、基本資料、修改密碼、幫助、排班