ক্যাপস্টোন — একটি সম্পূর্ণ ইন্টারঅ্যাকটিভ সিস্টেম এন্ড-টু-এন্ড ডিজাইন, প্রোটোটাইপ ও ইভালুয়েশন

# ========== ধাপ ১: ওয়েটেড হিউরিস্টিক ইভালুয়েশন স্কোর ==========
checklist = [
    {"name": "সিস্টেম স্ট্যাটাসের দৃশ্যমানতা (নিয়েছি/মিস করা/আসন্ন স্পষ্ট ব্যাজ)", "weight": 3, "score": 1.0},
    {"name": "এরর প্রিভেনশন (মিস-মার্ক করার আগে কনফার্মেশন, আনডু আছে)", "weight": 3, "score": 1.0},
    {"name": "রিকগনিশন, রিকল নয় (পিল-আইকন/ছবি, নাম মনে রাখতে হয় না)", "weight": 2, "score": 1.0},
    {"name": "ফ্লেক্সিবিলিটি ও দক্ষতা (কেয়ারগিভার সেটআপ আছে, কিন্তু কাস্টমাইজেশন সীমিত)", "weight": 2, "score": 0.5},
    {"name": "সিস্টেম ও বাস্তব জগতের মিল (সাধারণ ভাষা, পরিচিত আইকন)", "weight": 2, "score": 1.0},
    {"name": "ব্যবহারকারীর নিয়ন্ত্রণ ও স্বাধীনতা (নিয়েছি/মিস করা মার্ক আনডু করা যায়)", "weight": 2, "score": 1.0},
    {"name": "নান্দনিক ও মিনিমালিস্ট ডিজাইন (বড়, ফাঁকা, অগোছালো নয়)", "weight": 1, "score": 1.0},
    {"name": "হেল্প ও ডকুমেন্টেশন (ইন-অ্যাপ হেল্প নেই, শুধু কেয়ারগিভার-সহায়তা)", "weight": 1, "score": 0.5},
]

total_weight = sum(item["weight"] for item in checklist)
weighted_sum = sum(item["weight"] * item["score"] for item in checklist)
checklist_pct = weighted_sum / total_weight * 100

for item in checklist:
    print(f"[w={item['weight']}] {item['score']:.2f}  {item['name']}")

print(f"\nমোট ওজন: {total_weight}  |  ওয়েটেড স্কোর: {weighted_sum:.2f}  |  চূড়ান্ত চেকলিস্ট স্কোর: {checklist_pct:.1f}%")

# ========== ধাপ ২: WCAG কনট্রাস্ট-রেশিও চেক ==========
def relative_luminance(rgb):
    def channel(c):
        c = c / 255
        if c <= 0.03928:
            return c / 12.92
        return ((c + 0.055) / 1.055) ** 2.4
    r, g, b = rgb
    return 0.2126 * channel(r) + 0.7152 * channel(g) + 0.0722 * channel(b)

def contrast_ratio(rgb1, rgb2):
    l1 = relative_luminance(rgb1)
    l2 = relative_luminance(rgb2)
    lighter, darker = max(l1, l2), min(l1, l2)
    return (lighter + 0.05) / (darker + 0.05)

AA_NORMAL = 4.5

pairs = [
    ("'নিয়েছি' (Taken) ব্যাজ -- সাদা টেক্সট অন গাঢ় সবুজ", (255, 255, 255), (27, 94, 32)),
    ("'মিস করা' (Missed) ব্যাজ -- সাদা টেক্সট অন গাঢ় লাল", (255, 255, 255), (198, 40, 40)),
    ("মিউটেড হেল্পার টেক্সট -- হালকা ধূসর অন সাদা ব্যাকগ্রাউন্ড", (156, 163, 175), (255, 255, 255)),
]

results = []
for label, fg, bg in pairs:
    ratio = contrast_ratio(fg, bg)
    status = "PASS" if ratio >= AA_NORMAL else "FAIL"
    results.append((label, ratio, status))
    print(f"{label}\n  contrast = {ratio:.2f}:1  (AA থ্রেশহোল্ড {AA_NORMAL}:1)  ->  {status}\n")

passed_pairs = sum(1 for _, _, s in results if s == "PASS")
total_pairs = len(results)
print(f"মোট {total_pairs}টি রঙ-জোড়ার মধ্যে {passed_pairs}টি AA পাস করেছে")

# ========== ধাপ ৩: System Usability Scale (SUS) স্কোর ==========
respondents = [
    [5, 1, 4, 2, 5, 1, 4, 2, 5, 1],   # রহিমা, ৬৮ -- অভিজ্ঞ ব্যবহারকারী, বড় বাটনে স্বচ্ছন্দ
    [4, 2, 4, 1, 4, 2, 5, 1, 4, 2],   # করিম, ৭২
    [3, 2, 3, 3, 3, 2, 4, 2, 3, 3],   # আনোয়ারা, ৭৫ -- হালকা দৃষ্টি সমস্যা
    [4, 1, 5, 1, 4, 1, 4, 1, 5, 2],   # সেলিনা, ৬৫ -- কেয়ারগিভার সহায়তায় শুরু করেছেন
    [2, 4, 2, 3, 2, 3, 3, 4, 2, 4],   # জব্বার, ৭৮ -- প্রথমবার স্মার্টফোন ব্যবহার করছেন, কষ্ট হয়েছে
    [4, 2, 4, 2, 5, 1, 4, 2, 4, 1],   # নাসিমা, ৭০
]

def sus_score(responses):
    total = 0
    for i, score in enumerate(responses):
        item_num = i + 1
        if item_num % 2 == 1:          # বিজোড় আইটেম (ইতিবাচক ভাষায় লেখা): score - 1
            total += (score - 1)
        else:                          # জোড় আইটেম (নেতিবাচক ভাষায় লেখা): 5 - score
            total += (5 - score)
    return total * 2.5

sus_scores = [sus_score(r) for r in respondents]
names = ["রহিমা", "করিম", "আনোয়ারা", "সেলিনা", "জব্বার", "নাসিমা"]
for name, s in zip(names, sus_scores):
    print(f"{name}: {s:.1f}")

avg_sus = sum(sus_scores) / len(sus_scores)
print(f"\nগড় SUS স্কোর (n={len(sus_scores)}): {avg_sus:.1f}  (ইন্ডাস্ট্রি-গড় বেঞ্চমার্ক প্রায় ৬৮)")

# ========== ধাপ ৪: টাস্ক সাকসেস রেট ও সময়ের পরিসংখ্যান ==========
import statistics

# টাস্ক: "আজকের সকালের ওষুধ 'নিয়েছি' হিসেবে চিহ্নিত করুন" (একই ৬ জন অংশগ্রহণকারী)
sessions = [
    {"name": "রহিমা", "success": True,  "time_s": 6.2},
    {"name": "করিম",  "success": True,  "time_s": 8.1},
    {"name": "আনোয়ারা", "success": True,  "time_s": 11.4},
    {"name": "সেলিনা", "success": True,  "time_s": 7.5},
    {"name": "জব্বার", "success": False, "time_s": 42.0},
    {"name": "নাসিমা", "success": True,  "time_s": 9.8},
]

successes = [s for s in sessions if s["success"]]
n = len(sessions)
n_success = len(successes)
success_rate = n_success / n * 100

times_all = [s["time_s"] for s in sessions]
times_success = [s["time_s"] for s in successes]

mean_all = statistics.mean(times_all)
median_all = statistics.median(times_all)
mean_success = statistics.mean(times_success)
median_success = statistics.median(times_success)
stdev_success = statistics.stdev(times_success)

for s in sessions:
    status = "সফল" if s["success"] else "ব্যর্থ"
    print(f"{s['name']:8s}  {status}  time={s['time_s']:5.1f}s")

print(f"\nমোট অংশগ্রহণকারী: {n}, সফল: {n_success}")
print(f"টাস্ক সাকসেস রেট: {success_rate:.1f}%")
print(f"সব সেশনের গড় সময়: {mean_all:.1f}s, মধ্যক: {median_all:.1f}s")
print(f"শুধু সফল সেশনের গড় সময়: {mean_success:.1f}s, মধ্যক: {median_success:.1f}s, স্ট্যান্ডার্ড ডেভিয়েশন: {stdev_success:.2f}s")

# ========== ধাপ ৫: চূড়ান্ত মূল্যায়ন সারাংশ ও সুপারিশ -- ধাপ ১-৪-এর প্রকৃত ফলাফল থেকে ==========
SUCCESS_THRESHOLD = 85.0  # স্বাস্থ্য-সংক্রান্ত অ্যাপের জন্য প্রত্যাশিত ন্যূনতম টাস্ক-সাকসেস মান

major_issues = [item["name"] for item in checklist if item["weight"] >= 3 and item["score"] < 1.0]
if passed_pairs < total_pairs:
    major_issues.append(f"WCAG AA কনট্রাস্ট ({passed_pairs}/{total_pairs} পাস) -- মিউটেড হেল্পার টেক্সট ফেল করেছে")
if success_rate < SUCCESS_THRESHOLD:
    major_issues.append(f"টাস্ক সাকসেস রেট {success_rate:.1f}% প্রত্যাশিত {SUCCESS_THRESHOLD:.0f}% থ্রেশহোল্ডের নিচে")

minor_issues = [item["name"] for item in checklist if item["weight"] < 3 and item["score"] < 1.0]

print("=" * 70)
print("চূড়ান্ত মূল্যায়ন সারাংশ -- মেডিরিমাইন্ড (হাইপোথেটিক্যাল)")
print("=" * 70)
print(f"১. ওয়েটেড হিউরিস্টিক চেকলিস্ট স্কোর: {checklist_pct:.1f}%")
print(f"২. WCAG AA কনট্রাস্ট: {passed_pairs}/{total_pairs} পেয়ার পাস")
print(f"৩. গড় SUS স্কোর: {avg_sus:.1f} / 100")
print(f"৪. টাস্ক সাকসেস রেট: {success_rate:.1f}%  (সফল সেশনের গড় সময় {mean_success:.1f}s)")
print()
print(f"মেজর ইস্যু ({len(major_issues)}টি): {major_issues}")
print(f"মাইনর ইস্যু ({len(minor_issues)}টি): {minor_issues}")

if major_issues:
    verdict = "মেজর রিভিশন দরকার"
elif checklist_pct >= 90:
    verdict = "রেডি টু শিপ"
elif checklist_pct >= 75:
    verdict = "মাইনর রিভিশন সহ শিপ করা যায়"
else:
    verdict = "রিভিশন দরকার"

print(f"\nচূড়ান্ত সুপারিশ: {verdict}")