Glovelly Handbook

The Glovelly Handbook is the repo-owned guide for running, testing, and evolving Glovelly.

Glovelly is a personal business platform for self-employed music work. The product covers authenticated access, clients, gigs, gig expenses and receipt attachments, invoice generation, invoice issue/reissue/delivery, seller profile setup, Google Drive invoice publishing, email delivery, admin user management, and a small read-only MCP business data surface.

Start Here

• UAT and regression testing: manual tester journeys for checking the product before release.
• Domain notes: durable business concepts and vocabulary.
• Privacy policy: public privacy notice for Glovelly.
• Application terms: public terms of service for Glovelly.
• Engineering: architecture, authentication, deployment, data, email, and ADR notes.
• Testing notes: automated and manual verification guidance for engineers.
• Codebase map: compact technical orientation for future agent work.
• Conventions: repo conventions and maintenance notes.
• Roadmap: current direction and known follow-up areas.
• MCP notes: read-only MCP business data surface.

How To Use This Handbook

Use these Markdown files as the canonical source of truth. The published handbook is generated from this tree with DocFX and GitHub Pages.

For release confidence, start with the UAT section. For code changes, use the testing and conventions pages alongside the source files they reference.

Local Preview

Restore the repo-local .NET tools:

dotnet tool restore

Build and serve the handbook from the repo root:

dotnet tool run docfx docs/docfx.json --serve

The generated site is written to docs/_site, which is ignored by the DocFX build configuration.