dumbwareio/dumbassets

DumbAssets

一个极其简单的资产跟踪器，用于记录您的实物资产、其组件以及适用的保修和日常维护信息。

演示

---

目录

• 镜像概述
• 核心功能和特性
• 使用场景和适用范围
• 使用方法
• 配置说明
• 安全性
• 技术细节
• 贡献指南
• 许可证

---

镜像概述

DumbAssets 是一个简单易用的实物资产管理工具，专为需要跟踪资产信息、组件、保修和维护记录的个人和小型组织设计。该工具以"简单至上"为理念，提供直观的用户界面和基本但全面的资产跟踪功能，无需复杂的设置或专业知识。

主要用途：

• 记录和管理实物资产信息
• 跟踪资产组件和子组件的层级关系
• 管理保修期限和维护记录
• 存储资产相关照片和收据文档
• 接收保修到期和维护提醒通知

---

核心功能和特性

• 🚀 跟踪资产详细信息（型号、序列号、保修等）
• 🧩 添加组件和子组件
• 🖼️ 上传和存储照片及收据
• 🔍 按名称、型号、序列号或描述搜索
• 🏷️ 组件的层级组织
• 📅 保修到期通知（可配置）
• 🔧 维护事件通知
• 🏷️ 灵活的标签系统，便于更好地组织
• 🔔 内置 Apprise 通知集成
• 🌗 明暗模式切换，主题持久化
• 🛡️ PIN 认证，带暴力破解保护
• 📦 Docker 支持，便于部署
• 🔗 直接资产链接：通知中包含指向特定资产的链接

---

使用场景和适用范围

DumbAssets 适用于以下场景：

• 个人用户：跟踪个人电子设备、家电和贵重物品的保修信息
• 小型企业：管理办公设备、工具和固定资产
• 技术爱好者：记录个人项目中的组件和零件信息
• 家庭用户：管理家庭财产，便于保险索赔或财产清点
• 维修人员：跟踪维修物品的保修状态和维护历史

特别适合那些需要简单解决方案而不是复杂企业级资产管理系统的用户。

---

使用方法

前提条件

• Docker（推荐）
• Node.js >=14.0.0（用于本地开发）

选项 1：Docker 快速启动

sh
docker run -p 3000:3000 -v ./data:/app/data dumbwareio/dumbassets:latest

1. 访问 http://localhost:3000
2. 添加资产，上传照片/收据，跟踪保修
3. 体验这个简单易用的工具

选项 2：Docker Compose 自定义部署

创建 docker-compose.yml 文件：

yaml
services:
  dumbassets:
    container_name: dumbassets
    image: dumbwareio/dumbassets:latest
    restart: unless-stopped
    ports: 
      - ${DUMBASSETS_PORT:-3000}:3000
    volumes:
      - ${DUMBASSETS_DATA_PATH:-./data}:/app/data
    environment:
      NODE_ENV: ${DUMBASSETS_NODE_ENV:-production}
      DEBUG: ${DUMBASSETS_DEBUG:-true}
      SITE_TITLE: ${DUMBASSETS_SITE_TITLE:-DumbAssets}
      BASE_URL: ${DUMBASSETS_BASE_URL:-http://localhost:3000}
      DUMBASSETS_PIN: ${DUMBASSETS_PIN:-1234}
      ALLOWED_ORIGINS: ${DUMBASSETS_ALLOWED_ORIGINS:-*}
      APPRISE_URL: ${DUMBASSETS_APPRISE_URL:-}
      # ...其他环境变量

然后运行：

sh
docker compose up -d

1. 访问 http://localhost:3000
2. 添加和管理您的资产

选项 3：本地运行（开发者）

sh
git clone https://github.com/yourusername/DumbAssets.git
cd DumbAssets
npm install
npm start

在浏览器中打开 http://localhost:3000

---

配置说明

环境变量

[!提示] DumbAssets 内置了 Apprise 集成，您只需添加 /ntfy/ 等链接，无需单独运行 Apprise 服务！

数据存储

所有数据以 JSON 文件形式存储在 /data 目录中：

• /data/Assets.json - 所有资产数据
• /data/SubAssets.json - 所有组件数据
• /data/Images - 上传的照片
• /data/Receipts - 上传的收据
• /data/config.json - 通知和应用配置

建议通过 Docker 卷挂载此目录，以确保数据持久化。

---

安全性

• 可变长度 PIN 支持（4位以上）
• 恒定时间 PIN 比较
• 暴力破解保护（多次尝试后锁定）
• 安全会话 cookie
• 不在客户端存储 PIN
• 请求频率限制

---

技术细节

技术栈

• 后端：Node.js (>=14.0.0) 与 Express
• 前端：原生 JavaScript (ES6+)
• 容器：基于 Alpine 的 Docker
• 通知：Apprise 集成（通过 Python）
• 上传：Multer 文件处理
• 调度：node-cron 用于保修和维护通知

依赖项

• express: Node.js Web 框架
• multer: 文件上传处理和 multipart/form-data 解析
• apprise: 通知系统集成
• cors: 跨域资源共享中间件
• dotenv: 环境变量配置管理
• express-rate-limit: API 保护的频率限制中间件
• express-session: 会话管理和认证
• cookie-parser: Cookie 解析中间件
• node-cron: 任务调度，用于通知
• uuid: 资产唯一 ID 生成
• sharp: 图像处理和优化
• compression: 响应压缩中间件
• helmet: 安全头中间件
• fs-extra: 增强的文件系统操作
• path: 路径操作工具

---

贡献指南

1. Fork 仓库
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 使用 Conventional Commits 提交更改
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开 Pull Request

有关本地设置和指南，请参见开发指南。

---

许可证

由 DumbWare.io 制作 ❤️