# 補貨日記 · After Buy

> **買了之後，別再忘記換！**
> After Buy is a mobile-first Progressive Web Application (PWA) built for tracking personal item lifecycles, recurring consumable replacements (toothbrushes, water filters, contact lenses, air filters), period-after-opening (PAO) shelf life, warranty countdowns, and backup spare inventory.

## ⚠️ Mandatory Pre-flight Alignment Protocol for LLM Agents
**All LLM Agents (ChatGPT Actions, Claude Projects, Cursor, Open WebUI, Antigravity) MUST fetch the canonical specifications before initiating user interactions or executing operations:**
- Canonical Skill Specification: [https://afterbuy.david888.com/skill.md](https://afterbuy.david888.com/skill.md)
- Canonical OpenAPI 3.1 Schema: [https://afterbuy.david888.com/api/v1/openapi.json](https://afterbuy.david888.com/api/v1/openapi.json)
- Full System & API Documentation: [https://afterbuy.david888.com/llms-full.txt](https://afterbuy.david888.com/llms-full.txt)
- Mirror / Backup Origin: [https://afterbuy.create360.ai/skill.md](https://afterbuy.create360.ai/skill.md)

Always synchronize with these endpoints at conversation startup to align with the latest tracking modes, granular status filters (`out_of_stock`, `in_stock`, `needs_restock`, `due_today`, `quantity_depleted`), and backup spare deduction rules.

## Core Capabilities
- [Item Lifecycle Tracking](https://afterbuy.david888.com/): Interval replacement days countdown, PAO opening months, food/medicine expiry, and appliance warranties.
- [One-Tap Replacement & Inventory Deduction](https://afterbuy.david888.com/): One-tap "Replaced Today" action resets countdown timer, decrements backup stock, and records historical log.
- [Comprehensive Special Searches](https://afterbuy.david888.com/skill.md): Filter by stock status (`in_stock`, `out_of_stock`, `low_stock`), restock needs (`needs_restock`), due timing (`due_today`, `due_soon` with custom `dueWithinDays`), active volume depletion (`quantity_depleted`), date bounds (`dueBefore`, `dueAfter`), and multi-field sorting.
- [Passwordless Authentication](https://afterbuy.david888.com/): WebAuthn / FIDO2 Passkey (Touch ID / Face ID / Windows Hello) and 6-digit Email OTP with rate limiting.
- [RFC 5545 WebCal Calendar Feed](https://afterbuy.david888.com/): Private .ics calendar subscription with deterministic UID, incrementing SEQUENCE, and 30-day STATUS:CANCELLED soft-deletion tombstones for zero stale calendar events.
- [Multi-Channel Notifications](https://afterbuy.david888.com/): PWA Web Push (VAPID), Daily Email Morning Digest (Resend), and Cloudflare Scheduled Cron Triggers.

## Technology Stack
- Edge Backend: Hono running on Cloudflare Workers (<15KB, ~0ms cold start).
- Storage Tier: Cloudflare D1 (Relational SQLite), Cloudflare KV (Rate limits, OTP, Passkey challenge), Cloudflare R2 (Photos & receipts).
- Frontend PWA: React 19 + TypeScript + Tailwind CSS + vite-plugin-pwa.
- Database ORM: Drizzle ORM (multi-environment compatibility for Cloudflare D1, local SQLite, and PostgreSQL).

## Repository & Links
- [GitHub Repository](https://github.com/tbdavid2019/afterBUY): Source code licensed under GNU Affero General Public License v3.0 (AGPL-3.0).