生財有跡（Wealth Tracker）是一款專注於個人資產分析的應用程式。其核心功能是：全面記錄並展示使用者的資產狀況，幫助使用者輕鬆瞭解財務現狀；運用 AI 能力，結合每種資產的特性和當前環境，提供適宜的財務建議。
專案願景
在當今多元化的經濟環境中，個人資產管理變得日益重要。它往往分散於各類金融賬戶和服務中，例如銀行存款與理財產品、移動支付平臺（如微信支付、支付寶）、公積金、醫保賬戶、貨幣基金（例如餘額寶）、債券、各種股票及基金產品、房地產、貴金屬、外部借款（儘量不做此配置🤫）以及其他投資等等（對於部分朋友，或許還有貸款、欠款等負債）。這些賬戶中的數額在不斷變動，使得快速準確地瞭解個人總資產狀況成為一項挑戰。
本專案旨在提供一個高效、直觀的解決方案，以應對個人資產管理中的分散性和複雜性。生財有跡專注於賬戶餘額及整體數額，避免深陷於單筆收支的瑣碎細節。其目標是透過簡化操作流程，幫助使用者揭示個人資產的整體變化趨勢，並透過友好的使用者介面，使使用者能夠輕鬆記錄和洞悉自己的財務資訊。如欲瞭解更多，可移步至博文：生財有跡 | 您專屬的資產跟蹤與分析工具。
核心特性
- 簡潔易用的操作介面：使用者可以透過幾個簡單的步驟快速上手，無需任何複雜的財務知識。
- 豐富的資料視覺化：透過圖表和圖形，直觀展示資產變化，幫助使用者輕鬆掌握財務狀況。
- 本地部署的靈活性：部署在哪裡由使用者決定，確保資料的私密性、安全性，以及可擴充套件性。
- 開源的程式碼架構：專案的原始碼完全開放，歡迎參與貢獻，以不斷改進和完善工具的功能。
透過這些特性，希望建立一個使用者友好、透明且可信賴的個人財分析工具，幫助使用者更全面地掌握自己的財務狀況。
線上體驗
為了讓您更直觀地瞭解 生財有跡 的功能和特性，已在伺服器上使用 pm2 部署了一個演示版本。該演示環境填充了模擬資料，方便您全面體驗各項功能。無論您是想評估工具的實用性，還是出於好奇想一探究竟，歡迎訪問以下連結進行體驗：
https://fund.niceshare.site/
請注意，這是一個公共演示環境，因此請勿在其中輸入任何真實的個人財務資訊。建議您在體驗後，考慮按照本文件的指導，在自己的環境中部署和使用"生財有跡"，以確保您的財務資料的隱私和安全。
如果您在使用過程中遇到任何問題或有反饋意見，歡迎透過專案的 GitHub 頁面與我們聯絡。您的寶貴意見將幫助我們不斷改進這一工具，以更好地滿足使用者的需求。
先決條件
說明使用者在安裝和使用前，需要準備的一些先決條件，譬如：您需要安裝或升級 Node.js（>= 16.*），推薦使用 Pnpm 或 Yarn 作為首選包管理工具。
如何使用？
使用 Docker
使用 docker compose：
version: '3.8'
services:
wealth-tracker:
image: nicejade/wealth-tracker
container_name: wealth-tracker
ports:
- '8888:8888'
volumes:
- ./data:/app/data
restart: unless-stopped
volumes:
data:
這將在後臺啟動服務，並且效果與下面的 docker run 命令相同。使用 Docker Compose 可以更方便地管理多個容器，並且配置更易讀和維護。
或者 docker run：
docker run -d -p 8888:8888 -v "$(pwd)/data:/app/data" nicejade/wealth-tracker
如果您在本地部署，只需開啟網址——http://localhost:8888 即可訪問。如果在伺服器執行，可透過 http://[Server-IP]:8888 來訪問，您也可以指定其他埠。
使用 Node.js
# clone project
git clone https://github.com/nicejade/wealth-tracker.git
# install & run for client
cd client && pnpm i && pnpm start
# install & run for srever
cd server && pnpm i && pnpm start
本專案客戶端採用 Svelte 框架，基於 Vite 所構建，預設 5173 埠，只需開啟網址—— http://localhost:5173 即可訪問。
命名由來
在專案開發初期，有為應用取中文名為："財富追蹤器"（英文名：Wealth Tracker）。這個名稱初看簡潔明瞭，似乎完美契合產品理念。然而，隨著開發深入，逐漸顯現出其侷限性：
- 概念範疇過廣："財富"一詞涵蓋範圍極廣，不僅包括金錢資產，還可能指代時間、知識、經歷，甚至是絕美容顏等無形價值。
- 功能定位不夠精準：該應用實際上專注於能被精確計算和記錄、且已經形成的有形資產，而非泛泛追蹤所有形式的"財富"。
這種認知更新促使重新思考產品定位和命名。偶然想到了兩個頗具啟發性的成語："生財有道"和"生財有術"；而應用的核心功能恰恰是記錄資產增長的軌跡。基於這一靈感，最終確定將應用命名為"生財有跡"。這個名字巧妙地結合了幾個要素：
- "跡"與"記"同音，暗示了記錄的功能。
- "生"與"升"同音，象徵著資產的增長。
- 整體保留了"生財"的概念，與原有的資產主題保持一致。
"生財有跡"這個新名稱不僅準確反映出產品功能定位，傳達了產品理念，還蘊含了對使用者資產增長的美好祝願，希望您也會喜歡。
給予支援
生財有跡專案開源且免費，然而設計與編碼需耗費時間和精力。如若您對其使用感到滿意，請考慮透過以下方式進行小額捐贈：
微信掃碼贊助
路線圖
"生財有跡"專案正處於積極的設計和研發階段，致力於在功能豐富與易用性之間尋求平衡，以滿足使用者日益增長的個人財務管理需求。未來開發重點包括增強資料視覺化能力、加強資料安全性、以及提升 AI 輔助分析功能等。
特別鳴謝
本專案的開發過程中，依賴並受益於以下優秀的開源技術和工具（未包含全部）。它們不僅提供了強大的功能，還促進了專案的高效開發和穩定執行。
- Svelte: 作為一種新興的前端框架，Svelte 透過其創新的編譯時技術，讓我們的 Web 應用更加輕量和高效。它減少了我們需要編寫的樣板程式碼，同時提高了執行時的效能。
- TailwindCSS: 透過提供實用主義的 CSS 類，TailwindCSS 極大地簡化了樣式設計的過程。它使得我們能夠快速構建美觀且響應式的使用者介面，同時保持程式碼的清晰和維護性。
- Vite: 作為一個現代化的前端構建工具，Vite 透過其快速的冷啟動和即時的模組熱更新，極大地提高了我們的開發效率。它利用了原生 ES 模組特性，使得專案構建更加高效。
- Flowbite: 提供了一系列預構建的元件和模板，Flowbite 極大地加快了我們的開發流程。它幫助我們快速實現了複雜的使用者介面元素，同時保持了程式碼的可定製性和可維護性。
- Axios: 作為一個基於 Promise 的 HTTP 客戶端，Axios 簡化了我們的 Web 應用中與 API 的互動。它的易用性和廣泛的功能集使得我們能夠輕鬆處理 HTTP 請求和響應。
- Day.js: 作為一個輕量級的 JavaScript 日期庫，Day.js 提供了直觀的 API 來處理日期和時間。它使得我們在應用中處理複雜的日期計算變得簡單且可靠。
- Node.js: 作為一個高效的 JavaScript 執行環境，Node.js 使得伺服器端開發變得前所未有的簡單和快速。它的事件驅動和非阻塞 I/O 模型極大地提高了我們的應用效能和響應速度。
- Fastify: 這個高效能的 Node.js Web 框架為我們提供了一個簡單且強大的介面來構建 RESTful API。它的低開銷和高度可擴充套件性使得我們的後端服務既快速又穩定。
- SQLite3: 作為一個輕量級的資料庫引擎，SQLite3 為我們提供了一個無需配置的本地儲存解決方案。它的簡單性和高效性使得開發者在本地部署應用時能夠輕鬆管理資料。
- Sequelize: 作為一個強大的 ORM 框架，Sequelize 為我們提供了一種簡單且直觀的方式來管理資料庫關係。它的靈活性和功能豐富性使得我們能夠輕鬆實現複雜的資料操作和查詢。
在此，對上述技術和工具的開發者和社群，致以崇高的敬意和衷心的感謝❤️。正是得益於他們的卓越貢獻，生財有跡才能得以成功構建並持續最佳化。同時，也要感謝如 ChatGPT、Github Copilot、Poe、Kimi 等 AI 工具在開發過程中提供的寶貴支援，它們顯著提高了工作效率和體驗。