diff --git a/compose.yaml b/compose.yaml index 20d85a8..a770e3d 100644 --- a/compose.yaml +++ b/compose.yaml @@ -76,6 +76,11 @@ services: container_name: star-erp-proxy extra_hosts: - 'host.docker.internal:host-gateway' + ports: + - '8080:8080' + - '8081:8081' + volumes: + - './nginx/local-proxy.conf:/etc/nginx/conf.d/default.conf:ro' networks: - sail depends_on: diff --git a/nginx/local-proxy.conf b/nginx/local-proxy.conf new file mode 100644 index 0000000..f7e0f7a --- /dev/null +++ b/nginx/local-proxy.conf @@ -0,0 +1,29 @@ +server { + listen 8080; + server_name localhost; + + location / { + proxy_pass http://star-erp-laravel:8080; + proxy_set_header Host $http_host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + proxy_set_header X-Forwarded-Host $http_host; + proxy_set_header X-Forwarded-Port $server_port; + } +} + +server { + listen 8081; + server_name localhost; + + location / { + proxy_pass http://star-erp-laravel:8080; + proxy_set_header Host $http_host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + proxy_set_header X-Forwarded-Host $http_host; + proxy_set_header X-Forwarded-Port $server_port; + } +} diff --git a/public/images/manual/overview_and_login.webp b/public/images/manual/overview_and_login.webp new file mode 100644 index 0000000..2030870 Binary files /dev/null and b/public/images/manual/overview_and_login.webp differ diff --git a/resources/js/Pages/System/Manual/Index.tsx b/resources/js/Pages/System/Manual/Index.tsx index cc0b77b..6d755af 100644 --- a/resources/js/Pages/System/Manual/Index.tsx +++ b/resources/js/Pages/System/Manual/Index.tsx @@ -10,7 +10,7 @@ import { HelpCircle } from "lucide-react"; import { useState } from "react"; -import { ScrollArea } from "@/Components/ui/scroll-area"; + import { Input } from "@/Components/ui/input"; import { cn } from "@/lib/utils"; @@ -69,7 +69,7 @@ export default function ManualIndex({ toc, currentSlug, content }: Props) { - +
{filteredToc.map((section, idx) => (
@@ -96,7 +96,7 @@ export default function ManualIndex({ toc, currentSlug, content }: Props) {
))}
- +
{/* Main Content */} diff --git a/resources/markdown/manual/01-getting-started.md b/resources/markdown/manual/01-getting-started.md new file mode 100644 index 0000000..f83bf36 --- /dev/null +++ b/resources/markdown/manual/01-getting-started.md @@ -0,0 +1,65 @@ +# 新手上路：登入與基本操作 + +歡迎來到 Star ERP！這是一套幫助我們管理庫存、出貨與帳務的系統。 +這篇指南會帶著您完成第一次登入，並熟悉系統的基本畫面。 + +--- + +## 步驟 1：登入系統 + +1. 打開您的網頁瀏覽器（如 Google Chrome 或 Edge）。 +2. 在網址列輸入主管或資訊人員提供給您的**專屬系統網址**。 +3. 您會看到一個登入畫面，請輸入您的： + * **帳號 (Username)** 或 Email + * **密碼 (Password)** +4. 點擊藍色的 **【登入】** 按鈕。 + +> 💡 **小撇步：忘記密碼怎麼辦？** +> 請直接聯繫您的部門主管或資訊人員（IT），他們可以在後台幫您重新設定密碼。 + +### 📸 操作示範動畫：登入與展開選單 +> 以下動畫為您準備了：輸入帳號密碼登入後，在儀表板開啟左側選單的實際連續動作課程。 +> +> ![系統登入與基本操作示範](/images/manual/overview_and_login.webp) + +--- + +## 步驟 2：認識基本畫面 + +登入成功後，您會看到系統的「儀表板」（系統的首頁）。以下是畫面中最重要的三個區域： + +### 1. 左側導覽選單（最重要！） +這裡是系統的所有功能總表。您會看到如 **【商品與庫存管理】**、**【銷售管理】** 等大分類。 +* **想做什麼就在這找**：例如要查庫存，就點開 **【商品與庫存管理】**。 +* **收起/展開選單**：如果您覺得畫面太小，可以點擊左下角的箭頭按鈕「<」把選單收起來；再點一次「>」就會打開。 + +### 2. 頂部導覽列 +畫面的最上方有一排工具列，它的主要功能是： +* **目前位置**：左邊會顯示您現在在哪個畫面（例如：目前在 `商品與庫存管理 > 即時庫存查詢`），幫助您不要迷路。 +* **個人選單**：右上角有您名字的圖示，點擊它可以進行**修改密碼**或**登出**。 + +### 3. 中間工作區 +畫面的正中央就是您操作的主題區。 +* **清單列表**：您建立的訂單或資料都會條列在這裡。 +* **主要按鈕**：通常在列表的右上角，會有藍色的 **【+ 新增】** 按鈕，這是建立新資料最常用的按鍵。 + +--- + +## 步驟 3：如何修改自己的密碼 + +為了保護您的帳號安全，建議您第一次登入後先更改密碼： + +1. 點擊畫面最右上角**您的名字**。 +2. 點擊選單中的 **【個人設定】** 或 **【Profile】**。 +3. 找到更改密碼的區塊。 +4. 依序輸入「舊密碼」、「新密碼」，然後再輸入一次「新密碼」作確認。 +5. 點擊 **【儲存】** 按鈕。 + +> ⚠️ **注意事項：登出系統** +> 當您下班或離開座位較長時間時，建議點擊右上角的您的名字，選擇 **【登出】**，以保護公司資料安全。 + +--- +🎉 **恭喜您！您已經學會最基礎的操作了。** +接下來，請根據您的日常工作，選擇對應的章節繼續閱讀： +* [處理客戶訂單與出貨操作](02-sales-workflow) +* [查詢庫存與日常管理](04-inventory-management) diff --git a/resources/markdown/manual/02-sales-workflow.md b/resources/markdown/manual/02-sales-workflow.md new file mode 100644 index 0000000..78e1cdc --- /dev/null +++ b/resources/markdown/manual/02-sales-workflow.md @@ -0,0 +1,49 @@ +# 客戶下單了：處理銷售與出貨 + +當客戶向我們訂購商品時，我們需要將訂單輸入系統，並在貨物寄出時扣除庫存。 +這篇指南會一步步帶您完成「建立訂單」與「出貨扣庫存」的流程。 + +--- + +## 階段一：把客戶的訂單打進系統 (建立銷售單) + +當收到客戶的採購電話或 Line 訊息時，我們第一步就是要把資料建檔。 + +1. 請看畫面左側，找到並點擊 **【銷售管理】** 分類。 +2. 接著點擊底下的 **【銷售訂單管理】**。 +3. 在畫面右上角，點擊藍色的 **【+ 新增訂單】** 按鈕。 + +### 填寫訂單內容 +畫面會跳出一個表單，請依序填寫以下重要資訊： + +* **選擇客戶**：點擊選單，選出是哪一位客戶下單。 +* **選擇商品**：在底下的明細表，選擇客戶要買的商品，並填入「數量」。 +* **單價與總額**：系統通常會自動帶出商品價格，請核對最後的【總金額】是否正確。 + +> 💡 **小撇步：找不到客戶怎麼辦？** +> 如果這位客戶是第一次跟我們買東西，目前系統可能需要請主管或行政人員協助在後台將「客戶資料」建檔後，才能選得到他。 + +4. 確認內容無誤後，點擊最下方的 **【儲存】**。 +5. 儲存後，這張訂單的狀態會是「草稿」或「待處理」，這代表貨還沒寄出去，庫存也還沒扣。 + +--- + +## 階段二：貨品寄出並扣除庫存 (出貨單) + +當倉庫人員把貨打包好，交給物流司機寄出後，我們就要在系統中進行「出貨」的動作，這樣庫存數量才會真的變少。 + +1. 點擊左側的 **【供應鏈管理】** > **【出貨單管理】**(目前此功能製作中，後續將開放)。 +2. 點擊右上角的 **【+ 新增出貨單】**。 +3. **最重要的一步：帶入訂單** + 畫面中會有一個選項請您選擇「來源銷售單」。請在這裡選取您在【階段一】打好的那張客戶訂單。 + *(系統會非常聰明地把那張訂單的商品與數量，自動照抄過來！)* +4. **選擇扣哪裡的庫存**：請確認「出貨倉庫」是選對的（例如：是由 A 倉庫出貨，還是總公司出貨）。 +5. 檢查確認出貨的數量無誤後，點擊 **【儲存並確認出貨】**。 + +> ⚠️ **注意事項：庫存扣除了！** +> 當您點擊確認出貨的瞬間，系統就會**立刻扣除**該倉庫的商品數量。請務必確認商品真的已經寄出才進行這個動作喔！ + +--- +🎉 **完成！您已經熟練地處理完一筆客戶訂單了。** +* [上一章：返回新手上路](01-getting-started) +* [查詢目前倉庫還剩多少貨 (庫存管理)](04-inventory-management) diff --git a/resources/markdown/manual/03-purchasing-workflow.md b/resources/markdown/manual/03-purchasing-workflow.md new file mode 100644 index 0000000..4a80d58 --- /dev/null +++ b/resources/markdown/manual/03-purchasing-workflow.md @@ -0,0 +1,58 @@ +# 買貨與收貨：採購與進貨點收 + +當我們發現倉庫裡的商品快賣完，需要向外面的廠商叫貨時，就會用到這個流程。 +這篇指南會帶您了解如何「打採購單給廠商」，以及當貨車送來時，如何進行「進貨點收」。 + +--- + +## 階段一：向廠商叫貨 (建立採購單) + +打電話或傳 Line 跟廠商叫貨後，我們也必須把叫貨紀錄打進系統裡。 + +1. 點擊畫面左側的 **【供應鏈管理】** 分類。 +2. 點選 **【採購單管理】**。 +3. 點擊右上角的藍色按鈕 **【+ 新增採購單】**。 + +### 填寫叫貨內容 +* **選擇供應商**：選出這次是要跟哪一家廠商叫貨。 +* **預計送達的倉庫**：選定這批貨之後會送到哪一個倉庫。 +* **品項明細**：在下方選擇我們要買的商品，並填入「數量」與我們雙方談好的「進貨單價」。 + +> 💡 **小撇步：查不到供應商名字？** +> 如果這是新的合作廠商，請先到左側的 **【供應鏈管理】 > 【廠商資料管理】** 點擊新增，把廠商的聯絡方式建立好。 + +4. 確認採購數量與金額無誤後，點擊 **【儲存】**。 +5. 這時候採購單只是一個「紀錄」，**倉庫的庫存還不會增加**。 + +--- + +## 階段二：廠商送貨來了 (進貨驗收) + +過了幾天，廠商的司機把貨物送到倉庫了。這時候我們必須打開系統點收，確認數量正確後，庫存才會增加。 + +1. 點擊畫面左側的 **【供應鏈管理】** 分類。 +2. 點擊 **【進貨單管理】**（或是稱為收貨單）。 +3. 點擊右上角 **【+ 新增進貨單】**。 +4. **帶入採購紀錄**： + 在畫面中選擇「來源採購單」。請選取您之前建好的那張單子。系統會把您當初叫貨的明細直接複製過來。 +5. **實際點收數量**： + 請看著現場的貨物清點。如果當初叫了 100 個，但廠商今天只送來 80 個，請務必把清單上的數量**改成 80**。 +6. **填寫效期/批號 (如果是食品或有保存期限的商品)**： + 有需要的話，請把包裝上的有效期限輸入系統。 + +> ⚠️ **注意事項：數量立刻增加！** +> 確認無誤並點擊 **【儲存並驗收】** 後，系統會**立刻把這些數量加進庫存中**。只要完成這一步，其他同事立刻就可以在系統查到這批新貨了。 + +--- + +## 💡 特殊情況：發現瑕疵品要退貨怎麼辦？ + +如果點收的時候，發現有幾箱商品破損了，我們必須把它退回給廠商。 + +1. 點擊左側的 **【供應鏈管理】 > 【採購退回單】**(如果有開放此功能)，或是從原本的採購單進行退回處理。 +2. 新增一張退貨單，並選出要退掉的商品與數量。 +3. 儲存確認後，系統就會把這部分故障的數量從庫存扣除，並記錄一筆帳款扣減。 + +--- +🎉 **完成！採購與收貨的流程就是這麼簡單。** +* [了解如何隨時掌握目前庫存數量](04-inventory-management) diff --git a/resources/markdown/manual/04-inventory-management.md b/resources/markdown/manual/04-inventory-management.md new file mode 100644 index 0000000..cb26bb9 --- /dev/null +++ b/resources/markdown/manual/04-inventory-management.md @@ -0,0 +1,54 @@ +# 目前還剩多少貨：庫存查詢與管理 + +這個章節對於每天要撿貨、出貨的同事非常重要。 +如何隨時知道倉庫裡還有多少商品可以賣？如何把 A 分店的貨調到 B 分店？都在這裡解答。 + +--- + +## 一、即時庫存查詢 + +當業務同事打電話問：「現在台北總倉還有沒有 XL 號的衣服可以賣？」時，您可以這樣做： + +1. 點擊左側的 **【商品與庫存管理】** 分類。 +2. 點擊 **【即時庫存查詢】**。 +3. 畫面上會列出所有公司倉庫裡面的每一項商品，以及它們目前剩餘「可賣數量」。 + +> 💡 **小撇步：善用搜尋功能（放大鏡）** +> 貨物有很多種，一直往下滑太慢了。請在列表上方的「搜尋框」輸入商品名稱的一部分，例如輸入「衣服 XL」，系統就會馬上過濾出結果，讓您一秒回答業務的問題！ + +--- + +## 二、把 A 倉庫的貨搬到 B 倉庫 (庫存調撥) + +假設今天台中分公司的乳液賣光了，想要從台北總倉緊急調貨 50 瓶過去。 + +1. 點擊左側的 **【商品與庫存管理】** > **【庫存調撥】**。 +2. 點擊右上角的 **【+ 新增調撥單】**。 +3. **選擇起點與終點**： + * 【調出倉庫】：選擇「台北總倉」（貨從這出去）。 + * 【調入倉庫】：選擇「台中分公司」（貨要搬去哪裡）。 +4. **填寫調撥明細**：在下方選擇「乳液」，並在數量欄位輸入 50。 +5. 確認無誤後，點擊 **【儲存】**。 + +這樣系統就會自動把台北的庫存扣掉 50，並且把台中的庫存增加 50，讓兩個地方的數量都維持正確。 + +--- + +## 三、發現與系統數字對不起來 (庫存調整) + +每個月底，大家可能會在倉庫「盤點」。 +如果系統顯示還有 10 瓶香水，但您數完架上卻只剩下 9 瓶，這時候該怎麼讓系統的數字變成正確的 9 瓶呢？ + +1. 點擊左側的 **【商品與庫存管理】** > **【庫存盤調】**。 +2. 點擊 **【+ 新增調整單】**。 +3. 選擇要調整的倉庫（例如：台北總倉）。 +4. 選擇品項（香水）。 +5. 在「調整數量」處，因為少了 1 瓶，請輸入 `-1`（若是盤盈多出 1 瓶則輸入 `1`）。 +6. **寫下原因**：可以在備註欄位寫下「月底盤點短少」或「破損丟棄」。 +7. 點擊 **【儲存】**。 + +**注意！完成後，系統的數量就會變回 9 瓶囉！** + +--- +🎉 **您現在也是庫存管理的大師了。** +* [如果想知道生產流程怎麼運作，請看下一章](05-production-guide) diff --git a/resources/markdown/manual/05-production-guide.md b/resources/markdown/manual/05-production-guide.md new file mode 100644 index 0000000..1e378d3 --- /dev/null +++ b/resources/markdown/manual/05-production-guide.md @@ -0,0 +1,59 @@ +# 我們自己做：生產與製造流程 + +如果您工作的單位有自己的工廠或廚房，會把「原料」加工變成「成品」拿去賣，這套流程就是為您設計的。 + +在 Star ERP 系統中，生產流程非常直覺！您不需要像傳統系統那樣四處尋找「領料單」或是「生產入庫單」。 +**從開工到入庫的所有動作，都在同一張「生產工單」畫面上，透過點擊狀態按鈕來一鍵完成。** + +--- + +## 階段一：發出製造任務 (新增生產工單) + +廠長決定今天下午要生產 50 盒「綜合餅乾」，這時候我們要把任務開出來。 + +1. 點擊左側的 **【生產管理】** 分類 > **【生產工單】**。 +2. 點擊右上角的藍色按鈕 **【+ 新增工單】**。 +3. **填寫生產任務**：選擇要做的商品（綜合餅乾）、計畫數量（50）、預計入庫倉庫，然後儲存。 +4. 此時會產生一張編號單據，狀態為 **「草稿」**。 + +--- + +## 階段二：審核與準備開工 + +要讓現場人員可以開始領料，這張單子必須先經過確認。 + +1. 進入剛才建立的生產工單詳細畫面。 +2. 點擊右上方的 **【送審工單】**。 +3. 接著點擊 **【核准工單】**。（如果您的公司有嚴格權限，這一步可能需要由主管來點擊）。 + +這張單子現在變成「已核准」，代表可以隨時動工了。 + +--- + +## 階段三：開爐製作 ➔ 系統幫您自動扣原料庫存 + +開始做餅乾之前，我們必須從食材倉庫去領麵粉、糖、奶油出來。在系統裡，這一步超級簡單： + +1. 在生產工單畫面右上方，點擊藍色按鈕 **【▶ 開始製作 (扣除原料庫存)】**。 +2. **就這樣！不用再手動打字！** 系統此時會去查看「綜合餅乾」的配方表，自動默默幫您把麵粉、糖、奶油等對應的數量從系統的原料倉庫扣掉。 +3. 此時工單的狀態會變成 **「製作中」**。 + +> ⚠️ **注意事項：確認您的配方設定得對不對** +> 因為系統是「自動扣料」，如果配方表寫錯，或是原料倉庫根本沒有庫存，系統可能會扣出負數或是跳出提示喔！ + +--- + +## 階段四：烤好了 ➔ 系統幫您自動加成品庫存 + +餅乾做好了、包裝好了，要送進倉庫準備出貨給客人。 + +1. 在同一張生產工單畫面右上方，點擊藍色按鈕 **【✔ 製作完成 (成品入庫)】**。 +2. 系統會跳出一個小視窗，請您確認：「這批剛做好的 50 盒餅乾，要放進哪一個倉庫？」。 +3. 選擇好真正的入庫倉庫後，點擊確認。 +4. 此時工單變成 **「已完成」**。 + +**太棒了！您剛完成一次生產循環：您只需在工單推進進度，系統就自動幫您完成領出原料（扣庫存）以及產出成品（加庫存）的帳務處理了。** + +--- +🎉 **您現在熟悉生產的派工與回報流程了。** +* [如果您還負責看帳款，請看下一章](06-finance-basics) diff --git a/resources/markdown/manual/06-finance-basics.md b/resources/markdown/manual/06-finance-basics.md new file mode 100644 index 0000000..7f51b7d --- /dev/null +++ b/resources/markdown/manual/06-finance-basics.md @@ -0,0 +1,42 @@ +# 記下公司的花費：財務與帳款基礎 + +做生意難免有很多雜費，例如水電費、網路費等。每個月這些固定支出的流水帳要記在哪裡呢？ +本指南教您紀錄最基礎的財務款項。 + +--- + +## 一、收到水電瓦斯帳單時 (公共事業費) + +每個月公司都會收到水費、電費帳單。這些零星花費可以統一記錄在這裡。 + +1. 點擊左側的 **【財務管理】** 分類。 +2. 點擊 **【公共事業費】**。 +3. 點擊右上角的 **【+ 新增費用】**。 +4. 選擇這個費用是「水費」、「電費」還是「網路費」。 +5. **填入金額**：例如 1,500 元。 +6. **繳費期限**：輸入帳單上的最後繳款日。 +7. 如果您已經去超商或銀行繳清了，可以直接把狀態改為「已繳費」。 +8. 點擊 **【儲存】**。 + +月底會計人員就可以打開系統，一眼看出這個月水電費總共花了多少錢。 + +--- + +## 二、我們欠廠商多少錢 (應付帳款) + +回想一下我們之前的[採購流程](03-purchasing-workflow.md)。 +當廠商把貨送來給我們，我們簽收完成後，我們是不是就「欠廠商一筆貨款」了？ +這個紀錄在哪裡看呢？ + +1. 當您**建立完【進貨單】之後**，這筆錢其實不需要您再去重新打一張帳單，系統已經自動幫您記一筆「應付廠商款項」了。 +2. （根據系統版本可能會有專屬介面）您可以前往 **【財務管理】** > **【應付帳款】**，裡面會列出： + * 欠哪一家廠商？ + * 哪一天送什麼貨來的？ + * 金額是多少？ + +所以只要您乖乖把進貨跟退貨單都有打好，系統就會幫您自動結算出這個月該付給每家廠商多少錢的總結！ + +--- +🎉 **非常感謝您的閱讀！** +您已經把日常最容易碰到的情境操作都學完了！ +如有進階問題，可參考 [系統常見問題 (FAQ)](faq) 或尋求資訊人員協助。 diff --git a/resources/markdown/manual/faq.md b/resources/markdown/manual/faq.md index a4c065d..cf18c86 100644 --- a/resources/markdown/manual/faq.md +++ b/resources/markdown/manual/faq.md @@ -1,30 +1,36 @@ # 常見問題 (FAQ) -這裡彙整了使用者最常遇到的問題與解決方案。 +這裡彙整了大家在日常操作系統中最容易遇到的疑問與解決方案。如果您在這裡找不到解答，隨時歡迎聯繫技術團隊！ + +--- ## 1. 系統登入與權限 ### Q: 為什麼我登入後看不見某些功能選單？ -**A:** 系統採用權限控管機制。如果您看不見特定選單（例如：「財務管理」），表示您的角色尚未被賦予該項目的權限。請聯繫系統管理員協助處理。 +**答：** 系統採用嚴格的權限控管機制。如果您看不見特定的選單（例如左側沒有出現 **【財務管理】**），表示您的帳號目前尚未被賦予該模組的檢視權限。請直接聯繫主管或系統管理員為您開啟權限。 ### Q: 如何變更登入密碼？ -**A:** 請點擊右上角個人圖示進入「使用者設定」，即可找到變更密碼的功能。 +**答：** 請點擊畫面右上角您的 **個人圖示**，選擇 **【修改密碼】** 功能。依照畫面指示輸入舊密碼與新密碼後，點擊儲存即可完成。 + +--- ## 2. 採購與進貨 -### Q: 進貨單儲存後可以修改嗎？ -**A:** 為了確保帳務與庫存紀錄的嚴謹性，進貨單一旦儲存並生效後即無法直接修改。若輸入錯誤，請建立一張「庫存調整單」進行修正。 +### Q: 進貨單點收儲存後，還可以手動修改數量嗎？ +**答：** 為了確保公司帳務與庫存紀錄的正確性，進貨單一旦點擊 **「儲存並驗收」** 生效後，就 **無法再直接修改**。如果您當下打錯數量，請前往 **【商品與庫存管理】** > **【庫存盤調】** 開立調整單進行修正，並詳細備註原因。 -### Q: 採購單為什麼無法點收進貨？ -**A:** 請確認該採購單是否已處於「已核准」狀態。只有核准後的採購單才能被進貨流程引用。 +### Q: 為什麼打好的採購單，在新增進貨單的時候選不到它？ +**答：** 系統規定：只有狀態抵達 **「已核准」** 的採購單，才能被當作新進貨驗收的憑證。請回到您的採購單列表，確認您要收的單據是否送出並已經被主管核准了。 + +--- ## 3. 庫存管理 -### Q: 庫存分析中的「週轉天數」是如何計算的？ -**A:** 週轉天數 = (目前庫存 / 過去 30 天日平均銷量)。這能幫助您評估現有庫存還能支撐多久。 +### Q: 報表裡顯示的「週轉天數」是什麼意思？ +**答：** 計算公式為「目前倉庫庫存量 ÷ 這個商品過去 30 天平均每日銷量」。這個數字能幫助您一眼判定：「目前的庫存量大約還能撐著賣幾天？」這有助於您決定是否需要提早向廠商叫貨。 -### Q: 「滯銷」的定義是什麼？ -**A:** 系統預設將「目前有庫存」且「超過 90 天未有銷售紀錄」的商品標記為滯銷。 +### Q: 報表說某個商品「滯銷」，請問電腦是怎麼判定滯銷的？ +**答：** 系統預設會將「目前倉庫裡還有庫存」且「已經連續超過 90 天未有銷售紀錄」的商品標記為滯銷。建議您可以針對這些被點名的商品盡速安排促銷出清。 --- -*如有其他問題，請聯繫技術中心 (分機: 8888)。* \ No newline at end of file +*如有進階問題，請隨時聯繫技術中心獲得協助。* \ No newline at end of file diff --git a/resources/markdown/manual/module-finance.md b/resources/markdown/manual/module-finance.md new file mode 100644 index 0000000..7c7f124 --- /dev/null +++ b/resources/markdown/manual/module-finance.md @@ -0,0 +1,29 @@ +# 模組詳解：財務管理 + +此模組用來整理公司的日常花費，以及我們「欠廠商多少錢」。有了這個工具，月底結帳時會計人員就不需要翻找一堆紙本發票了。 + +--- + +## 1. 公共事業費 +* **這是做什麼用的？** + 用來記錄每個月固定的零星開銷，例如公司的水費、電費、網路費、甚至是辦公室的瓦斯費。 +* **如何操作？** + 1. 點擊左側 **【財務管理】** > **【公共事業費】**。 + 2. 點擊右上角 **【+ 新增費用】**。 + 3. 下拉選單選擇這個帳單是哪一類（如：電費）。 + 4. 填寫帳單上的「應繳金額」與「繳費截止日」。 + 5. 如果會計已經去繳掉了，就把狀態打勾勾改成「已繳款」，這樣月底盤點現金時數字才會準確。 + +## 2. 應付帳款 +* **這是做什麼用的？** + 當我們向廠商叫貨，廠商把貨送來我們點收完成後，會計不可能馬上抱著現金去付給司機。通常是會累積一個月再一起匯款。 + 這裡就是系統幫您自動整理好的：「到底我們現在總共欠了哪幾家廠商、分別欠了多少錢」。 +* **如何操作？** + 1. 點擊左側 **【財務管理】** > **【應付帳款】**。 + 2. 您會在列表上看到廠商的名字，以及欠款的總金額。 + 3. 點進去可以看明細（例如：因為 1 號送了一批貨欠了三千、15 號送了一批貨欠了五千）。 + 4. 當月底會計把款項匯給廠商後，可以勾選這些帳款並標記為「已付款」，帳面上我們就不欠錢了。 + +--- +> ⚠️ **注意事項：這裡只管結果！** +> 如果您發現「應付帳款」的數字有錯，代表當初倉庫人員在點收**【進貨單】**的數量時就錯了！您必須回到【供應鏈管理】把退貨或錯誤數量更正，這裡的帳單金額才會是對的。 diff --git a/resources/markdown/manual/module-inventory.md b/resources/markdown/manual/module-inventory.md new file mode 100644 index 0000000..cc528d8 --- /dev/null +++ b/resources/markdown/manual/module-inventory.md @@ -0,0 +1,62 @@ +# 模組詳解：商品與庫存管理 + +此模組是 Star ERP 的核心，用來建立公司在賣的所有產品，並管理它們存放在哪裡、現在還剩多少。 + +--- + +## 1. 即時庫存查詢 +* **這是做什麼用的？** + 讓您一秒鐘查出某個商品在所有倉庫裡面還剩下多少個。 +* **如何操作？** + 1. 點擊左側 **【商品與庫存管理】** > **【即時庫存查詢】**。 + 2. 在畫面上方的「搜尋框」輸入商品名稱或編號。 + 3. 列表會顯示該商品在「A 倉庫有幾個」、「B 倉庫有幾個」，以及可以立即出貨的「可用數量」。 + +## 2. 商品資料管理 +* **這是做什麼用的？** + 公司要賣新東西了！您必須先在這裡把「新商品」的基本資料建檔，後續採購或銷售才能選得到它。 +* **如何操作？** + 1. 點擊左側 **【商品與庫存管理】** > **【商品資料管理】**。 + 2. 點擊右上角 **【+ 新增商品】**。 + 3. 填寫商品的「名稱」、「分類」、「單位（例如：個、箱）」與「售價」。 + 4. 點擊 **【儲存】**。 + +## 3. 倉庫管理 +* **這是做什麼用的？** + 設定公司目前有幾個放貨的地方，例如「台北總倉」、「台中門市」、「冷凍冰庫」等。 +* **如何操作？** + 1. 點擊左側 **【商品與庫存管理】** > **【倉庫管理】**。 + 2. 若有新倉庫啟用，點擊 **【+ 新增倉庫】**，輸入名稱即可。 + +## 4. 庫存盤點 +* **這是做什麼用的？** + 每個月底去倉庫數數量時使用的功能。把系統紀錄的數字拿來跟實際數完的數字做比對。 +* **如何操作？** + 1. 點擊左側 **【商品與庫存管理】** > **【庫存盤點】**。 + 2. 點擊 **【+ 新增盤點單】**，選擇要盤點的倉庫開始清點作業。 + +## 5. 庫存盤調 +* **這是做什麼用的？** + 當發現系統數量跟實際數量「不攏（不一致）」時，用來把數字改正確的地方。 + 例如丟掉過期品、或是盤點發現少一個。 +* **如何操作？** + 1. 點擊左側 **【商品與庫存管理】** > **【庫存盤調】**。 + 2. 點擊 **【+ 新增調整單】**。 + 3. 輸入要「扣除 (-)」或「增加 (+)」的數量，並寫下原因（如：過期報廢）。 + 4. 點擊 **【儲存】** 後系統數量立即更新。 + +## 6. 庫存調撥 +* **這是做什麼用的？** + 把貨物從 A 倉庫搬到 B 倉庫。 +* **如何操作？** + 1. 點擊左側 **【商品與庫存管理】** > **【庫存調撥】**。 + 2. 點擊 **【+ 新增調撥單】**。 + 3. 選擇【調出倉庫】與【調入倉庫】，並填寫要搬過去的商品與數量。 + 4. 點擊 **【確認調撥】**。 + +## 7. 門市叫貨 +* **這是做什麼用的？** + 專供各個分店門市向「總部/總倉」請求補貨的功能。門市人員在這裡打單，總部就會收到通知準備出貨。 +* **如何操作？** + 1. 門市人員點擊左側 **【商品與庫存管理】** > **【門市叫貨】**。 + 2. 點擊 **【+ 新增叫貨單】**，填寫需要的明細後送出。 diff --git a/resources/markdown/manual/module-production.md b/resources/markdown/manual/module-production.md new file mode 100644 index 0000000..5e43fb6 --- /dev/null +++ b/resources/markdown/manual/module-production.md @@ -0,0 +1,29 @@ +# 模組詳解：生產管理 + +如果您的公司有工廠或廚房，會把「原料」經過處理變成「成品」拿去賣，這個模組就是為了讓您能追蹤「每天用了多少料、做出了多少成品」。 +系統的生產邏輯是建立在一張「生產工單」上，由這張單子的**狀態切換**來自動幫您完成倉庫原料的扣除與成品的增加。 + +--- + +## 1. 配方管理 (Recipe) +* **這是做什麼用的？** + 這就像是廚師的「黃金比例食譜」。 + 例如：系統要知道生產 1 盒「綜合餅乾」，需要消耗 100g 麵粉、50g 奶油跟 20g 糖。必須先把食譜建好，未來系統才能自動幫您算要準備多少料。 +* **如何操作？** + 1. 點擊左側 **【生產管理】** > **【配方管理】**。 + 2. 點擊右上角 **【+ 新增配方】**。 + 3. 上方選擇您的「成品」是什麼（綜合餅乾）。 + 4. 下方一行一行選擇要用到哪些原物料（麵粉、奶油），並輸入需要的數量。 + 5. 點擊 **【儲存】**。 + +## 2. 生產工單 +* **這是做什麼用的？** + 這是廠長發給產線的「任務指令單」。系統不需要您手動去打「領料單」或「入庫單」，所有動作都在這張工單畫面上，透過點擊「狀態按鈕」自動完成。 +* **如何操作？** + 1. 點擊左側 **【生產管理】** > **【生產工單】**。 + 2. 點擊右上角 **【+ 新增工單】**。選出今天要生產什麼「成品」、預計生產多少「數量」並儲存。這時工單是**【草稿】**狀態。 + 3. 點進這張工單的詳細畫面，接下來的操作都會在右上角的按鈕區： + * **【送審工單】**：將草稿送出。 + * **【核准工單】**：由主管點擊核准，表示同意生產計畫。 + * **領料動作 (自動扣庫存)**：點擊藍色按鈕 **【開始製作 (扣除原料庫存)】**。系統就會根據您當初建的配方比例，從系統裡的原料倉庫自動扣掉對應的粉、油、糖。此時狀態會變成【製作中】。 + * **完工動作 (自動加庫存)**：當餅乾烤好包裝完畢，點擊 **【製作完成 (成品入庫)】**。系統會跳出一個視窗問您「這批做好的成品要放進哪個倉庫？」。選好倉庫並確認後，這批新的成品數量就會立刻加到系統倉庫裡了。 diff --git a/resources/markdown/manual/module-report.md b/resources/markdown/manual/module-report.md new file mode 100644 index 0000000..337df19 --- /dev/null +++ b/resources/markdown/manual/module-report.md @@ -0,0 +1,36 @@ +# 模組詳解：報表與分析 + +此模組是老闆與主管們最愛用的功能，系統會自動把每天員工打的「進貨單」、「出貨單」、「盤點單」數字蒐集起來，畫成圖表與報表讓您一目了然。 + +--- + +## 1. 會計報表 +* **這是做什麼用的？** + 把一段時間內公司所有的「支出」跟「收入」金額總結起來的地方。 +* **如何操作？** + 1. 點擊左側 **【報表與分析】** > **【會計報表】**。 + 2. 在上方選擇您想查看的「時間範圍」（例如：上個月）。 + 3. 畫面會自動幫您結算這個月總共賣了多少錢、花了多少錢進貨買料。 + +## 2. 庫存報表 +* **這是做什麼用的？** + 如果老闆問：「上個月我們的 A 餅乾總共進了多少？出了多少？現在剩多少？」就來這裡查。 +* **如何操作？** + 1. 點擊左側 **【報表與分析】** > **【庫存報表】**。 + 2. 選擇「時間範圍」並指定要看哪個「倉庫」。 + 3. 報表會列出每種商品的期初數量、入庫總和、出庫總和，以及目前的期末數量。 + +## 3. 庫存分析 +* **這是做什麼用的？** + 讓系統用「圖表」的方式跟您說：哪些商品賣最好（快沒貨了要進），哪些商品一直滯銷（可能要打折出清）。 +* **如何操作？** + 1. 點擊左側 **【報表與分析】** > **【庫存分析】**。 + 2. 您會看到各種銷售排名與庫存水位圖，幫助您做後續的採購決策。 + +## 4. 批號溯源 +* **這是做什麼用的？** + 這是食品業與生技業非常重要的功能。如果某批麵粉被查出有問題，您可以透過這個功能「往前查」這批麵粉是哪天跟誰買的？「往後查」這批麵粉被我們拿去做成了哪批餅乾、賣給了誰？ +* **如何操作？** + 1. 點擊左側 **【報表與分析】** > **【批號溯源】**。 + 2. 輸入您要追查的「商品批號」。 + 3. 系統會畫出一張樹狀圖，清楚列出它從進貨、生產、到出貨的所有歷史紀錄。 diff --git a/resources/markdown/manual/module-sales.md b/resources/markdown/manual/module-sales.md new file mode 100644 index 0000000..99f0f1c --- /dev/null +++ b/resources/markdown/manual/module-sales.md @@ -0,0 +1,27 @@ +# 模組詳解：銷售管理 + +此模組專門處理「賣出去」的所有事情，包含我們收到了哪些客人的訂單，以及從外部系統（如蝦皮、官網）轉進來的訂單。 + +--- + +## 1. 銷售單匯入 +* **這是做什麼用的？** + 如果公司有經營網購平台（像是蝦皮、MOMO 等），每天可能會有好幾百張訂單。為了不用由行政人員慢慢「一筆一筆用手打」，可以把那些平台的訂單存成一個 Excel 表格，在這裡「一次全部載入（匯入）」。 +* **如何操作？** + 1. 點擊左側 **【銷售管理】** > **【銷售單匯入】**。 + 2. 點擊畫面上的 **【上傳檔案】** 按鈕。 + 3. 從你的電腦中選取從網購平台下載下來的 Excel 檔案。 + 4. 系統會自動把幾百張訂單變成 ERP 裡的一筆一筆銷售單。 + +## 2. 銷售訂單管理 +* **這是做什麼用的？** + 這裡是所有「已經成立的客戶交易」的總表。不管是業務手動建立的，還是上面提到從 Excel 匯入的，通通都會在這裡排成一列。 + 您可以在這裡查看哪筆訂單還沒出貨、哪筆客人已經付款。 +* **如何操作？** + 1. 點擊左側 **【銷售管理】** > **【銷售訂單管理】**。 + 2. 如果有客人打電話進來訂購，點擊右上角 **【+ 新增訂單】**，把客戶買了什麼、數量多少登錄進系統。 + 3. 如果是要找某一筆已經成立的單：在「搜尋框」輸入客人的名字或電話，系統就會立刻幫您把單子找出來。 + +--- +> 💡 **小撇步：訂單要怎麼「出貨扣庫存」？** +> 目前銷售模組的主要工作是「建檔」。如果要真正把貨寄出去並從倉庫扣除數量，現階段系統會在您建完訂單並確認後，於後台自動或透過指定的出貨流程來進行庫存扣減。 diff --git a/resources/markdown/manual/module-supply-chain.md b/resources/markdown/manual/module-supply-chain.md new file mode 100644 index 0000000..de1531e --- /dev/null +++ b/resources/markdown/manual/module-supply-chain.md @@ -0,0 +1,38 @@ +# 模組詳解：供應鏈管理 + +此模組專門處理「向外採買」的所有事情，包含對口廠商是誰、我們訂了什麼貨、貨送來了沒。 + +--- + +## 1. 廠商資料管理 +* **這是做什麼用的？** + 像是一本供應商的名片簿。建好廠商資料後，打採購單時才能直接選取，不用每次重打聯絡資訊。 +* **如何操作？** + 1. 點擊左側 **【供應鏈管理】** > **【廠商資料管理】**。 + 2. 點擊右上角 **【+ 新增廠商】**。 + 3. 填寫廠商的「公司名稱」、「聯絡人」、「電話」與「統一編號」。 + 4. 點擊 **【儲存】**。 + +## 2. 採購單管理 +* **這是做什麼用的？** + 當我們需要向廠商買東西時，用來記錄「要買什麼、買多少、多少錢」的憑證。 + *(注意：這時候貨還沒來，所以庫存不會增加)* +* **如何操作？** + 1. 點擊左側 **【供應鏈管理】** > **【採購單管理】**。 + 2. 點擊右上角 **【+ 新增採購單】**。 + 3. 選出供應商、預計收貨的倉庫，並在下方填滿要採買的商品品項與單價。 + 4. 點擊 **【儲存】** 並送出給主管簽核。 + +## 3. 進貨單管理 +* **這是做什麼用的？** + 當廠商司機把貨物送到我們倉庫現場時，用來「點收」並把數量「加進庫存」的功能。 +* **如何操作？** + 1. 點擊左側 **【供應鏈管理】** > **【進貨單管理】**。 + 2. 點擊右上角 **【+ 新增進貨單】**。 + 3. **關鍵步驟**：選擇「來源採購單」，系統會自動把當初叫貨的清單複製過來。 + 4. 拿著明細核對現場數量，若有短少請直接修改畫面上的數字。 + 5. 確認無誤後點擊 **【儲存並驗收】**，庫存數量就會馬上增加了！ + +--- +> 💡 **小撇步：如果要退貨怎麼辦？** +> 若遇到瑕疵品需要退回給廠商，您可以直接在當時的那張「進貨單」裡面，尋找 **【採購退回】** 相關的按鈕，系統就會幫您把貨品扣出庫存並計入退款。 diff --git a/resources/markdown/manual/module-system.md b/resources/markdown/manual/module-system.md new file mode 100644 index 0000000..e850b7c --- /dev/null +++ b/resources/markdown/manual/module-system.md @@ -0,0 +1,37 @@ +# 模組詳解：系統管理 + +此模組通常只有**系統管理員**或**老闆**才能進來。用來設定「誰可以進來這個系統」、「他們進來後能看到什麼功能」，以及查看大家的「操作紀錄」。 + +--- + +## 1. 使用者管理 +* **這是做什麼用的？** + 當公司有新員工報到時，您必須在這裡幫他開一個「可以登入系統的帳號」。如果員工離職了，也要來這裡把他的帳號停用。 +* **如何操作？** + 1. 點擊左側 **【系統管理】** > **【使用者管理】**。 + 2. 點擊右上角 **【+ 新增使用者】**。 + 3. 輸入他的名字、工作 Email、設定一組初始密碼，並指派一個「角色」（例如：倉管人員）。 + 4. 點擊 **【儲存】**。 + +## 2. 角色與權限 +* **這是做什麼用的？** + 這裡定義了「不同職位可以做什麼事」。例如：您不希望「採購人員」可以看到「財務報表」與「薪資」，就可以在這裡把「採購人員」這個角色的權限拔掉。 +* **如何操作？** + 1. 點擊左側 **【系統管理】** > **【角色與權限】**。 + 2. 點擊某個角色（如：倉管人員）旁邊的 **【編輯】**。 + 3. 畫面會列出系統所有的功能（如：新增進貨單、刪除採購單）。 + 4. 您只要把允許他們用的功能「打勾」，不允許的「取消打勾」，按下儲存即可。 + +## 3. 操作紀錄 +* **這是做什麼用的？** + 系統的「行車紀錄器」。如果發現某張訂單的數字被亂改了，可以在這裡抓出「是誰、在幾點幾分、把原本的 10 個改成了 5 個」。 +* **如何操作？** + 1. 點擊左側 **【系統管理】** > **【操作紀錄】**。 + 2. 列表會詳細記錄所有人的一舉一動，您可以透過上方的搜尋框找特定的人或檔案。 + +## 4. 系統設定 +* **這是做什麼用的？** + 用來設定公司層級的基本參數，例如：公司的 Logo、印表機的格式、或是進貨單的單號規則等等。 +* **如何操作？** + 1. 點擊左側 **【系統管理】** > **【系統設定】**。 + 2. 依據畫面的分類標籤，修改完畢後按下儲存。 diff --git a/resources/markdown/manual/toc.json b/resources/markdown/manual/toc.json index 998ee93..eb18e4f 100644 --- a/resources/markdown/manual/toc.json +++ b/resources/markdown/manual/toc.json @@ -3,21 +3,66 @@ "title": "新手上路", "pages": [ { - "title": "登入與帳號設定", - "slug": "getting-started" + "title": "新手上路：登入與基本操作", + "slug": "01-getting-started" } ] }, { - "title": "核心流程", + "title": "日常工作情境", "pages": [ { - "title": "採購流程說明", - "slug": "purchasing-workflow" + "title": "客戶下單了：處理銷售與出貨", + "slug": "02-sales-workflow" }, { - "title": "庫存管理規範", - "slug": "inventory-management" + "title": "買貨與收貨：採購與進貨點收", + "slug": "03-purchasing-workflow" + }, + { + "title": "目前還剩多少貨：庫存查詢與管理", + "slug": "04-inventory-management" + }, + { + "title": "我們自己做：生產與製造流程", + "slug": "05-production-guide" + }, + { + "title": "記下公司的花費：財務與帳款基礎", + "slug": "06-finance-basics" + } + ] + }, + { + "title": "模組功能詳解", + "pages": [ + { + "title": "📦 商品與庫存管理", + "slug": "module-inventory" + }, + { + "title": "🚚 供應鏈管理", + "slug": "module-supply-chain" + }, + { + "title": "🛒 銷售管理", + "slug": "module-sales" + }, + { + "title": "🏭 生產管理", + "slug": "module-production" + }, + { + "title": "💰 財務管理", + "slug": "module-finance" + }, + { + "title": "📊 報表與分析", + "slug": "module-report" + }, + { + "title": "⚙️ 系統管理", + "slug": "module-system" } ] },