生财有迹（ Wealth Tracker ）是一款专注于个人资产分析的应用程序。其核心功能是：全面记录并展示用户的资产状况，帮助用户轻松了解财务现状；运用 AI 能力，结合每种资产的特性和当前环境，提供适宜的财务建议。
在当今多元化的经济环境中，个人资产管理变得日益重要。它往往分散于各类金融账户和服务中，例如银行存款与理财产品、移动支付平台（如微信支付、支付宝）、公积金、医保账户、货币基金（例如余额宝）、债券、各种股票及基金产品、房地产、贵金属、外部借款（尽量不做此配置🤫）以及其他投资等等（对于部分朋友，或许还有贷款、欠款等负债）。这些账户中的数额在不断变动，使得快速准确地了解个人总资产状况成为一项挑战。
本项目旨在提供一个高效、直观的解决方案，以应对个人资产管理中的分散性和复杂性。生财有迹专注于账户余额及整体数额，避免深陷于单笔收支的琐碎细节。其目标是通过简化操作流程，帮助用户揭示个人资产的整体变化趋势，并通过友好的用户界面，使用户能够轻松记录和洞悉自己的财务信息。如欲了解更多，可移步至博文：生财有迹 | 您专属的资产跟踪与分析工具。
通过这些特性，希望建立一个用户友好、透明且可信赖的个人财分析工具，帮助用户更全面地掌握自己的财务状况。
为了让您更直观地了解 生财有迹 的功能和特性，已在服务器上使用 pm2 部署了一个演示版本。该演示环境填充了模拟数据，方便您全面体验各项功能。无论您是想评估工具的实用性，还是出于好奇想一探究竟，欢迎访问以下链接进行体验：
请注意，这是一个公共演示环境，因此请勿在其中输入任何真实的个人财务信息。建议您在体验后，考虑按照本文档的指导，在自己的环境中部署和使用"生财有迹"，以确保您的财务数据的隐私和安全。
如果您在使用过程中遇到任何问题或有反馈意见，欢迎通过项目的 GitHub 页面与我们联系。您的宝贵意见将帮助我们不断改进这一工具，以更好地满足用户的需求。
使用 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 来访问，您也可以指定其他端口。
PM2 是一个强大的生产环境进程管理器，它不仅支持通过命令行启动应用，还可以使用配置文件（通常名为 ecosystem.config.js）来管理复杂的部署场景。为了简化部署流程并确保一致性，本项目已将所有必要的 PM2 配置和启动命令封装到了 npm 脚本中：
# clone project
git clone https://github.com/nicejade/wealth-tracker.git
cd wealth-tracker
# globally install pm2 pnpm & lerna
npm i pm2 pnpm lerna -g
# install dependencies(client & server)
pnpm i
# start your service
npm run deploy
除了 deploy 命令，项目还提供了其他几个常用的 npm 脚本：
npm run start: 使用 PM2 启动应用；npm run stop: 停止 PM2 管理的应用；npm run restart: 重启应用；npm run logs: 查看应用日志。说明用户在安装和使用前，需要准备的一些先决条件，譬如：您需要安装或升级 Node.js（>= 16.*），推荐使用 Pnpm 或 Yarn 作为首选包管理工具。本项目采用 pnpm （利用其 workspace 功能）结合 Lerna@8.1 来管理项目依赖，以实现更高效的包管理和工作流程。为确保您的开发环境与项目要求一致，建议您全局安装这两个工具：
# clone project
git clone https://github.com/nicejade/wealth-tracker.git
cd wealth-tracker
# globally install pm2 pnpm & lerna
npm i pm2 pnpm lerna -g
# install dependencies(client & server)
pnpm i
# install & run for client
cd client && pnpm start
# install & run for srever
cd server && pnpm start
本项目客户端采用 Svelte 框架，基于 Vite 所构建，默认 5173 端口，只需打开网址—— http://localhost:5173 即可访问。
在项目开发初期，有为应用取中文名为："财富追踪器"（英文名：Wealth Tracker）。这个名称初看简洁明了，似乎完美契合产品理念。然而，随着开发深入，逐渐显现出其局限性：
这种认知更新促使重新思考产品定位和命名。偶然想到了两个颇具启发性的成语："生财有道"和"生财有术"；而应用的核心功能恰恰是记录资产增长的轨迹。基于这一灵感，最终确定将应用命名为"生财有迹"。这个名字巧妙地结合了几个要素：
"生财有迹"这个新名称不仅准确反映出产品功能定位，传达了产品理念，还蕴含了对用户资产增长的美好祝愿，希望您也会喜欢。
"生财有迹"项目正处于积极的设计和研发阶段，致力于在功能丰富与易用性之间寻求平衡，以满足用户日益增长的个人财务管理需求。未来开发重点包括增强数据可视化能力、加强数据安全性、以及提升 AI 辅助分析功能等。
知人者智，自知者明：清晰了解自身的资产状况，才能更好地规划未来。面对日益复杂、多元化的资产管理需求，提供一个高效的解决方案尤为关键。本项目旨在为用户提供全面的支持，帮助他们实现更精准的财务规划和明智决策，从而有效促进个人财富的持续增长。
传统记账应用主要关注日常收支明细，适合学生等收入有限人群；而「生财有迹」专注于已形成的资产存量，帮助用户了解"现在拥有什么"（现状与未来），而非过往的支出记录（历史）。这种设计更符合在职人士的理财需求，让用户把精力集中在资产的整体规划和增长上。
生财有迹不仅仅是一个资产追踪工具，更期望成为用户的智能财富助手。未来的发展规划主要包括：
推荐使用 pnpm 来安装依赖，执行命令 pnpm i。如遇到网络问题，可使用国内镜像加速（如 阿里云 npmmirror 镜像站），以确保快速顺利完成安装，具体命令如下：
pnpm i --registry=https://registry.npmmirror.com
SQLite3 是一款轻量级数据库，无需额外配置，简单易用且高效。由于本项目不需要存储大量数据，SQLite3 非常适合。此外，它支持快速的数据同步和迁移，能够满足项目的灵活性和性能需求。
本项目的开发过程中，依赖并受益于以下优秀的开源技术和工具（未包含全部）。它们不仅提供了强大的功能，还促进了项目的高效开发和稳定运行。
在此，对上述技术和工具的开发者和社区，致以崇高的敬意和衷心的感谢❤️。正是得益于他们的卓越贡献，生财有迹才能得以成功构建并持续优化。同时，也要感谢如 Codeium Windsurf 、Cursor 、ChatGPT、Github Copilot 、Poe、Kimi 等 AI 工具在开发过程中提供的宝贵支持，它们显著提高了工作效率和体验。
这是一个专为移动设备优化的页面（即为了让你能够在 Google 搜索结果里秒开这个页面），如果你希望参与 V2EX 社区的讨论，你可以继续到 V2EX 上打开本讨论主题的完整版本。
V2EX 是创意工作者们的社区，是一个分享自己正在做的有趣事物、交流想法，可以遇见新朋友甚至新机会的地方。
V2EX is a community of developers, designers and creative people.