README
¶
server price tracker
An API-first Go service that monitors eBay listings for server hardware, extracts structured attributes via LLM (Ollama, Anthropic Claude, or compatible backends), scores listings against historical baselines, and alerts on deals via Discord webhooks. The CLI acts as a client to the API, and the API design supports future integrations (Discord bot, web UI, Grafana dashboards).
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
server-price-tracker
command
Package main is the entry point for the server-price-tracker.
|
Package main is the entry point for the server-price-tracker. |
|
server-price-tracker/cmd
Package cmd implements the CLI commands for server-price-tracker.
|
Package cmd implements the CLI commands for server-price-tracker. |
|
internal
|
|
|
api/client
Package client provides a thin HTTP client for the server-price-tracker API.
|
Package client provides a thin HTTP client for the server-price-tracker API. |
|
api/handlers
Package handlers implements HTTP handlers for the server-price-tracker API.
|
Package handlers implements HTTP handlers for the server-price-tracker API. |
|
api/middleware
Package middleware provides Echo middleware for server-price-tracker.
|
Package middleware provides Echo middleware for server-price-tracker. |
|
config
Package config handles loading and validating the application configuration from YAML files with environment variable substitution.
|
Package config handles loading and validating the application configuration from YAML files with environment variable substitution. |
|
ebay
Package ebay provides an eBay Browse API client abstracted behind interfaces for testability.
|
Package ebay provides an eBay Browse API client abstracted behind interfaces for testability. |
|
engine
Package engine implements the core business logic loops: scoring, ingestion, baseline recomputation, and alert evaluation.
|
Package engine implements the core business logic loops: scoring, ingestion, baseline recomputation, and alert evaluation. |
|
metrics
Package metrics defines Prometheus metrics for server-price-tracker.
|
Package metrics defines Prometheus metrics for server-price-tracker. |
|
notify
Package notify defines the notification interface and implementations for alert delivery.
|
Package notify defines the notification interface and implementations for alert delivery. |
|
store
Package store defines the datastore abstraction for server-price-tracker.
|
Package store defines the datastore abstraction for server-price-tracker. |
|
pkg
|
|
|
extract
Package extract provides LLM-based attribute extraction for eBay listings, abstracted behind interfaces for testability.
|
Package extract provides LLM-based attribute extraction for eBay listings, abstracted behind interfaces for testability. |
|
scorer
Package score implements the composite deal scoring algorithm for eBay listings.
|
Package score implements the composite deal scoring algorithm for eBay listings. |
|
types
Package domain defines the core business types for the server price tracker.
|
Package domain defines the core business types for the server price tracker. |
|
test
|
|
|
utils
Package testhelper provides shared utilities for integration and e2e tests.
|
Package testhelper provides shared utilities for integration and e2e tests. |
|
tools
|
|
|
mock-server
command
Package main implements a mock eBay API server for local development.
|
Package main implements a mock eBay API server for local development. |
Click to show internal directories.
Click to hide internal directories.