pixelpulse01/3dfilamentmanagement repository overview

🌐 Bilingual · 🐳 Docker · 🪟 Windows Portable · 📊 Cost Calculator

⁠

⁠3D Filament Inventory Management System / 3D 打印耗材库存管理系统

A full-featured consumable asset management tool for 3D printing enthusiasts, small studios, and print farms. Track filaments from purchase to depletion, manage printers and slots, and calculate project costs with a built-in commercial pricing engine.

一款面向 3D 打印爱好者、小型工作室和打印农场的全功能耗材资产管理工具。耗材全生命周期追踪、设备与槽位管理、内置商业成本计算器。

GitHub: pixelpulse0x1/3DFilamentManagement⁠

Memory: 30.21MB

⁠📖 English

⁠✨ Key Features

• Dashboard & Statistics — Inventory overview, weight tracking, low-stock alerts, per-brand stats, cross status matrix (Material × 5-state)
• Filament Management — Full lifecycle (purchase → open → load → deplete), 5-state machine, dual-track loading, weighing calculator, batch operations
• Device Management — Multi-printer + multi-slot (AMS), load/unload with auto status sync, 36 built-in printer models (Bambu Lab / Creality / Prusa / etc.)
• Commercial Pricing Engine — Dynamic multi-row cost calculator, Suggested Price = (Total Cost + Labor) / (1 − Profit% − Platform% − Tax%), zero-denominator protection, history center (50 records)
• Reports — Usage logs with withdraw mechanism, monthly/daily charts (Chart.js), ROI billing, 7-sheet Excel export
• System — Glassmorphism dark UI, background customization, one-click backup & hot restore, data migration from legacy DB
• i18n — 624-key Chinese/English bilingual dictionary, instant language switch, status enum disaster prevention (triple-layer defense)

⁠📸 Screenshots

⁠🚀 Quick Start

⁠Option 1: Docker Pull

docker pull pixelpulse01/3dfilamentmanagement:latest

docker run -d \
  --name 3dfilament \
  -p 9055:3155 \
  -v /opt/docker-stacks/3dfilamentmanagement:/data \
  -e SECRET_KEY=your-random-secret-key \
  -e TZ=Asia/Shanghai \
  pixelpulse01/3dfilamentmanagement:latest

Then visit http://:9055

⁠Option 2: Docker Compose (Recommended)

Create a docker-compose.yml:

services:
  3dfilamentmanagement:
    image: pixelpulse01/3dfilamentmanagement:latest
    container_name: 3dfilamentmanagement
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai
      - SECRET_KEY=change-me-to-random-string
      - DATA_DIR=/data
    ports:
      - "9055:3155"
    volumes:
      - /opt/docker-stacks/3dfilamentmanagement:/data

Then:

docker compose up -d

⁠🔧 Configuration

⁠📁 Data Persistence

All data is stored in /data inside the container:

/data/
├── database/
│   └── filament_inventory.db     # SQLite database (auto-migrated on startup)
└── uploads/
    ├── backgrounds/              # Background images
    └── filaments/                # Filament photos

Mount a host directory to /data to persist your database and uploads across container rebuilds.

⁠🏗️ Build from Source

git clone https://github.com/pixelpulse0x1/3DFilamentManagement.git
cd 3DFilamentManagement/workspace

# Build & run
docker compose build --no-cache
docker compose up -d

⁠🖥️ Windows Portable Edition

A zero-dependency Windows portable version is also available. Download 3D_Inventory_Management_v0.6.2.3.zip from the GitHub Releases⁠, extract anywhere, and double-click 运行系统.bat — no Python installation required.

⁠🛠️ Tech Stack

⁠📖 Documentation

• TECHNICAL_REFERENCE.md⁠ — Full technical reference (DB schema, API docs, migration engine, pricing formulas, build & packaging guide) — in Chinese

⁠🔄 Version History

⁠📄 License

MIT License. See LICENSE⁠.

⁠📖 中文

⁠✨ 核心功能

• 仪表板与统计 — 库存总览看板、使用重量追踪、低库存预警、厂商耗材统计、材料类型 × 5 态交叉矩阵
• 耗材管理 — 全生命周期（购买→开封→上机→耗尽）、5 态状态机、双轨上机、称重计算器、批量操作
• 设备管理 — 多打印机 + 多槽位 (AMS)、上机/下机自动状态同步、36 款内置打印机型号（拓竹/创想三维/Prusa 等）
• 商业报价引擎 — 多行动态成本计算器、建议报价 = (总成本 + 辛苦费) / (1 − 利润率% − 平台抽成% − 税率%)、分母为零防崩溃、50 条历史记录
• 使用记录与报表 — 撤回机制、月度/每日图表 (Chart.js)、ROI 效能账单、Excel 7 表导出
• 系统管理 — 玻璃拟态深色 UI、外观定制、一键备份与热还原、旧版数据迁移
• 国际化 — 624 键中英双语字典、即时语言切换、状态枚举通信防灾（三层防御）

⁠📸 系统截图

⁠🚀 快速开始

⁠方式一：直接拉取镜像

docker pull pixelpulse01/3dfilamentmanagement:latest

docker run -d \
  --name 3dfilament \
  -p 9055:3155 \
  -v /opt/docker-stacks/3dfilamentmanagement:/data \
  -e SECRET_KEY=your-random-secret-key \
  -e TZ=Asia/Shanghai \
  pixelpulse01/3dfilamentmanagement:latest

访问 http://<你的服务器IP>:9055

⁠方式二：Docker Compose（推荐）

创建 docker-compose.yml：

services:
  3dfilamentmanagement:
    image: pixelpulse01/3dfilamentmanagement:latest
    container_name: 3dfilamentmanagement
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai
      - SECRET_KEY=change-me-to-random-string
      - DATA_DIR=/data
    ports:
      - "9055:3155"
    volumes:
      - /opt/docker-stacks/3dfilamentmanagement:/data

然后执行：

docker compose up -d

⁠🔧 配置参数说明

⁠📁 数据持久化

所有数据存储在容器内 /data 目录：

/data/
├── database/
│   └── filament_inventory.db     # SQLite 数据库（启动时自动迁移）
└── uploads/
    ├── backgrounds/              # 背景图
    └── filaments/                # 耗材实物图

将宿主机目录挂载到 /data 即可在容器重建后保留数据库和上传文件。

⁠🏗️ 从源码构建

git clone https://github.com/pixelpulse0x1/3DFilamentManagement.git
cd 3DFilamentManagement/workspace

# 构建并启动
docker compose build --no-cache
docker compose up -d

⁠🖥️ Windows 绿色便携版

同时提供零依赖的 Windows 绿色便携版。从 GitHub Releases⁠ 下载 3D_Inventory_Management_v0.6.2.3.zip，解压到任意目录，双击 运行系统.bat 即可启动——无需安装 Python 或任何运行环境。

⁠🛠️ 技术栈

⁠📖 文档

• TECHNICAL_REFERENCE.md⁠ — 完整技术参考（数据库结构 · API 文档 · 迁移引擎 · 报价公式 · 打包编译 · 部署指南）

⁠🔄 版本历史

⁠📄 License

MIT License. 详见 LICENSE⁠。

⁠☕ 支持项目 / Support the Project

❤️ 所有打赏将用于服务器/域名开销，或只是让我在深夜写代码时多杯热茶。

All donations go toward server/domain costs, or just a cup of tea for late-night coding.

微信赞赏 · 金额随心 WeChat · Amount at Will

支付宝红包 · 扫码支持 Alipay · Scan to Support

_{⚠️ 此赞助完全自愿，不构成任何服务合同，Issue 仍按正常优先级处理。}

_{⚠️ This sponsorship is completely voluntary and does not constitute any service contract. Issues will still be processed with standard priority.}

_{Built with ❤️ by pixelpulse0x1⁠}