# ছায়েদুল হক–ছালেহা খাতুন ফাউন্ডেশন — বাস্তবায়ন পরিকল্পনা

## পণ্যের লক্ষ্য
একটি বাংলা, মোবাইল-ফ্রেন্ডলি, সুদমুক্ত সমিতি/মাইক্রোফাইন্যান্স পোর্টাল যেখানে সদস্য নিজের সঞ্চয়, মাসিক বকেয়া, কল্যাণ তহবিল, আয়-বণ্টন ও বিনিয়োগের সারাংশ দেখতে পারবেন; আর অ্যাডমিন/সুপার অ্যাডমিন সদস্য, আয়-ব্যয়, বিনিয়োগ এবং অনুমোদন নিয়ন্ত্রণ করবেন।

## বাস্তবায়ন পদ্ধতি
- React + Tailwind frontend, বিদ্যমান Manus OAuth authentication, Express/tRPC backend ও managed MySQL database ভিত্তি।
- প্রথম usable release-এ একটি polished login/brand portal এবং role-aware member/admin dashboard থাকবে।
- সরবরাহকৃত `FortpolioSSF.xlsx` থেকে ৩৩ জন সদস্য, সদস্য কোড, মোবাইল এবং ২০২৪ সালের সঞ্চয়/কল্যাণ তহবিলের সারাংশ ড্যাশবোর্ডে প্রাথমিক ডেটা হিসেবে দেখানো হবে।
- ব্যক্তিগত পূর্ণ প্রোফাইল, সদস্য যোগ/বাতিল, মাসিক জমা, আয়/ব্যয় এন্ট্রি, অনুমোদন, PDF রসিদ, WhatsApp পাঠানো এবং ছয় মাস অন্তর আয়-বণ্টনের জন্য backend schema ও admin actions ধাপে ধাপে যুক্ত করার উপযোগী structure রাখা হবে।
- লগইন provider হিসেবে Manus OAuth ব্যবহার করা হবে; সদস্য/অ্যাডমিনের role database-এর `users.role` থেকে নির্ধারিত হবে। কাস্টম plaintext password রাখা হবে না।

## ডেটা ও আচরণ
- সদস্য: বাংলা/ইংরেজি নাম, মোবাইল, পিতা-মাতা, স্বামী/স্ত্রী, জন্ম তারিখ, লিঙ্গ, ইমেইল, NID, পেশা, যোগদানের তারিখ, ঠিকানা, প্রারম্ভিক জমা, নমিনী এবং ছবি।
- মাসিক জমা: সদস্য সঞ্চয় ৫০০ টাকা/মাস এবং কল্যাণ তহবিল ২০ টাকা/মাস; প্রতিটি entry pending → approved হবে। অনুমোদনের আগে সদস্যের dashboard-এ entry দেখা যাবে না।
- বর্তমান balance: মোট সঞ্চয় + অনুমোদিত আয় − বিনিয়োগ − অনুমোদিত ব্যয়।
- আয়-বণ্টন: ছয় মাস অন্তর, সদস্যের eligible deposit proportion অনুযায়ী অটো হিসাব।
- রসিদ: অনুমোদিত জমার পর PDF download/print-এর জন্য প্রস্তুত হবে; WhatsApp delivery-এর জন্য provider/number পরে কনফিগার করা যাবে।
- অভিযোগ/পরামর্শ: সদস্যের বার্তা ও status ট্র্যাক করার ফিচার।

## ডিজাইন

### সম্ভাব্য তিনটি শৈলী
1. **Quiet Islamic Ledger** — গভীর সবুজ, warm paper, সংযত জ্যামিতিক মোটিফ; সম্ভাবনা ০.০৭।
2. **Civic Blue Ledger** — নীল-সাদা civic dashboard, পরিষ্কার data density; সম্ভাবনা ০.০৬।
3. **Terracotta Community** — উষ্ণ মাটি-রঙ, মানবিক community feel; সম্ভাবনা ০.০৫।

### নির্বাচিত শৈলী: Quiet Islamic Ledger
- **Design Movement:** শান্ত Islamic editorial + cooperative ledger aesthetics।
- **Core Principles:** বিশ্বাসযোগ্যতা, হিসাবের স্বচ্ছতা, পারিবারিক উষ্ণতা, কম cognitive load।
- **Color Philosophy:** গভীর মসজিদ-সবুজ আস্থা ও সুদমুক্ত নীতিকে বোঝাবে; cream background কাগজের ledger-এর অনুভূতি দেবে; saffron accent approval/action-এর উষ্ণতা দেবে।
- **Layout Paradigm:** বামদিকে সরু rail, ডানদিকে asymmetrical dashboard canvas; quote ও profile section-এ editorial flow; repetitive cards কমিয়ে status strip ও ledger table ব্যবহার।
- **Signature Elements:** অর্ধচন্দ্র/পাতার monogram mark, সূক্ষ্ম geometric grid texture, “সুদমুক্ত” pill badge।
- **Interaction Philosophy:** প্রতিটি আর্থিক action-এ status, তারিখ ও অনুমোদনের অবস্থা দৃশ্যমান; destructive action-এ confirmation; success feedback শান্ত এবং স্পষ্ট।
- **Animation:** page load-এ 160ms fade-up; KPI numbers 400ms ease-out; table hover-এ শুধু background shift; কোনো distracting loop নয়।
- **Typography System:** বাংলা UI-তে `Noto Sans Bengali`, আরবি উদ্ধৃতিতে serif fallback; ইংরেজি code/amount-এ `Inter` fallback; headings bold, labels medium, tabular figures।
- **Brand Essence:** আত্মীয়তার বন্ধনকে আর্থিক শৃঙ্খলা ও স্বচ্ছতায় রূপ দেওয়া; ব্যক্তিত্ব — বিশ্বস্ত, শান্ত, যত্নশীল।
- **Brand Voice:** সম্মানজনক, সংক্ষিপ্ত, নির্ভরযোগ্য। উদাহরণ: “আপনার সঞ্চয়, আপনার অধিকার—স্বচ্ছ হিসাবের সঙ্গে।” / “অনুমোদনের পরই হিসাব সদস্যের কাছে দৃশ্যমান হবে।”
- **Wordmark & Logo:** পাতার দুই ডগা ও অর্ধচন্দ্রের সমন্বয়ে `শ` monogram; পাশে foundation wordmark।
- **Signature Brand Color:** `#0E5C4A` deep emerald।

## Project structure
- `client/src/pages/Home.tsx`: public login portal এবং authenticated role-aware dashboard।
- `client/src/lib/foundationData.ts`: Excel-ভিত্তিক প্রাথমিক member and portfolio data।
- `client/src/index.css`: brand tokens, responsive layout, typography এবং ledger styling।
- `server/_core/`: Manus OAuth/session infrastructure অপরিবর্তিত থাকবে।
- `drizzle/schema.ts`: user role-এর সম্প্রসারণ এবং পরবর্তী member/ledger tables-এর জায়গা।
- `public/manus-routes.json`: প্রকাশযোগ্য route manifest।
- `TODO.md`: user-requested outcomes এবং delivery status।

## হোস্টিং নোট
ব্যবহারকারীর cPanel তালিকায় Node.js App, MySQL/phpMyAdmin, SSL, Git, Backup, Cron এবং ModSecurity আছে—যা পরবর্তী self-hosted deployment-এর জন্য যথেষ্ট। বর্তমান MVP Manus managed preview/database-এ তৈরি হচ্ছে; domain-এ প্রকাশের আগে cPanel Node runtime, environment variables, database migration, SSL এবং backup policy আলাদাভাবে configure করতে হবে।