mirror of
https://github.com/maziggy/bambuddy.git
synced 2026-10-21 10:15:04 +02:00
maziggy
76e327f4a1
A triage review of the last 200 closed issues found ~1/3 were
user-side setup errors — printer not in LAN developer mode, blocked
ports, Docker bridge networking, wrong access code, cross-subnet —
each costing a multi-round-trip support exchange.
Add a Connection Diagnostic that runs those checks automatically:
- backend/app/services/printer_diagnostic.py: TCP probes of MQTT
8883 / FTPS 990 / RTSPS 322, LAN developer mode, Docker network
mode, printer/host subnet match, MQTT credential class; each
check returns pass/fail/warn/skip with a localized fix.
- Routes: GET /printers/{id}/diagnostic (saved printer) and
POST /printers/diagnostic (pre-save Add-Printer flow).
- ConnectionDiagnostic.tsx: modal + shared checklist, surfaced from
the printer card actions menu, an offline-printer quick button,
the Add-Printer dialog, and a new System-page section.
- The in-app bug reporter scans configured printers when the form
opens and always shows the result inline — a healthy confirmation,
or the detected problem and its fix.
- config.yml troubleshooting link repointed to the rendered wiki
page; bug_report.yml gains a diagnostic checkbox.
Diagnostic strings translated across all 8 locales. Backend service
unit tests (15) + frontend modal tests (3). Ruff clean, frontend
build clean, i18n parity green.
177 lines
4.8 KiB
YAML
177 lines
4.8 KiB
YAML
name: Bug Report
|
|
description: Report a bug or unexpected behavior
|
|
title: "[Bug]: "
|
|
labels: ["bug", "triage"]
|
|
body:
|
|
- type: markdown
|
|
attributes:
|
|
value: |
|
|
Thanks for taking the time to report a bug! Please fill out the form below.
|
|
|
|
- type: dropdown
|
|
id: component
|
|
attributes:
|
|
label: Component
|
|
description: Which part of the project is affected?
|
|
options:
|
|
- Bambuddy
|
|
- SpoolBuddy
|
|
- Both
|
|
validations:
|
|
required: true
|
|
|
|
- type: textarea
|
|
id: description
|
|
attributes:
|
|
label: Bug Description
|
|
description: A clear and concise description of what the bug is.
|
|
placeholder: Describe what happened...
|
|
validations:
|
|
required: true
|
|
|
|
- type: textarea
|
|
id: expected
|
|
attributes:
|
|
label: Expected Behavior
|
|
description: What did you expect to happen?
|
|
placeholder: Describe what you expected...
|
|
validations:
|
|
required: true
|
|
|
|
- type: textarea
|
|
id: steps
|
|
attributes:
|
|
label: Steps to Reproduce
|
|
description: How can we reproduce this issue?
|
|
placeholder: |
|
|
1. Go to '...'
|
|
2. Click on '...'
|
|
3. See error
|
|
validations:
|
|
required: true
|
|
|
|
- type: dropdown
|
|
id: printer
|
|
attributes:
|
|
label: Printer Model
|
|
description: Which printer model are you using?
|
|
options:
|
|
- X1 Carbon
|
|
- X1
|
|
- X1E
|
|
- X2D
|
|
- P1S
|
|
- P1P
|
|
- P2S
|
|
- A1
|
|
- A1 Mini
|
|
- H2D
|
|
- H2D Pro
|
|
- H2C
|
|
- H2S
|
|
- Multiple printers
|
|
- Not printer-related
|
|
validations:
|
|
required: false
|
|
|
|
- type: input
|
|
id: version
|
|
attributes:
|
|
label: Bambuddy Version
|
|
description: Which version of Bambuddy are you running? (Check Settings page)
|
|
placeholder: e.g., 0.1.5
|
|
validations:
|
|
required: true
|
|
|
|
- type: input
|
|
id: spoolbuddy_version
|
|
attributes:
|
|
label: SpoolBuddy Version
|
|
description: If SpoolBuddy-related, which version is running? (Check SpoolBuddy Settings → Updates)
|
|
placeholder: e.g., 0.1.0
|
|
|
|
- type: input
|
|
id: firmware
|
|
attributes:
|
|
label: Printer Firmware Version
|
|
description: Which firmware version is your printer running? (Check printer screen or Bambu Handy app). Leave blank if not printer-related.
|
|
placeholder: e.g., 01.08.00.00
|
|
|
|
- type: dropdown
|
|
id: installation
|
|
attributes:
|
|
label: Installation Method
|
|
description: How did you install Bambuddy?
|
|
options:
|
|
- Manual (git clone)
|
|
- Docker
|
|
- Other
|
|
validations:
|
|
required: true
|
|
|
|
- type: dropdown
|
|
id: os
|
|
attributes:
|
|
label: Operating System
|
|
description: What OS is Bambuddy running on?
|
|
options:
|
|
- Linux (Ubuntu/Debian)
|
|
- Linux (Other)
|
|
- macOS
|
|
- Windows
|
|
- Docker
|
|
- Other
|
|
validations:
|
|
required: true
|
|
|
|
- type: markdown
|
|
attributes:
|
|
value: |
|
|
---
|
|
### 📦 Support Package
|
|
|
|
For faster debugging, please create and attach a **Support Package** from **Settings → System Info → Download Support Package**.
|
|
This includes logs, system info, and configuration (with sensitive data redacted).
|
|
|
|
For detailed instructions on enabling debug logging, see: [Debug Logging Guide](https://wiki.bambuddy.cool/features/system-info/?h=debug#enable-debug-logging)
|
|
|
|
- type: textarea
|
|
id: logs
|
|
attributes:
|
|
label: Relevant Logs / Support Package
|
|
description: |
|
|
Attach a support package (.zip) or paste relevant logs here. Enable DEBUG mode for verbose logging.
|
|
💡 Tip: You can drag and drop files directly into this text box.
|
|
placeholder: |
|
|
Drag and drop your support package .zip file here, or paste logs...
|
|
|
|
- type: textarea
|
|
id: screenshots
|
|
attributes:
|
|
label: Screenshots
|
|
description: |
|
|
If applicable, add screenshots to help explain your problem.
|
|
💡 Tip: You can drag and drop images directly into this text box.
|
|
|
|
- type: textarea
|
|
id: additional
|
|
attributes:
|
|
label: Additional Context
|
|
description: Add any other context about the problem here.
|
|
|
|
- type: checkboxes
|
|
id: checklist
|
|
attributes:
|
|
label: Checklist
|
|
options:
|
|
- label: I have searched existing issues to ensure this bug hasn't already been reported
|
|
required: true
|
|
- label: I am using the latest version of Bambuddy
|
|
required: true
|
|
- label: My printer is set to LAN Only mode
|
|
required: true
|
|
- label: My printer has Developer Mode enabled
|
|
required: true
|
|
- label: For a connection or printing problem, I ran the in-app Connection Diagnostic (printer card or System page) and included the result above
|
|
required: false
|