first push

2026-06-04 16:20:56 -05:00
parent a663de4f29
commit 392ae7bbe3
111 changed files with 5312 additions and 0 deletions
@@ -0,0 +1,57 @@
+---
+type: project
+status: active
+source: git.alwisp.com
+repo: qrknit/qrknit
+repo_url: https://git.alwisp.com/qrknit/qrknit
+language: HTML
+branch: master
+tags: [repo, qrknit]
+updated: 2026-05-29
+---
+
+# qrknit
+
+**Repository:** [qrknit/qrknit](https://git.alwisp.com/qrknit/qrknit) · branch `master` · HTML
+
+## Summary
+
+QRKnit: commercial QR code generator and URL shortener — create, manage, and track branded QR codes and short links
+
+## Current status
+
+Active. Synced from Gitea on 2026-05-29.
+
+## Documentation overview
+
+# QRknit — URL Shortener & QR Code Generator
+
+A managed URL shortener with QR code generation, deep click analytics, and tag-based link organization.
+
+- **Multi-user** — admin account seeded from env vars; admin can create/delete/manage accounts via the UI
+- **Per-user isolation** — each user sees only their own links and tags; admin has its own isolated workspace separate from all other accounts
+- **Organizations** — group users into orgs that share link/tag visibility and pool usage quotas under a shared plan
+- **Plan tiers** — Admin / Free / Starter / Pro / Team with enforced limits on active links, monthly clicks, and analytics history window; org members inherit their org's plan
+- **Scoped tags** — tags are owned by the user who creates them; org members share a tag namespace, solo users and admins each have their own isolated namespace
+- **Deep analytics** — daily charts, referrer/device/browser/country breakdowns, hourly 7×24 heatmap, raw click CSV export
+- **Private instance** — Pro and Team plans include a dedicated private deployment on your own infrastructure
+
+---
+
+## 🗺 Feature Map
+
+### Shipped
+
+| Feature area | What's included |
+|---|---|
+| **Short links** | Random & custom codes, link expiry, pinned links, one-click copy, auto-fetch page title |
+| **QR codes** | QR generation for any link or URL, logo overlay, dot-shape presets, inline thumbnail, copy to clipboard |
+| **Analytics** | Per-link daily click charts, referrer / device / browser / country breakdowns, hourly 7×24 heatmap, raw click CSV export |
+| **Tags** | Tag links for filtering; tags are scoped per user — org members share a namespace, solo users and admins each have their own |
+| **Bulk tools** | Bulk delete, bulk tag, bulk expire; CSV import & export |
+
+…(truncated — see repo)
+
+## Notes
+
+- Project file auto-created from repo documentation.