pyr0ball
2dda26a911
Closes #15, #22, #24, #25. Closes #1 and #27 (already shipped in 0.2.0). ## CI/CD (#22) - .forgejo/workflows/ci.yml — Python lint (ruff) + pytest + Vue typecheck + vitest on every PR/push. Installs cf-core from GitHub mirror for the CI runner. - .forgejo/workflows/release.yml — Docker build/push (api + web) to Forgejo registry on v* tags; git-cliff changelog; multi-arch amd64+arm64. - .forgejo/workflows/mirror.yml — push to GitHub + Codeberg mirrors. ## Self-hosted installer (#25) - install.sh rewritten to match CF installer pattern: coloured output, named functions, --docker / --bare-metal / --help flags, auto-detect Docker/conda/ Python/Node/Chromium/Xvfb, license key prompting with format validation. ## Nginx docs (#24) - docs/nginx-self-hosted.conf — sample nginx config: SPA fallback, SSE proxy (proxy_buffering off), long-term asset cache headers. - docs/getting-started/installation.md — bare-metal install section with nginx setup, Chromium/Xvfb note, serve-ui.sh vs nginx trade-off. ## cf-orch agent (#15) - compose.override.yml — cf-orch-agent sidecar service (profiles: [orch]). Starts only with docker compose --profile orch. Registers with coordinator at CF_ORCH_COORDINATOR_URL (default 10.1.10.71:7700). - .env.example — CF_ORCH_URL / CF_ORCH_COORDINATOR_URL comments expanded. ## Docs - mkdocs.yml + full docs/ tree (getting-started, reference, user-guide) staged from prior session work. Bump version 0.2.0 → 0.3.0.
39 lines
1.6 KiB
Markdown
39 lines
1.6 KiB
Markdown
# Quick Start
|
||
|
||
## 1. Run a search
|
||
|
||
Type a query into the search bar and press **Search** or hit Enter.
|
||
|
||
!!! tip
|
||
Start broad (`vintage camera`) then narrow with keyword filters once you see results. The must-include and must-exclude fields let you refine without re-searching from scratch.
|
||
|
||
## 2. Read the trust badge
|
||
|
||
Each listing card shows a trust badge in the top-right corner:
|
||
|
||
| Badge | Meaning |
|
||
|-------|---------|
|
||
| Green (70–100) | Established seller, no major concerns |
|
||
| Yellow (40–69) | Some signals missing or marginal |
|
||
| Red (0–39) | Multiple red flags — proceed carefully |
|
||
| `STEAL` label | Price significantly below market median |
|
||
|
||
A spinning indicator below the badge means enrichment is still in progress (account age is being fetched). Scores update automatically when enrichment completes.
|
||
|
||
## 3. Check red flags
|
||
|
||
Red flag pills appear below the listing title when Snipe detects a concern. Hover or tap a flag for a plain-language explanation.
|
||
|
||
## 4. Click through to eBay
|
||
|
||
Listing titles link directly to eBay. In cloud mode, links include an affiliate code that supports Snipe's development at no cost to you. You can opt out in Settings.
|
||
|
||
## 5. Filter results
|
||
|
||
Use the sidebar filters to narrow results without re-running the eBay search:
|
||
|
||
- **Min trust score** — slider to hide low-confidence listings
|
||
- **Min account age / Min feedback** — hide new or low-volume sellers
|
||
- **Hide listings checkboxes** — hide new accounts, suspicious prices, duplicate photos, damage mentions, long-on-market, significant price drop
|
||
|
||
These filters apply instantly to the current result set. Use the search bar to change the underlying eBay query.
|