add signals demo

Author: CarGuo

README.md

@@ -59,6 +59,8 @@
 > 
 > 6、 Redux：目前展示了全局登陆和用户信息等上面使用。
 > 
+> 7、 Signals：目前用于 NotifyPage、RepositoryDetailFileListPage 页面内状态管理
+> 
 > **列表显示有多个，其中：**
 > 
 > 1、**gsy_pull_load_widget.dart.dart**
@@ -168,6 +170,10 @@
 │  │Common UI││  │Riverpod │  │                │                 │
 │  └─────────┘│  └─────────┘  │                │                 │
 │             │               │                │                 │
+│             │  ┌─────────┐  │                │                 │
+│             │  │ Signals │  │                │                 │
+│             │  └─────────┘  │                │                 │
+│             │               │                │                 │
 └─────────────┴───────────────┴────────────────┴─────────────────┘
 ```
 
@@ -224,7 +230,7 @@ riverpod 页面内状态管理：
 
 ```
 ┌───────────────────────────────────────────────────────────────────────────┐
-│                           TrendPage Architecture                           │
+│                         Page Architecture Overview                         │
 └───────────────────────────────────────────────────────────────────────────┘
                                       │
                                       ▼
@@ -236,71 +242,54 @@ riverpod 页面内状态管理：
 │  └───────────────────┘   └────────────────────┘   └────────────────────┘  │
 └───────────────────────────────────────────────────────────────────────────┘
                                       │
-                                      ▼
-┌───────────────────────────────────────────────────────────────────────────┐
-│                         TrendPage Specific State                           │
-├───────────────────────────────────────────────────────────────────────────┤
-│                                                                           │
-│  ┌─────────────────────────────────────────────────────────────────────┐  │
-│  │                      Riverpod Providers                             │  │
-│  │  ┌───────────────────────────────┐  ┌─────────────────────────────┐ │  │
-│  │  │        trendFirstProvider     │  │     trendSecondProvider     │ │  │
-│  │  │ (Primary Data Source)         │  │ (Secondary Data Source)     │ │  │
-│  │  │ - Takes time & language params│  │ - Depends on firstProvider  │ │  │
-│  │  │ - Fetches trending repos      │  │ - Processes additional data │ │  │
-│  │  └───────────────────────────────┘  └─────────────────────────────┘ │  │
-│  └─────────────────────────────────────────────────────────────────────┘  │
-│                                    │                                      │
-│                                    ▼                                      │
-│  ┌─────────────────────────────────────────────────────────────────────┐  │
-│  │                   Local State (StatefulWidget)                      │  │
-│  │  ┌───────────────────────────┐  ┌───────────────────────────────┐  │  │
-│  │  │ User Interface Controls   │  │ Filter Parameters             │  │  │
-│  │  │ - scrollController        │  │ - selectTime (daily/weekly)   │  │  │
-│  │  │ - _isOpen                 │  │ - selectType (language)       │  │  │
-│  │  │ - refreshIndicatorKey     │  │ - selectTimeIndex            │  │  │
-│  │  └───────────────────────────┘  │ - selectTypeIndex            │  │  │
-│  │                                 └───────────────────────────────┘  │  │
-│  └─────────────────────────────────────────────────────────────────────┘  │
-│                                    │                                      │
-│                                    ▼                                      │
-│  ┌─────────────────────────────────────────────────────────────────────┐  │
-│  │                     Global State Flags                             │  │
-│  │  ┌───────────────────────────────┐  ┌─────────────────────────────┐ │  │
-│  │  │ trendLoadingState (boolean)   │  │ trendRequestedState (bool)  │ │  │
-│  │  │ - Tracks loading status       │  │ - Tracks if data requested  │ │  │
-│  │  └───────────────────────────────┘  └─────────────────────────────┘ │  │
-│  └─────────────────────────────────────────────────────────────────────┘  │
-│                                                                           │
-└───────────────────────────────────────────────────────────────────────────┘
-                                      │
+                     ┌────────────────┴────────────────┐
+                     ▼                                 ▼
+┌─────────────────────────────────┐  ┌─────────────────────────────────────┐
+│     TrendPage (Riverpod)        │  │       NotifyPage (Signals)          │
+├─────────────────────────────────┤  ├─────────────────────────────────────┤
+│                                 │  │                                     │
+│┌─────────────────────────────┐  │  │┌───────────────────────────────────┐│
+││      Riverpod Providers     │  │  ││         Signals State             ││
+││┌───────────────────────────┐│  │  ││┌─────────────────────────────────┐││
+│││    trendFirstProvider     ││  │  │││   notifySignal (List)           │││
+│││    trendSecondProvider    ││  │  │││   notifyIndexSignal (int)       │││
+││└───────────────────────────┘│  │  │││   signalPage (int)              │││
+│└─────────────────────────────┘  │  ││└─────────────────────────────────┘││
+│                                 │  │└───────────────────────────────────┘│
+│┌─────────────────────────────┐  │  │┌───────────────────────────────────┐│
+││  Local State (StatefulWidget)│  │  ││     SignalsMixin Processing      ││
+││  - UI Controls              │  │  ││  - createEffect() for reactions   ││
+││  - Filter Parameters        │  │  ││  - Manages data loading           ││
+│└─────────────────────────────┘  │  ││  - Updates UI based on signals    ││
+│                                 │  │└───────────────────────────────────┘│
+└─────────────────────────────────┘  └─────────────────────────────────────┘
+                     │                                 │
+                     └────────────────┬────────────────┘
                                       ▼
 ┌───────────────────────────────────────────────────────────────────────────┐
 │                            Data Layer                                      │
 │  ┌───────────────────────────────────────────────────────────────────────┐ │
-│  │                       ReposRepository                                 │ │
+│  │                  ReposRepository / UserRepository                     │ │
 │  │  ┌────────────────────────┐       ┌─────────────────────────────────┐ │ │
-│  │  │ Network Request        │───┬──▶│ TrendRepositoryDbProvider       │ │ │
-│  │  │ - API calls            │   │   │ - Database caching              │ │ │
-│  │  └────────────────────────┘   │   │ - Offline data retrieval        │ │ │
-│  │                               │   └─────────────────────────────────┘ │ │
+│  │  │ Network Request        │───┬──▶│ Database Providers              │ │ │
+│  │  │ - API calls            │   │   │ - Data caching                  │ │ │
+│  │  └────────────────────────┘   │   └─────────────────────────────────┘ │ │
 │  │                               │                                       │ │
 │  │                               │   ┌─────────────────────────────────┐ │ │
-│  │                               └──▶│ TrendingRepoModel               │ │ │
-│  │                                   │ - Data model for trending repos │ │ │
+│  │                               └──▶│ Data Models                     │ │ │
+│  │                                   │ - Structure definitions         │ │ │
 │  │                                   └─────────────────────────────────┘ │ │
 │  └───────────────────────────────────────────────────────────────────────┘ │
 └───────────────────────────────────────────────────────────────────────────┘
                                       │
                                       ▼
 ┌───────────────────────────────────────────────────────────────────────────┐
 │                              UI Components                                 │
-│  ┌────────────────────────────┐ ┌─────────────────────────┐ ┌───────────┐ │
-│  │ TrendTypeModel             │ │ ReposViewModel          │ │ ReposItem │  │
-│  │ - Filter options           │ │ - UI data wrapper       │ │ - UI      │ │
-│  └────────────────────────────┘ └─────────────────────────┘ └───────────┘ │
+│  ┌────────────────────┐  ┌────────────────────┐  ┌────────────────────┐   │
+│  │ View Models        │  │ List Items         │  │ Interactive UI     │   │
+│  │ - Data Formatting  │  │ - Item Rendering   │  │ - User Actions     │   │
+│  └────────────────────┘  └────────────────────┘  └────────────────────┘   │
 └───────────────────────────────────────────────────────────────────────────┘
-
 ```
 
 provider 页面内状态管理：