test-nmp-readme
v1.0.1
Published
**Favorneed** হলো একটি আধুনিক সামাজিক সহায়তা ও দানভিত্তিক প্ল্যাটফর্ম, যেখানে সাধারণ ব্যবহারকারীরা বিভিন্ন ভূমিকা (role) নিয়ে মানবকল্যাণমূলক কাজে অংশ নিতে পারেন।
Readme
🌍 Favorneed — Empowering Help & Humanity
Favorneed হলো একটি আধুনিক সামাজিক সহায়তা ও দানভিত্তিক প্ল্যাটফর্ম, যেখানে সাধারণ ব্যবহারকারীরা বিভিন্ন ভূমিকা (role) নিয়ে মানবকল্যাণমূলক কাজে অংশ নিতে পারেন।
🚀 Features
- Unified User System with multiple roles
- Real-time messaging and notifications
- Admin-controlled post approval system
- OTP and Document-based verification
- Donation & Wallet management
- Success Story & Blog publishing
- Role-based dashboard (Admin/User)
- Near Me, Blood Bank & Which Doctor features
👥 User Roles
| Role | Description | |------|--------------| | Personal | সাধারণ ব্যবহারকারী যারা রক্তদান বা সাহায্যমূলক কাজে অংশ নেয় | | Doctor | চিকিৎসা সহায়তা প্রদানকারী ব্যবহারকারী | | Public Figure | সচেতনতা বা অনুপ্রেরণামূলক কাজের জন্য প্রভাবশালী ব্যক্তি | | Organization | NGO, Hospital, বা কোনো প্রতিষ্ঠান যারা সংগঠিতভাবে সাহায্য করে |
🧭 Dashboards
👑 Admin Dashboard
- Manage users, posts, verifications & reports
- Approve success stories and blogs
- Handle support messages
- Manage donation transactions and withdrawals
👤 User Dashboard
- Create posts and requests (pending approval)
- Comment, like, or report posts
- Real-time chat & notification
- Access donation & wallet history
- View nearby donors, doctors, and organizations
🛠️ Tech Stack
| Layer | Technology | |--------|-------------| | Frontend | Next.js, Tailwind CSS | | Backend | Express.js, Node.js | | Database | PostgreSQL (Prisma ORM) | | Auth | JWT + Cookie-based | | File Uploads | Cloud Storage / Local FS | | Realtime | Socket.io / WebSocket | | Control | Role-based Access |
💡 Purpose
Favorneed তৈরি হয়েছে মানবিক সাহায্যকে ডিজিটালভাবে একত্রিত করার জন্য —
যাতে মানুষ, ডাক্তার, পাবলিক ফিগার, ও প্রতিষ্ঠান একসাথে কাজ করতে পারে সাহায্যের জন্য,
এবং প্রতিটি সাফল্য গল্প হিসেবে মানুষের সামনে আসে।
⭐ Tagline:
“Connecting Humanity through Digital Help.”
📌 Author: Arman Mia
---
### 🧩 ERD Plan (Entity Relationship Diagram)
তুমি নিচের স্ট্রাকচারটা **draw.io**, **dbdiagram.io**, বা **Diagrams.net**-এ তৈরি করতে পারবে 👇
**Entities:**
1. **users**
* id (PK)
* name
* email
* password
* role (ENUM: personal, doctor, public_figure, organization, admin)
* gender
* date_of_birth
* blood_group
* address
* is_verified (boolean)
* created_at
2. **profiles** (optional extended info)
* id (PK)
* user_id (FK → users.id)
* doctor_type (nullable)
* organization_name (nullable)
* weight (nullable)
* profile_photo
* document_url
3. **posts**
* id (PK)
* user_id (FK → users.id)
* title
* content
* image_url
* category (ENUM: help_request, success_story, blog)
* status (ENUM: pending, approved, rejected)
* created_at
4. **comments**
* id (PK)
* post_id (FK → posts.id)
* user_id (FK → users.id)
* text
* created_at
5. **donations**
* id (PK)
* donor_id (FK → users.id)
* receiver_id (FK → users.id)
* amount
* status (ENUM: success, pending, failed)
* created_at
6. **wallets**
* id (PK)
* user_id (FK → users.id)
* balance
7. **transactions**
* id (PK)
* wallet_id (FK → wallets.id)
* type (ENUM: deposit, withdraw, donation)
* amount
* status
* created_at
8. **notifications**
* id (PK)
* user_id (FK → users.id)
* message
* is_read (boolean)
* created_at
9. **reports**
* id (PK)
* reporter_id (FK → users.id)
* post_id (FK → posts.id)
* reason
* created_at
---
