Conntacti

تطبيق سطح مكتب (Electron) لإدارة ودمج قوائم جهات الاتصال محلياً على جهازك — بدون رفع للسحابة.

الميزات

• استيراد من CSV وJSON وvCard (2.1 / 3.0 / 4.0) مع كشف ترميز الملفات
• مراجعة الدمج خطوة بخطوة (مكرر / شبه مكرر / غامض / جديد)
• تحرير الجدول، البحث، التصفية، التصدير (CSV، vCard 3/4، JSON)
• التحقق من أرقام الهاتف (libphonenumber) واقتراحات التشابه والدمج

التشغيل للتطوير

npm install
npm run dev      # Vite + Electron مع إعادة تحميل الواجهة
npm test         # اختبارات الوحدة + بناء Vite
npm run test:e2e # اختبارات Electron (Playwright) — يحتاج شاشة أو xvfb
npm run typecheck # فحص TypeScript للوحدات المعرّفة بـ .ts
npm start        # بناء الواجهة ثم تشغيل Electron

البناء والإصدار (Forgejo)

الريبو على Forgejo (ليس GitHub/GitLab): https://git.majlis.lab/mrn/conntacti

npm run dist              # AppImage محلي (غير مرفوع في git)
cp .env.example .env        # FORGEJO_TOKEN
npm run publish:forgejo     # Releases + Packages

• Releases — وسم vX.Y.Z + ملاحظات + مرفق AppImage
• Packages — conntacti/<version>/ و conntacti/latest/Conntacti.AppImage

توكن Forgejo (مرة واحدة)

1. الإعدادات → التطبيقات → Generate New Token
2. صلاحيات: write:repository و write:package
3. في .env: FORGEJO_TOKEN=... و FORGEJO_TLS_INSECURE=1

بعد كل commit، Husky يبني ويدفع ثم ينشر تلقائياً (يتطلب .env).

Forgejo Actions: .forgejo/workflows/release.yml — أضف سر FORGEJO_TOKEN في إعدادات المستودع.

رقم الإصدار: major · minor · patch — [bump: …] أو feat: / fix: في رسالة الـ commit.

مكان حفظ البيانات

يُخزَّن الملف على الجهاز في مجلد بيانات التطبيق:

~/.config/Conntacti/contacts-data.json (أو المسار المكافئ حسب النظام)

قبل كل حفظ يُنشأ نسخ احتياطي بامتداد .bak (يُحتفظ بآخر 24 نسخة).

الترخيص

MIT