প্রকল্প সম্পর্কে

Umami-কে একটি প্রাইভেসী-ফার্স্ট অ্যানালিটিক্স প্ল্যাটফর্ম হিসেবে উপস্থাপন করা হয়েছে যা ট্রাফিক, ক্যাম্পেইন, বিহেভিয়ার, কনভার্সন এবং রেভিনিউ-কে এক জায়গায় নিয়ে আসে। প্রজেক্টটি জোর দিয়ে বলেছে যে এটি কোনো কুকিজ বা নজরদারি কৌশল ব্যবহার করে না এবং এটি সেলফ-হোস্টেড অথবা হোস্ট করা ক্লাউড অফারের মাধ্যমে পরিচালনা করা যেতে পারে। README-তে একটি পাবলিক ডেমো লিঙ্ক করা আছে এবং প্রজেক্ট সাপোর্ট চ্যানেলের মধ্যে GitHub, Twitter, LinkedIn এবং Discord অন্তর্ভুক্ত। কোডটি MIT লাইসেন্সের অধীনে প্রকাশ করা হয়েছে। সোর্স থেকে ইনস্টলেশনের জন্য Node.js 18.18 বা তার পরবর্তী সংস্করণ এবং একটি PostgreSQL ডাটাবেস (ভার্সন 12.14 বা তার পরবর্তী) সহ একটি সার্ভার প্রয়োজন। ডকুমেন্ট করা পদ্ধতিটি হলো রিপোজিটরি ক্লোন করা, pnpm দিয়ে ডিপেন্ডেন্সি ইনস্টল করা, একটি `DATABASE_URL` কানেকশন স্ট্রিং সহ `.env` ফাইল তৈরি করা, বিল্ড চালানো এবং তারপরে অ্যাপ্লিকেশনটি শুরু করা। বিল্ড ধাপটি প্রথম ইনস্টলেশনের সময় ডাটাবেস টেবিল তৈরি করে এবং `admin` ইউজারনেম ও `umami` পাসওয়ার্ড সহ একটি লগইন ইউজার সিড করে। ডিফল্টভাবে অ্যাপটি `http://localhost:3000`-এ শুরু হয়, তাই ডকুমেন্টেশনে উল্লেখ করা হয়েছে যে আপনাকে সাধারণত একটি ওয়েব সার্ভার থেকে রিকোয়েস্ট প্রক্সি করতে হবে অথবা সরাসরি সার্ভ করার জন্য পোর্ট পরিবর্তন করতে হবে। বেশ কিছু এনভায়রনমেন্ট অপশন ডকুমেন্ট করা হয়েছে। `API_URL` ইন্টারনাল UI API কলের জন্য ব্যবহৃত বেস URL পরিবর্তন করতে পারে; রিলেটিভ পাথগুলো `BASE_PATH`-এর অধীনে সার্ভ করা হয়, আর অ্যাবসোলিউট URL-গুলো লোকাল `/api` রুটের মাধ্যমে প্রক্সি করা হয়। `TWO_FACTOR_ENCRYPTION_KEY`, যা উদাহরণস্বরূপ `openssl rand -hex 32` দিয়ে তৈরি একটি ৬৪-ক্যারেক্টার হেক্স স্ট্রিং, টু-ফ্যাক্টর অথেন্টিকেশন সক্ষম করে; এটি সেট না করা পর্যন্ত টু-ফ্যাক্টর অথেন্টিকেশন অনুপলব্ধ থাকে এবং এটি বাধ্যতামূলক করা যায় না। কন্টেইনারাইজড ডেপ্লয়মেন্টের জন্য, প্রজেক্টটি Docker ইমেজ প্রকাশ করে এবং একটি Docker compose ফাইল প্রদান করে যা PostgreSQL ডাটাবেসের সাথে Umami পরিচালনা করে। আপডেটগুলো হয় সোর্স পুল করে, ডিপেন্ডেন্সি পুনরায় ইনস্টল এবং রিবিল্ড করার মাধ্যমে, অথবা নতুন ইমেজ পুল করে Docker compose-এর মাধ্যমে কন্টেইনারগুলো পুনরায় তৈরি করার মাধ্যমে সম্পন্ন করা হয়। একটি বিস্তারিত গেটিং-স্টার্টেড গাইড প্রজেক্টের ডকুমেন্টেশন সাইটে হোস্ট করা হয়েছে।