fix md
This commit is contained in:
Phuoc Nguyen
214
docs/TEST_AUTO_LOGIN.md
Normal file
214
docs/TEST_AUTO_LOGIN.md
Normal file
@@ -0,0 +1,214 @@
|
||||
# Complete Auto-Login Test
|
||||
|
||||
**Date**: October 10, 2025
|
||||
|
||||
---
|
||||
|
||||
## Step-by-Step Test
|
||||
|
||||
### Step 1: Login with Remember Me
|
||||
|
||||
1. **Run the app**: `flutter run`
|
||||
2. **Login** with:
|
||||
- Email: `admin@retailpos.com`
|
||||
- Password: `Admin123!`
|
||||
- **Remember Me: CHECKED ✅**
|
||||
3. **Click Login**
|
||||
|
||||
**Expected Logs**:
|
||||
```
|
||||
REQUEST[POST] => PATH: /auth/login
|
||||
📡 DataSource: Calling login API...
|
||||
📡 DataSource: Status=200
|
||||
🔐 Repository: Starting login (rememberMe: true)...
|
||||
💾 SecureStorage: Saving token (length: 247)...
|
||||
💾 SecureStorage: Token saved successfully
|
||||
💾 SecureStorage: Verification - token exists: true, length: 247
|
||||
🔐 Repository: Token saved to secure storage (persistent)
|
||||
🔐 Repository: Token set in DioClient
|
||||
✅ Login SUCCESS: user=Admin User, token length=247
|
||||
✅ State updated: isAuthenticated=true
|
||||
AuthWrapper build: isAuthenticated=true, isLoading=false
|
||||
```
|
||||
|
||||
**Result**: Should navigate to MainScreen
|
||||
|
||||
---
|
||||
|
||||
### Step 2: Hot Restart (Test Auto-Login)
|
||||
|
||||
**In terminal, press 'R' (capital R for hot restart)**
|
||||
|
||||
**Expected Logs**:
|
||||
```
|
||||
📱 RetailApp: initState called
|
||||
📱 RetailApp: Calling initialize()...
|
||||
🚀 Initializing auth state...
|
||||
🔍 Checking authentication...
|
||||
💾 SecureStorage: Checking if token exists...
|
||||
💾 SecureStorage: Reading token...
|
||||
💾 SecureStorage: Token read result - exists: true, length: 247
|
||||
💾 SecureStorage: Token exists: true
|
||||
🔍 Has token in storage: true
|
||||
🔍 Token retrieved, length: 247
|
||||
✅ Token loaded from storage and set in DioClient
|
||||
🚀 isAuthenticated result: true
|
||||
🚀 Token found, fetching user profile...
|
||||
REQUEST[GET] => PATH: /auth/profile
|
||||
📡 DataSource: Response...
|
||||
✅ Profile loaded: Admin User
|
||||
✅ Initialize complete: isAuthenticated=true
|
||||
AuthWrapper build: isAuthenticated=true, isLoading=false
|
||||
```
|
||||
|
||||
**Result**: ✅ Should auto-login and show MainScreen (no login page!)
|
||||
|
||||
---
|
||||
|
||||
### Step 3: Logout and Test Without Remember Me
|
||||
|
||||
1. **Go to Settings tab**
|
||||
2. **Click Logout**
|
||||
3. **Should return to LoginPage**
|
||||
4. **Login again with Remember Me UNCHECKED ❌**
|
||||
|
||||
**Expected Logs**:
|
||||
```
|
||||
🔐 Repository: Starting login (rememberMe: false)...
|
||||
🔐 Repository: Token NOT saved (session only - rememberMe is false)
|
||||
```
|
||||
|
||||
5. **Press 'R' to hot restart**
|
||||
|
||||
**Expected Logs**:
|
||||
```
|
||||
📱 RetailApp: initState called
|
||||
📱 RetailApp: Calling initialize()...
|
||||
🚀 Initializing auth state...
|
||||
🔍 Checking authentication...
|
||||
💾 SecureStorage: Checking if token exists...
|
||||
💾 SecureStorage: Reading token...
|
||||
💾 SecureStorage: Token read result - exists: false, length: 0
|
||||
💾 SecureStorage: Token exists: false
|
||||
🔍 Has token in storage: false
|
||||
❌ No token found in storage
|
||||
🚀 isAuthenticated result: false
|
||||
❌ No token found, user needs to login
|
||||
AuthWrapper build: isAuthenticated=false, isLoading=false
|
||||
```
|
||||
|
||||
**Result**: ✅ Should show LoginPage (must login again)
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting Guide
|
||||
|
||||
### Issue 1: No initialization logs
|
||||
|
||||
**Symptom**: Don't see `📱 RetailApp: initState called`
|
||||
|
||||
**Cause**: Hot reload ('r') instead of hot restart ('R')
|
||||
|
||||
**Fix**: Press 'R' (capital R) in terminal, not 'r'
|
||||
|
||||
---
|
||||
|
||||
### Issue 2: Token not being saved
|
||||
|
||||
**Symptom**: See `🔐 Repository: Token NOT saved (session only)`
|
||||
|
||||
**Cause**: Remember Me checkbox was not checked
|
||||
|
||||
**Fix**: Make sure checkbox is checked before login
|
||||
|
||||
---
|
||||
|
||||
### Issue 3: Token saved but not loaded
|
||||
|
||||
**Symptom**:
|
||||
- Login shows: `💾 SecureStorage: Token saved successfully`
|
||||
- Restart shows: `💾 SecureStorage: Token read result - exists: false`
|
||||
|
||||
**Possible Causes**:
|
||||
1. Hot reload instead of hot restart
|
||||
2. Different SecureStorage instances (should not happen with keepAlive)
|
||||
3. Platform-specific secure storage issue
|
||||
|
||||
**Debug**:
|
||||
```dart
|
||||
// Add this temporarily to verify token persistence
|
||||
// In lib/features/auth/presentation/pages/login_page.dart
|
||||
// After successful login, add:
|
||||
Future.delayed(Duration(seconds: 1), () async {
|
||||
final storage = SecureStorage();
|
||||
final token = await storage.getAccessToken();
|
||||
print('🔬 TEST: Token check after 1 second: ${token != null}');
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Issue 4: Initialize not being called
|
||||
|
||||
**Symptom**: No `🚀 Initializing auth state...` log
|
||||
|
||||
**Cause**: `initState()` not being called or postFrameCallback not executing
|
||||
|
||||
**Fix**: Verify app.dart has:
|
||||
```dart
|
||||
@override
|
||||
void initState() {
|
||||
super.initState();
|
||||
print('📱 RetailApp: initState called'); // Should see this
|
||||
WidgetsBinding.instance.addPostFrameCallback((_) {
|
||||
print('📱 RetailApp: Calling initialize()...'); // Should see this
|
||||
ref.read(authProvider.notifier).initialize();
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Complete Log Sequence (Success Case)
|
||||
|
||||
### On Login (Remember Me = true)
|
||||
```
|
||||
1. REQUEST[POST] => PATH: /auth/login
|
||||
2. 📡 DataSource: Calling login API...
|
||||
3. 🔐 Repository: Starting login (rememberMe: true)...
|
||||
4. 💾 SecureStorage: Saving token (length: 247)...
|
||||
5. 💾 SecureStorage: Token saved successfully
|
||||
6. 💾 SecureStorage: Verification - token exists: true, length: 247
|
||||
7. 🔐 Repository: Token saved to secure storage (persistent)
|
||||
8. ✅ Login SUCCESS
|
||||
9. AuthWrapper build: isAuthenticated=true
|
||||
```
|
||||
|
||||
### On App Restart (Auto-Login)
|
||||
```
|
||||
1. 📱 RetailApp: initState called
|
||||
2. 📱 RetailApp: Calling initialize()...
|
||||
3. 🚀 Initializing auth state...
|
||||
4. 🔍 Checking authentication...
|
||||
5. 💾 SecureStorage: Checking if token exists...
|
||||
6. 💾 SecureStorage: Reading token...
|
||||
7. 💾 SecureStorage: Token read result - exists: true, length: 247
|
||||
8. 🔍 Has token in storage: true
|
||||
9. ✅ Token loaded from storage and set in DioClient
|
||||
10. 🚀 Token found, fetching user profile...
|
||||
11. ✅ Profile loaded: Admin User
|
||||
12. ✅ Initialize complete: isAuthenticated=true
|
||||
13. AuthWrapper build: isAuthenticated=true
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## What to Share
|
||||
|
||||
If auto-login is still not working, please share:
|
||||
|
||||
1. **Complete logs from login** (Step 1)
|
||||
2. **Complete logs from restart** (Step 2)
|
||||
3. **Platform** (iOS, Android, macOS, web, etc.)
|
||||
|
||||
This will help identify exactly where the issue is! 🔍
|
||||
Reference in New Issue
Block a user