اسکریپت ModuQR یک استودیوی متنباز برای ساخت، طراحی و اسکن QR است که دو اصل را جدی میگیرد: حفظ قابلیت اسکن و حریم خصوصی در حالت Static.
پروژه در مرحلهی توسعهی pre-1.0 و نسخهی Repository برابر 0.1.0 است. اولین Release عمومی فقط پس از پاس کامل نصب تمیز Dependencyها، TypeScript، Lint، Unit Test، Production Build، Playwright، Accessibility و Dependency Audit با برچسب v0.1.0 منتشر میشود. شمارهی Phaseها به Major Version نگاشت نمیشود و 1.0.0 فقط برای زمانی رزرو است که APIها، Schemaها و قراردادهای سازگاری پروژه واقعاً پایدار شده باشند.
پیادهسازی Phase 2 اکنون شامل Connected/Fluid neighbour-aware، کنترل مستقل Finderها، Gradientهای چندمرحلهای، migration فایل طراحی از schema v1 و v2 به v3، Presetهای حرفهای، پروژههای محلی، Scanner دوربین/تصویر، Safety Simulation، اشتراکگذاری فقطِ استایل و Batch محلی تا ۵۰۰ ردیف است. انتشار نهایی همچنان به عبور کامل از دروازهی تست و CI وابسته است.
- URL، متن، ایمیل، تلفن، SMS، WhatsApp، WiFi، vCard، موقعیت جغرافیایی و رویداد iCalendar
- Smart Detect برای ورودی Pasteشده
- Renderer اختصاصی SVG و جداسازی Encoding از Styling
- کنترل شکل Module و Finder، Connected/Fluid، رنگ، Gradient، Quiet Zone و Error Correction
- کنترل مستقل Finder بالا-چپ، بالا-راست و پایین-چپ
- لوگوی PNG/JPEG/WebP/SVG با validation و Sanitization و محافظت از Finderها
- 60 Preset دادهمحور با جستوجو، دستهبندی و Favorite محلی
- Scan Safety Score همراه با Decode واقعی خروجی و مدیریت کنترلشدهی payload بیش از ظرفیت
- خروجی SVG، PNG، JPEG، WebP و PDF
- Scanner دوربین/تصویر و Scan → Redesign بدون قرار دادن Payload حساس در URL
- Batch محلی CSV/TSV/JSON تا ۵۰۰ ردیف با Worker، Template، خروجی ZIP/PDF و بررسی ظرفیت فایل
- ذخیرهی Local Project در IndexedDB و Import/Export فایل JSON نسخهدار
- Light/Dark/System، PWA، Offline reuse، SEO و تستهای خودکار
در حالت Static، دادهی QR، رمز WiFi، لوگو و تصویر Scanner برای تولید QR به Backend پروژه ارسال نمیشوند. پروژههای ذخیرهشده نیز داخل IndexedDB مرورگر باقی میمانند. فایلهای لوگو و Design JSON بهعنوان ورودی غیرقابلاعتماد اعتبارسنجی میشوند و URLهای Scanشده خودکار باز نمیشوند.
corepack prepare pnpm@10.15.0 --activate
corepack pnpm install --frozen-lockfile
corepack pnpm devبرای تست Local نیازی به دانلود Browserهای Playwright نیست؛ تست Local از Google Chrome نصبشدهی سیستم استفاده میکند. CI ماتریس Chromium/Firefox/WebKit را اجرا میکند.
برای Production باید NEXT_PUBLIC_SITE_URL روی دامنهی HTTPS واقعی تنظیم شود.
apps/web
packages/core
packages/renderer
packages/presets
packages/scan-validator
packages/shared
جزئیات معماری در Architecture و ماتریس تست در Testing قرار دارد.