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

Go Performance Starter হল একটি মতামতপ্রবণ, সার্ভার-রেন্ডার্ড শুরু বিন্দু ছোট SaaS পণ্যের জন্য, Go (Chi), templ টেমপ্লেট, HTMX Alpine.js সহ, Tailwind CSS, Supabase (Auth + PostgreSQL) এবং Cloudflare এর সমন্বয়। এর দাবি হল সার্ভার-রেন্ডার্ড Go, minimale JavaScript সহ, যেখানে কর্মক্ষমতা বাজেট এবং AI-এজেন্ট গার্ডরেল CI-এ প্রয়োগ করা হয়, শুধু বর্ণনা নয়। প্রমাণীকরণ Supabase ইমেল/পাসওয়ার্ড ব্যবহার করে সার্ভার-সাইড JWT যাচাই করে, এবং অ্যানোনিমাস অতिथি সাইন-ইনও সমর্থন করে astfel যে ডেমো ভিজিটররা সাইন‑আপ না করে একটি বাস্তব আইডিটি পায়। মাল্টি‑টেন্যান্সি PostgreSQL Row Level Security‑এ ভিত্তি করে: অনুরোধের JWT দাবি স্কোপড ট্রানজেকশনে (SET LOCAL ROLE plus request.jwt.claims) নিয়ে যায়, যাতে auth.uid() RLS নীতির মধ্যে সমাধান হয় এবং রেপোজিটরি লেয়ার টেন্যান্ট স্কোপিং বypass করতে পারে না। README এই পদ্ধতিটি Supabase‑কে load‑bearing করে ঘোষণা করে, একটি প্লাগ‑ইন অ্যাডাপ্টার নয়; বিক্রেতা‑নিরপেক্ষ প্রমাণীকরণের জন্য প্রমাণ মিডলওয়্যার, RLS স্কোপ হেল্পার এবং নীতিগুলো পুনর্লিখন প্রয়োজন। শামিল ডেমো স্ট্যাককে ব্যায়াম করার জন্য intenciónিত: /patterns রুটে প্রতিটি সমর্থিত HTMX/Alpine প্যাটার্নের প্রদর্শন এবং উৎস, এবং একটি আর্কিটেকচার কুইজ যেখানে ভুল উত্তরগুলো ব্যবহারকারী‑নির্দিষ্ট ফ্ল্যাশকার্ড হিসেবে সংরক্ষিত হয়, যা বাস্তব RLS‑সুরক্ষিত পंक्तিগুলো। একটি ব্যাকগ্রাউন্ড জব inactive অতিথি들을 Supabase admin API-এর মাধ্যমে মেয়াদ শেষ করে। ডেভেলপার টুলিং:type-safe templ টেমপ্লেটকে Go‑এ কম্পাইল করা, sqlc কোড জেনারেশন রেপোজিটরি প্যাটার্নের সাথে, air দিয়ে হট রিলোড, Taskfile অটোমেশন, golangci-lint, Prometheus মেট্রিক, log/slog দিয়ে স্ট্রাকচার্ড লগিং, হেল্থ চেক, এবং CI/CD। একটি ভূমিকা‑ভিত্তিক ডিজাইন সিস্টেম সেমান্টিক টোকেন যেমন bg-surface এবং text-muted-foreground ব্যবহার করে, ডার্ক মোডে টোকেনগুলো ফ্লিপ করে (কম্পোনেন্ট পরিবর্তন না করে) এবং CI‑এ raw grays এবং dark: drift‑এর বিরুদ্ধে চেক করা হয়। README তে নিম্নলিখিত বাজেটগুলি তালিকাভুক্ত করা হয়েছে: P95 প্রতিক্রিয়া সময় ১০০ms এর নিচে, বাইনারি আকার ২০MB এর নিচে, Docker ইমেজ ৩০MB এর নিচে, স্থির‑অবস্থা মেমরি ১২৮MB এর নিচে, এবং স্টার্ট‑আপ ৫০0ms এর নিচে, যা task test:performance এবং task test:binary-size দ্বারা যাচাই করা হয়। প্রকল্পে একটি স্তরিত AI সংবিধান অন্তর্ভুক্ত: CLAUDE.md-এ halt-on-violation নিয়ম রয়েছে, ενώ .claude/engineering.md, workflow.md এবং stack.md-এ ইঞ্জিনিয়ারিং ডিফল্ট, প্রক্রিয়া এবং স্ট্যাক তথ্য রয়েছে। AGENTS.md task agents:build এবং CI দ্বারা তৈরি হয় এবং এটি ড্রিফট হলে CI ব্যর্থ হয়। অসামান্য বৈশিষ্ট্য তিন‑পাস Architect → Coder → Reviewer ফ্লো অনুসরণ করে। একক সংজ্ঞা done হল task ci quality gate (ফরম্যাটিং, লিন্ট, রেস টেস্ট, ড্রিফট চেক, বাইনারি আকার, ভালনেবিলিটি স্ক্যান), যা এজেন্টদের থ্রেশহোল্ড কমিয়ে না করে পাস করতে হয়। আর্কিটেকচার ডিসিশন রেকর্ড (ADR) প্রতিটির একটি Enforcement বিভাগ থাকে যেখানে নিয়মগুলো চেক‑এ ম্যাপ করা হয়। task check:adr একটি ডетерমিনিস্টিক স্যুট চালায় যা পরীক্ষাযোগ্য ADR ফলাফল যাচাই করে, যার মধ্যে একটি গোপন স্ক্যানারও অন্তর্ভুক্ত। চেক inicialmente-warning হিসেবে শুরু হয় এবং পরিষ্কার সময় বা একটি skutey पकড়ের পর ব্লকিং‑এ উন্নত হয়। দুটি হুক ব্লকিং: একটি Stop-gate যা এজেন্টদের ব্যর্থ টেস্ট বা ব্লকারের সাথে একটি টার্ন শেষ করতে বাধা দেয়, এবং একটি PreToolUse গার্ড যা বিদ্যমান ADR, AGENTS.md বা জেনারেটেড কোডে হ্যান্ড‑এডিটকে বাধা দেয়; উভয়েরই kill‑switch আছে। README-load-bearing এবং অপসারণ‑যোগ্য অংশগুলো চিহ্নিত করে এবং enforcement suite‑কে সম্পূর্ণরূপে বাদ দেওয়ার নির্দেশও দেয়। মূল versions.json একটি offent consumption contract হিসাবে বর্ণিত হয়েছে যা স্ট্যাক পিন्स তালিকাভুক্ত করে; task versions:check যদি কোনো কী এর ইন-রিপো স्रोতের সাথে মেল না তখন ব্যর্থ হয়, নতুন কী যোগ করা অনুমোদিত কিন্তু নাম পরিবর্তন বা মুছে ফেলা একটি破壞कारी পরিবর্তন। প্রারেবলা: Go ১.২৬+, Docker এবং Docker Compose, Task, এবং Node.js ২০+. দ্রুত শুরু: রেপো ক্লোন করা, .env.example কপি করা, ডেটাবেস শুরু করা,マイগ্রেশন চালানো, sqlc টাইপ তৈরি করা, Go এবং npm নির্ভরতা ইনস্টল করা, এবং হট রিলোড সহ ডেভ সার্ভার চালু করা, ডিফল্টরূপে পোর্ট ৪০০০‑এ সার্ভ করা। একটি এক‑বারের Supabase পাসওয়ার্ড‑রিসেট টেমপ্লেট কনফিগারেশন নথিভুক্ত করা হয়েছে। উপলব্ধ টাস্কে dev, ci, build, test, coverage, performance এবং binary-size চেক, লিন্ট, CSS বিল্ড, Docker ইমেজ বিল্ড এবং ভ্যুলনেবিলিটি স্ক্যানিং অন্তর্ভুক্ত। প্রকল্পটি MIT লাইসেন্সের অধীনে প্রকাশিত।