Project 2: Notes API + Flutter App

এই project এ তুমি প্রথমবার নিজের পুরো product বানাবে: নিজের backend, নিজের Flutter app, দুটো একসাথে কথা বলবে। এখন থেকে AI ব্যবহার করতে পারো, কিন্তু নিয়ম একটাই: AI এর লেখা প্রতিটা লাইন তুমি পড়বে আর বুঝবে, আর test তোমার ঠিক করা ক্ষেত্রগুলো যাচাই করবে। শেষে এটা তোমার portfolio এর প্রথম বড় project হবে।

#কী বানাবো: "নোটখাতা"

একটা note নেওয়ার app, যেটা ফোন আর web দুই জায়গাতেই চলে:

• Email/password দিয়ে register আর login
• Note তৈরি, পড়া, বদলানো, মুছে ফেলা
• Pin করা note সবার উপরে
• Note এ একটা ছবি যোগ করা
• Title আর লেখায় খোঁজা
• Tag দিয়ে ভাগ করা
• Infinite scroll (cursor pagination)
• Logout, আর সব device থেকে logout

#Non-functional requirement

#Architecture

#API এর তালিকা

#Database

users          (id, email UNIQUE, name, password_hash, is_active, created_at, updated_at)
refresh_tokens (id, user_id FK, token_hash UNIQUE, device_name, expires_at, revoked_at, created_at)
notes          (id, owner_id FK, title, content, is_pinned, image_key, idempotency_key,
                deleted_at, created_at, updated_at)
                UNIQUE (owner_id, idempotency_key)
                INDEX (owner_id, is_pinned, updated_at DESC)
tags           (id, owner_id FK, name)  UNIQUE (owner_id, name)
note_tags      (note_id FK, tag_id FK)  PRIMARY KEY (note_id, tag_id)

#কাজের ধাপ (প্রায় ৪ সপ্তাহ)

সপ্তাহ ১: Backend এর ভিত্তি

• বড় Project এর Structure অনুযায়ী folder
• Config, database, model, Alembic migration
• Register, login, /me, আর তাদের test

সপ্তাহ ২: Notes

• Note এর CRUD, মালিকানা যাচাই
• Cursor pagination, search, tag
• Idempotency key
• IDOR test সহ সব test

সপ্তাহ ৩: Flutter app

• Login/register screen, token secure storage এ
• Dio interceptor: token যোগ, 401 এ refresh, refresh ব্যর্থ হলে login এ ফেরা (Flutter সংযোগ অধ্যায় আগে একবার দেখে নিতে পারো)
• Note list (infinite scroll, pull to refresh), detail, edit, search

সপ্তাহ ৪: ছবি, polish, README

• ছবি upload আর দেখানো
• Error গুলো সুন্দর করে দেখানো (error.code অনুযায়ী)
• Empty state, loading state, offline এ বার্তা
• README আর demo video

#Flutter দিকের কিছু খুঁটিনাটি

// Idempotency: button চাপার সময় key বানাও, retry তে একই key
final key = const Uuid().v4();
await dio.post('/v1/notes',
    data: note.toJson(),
    options: Options(headers: {'Idempotency-Key': key}));

// Error parse: সব endpoint এর error একই ধরনে আসে
class ApiError {
  final String code;
  final String message;
  final Map<String, String> fields;
  // ...
}

Android emulator থেকে Mac এর localhost: http://10.0.2.2:8000। আসল phone থেকে: Mac এর local IP (192.168.x.x:8000) আর uvicorn কে --host 0.0.0.0 দিয়ে চালাতে হবে।

#Review checklist (AI এর code সহ)

#শেষ হলে

• GitHub এ দুইটা repo (backend, flutter) বা একটা monorepo
• README তে: কী, কেন, architecture এর ছবি, কীভাবে চালাবে, API এর তালিকা, screenshot, কী শিখলে
• ২ মিনিটের demo video: login, note তৈরি, ছবি, search, অন্য user দিয়ে প্রমাণ যে অন্যের note দেখা যায় না
• Month 5 এ এটা Docker এ ভরে internet এ deploy করবে

#নিজেকে যাচাই করো