5 Commits

Include renames

Author	SHA1	Message	Date
angel	cdd2202839	docs: document self-hosted Gitea and its MCP tooling for agents ... Make sure AI agents know this project is hosted on a self-hosted Gitea instance rather than GitHub, and that mcp__angel__* MCP tools (with no Projects API) are available for interacting with it.	2026-08-20 23:59:48 -06:00
angelandClaude Sonnet 5	b9dd4fc0e5	docs: split README into distributed docs, fix stale/broken content ... README had drifted: an unresolved merge-conflict marker left over from a past edit, a directory-structure diagram that no longer matches the repo (/internal/site, /internal/domains/platforms/tiktok - actual layout is server/, domains/, etc per AGENTS.md), and a duplicated dev-workflow blurb that AGENTS.md already documents more accurately. Splits the roadmap checklist out to ROADMAP.md and the Etsy API compliance checklist to domains/platforms/etsy/COMPLIANCE.md (next to the code it governs, where someone touching that integration will actually look for it) instead of burying both in one large README. README itself becomes a short front door with a "Where things live" index up top, since scattering docs across files only helps if there's an obvious map to them. Moves the CQRS/event-sourcing architecture note into AGENTS.md's Architecture section (with a new domains/raw_events bullet) rather than leaving it as prose in README, since AGENTS.md is the maintained engineering reference and that's where a reader would already be looking for how the domains are structured. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>	2026-08-20 17:34:58 -06:00
angelandClaude Sonnet 5	308f16f6cc	docs: add platform market research and weighted integration priority ranking ... Research to inform which mock platform (Amazon, Shopify, etc.) is worth turning into a real integration next, after Etsy. Adds GMV/seller-count market-size data for every platform in domains/accounts/platform.go, a weighted scoring model (GMV 45%, API/inventory-webhook completeness 30%, growth 15%, integration cost 10%), and the resulting ranked order. Also fills in Etsy's own row, sourced directly from domains/platforms/etsy/generated_client rather than external docs since it's the one platform actually live in this repo: Etsy Open API v3 has no webhook/push mechanism at all, and only the OAuth connection flow is built so far - polling-based order/inventory sync doesn't exist yet. Etsy is included as a reference score (3.85/10) against the same rubric used for the unbuilt platforms, mainly as a sanity check on the model rather than a claim that building it first was wrong. Flags that the existing capability table's BigCommerce row doesn't match an actual platform in this codebase (Tiktok does, and is now researched instead), and that Tiktok Shop's API details are unconfirmed pending a dedicated research pass. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>	2026-08-20 16:23:47 -06:00
angelandClaude Sonnet 5	f731947b51	docs: fill in AGENTS.md ... Setup, common commands, architecture overview, and the database/testing gotchas actually hit while working in this repo recently: migration files that can drift to the point of being unrunnable (not just stale), inconsistent platform-string casing between Go constants and SQL objects, global (unscoped) mock-platform NOTIFY channels, the require.Eventually-runs-on-a-goroutine hazard, and why domains/reports' fixtures use Etsy rather than Amazon. CLAUDE.md already points here via @AGENTS.md, so no change needed there. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XEDaCB7C2NEBgyvqEtZuxY	2026-08-20 00:36:55 -06:00
angel	fe8c451739	stubbed CLAUDE.md and AGENTS.md	2026-08-20 00:36:55 -06:00