آموزش فلاتر مقیاس‌پذیر: Supabase، معماری Clean و Riverpod - آخرین آپدیت

سرفصل ها و درس ها

مقدمه Introduction

• مرور کلی آموزش Tutorial Overview

• مرور کلی اپلیکیشن Community Board Community Board App Overview

• ویژگی‌های خاص و مقیاس‌پذیری اپلیکیشن Special Feature & App Scalability

• مخاطبان هدف، پیش‌نیازها و ساختار کلی Target Audience, Required Background, Overall Structure

• راهنمای استفاده از متریال آموزشی (PDF) و سورس کد گیت‌هاب Guidance on Using Learning Materials (PDF) and GitHub Source Code

پایه‌های توسعه: مفاهیم محوری و ابزارهای بهره‌وری Development Foundations: Core Concepts and Productivity Tools

• راهنمای استفاده از کدهای تمرینی و گیت‌هاب Guide to Using Practice Code and GitHub

• افزونه تولیدکننده Data Class در دارت (۱) Dart Data Class Generator Extension (1)

• افزونه تولیدکننده Data Class در دارت (۲) Dart Data Class Generator Extension (2)

• اسنیپت‌های Riverpod و افزونه‌های Freezed Flutter Riverpod Snippets & Freezed extensions

• افزونه‌های کاربردی VSCode Useful VSCode extensions

• کلاس‌های Callable Callable Classes

• مدیریت خطا با Either (۱) Error Handling with Either (1)

• مدیریت خطا با Either (۲) Error Handling with Either (2)

• مبانی json_serializable (۱) json_serializable primer (1)

• مبانی json_serializable (۲) json_serializable primer (2)

مرور کلی معماری Clean Clean Architecture Overview

• مرور معماری Clean (۱) Clearn Architecture Overview (1)

• مرور معماری Clean (۲) Clearn Architecture Overview (2)

• مرور معماری Clean (۳) Clearn Architecture Overview (3)

• مرور معماری Clean (۴) Clearn Architecture Overview (4)

• مرور معماری Clean (۵) Clearn Architecture Overview (5)

• ساختار پوشه‌بندی معماری Clean Clearn Architecture Folder Structure

مونوریپو (Monorepo): پی‌ریزی برای مقیاس‌پذیری Monorepo: Laying the Foundation for Scalability

• ساختار کلی اپلیکیشن Main App Structure

• چرا Monorepo و ساختار آن Why Monorepo & Monorepo structure

• تنظیمات pubspec.yaml، فایل barrel و پکیج core pubspec.yaml, barrel file, core package setup

• تنظیمات پکیج domain و پکیج data_supabase domain package, data_supabase package setup

• تنظیم فایل analysis_options.yaml analysis_options.yaml file setup

• راه‌اندازی riverpod_app (۱) riverpod_app setup (1)

• راه‌اندازی riverpod_app (۲) riverpod_app setup (2)

• راه‌اندازی riverpod_app (۳) riverpod_app setup (3)

• راه‌اندازی riverpod_app (۴) riverpod_app setup (4)

بک‌اند Supabase Supbase Backend

• راهنمای راه‌اندازی بک‌اند Supabase (سورس کد SQL) Supabase Backend Setup Guide (SQL Source Code)

• جدول public.profiles public.profiles table

• مقایسه جدول auth.users و public.profiles auth.users table vs public.profiles table

• جداول public.posts، public.comments و public.likes public.posts, public.comments and public.likes tables

• تنظیمات ذخیره‌سازی Supabase: تصاویر پست‌ها و آواتارها supabase storage setup: post-images and avatars

• امنیت سطح ردیف (RLS) برای جدول پروفایل‌ها profiles table Row Level Security

• امنیت سطح ردیف (RLS) برای جدول پست‌ها posts table Row Level Security

• امنیت سطح ردیف (RLS) برای جداول کامنت‌ها و لایک‌ها comment table and likes table Row Level Security

• امنیت سطح ردیف (RLS) برای ذخیره‌ساز تصاویر و آواتارها post-images storage and avatars storage Row Level Security

• تابع تریگر handle_new_user handle_new_user trigger function

• تابع تریگر updated_at updated_at trigger function

• تابع تریگر update_comments_count update_comments_count trigger function

• تابع تریگر update_likes_count و تابع handle_like update_likes_count trigger function, handle_like function

• تابع update_user_profile update_user_profile function

• ویوها (Views): post_display_view و comment_display_view Views: post_display_view, comment_display_view

• توابع get_my_posts و search_posts get_my_posts function, search_posts function

• توابع create_post، update_post، create_comment و update_comment create_post, update_post, create_comment, update_comment functions

• دسترسی‌های service_role service_role permissions

دوره فشرده Mutation در Riverpod 3 (اختیاری) Riverpod 3 Mutation Crash Course (Optional)

• [باید بخوانید] اطلاعات مهم قبل از شروع بخش ۶ [Must Read] Important Information Before Starting Section 6

• راهنمای استفاده از سورس کد و گیت‌هاب Guide to Using Source Code and GitHub

• فایل analysis_options.yaml مورد استفاده در دوره Mutation The analysis_options.yaml file used in the Riverpod Mutation Course

• مقدمه‌ای بر Mutation Introduction to Mutation

• اپلیکیشن todo_legacy (۱): دموی برنامه و مدل Todo todo_legacy app (1): app demo & Todo model

• اپلیکیشن todo_legacy (۲): وضعیت TodoListState todo_legacy app (2): TodoListState

• اپلیکیشن todo_legacy (۳): ارائه دهنده todoListProvider todo_legacy app (3): todoListProvider

• اپلیکیشن todo_legacy (۴): مدیریت وضعیت‌های فیلتر و شمارش todo_legacy app (4): todoListProvider,completedCountProvider,filteredTodosProvid

• اپلیکیشن todo_legacy (۵): رابط کاربری صفحه اصلی todo_legacy app (5): UI - HomePage

• اپلیکیشن todo_legacy (۶): صفحات افزودن و ویرایش Todo todo_legacy app (6): UI - AddTodoPage, UpdateTodoPage

• اپلیکیشن todo_legacy (۷): تست اپلیکیشن todo_legacy app (7): app test

• اپلیکیشن todo_mutation (۱): ایجاد Mutationها و اصلاح Providerها todo_muation app (1): Creating Mutations and Modifying Providers

• اپلیکیشن todo_mutation (۲): به‌روزرسانی رابط کاربری todo_mutation app (2): UI updates

• اپلیکیشن todo_mutation (۳): تست اپلیکیشن todo_mutation app (3): app test

• اپلیکیشن todo_mutation (۴): [عیب‌یابی] نمایش امن اسنک‌بار پس از unmount todo_mutation app (4): [Troubleshooting] Safely showing a snackbar after unmount

• اپلیکیشن todo_mutation (۵): مقایسه provider و mutation todo_mutation app (5): provider vs mutation

• اپلیکیشن login_legacy login_legacy app

• اپلیکیشن login_mutation login_mutation app

• کار با Mutation با تایپ‌های غیر void Mutation with non-void type T

قابلیت احراز هویت Authenticatioin Feature

• مرور کلی سیستم احراز هویت Authentication Overview

• بخش core: خطاها و استثناها، رابط UseCase core: Failures & Exceptions, UseCase Interface

• پارامترهای نام‌گذاری شده خصوصی Private Named Parameters

• بخش domain: موجودیت UserEntity، رابط AuthRepository و UseCaseها domain: UserEntity, AuthRepository Interface, UseCases

• نکات احتیاطی هنگام استفاده از فایل‌های barrel Cautions when using barrel files

• بخش data: مدل UserModel data: UserModel

• بخش data: رابط AuthRemoteDataSource و پیاده‌سازی Supabase data: AuthRemoteDataSource Interface, SupabaseAuthRemoteDataSource

• بخش data: پیاده‌سازی AuthRepositoryImpl data: AuthRepositoryImpl

• تزریق وابستگی‌های (DI) احراز هویت Auth Dependency Injections

• کنترلر احراز هویت (۱): وضعیت AuthStatus و AuthState AuthController (1) - AuthStatus enum, AuthState

• کنترلر احراز هویت (۲) AuthController (2)

• Mutationهای ورود، ثبت‌نام و استثنای PresentationFailure Login Mutation, Signup Mutation, PresentationFailureException

• قالب‌های صفحات اپلیکیشن App Pages Templates

• ثابت‌های مسیریابی (Routing) Routing Constants

• ناوبری تب‌ها (Tab Navigation) Tab Navigation

• راه‌اندازی GoRouter (۱) GoRouter Setup (1)

• راه‌اندازی GoRouter (۲) GoRouter Setup (2)

• صفحه ورود (۱) LoginPage (1)

• صفحه ورود (۲) LoginPage (2)

• صفحه ثبت‌نام SignupPage

• تست ورود و ثبت‌نام Login, Signup Test

قابلیت پست‌ها Post Feature

• بخش domain: موجودیت PostDisplay domain: PostDisplay entity

• بخش domain: رابط PostRepository و UseCase دریافت پست‌ها domain: PostRepository interface (getPosts), getPostsUseCase

• بخش data: مدل PostDisplayModel data: PostDisplayModel

• بخش data: منابع داده و پیاده‌سازی PostRepositoryImpl data: PostRemoteDataSource, SupabasePostRemoteDataSource, PostRepositoryImpl

• تزریق وابستگی‌های مربوط به پست Post Dependency Injection

• مقایسه Controller در برابر Mutation و ترکیب هر دو Controller vs Mutation vs Controller + Mutation

• کنترلر لیست پست‌ها: وضعیت PostListState PostListController - PostListState

• کنترلر لیست پست‌ها: متدهای build و fetchNextPage PostListController - build, fetchNextPage

• کنترلر لیست پست‌ها: متد refresh PostListController - refresh

• صفحه پست‌ها (۱) PostPage (1)

• صفحه پست‌ها (۲) PostPage (2)

• ویجت PostCard PostCard widget

• راهنمای Pagination و فیزیک اسکرول مختص هر پلتفرم Platform-Specific Scroll Physics & Pagination Guide

• بخش domain: ایجاد پست domain: Post Creation

• بخش data: ایجاد پست data: Post Creation

• پیاده‌سازی createPostMutation createPostMutation

• صفحه فرم ایجاد پست (PostFormPage) PostFormPage

• تست ایجاد پست Testing Post Creation

• ایجاد GlobalEventBus برای اطلاع‌رسانی ایجاد پست Creating GlobalEventBus (PostCreatedDispatched)

• پردازش EventBus در PostListController Processing GlobalEventBus in PostListController (PostCreatedDispatched)

• تست EventBus و اسکرول نامحدود در صفحه پست‌ها Processing & Testing GlobalEventBus, infinite scrolling in PostPage

• جزئیات GlobalEventBus GlobalEventBus details

• بخش domain: جزئیات پست domain: Post Detail

• بخش data: جزئیات پست data: Post Detail

• کنترلر جزئیات پست (۱) PostDetailController (1)

• کنترلر جزئیات پست (۲) PostDetailController (2)

• کنترلر لیست کامنت‌ها: وضعیت و متد build CommentListController - CommentListState, build

• کنترلر لیست کامنت‌ها: متدهای refresh و fetchNextPage CommentListController - refresh, fetchNextPage

• صفحه جزئیات پست (۱) PostDetailPage (1)

• صفحه جزئیات پست (۲) PostDetailPage (2)

• نمای لیست کامنت‌ها و ویجت CommentCard CommentListView, CommentCard

• بخش domain و data: لایک domain, data: like

• کنترلر لیست پست‌ها: تغییر وضعیت لایک و Mutation آن PostListController - toggleLike, toggleLikeMutation

• پیاده‌سازی لایک در صفحه پست‌ها PostPage - like

• کنترلر جزئیات پست: تغییر وضعیت لایک و Mutation آن PostDetailController - toggleLike, postDetailToggleLikeMutation

• پیاده‌سازی لایک در صفحه جزئیات PostDetailPage - like

• بخش domain: افزودن، ویرایش و حذف کامنت domain: Comment - Add, Edit, Delete

• بخش data: افزودن، ویرایش و حذف کامنت data: Comment - Add, Edit, Delete

• پیاده‌سازی createCommentMutation createCommentMutation

• حذف کامنت و به‌روزرسانی لیست پس از حذف deleteCommentMutation, CommentListController - refillAfterDelete

• پیاده‌سازی updateCommentMutation updateCommentMutation

• فیلد ورودی کامنت CommentInputField

• افزودن توابع ویرایش و حذف به CommentCard و تست آن‌ها CommentCard - Adding Edit, Delete functions, Testing comments functions

• بخش domain: حذف و ویرایش پست domain: Post Deletion, Post Edit

• بخش data: حذف و ویرایش پست data: Post Deletion, Post Edit

• حذف پست، اطلاع‌رسانی حذف و Mutation ویرایش deletePostMutation, PostDeletedDispatched, post refill, updatePostMutation

• پیاده‌سازی حذف پست در صفحه جزئیات PostDetailPage - post deletion

• حالت ویرایش در صفحه فرم پست PostFormPage - edit mode

• معماری و خوانایی کد Architecture & Readability

قابلیت پروفایل Profile Feature

• بخش domain domain

• بخش data data

• تزریق وابستگی‌ها Dependency Injection

• کنترلر پروفایل من (MyProfileController) MyProfileController

• بخش domain و data: دریافت پست‌های من domain, data: Get My Posts

• رویداد به‌روزرسانی پروفایل در GlobalEventBus GlobalEventBus: ProfileUpdatedDispatched

• کنترلر لیست پست‌های من و Mutation لایک MyPostListController, myPostToggleLikeMutation

• صفحه پروفایل من (۱) MyProfilePage (1)

• صفحه پروفایل من (۲) MyProfilePage (2)

• ویجت MyPostList MyPostList widget

• کنترلر پروفایل کاربر و صفحه UserProfilePage UserProfileController, UserProfilePage

• پیاده‌سازی updateProfileMutation updateProfileMutation

• صفحه ویرایش پروفایل (۱) EditProfilePage (1)

• صفحه ویرایش پروفایل (۲) EditProfilePage (2)

قابلیت جستجو Search Feature

• بخش domain domain

• بخش data data

• تزریق وابستگی‌ها Dependency Injection

• وضعیت جستجو (SearchState) SearchState

• کنترلر جستجو (۱) SearchController (1)

• کنترلر جستجو (۲) SearchController (2)

• کنترلر جستجو (۳) و Mutation لایک در جستجو SearchController (3), searchToggleLikeMutation

• صفحه جستجو (۱) SearchPage (1)

• صفحه جستجو (۲) SearchPage (2)

قابلیت Realtime در Supabase Supabase Realtime

• مرور کلی، تنظیمات، domain و data Overview, setup, domain, data

• بخش data: پیاده‌سازی RealtimeRepositoryImpl data: RealtimeRepositoryImpl

• تزریق وابستگی‌ها Dependency Injection

• افزودن قابلیت‌های Realtime به ScaffoldWithNavBar Adding realtime functionality to ScaffoldWithNavBar

جمع‌بندی و پایان Outro

• جمع‌بندی نهایی Outro