How cencool/peoplerapp works
Main Application Architecture Components
a) Client Layer (Flutter UI)
• Main pages found in lib/pages:
• Login Page
• Start Page
• Person List Page
• General Search Page
• Person Page
b) Widget Layer
• This directly below the Client Layer
• Widgets by functionality:
• Person-related widgets (PersonTab, PersonPhotoView)
• Search widgets (GeneralSearchTab)
• Data display widgets (PlutoPersonList, SfGridPersonList)
• Relation widgets (RelationTab, RelationTable)
c) State Management & Global Services
• This layer in the middle
• Include:
• AppState
• AppGlobals
• Configuration (AppConfig)
d) Data Models Layer
• This above the API layer
• Models from lib/models:
• Person
• PersonDetail
• PersonForm
• PersonItem
• Credentials
• RelationRecord
e) API Layer
• At the bottom
• API communication handling
• Error handling (ApiException)
Platform-Specific Components
• Android
• iOS
• Web
• Linux
• Windows
• macOS
Specific Implementation Details
Technical aspects:
• HTTP client implementation (dev_http.dart)
• Authentication flow
• Search functionality
• File attachment handling
• Person relations management
Component Relationships
Key relationships:
• Person-to-Attachment
• Person-to-Relation
• Search-to-Results
• Authentication-to-Protected Resources