কোড করার আগের ধাপসমূহ: একটি পূর্ণাঙ্গ গাইড

# সমস্যা বিবরণী
 
## সমস্যা:
 
ছোট ব্যবসায়ীরা তাদের দৈনিক আয়-ব্যয়ের হিসাব রাখতে পারেন না।
 
## টার্গেট ব্যবহারকারী:
 
বাংলাদেশের ছোট দোকানদার ও ব্যবসায়ী
 
## বর্তমান সমাধান:
 
- খাতায় হিসাব (ভুল হয়, হারিয়ে যায়)
- এক্সেল (জটিল, মোবাইলে কঠিন)
 
## আমাদের সমাধান:
 
একটি সহজ বাংলা মোবাইল অ্যাপ যেখানে আয়-ব্যয় লিখে রাখা যায়

# প্রয়োজনীয়তা ডকুমেন্ট
 
## কার্যকরী প্রয়োজনীয়তা (Functional Requirements)
 
- [x] ব্যবহারকারী রেজিস্ট্রেশন ও লগইন
- [x] আয় যোগ করা
- [x] ব্যয় যোগ করা
- [x] দৈনিক/মাসিক রিপোর্ট দেখা
- [ ] PDF রিপোর্ট ডাউনলোড (পরবর্তী ভার্সনে)
 
## অকার্যকরী প্রয়োজনীয়তা (Non-functional Requirements)
 
- পেজ লোড টাইম: < ২ সেকেন্ড
- মোবাইল রেসপন্সিভ হতে হবে
- ডাটা এনক্রিপ্টেড থাকবে
- বাংলা ভাষা সাপোর্ট

# প্রযুক্তি স্ট্যাক
 
## ফ্রন্টএন্ড
 
- **ফ্রেমওয়ার্ক:** React.js
- **স্টাইলিং:** Tailwind CSS
- **স্টেট ম্যানেজমেন্ট:** Redux Toolkit
 
## ব্যাকএন্ড
 
- **রানটাইম:** Node.js
- **ফ্রেমওয়ার্ক:** Express.js
- **ডাটাবেস:** PostgreSQL
- **ORM:** Prisma
 
## DevOps
 
- **ভার্সন কন্ট্রোল:** Git + GitHub
- **CI/CD:** GitHub Actions
- **হোস্টিং:** Vercel (ফ্রন্টএন্ড), Railway (ব্যাকএন্ড)
 
## কেন এই স্ট্যাক?
 
- React: বড় কমিউনিটি, প্রচুর রিসোর্স
- PostgreSQL: রিলেশনাল ডাটার জন্য উপযুক্ত
- Vercel: ফ্রি টিয়ার আছে, সহজ ডিপ্লয়মেন্ট

# সিস্টেম আর্কিটেকচার
 
## সামগ্রিক কাঠামো
 
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ ফ্রন্টএন্ড │────▶│ ব্যাকএন্ড │────▶│ ডাটাবেস │
│ (React) │◀────│ (Express) │◀────│ (PostgreSQL)│
└─────────────┘ └─────────────┘ └─────────────┘
 
## ডাটাবেস স্কিমা
 
### users টেবিল
 
| কলাম     | টাইপ    | বিবরণ             |
| -------- | ------- | ----------------- |
| id       | UUID    | প্রাইমারি কী      |
| name     | VARCHAR | ব্যবহারকারীর নাম  |
| email    | VARCHAR | ইমেইল (ইউনিক)     |
| password | VARCHAR | হ্যাশড পাসওয়ার্ড |
 
### transactions টেবিল
 
| কলাম     | টাইপ    | বিবরণ            |
| -------- | ------- | ---------------- |
| id       | UUID    | প্রাইমারি কী     |
| user_id  | UUID    | ফরেন কী (users)  |
| type     | ENUM    | income / expense |
| amount   | DECIMAL | টাকার পরিমাণ     |
| category | VARCHAR | ক্যাটেগরি        |
| date     | DATE    | তারিখ            |
 
## API এন্ডপয়েন্ট
 
- POST /api/auth/register → রেজিস্ট্রেশন
- POST /api/auth/login → লগইন
- GET /api/transactions → সব লেনদেন দেখা
- POST /api/transactions → নতুন লেনদেন যোগ
- DELETE /api/transactions/:id → লেনদেন মুছে ফেলা

# প্রজেক্ট পরিকল্পনা
 
## ফেজ ১: ভিত্তি তৈরি (সপ্তাহ ১-২)
 
- [ ] রিপোজিটরি সেটআপ
- [ ] প্রজেক্ট স্ট্রাকচার তৈরি
- [ ] ডাটাবেস সেটআপ ও মাইগ্রেশন
- [ ] বেসিক CI/CD পাইপলাইন
 
## ফেজ ২: অথেনটিকেশন (সপ্তাহ ৩)
 
- [ ] রেজিস্ট্রেশন API
- [ ] লগইন API
- [ ] JWT টোকেন সিস্টেম
- [ ] ফ্রন্টএন্ডে লগইন/রেজিস্ট্রেশন পেজ
 
## ফেজ ৩: মূল ফিচার (সপ্তাহ ৪-৬)
 
- [ ] আয় যোগ করার ফিচার
- [ ] ব্যয় যোগ করার ফিচার
- [ ] লেনদেনের তালিকা
- [ ] ক্যাটেগরি ম্যানেজমেন্ট
 
## ফেজ ৪: রিপোর্ট ও ড্যাশবোর্ড (সপ্তাহ ৭-৮)
 
- [ ] দৈনিক সারসংক্ষেপ
- [ ] মাসিক রিপোর্ট
- [ ] চার��ট ও গ্রাফ
 
## ফেজ ৫: টেস্টিং ও ডিপ্লয়মেন্ট (সপ্তাহ ৯-১০)
 
- [ ] ইউনিট টেস্ট লেখা
- [ ] ইন্টিগ্রেশন টেস্ট
- [ ] প্রোডাকশনে ডিপ্লয়
- [ ] ব্যবহারকারী টেস্টিং

# 💰 হিসাব-নিকাশ (Hishab-Nikash)
 
দৈনিক আয়-ব্যয়ের হিসাব রাখার সহজ বাংলা অ্যাপ।
 
## 🚀 শুরু করুন
 
### পূর্বশর্ত
 
- Node.js (v18+)
- PostgreSQL (v15+)
- npm বা yarn
 
### ইনস্টলেশন
 
# রিপোজিটরি ক্লোন করুন
 
git clone https://github.com/your-username/hishab-nikash.git
 
# ডিরেক্টরিতে যান
 
cd hishab-nikash
 
# ডিপেন্ডেন্সি ইনস্টল করুন
 
npm install
 
# এনভায়রনমেন্ট ভেরিয়েবল সেটআপ করুন
 
cp .env.example .env
 
# ডেভেলপমেন্ট সার্ভার চালু করুন
 
npm run dev
 
## 📁 ফোল্ডার স্ট্রাকচার
 
hishab-nikash/
├── src/
│ ├── components/ # UI কম্পোনেন্ট
│ ├── pages/ # পেজসমূহ
│ ├── services/ # API কল
│ ├── utils/ # হেল্পার ফাংশন
│ └── styles/ # স্টাইল ফাইল
├── server/
│ ├── routes/ # API রাউট
│ ├── controllers/ # বিজনেস লজিক
│ ├── models/ # ডাটাবেস মডেল
│ └── middleware/ # মিডলওয়্যার
├── tests/ # টেস্ট ফাইল
├── docs/ # ডকুমেন্টেশন
└── .github/ # GitHub কনফিগারেশন
 
## 🤝 অবদান রাখুন
 
CONTRIBUTING.md দেখুন।
 
## 📄 লাইসেন্স
 
MIT License

# Dependencies
node_modules/

# Environment
.env
.env.local

# Build
dist/
build/

# IDE
.vscode/
.idea/

# OS
.DS_Store
Thumbs.db

# Logs
*.log
npm-debug.log*

# ডাটাবেস
DATABASE_URL=postgresql://user:password@localhost:5432/hishab_nikash
 
# JWT সিক্রেট
JWT_SECRET=your-secret-key-here
 
# সার্ভার
PORT=3000
NODE_ENV=development

# টেস্টিং কৌশল
 
## টেস্টের ধরন
 
### ১. ইউনিট টেস্ট (Unit Test)
 
- **কী:** প্রতিটি ফাংশন আলাদাভাবে টেস্ট
- **টুল:** Jest
- **লক্ষ্য:** ৮০%+ কোড কভারেজ
 
### ২. ইন্টিগ্রেশন টেস্ট (Integration Test)
 
- **কী:** API এন্ডপয়েন্ট টেস্ট
- **টুল:** Supertest + Jest
 
### ৩. E2E টেস্ট (End-to-End Test)
 
- **কী:** পুরো ইউজার ফ্লো টেস্ট
- **টুল:** Playwright
 
## টেস্ট রান করার নিয়ম
 
- প্রতিটি PR-এ অটোমেটিক টেস্ট চলবে
- মেইন ব্রাঞ্চে মার্জের আগে সব টেস্ট পাস করতে হবে

# নিরাপত্তা নীতি
 
## সমর্থিত ভার্সন
 
| ভার্সন | সাপোর্ট            |
| ------ | ------------------ |
| 1.x    | ✅ নিরাপত্তা আপডেট |
| < 1.0  | ❌ সাপোর্ট নেই     |
 
## দুর্বলতা রিপোর্ট করুন
 
নিরাপত্তা সংক্রান্ত সমস্যা পেলে ইমেইল করুন: security@example.com
 
## নিরাপত্তা ব্যবস্থা
 
- পাসওয়ার্ড bcrypt দিয়ে হ্যাশ করা হয়
- JWT টোকেন ব্যবহার করা হয়
- SQL Injection প্রতিরোধে Parameterized Query ব্যবহার
- CORS সঠিকভাবে কনফিগার করা আছে
- Rate Limiting চালু আছে

name: CI Pipeline
 
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
 
jobs:
  test:
    runs-on: ubuntu-latest
 
    steps:
      - name: কোড চেকআউট
        uses: actions/checkout@v4
 
      - name: Node.js সেটআপ
        uses: actions/setup-node@v4
        with:
          node-version: "18"
 
      - name: ডিপেন্ডেন্সি ইনস্টল
        run: npm ci
 
      - name: লিন্টিং চেক
        run: npm run lint
 
      - name: টেস্ট চালানো
        run: npm test
 
      - name: বিল্ড চেক
        run: npm run build

সমস্যা চিহ্নিতকরণ
        │
        ▼
প্রয়োজনীয়তা নির্ধারণ
        │
        ▼
প্রযুক্তি স্ট্যাক নির্বাচন
        │
        ▼
সিস্টেম ডিজাইন ও আর্কিটেকচার
        │
        ▼
ওয়্যারফ্রেম ও UI ডিজাইন
        │
        ▼
প্রজেক্ট পরিকল্পনা ও টাস্ক ভাগ
        │
        ▼
রিপোজিটরি সেটআপ
        │
        ▼
টেস্টিং কৌশল নির্ধারণ
        │
        ▼
নিরাপত্তা পরিকল্পনা
        │
        ▼
CI/CD পাইপলাইন সেটআপ
        │
        ▼
  ✅ এখন কোড শুরু করুন!