# parthamallick49/task_manager_app architecture

> Architecture diagram of the GitHub repository parthamallick49/task_manager_app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-04-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/parthamallick49/task_manager_app
- Repository: https://github.com/parthamallick49/task_manager_app

## Overview

1. **Repository shape**
   - This is a two-tier mobile app: a **Flutter client** in `frontend/task_manager_app` and a **Node.js/Express backend** in `backend/task-manager-server`.
   - The system is centered on a REST API plus a small static file host for app distribution.

2. **Client-side presentation layer**
   - The Flutter app is organized by concern: `screens`, `widgets`, `auth`, `providers`, `services`, `models`, and `utils`.
   - Screens represent the user journeys: splash, login/register, home/dashboard, add/edit task, task details, search, and update prompt.

3. **Client state and data orchestration**
   - `providers/` acts as the app’s state boundary, likely wrapping authentication, task lists, and current user data for the widget tree.
   - `services/` contains the network-facing layer, so UI widgets do not talk directly to HTTP endpoints.
   - `utils/shared_prefs.dart` indicates local persistence of session data such as JWTs or user state.

4. **Authentication flow**
   - The app has a dedicated auth subdomain: `login_screen.dart`, `register_screen.dart`, and `auth_service.dart`.
   - Login/register appear to authenticate against the backend, then store credentials locally and drive subsequent API calls through the providers.

5. **Task management flow**
   - Task CRUD is split between `task_service.dart`, `task_provider.dart`, `task_model.dart`, and task-oriented screens/widgets.
   - The UI likely fetches tasks from the server, renders them in cards, and routes create/update/delete actions back through the service layer.

6. **Update/version-check path**
   - `version_check_service.dart` and `UpdateScreen.dart` suggest the app checks backend-provided version metadata.
   - The backend’s `public/apk/task_manager_latest.apk` and `routes/appInfoRoutes.js` indicate a built-in distribution path for APK updates, separate from normal task/auth APIs.

7. **Backend HTTP API boundary**
   - The Express app is split into `routes`, `controllers`, `middleware`, and `models`, which is a classic layered API architecture.
   - Routes define endpoints, controllers implement request handling, models map to persisted data, and middleware handles cross-cutting concerns.

8. **Backend domain modules**
   - `userController.js` and `taskController.js` are the main business logic entry points.
   - `userModel.js` and `taskModel.js` define the backend’s persistent entities, with MongoDB as the data store per the README.

9. **Backend security and error handling**
   - `middleware/authMiddleware.js` enforces authenticated access, likely validating JWTs on protected task/user routes.
   - `middleware/errorMiddleware.js` centralizes API error shaping, so the controllers can remain thin and route-specific.

10. **Backend API surface**
   - `userRoutes.js` likely handles signup/login and user-related operations.
   - `taskRoutes.js` handles authenticated CRUD for tasks.
   - `appInfoRoutes.js` exposes application metadata such as latest version/build info for the Flutter update flow.

11. **Static asset and distribution boundary**
   - The backend also serves static content from `public/`, most notably the APK file.
   - That means the server is both an API provider and an app artifact host, which is important for the architecture diagram.

12. **Platform packaging**
   - The Flutter project includes both Android and iOS runners, so the client is cross-platform even though the APK update path is Android-specific.
   - Android network/security config files suggest the mobile app is configured for backend connectivity and file handling on-device.

13. **End-to-end data flow**
   - User opens the Flutter app → splash/auth state is resolved from local storage → app calls backend APIs via services/providers.
   - Authenticated requests go to Express routes → middleware validates JWTs → controllers read/write MongoDB-backed models → JSON responses return to the app.
   - Separately, version checks hit app-info endpoints and may direct the user to download the latest APK from the backend-hosted static file.

14. **Key architectural boundaries to draw**
   - UI vs state vs network in Flutter.
   - Public API routes vs protected routes on the backend.
   - Business logic in controllers vs persistence in models.
   - Normal task/auth traffic vs update/distribution traffic.

Main entry points: [`backend/task-manager-server/routes/taskRoutes.js`](https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/routes/taskRoutes.js) (Task & user routes), [`frontend/task_manager_app/lib/providers/task_provider.dart`](https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/providers/task_provider.dart) (Task state), [`frontend/task_manager_app/lib/providers/auth_provider.dart`](https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/providers/auth_provider.dart) (Auth state), [`backend/task-manager-server/server.js`](https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/server.js) (Server entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Flutter client"]
  node_flutter_main["App shell<br/>Flutter entrypoint<br/>[main.dart]"]
  node_splash_screen["Splash<br/>Startup screen<br/>[splash_screen.dart]"]
  node_auth_screens["Login & register<br/>Auth UI<br/>[login_screen.dart]"]
  node_home_screen["Home<br/>Dashboard screen<br/>[home_screen.dart]"]
  node_task_screens["Task flows<br/>Task UI"]
  node_auth_provider["Auth state<br/>Provider<br/>[auth_provider.dart]"]
  node_task_provider["Task state<br/>Provider<br/>[task_provider.dart]"]
  node_user_provider["User state<br/>Provider<br/>[user_provider.dart]"]
  node_auth_service["Auth API<br/>Network service<br/>[auth_service.dart]"]
  node_task_service["Task API<br/>Network service<br/>[task_service.dart]"]
  node_version_service["Version check<br/>Update service"]
  node_local_prefs[("Local prefs<br/>Persistence<br/>[shared_prefs.dart]")]
  node_task_model["Task model<br/>Data model<br/>[task.dart]"]
end

subgraph group_backend["Express API"]
  node_backend_server["Server entry<br/>Express bootstrap<br/>[server.js]"]
  node_api_routes["Task & user routes<br/>REST routes<br/>[taskRoutes.js]"]
  node_appinfo_routes["App info routes<br/>Metadata routes<br/>[appInfoRoutes.js]"]
  node_user_controller["User controller<br/>Request handler<br/>[userController.js]"]
  node_task_controller["Task controller<br/>Request handler<br/>[taskController.js]"]
  node_auth_middleware["Auth guard<br/>Middleware<br/>[authMiddleware.js]"]
  node_error_middleware["Error handler<br/>Middleware<br/>[errorMiddleware.js]"]
  node_user_model["User model<br/>Mongo model<br/>[userModel.js]"]
  node_backend_task_model["Task model<br/>Mongo model<br/>[taskModel.js]"]
  node_apk_host["APK host<br/>Static asset"]
end

node_flutter_main -->|"launches"| node_splash_screen
node_splash_screen -->|"reads state"| node_auth_provider
node_splash_screen -->|"loads session"| node_local_prefs
node_auth_screens -->|"updates"| node_auth_provider
node_auth_provider -->|"calls"| node_auth_service
node_auth_service -->|"POST auth"| node_api_routes
node_auth_service -->|"stores token"| node_local_prefs
node_home_screen -->|"consumes"| node_task_provider
node_task_screens -->|"updates"| node_task_provider
node_task_provider -->|"calls"| node_task_service
node_task_service -->|"CRUD tasks"| node_api_routes
node_task_service -.->|"maps data"| node_backend_task_model
node_task_provider -.->|"uses"| node_task_model
node_user_provider -.->|"derives from"| node_auth_provider
node_version_service -->|"checks version"| node_appinfo_routes
node_version_service -->|"downloads APK"| node_apk_host
node_backend_server -->|"mounts"| node_api_routes
node_backend_server -->|"mounts"| node_appinfo_routes
node_api_routes -->|"protects"| node_auth_middleware
node_api_routes -->|"delegates"| node_user_controller
node_api_routes -->|"delegates"| node_task_controller
node_user_controller -->|"persists"| node_user_model
node_task_controller -->|"persists"| node_backend_task_model
node_backend_server -->|"uses"| node_error_middleware

click node_flutter_main "https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/main.dart"
click node_splash_screen "https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/screens/splash_screen.dart"
click node_auth_screens "https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/auth/login_screen.dart"
click node_home_screen "https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/screens/home_screen.dart"
click node_task_screens "https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/screens/add_task_screen.dart"
click node_auth_provider "https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/providers/auth_provider.dart"
click node_task_provider "https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/providers/task_provider.dart"
click node_user_provider "https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/providers/user_provider.dart"
click node_auth_service "https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/services/auth_service.dart"
click node_task_service "https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/services/task_service.dart"
click node_version_service "https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/services/version_check_service.dart"
click node_local_prefs "https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/utils/shared_prefs.dart"
click node_task_model "https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/models/task.dart"
click node_backend_server "https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/server.js"
click node_api_routes "https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/routes/taskRoutes.js"
click node_appinfo_routes "https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/routes/appInfoRoutes.js"
click node_user_controller "https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/controllers/userController.js"
click node_task_controller "https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/controllers/taskController.js"
click node_auth_middleware "https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/middleware/authMiddleware.js"
click node_error_middleware "https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/middleware/errorMiddleware.js"
click node_user_model "https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/models/userModel.js"
click node_backend_task_model "https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/models/taskModel.js"
click node_apk_host "https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/public/apk/task_manager_latest.apk"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_flutter_main,node_splash_screen,node_auth_screens,node_home_screen,node_task_screens,node_auth_provider,node_task_provider,node_user_provider,node_auth_service,node_task_service,node_version_service,node_local_prefs,node_task_model toneBlue
class node_backend_server,node_api_routes,node_appinfo_routes,node_user_controller,node_task_controller,node_auth_middleware,node_error_middleware,node_user_model,node_backend_task_model,node_apk_host toneAmber
```

## Components

### Flutter client

Cross-platform mobile app in frontend/task_manager_app

- [App shell](https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/main.dart): Flutter entrypoint · Bootstraps the mobile app and initial routing · `frontend/task_manager_app/lib/main.dart`
- [Splash](https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/screens/splash_screen.dart): Startup screen · Resolves initial auth/session state before navigation · `frontend/task_manager_app/lib/screens/splash_screen.dart`
- [Login & register](https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/auth/login_screen.dart): Auth UI · User sign-in and account creation screens · `frontend/task_manager_app/lib/auth/login_screen.dart`
- [Home](https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/screens/home_screen.dart): Dashboard screen · Primary task overview and navigation hub · `frontend/task_manager_app/lib/screens/home_screen.dart`
- [Task flows](https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/screens/add_task_screen.dart): Task UI · Add, detail, search, and update task screens · `frontend/task_manager_app/lib/screens/add_task_screen.dart`
- [Auth state](https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/providers/auth_provider.dart): Provider · App state boundary for authentication · `frontend/task_manager_app/lib/providers/auth_provider.dart`
- [Task state](https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/providers/task_provider.dart): Provider · State management for task lists and task actions · `frontend/task_manager_app/lib/providers/task_provider.dart`
- [User state](https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/providers/user_provider.dart): Provider · Current user/session data for the widget tree · `frontend/task_manager_app/lib/providers/user_provider.dart`
- [Auth API](https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/services/auth_service.dart): Network service · Handles login and registration requests · `frontend/task_manager_app/lib/services/auth_service.dart`
- [Task API](https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/services/task_service.dart): Network service · CRUD client for task endpoints · `frontend/task_manager_app/lib/services/task_service.dart`
- [Version check](https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/services/version_check_service.dart): Update service · Fetches app version metadata for update prompts · `frontend/task_manager_app/lib/services/version_check_service.dart`
- [Local prefs](https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/utils/shared_prefs.dart): Persistence · Stores session and user data on device · `frontend/task_manager_app/lib/utils/shared_prefs.dart`
- [Task model](https://github.com/parthamallick49/task_manager_app/blob/main/frontend/task_manager_app/lib/models/task.dart): Data model · Client-side task entity shape · `frontend/task_manager_app/lib/models/task.dart`

### Express API

Node.js server in backend/task-manager-server

- [Server entry](https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/server.js): Express bootstrap · Starts the API server and wires middleware/routes · `backend/task-manager-server/server.js`
- [Task & user routes](https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/routes/taskRoutes.js): REST routes · Protected task endpoints and auth-related user endpoints · `backend/task-manager-server/routes/taskRoutes.js`
- [App info routes](https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/routes/appInfoRoutes.js): Metadata routes · Exposes version/build info for update checks · `backend/task-manager-server/routes/appInfoRoutes.js`
- [User controller](https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/controllers/userController.js): Request handler · Implements signup/login and user-facing logic · `backend/task-manager-server/controllers/userController.js`
- [Task controller](https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/controllers/taskController.js): Request handler · Implements task CRUD business logic · `backend/task-manager-server/controllers/taskController.js`
- [Auth guard](https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/middleware/authMiddleware.js): Middleware · Validates authenticated access on protected routes · `backend/task-manager-server/middleware/authMiddleware.js`
- [Error handler](https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/middleware/errorMiddleware.js): Middleware · Central API error shaping and response handling · `backend/task-manager-server/middleware/errorMiddleware.js`
- [User model](https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/models/userModel.js): Mongo model · Persistent user entity definition · `backend/task-manager-server/models/userModel.js`
- [Task model](https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/models/taskModel.js): Mongo model · Persistent task entity definition · `backend/task-manager-server/models/taskModel.js`
- [APK host](https://github.com/parthamallick49/task_manager_app/blob/main/backend/task-manager-server/public/apk/task_manager_latest.apk): Static asset · Served Android build artifact for app distribution · `backend/task-manager-server/public/apk/task_manager_latest.apk`

## Connections

- App shell → Splash: launches · App starts in splash and session resolution
- Splash → Auth state: reads state · Checks whether a user is already authenticated
- Splash → Local prefs: loads session · Restores cached token or user state
- Login & register → Auth state: updates · Auth UI drives auth state changes
- Auth state → Auth API: calls · Delegates login and registration to the network layer
- Auth API → Task & user routes: POST auth · Sends authentication requests to the backend
- Auth API → Local prefs: stores token · Persists session data after successful auth
- Home → Task state: consumes · Dashboard renders task state from provider
- Task flows → Task state: updates · Task UI triggers create/update/search flows
- Task state → Task API: calls · Provider mediates task API access
- Task API → Task & user routes: CRUD tasks · Authenticated task operations go through REST routes
- Task API → Task model: maps data · Task payloads mirror backend task entities
- Task state → Task model: uses · Client state is shaped by the task model
- User state → Auth state: derives from · Current user state follows authentication state
- Version check → App info routes: checks version · Queries backend metadata for update availability
- Version check → APK host: downloads APK · Update flow points to hosted app binary
- Server entry → Task & user routes: mounts · Registers REST API routes
- Server entry → App info routes: mounts · Registers version/info routes
- Task & user routes → Auth guard: protects · Authenticated task endpoints are guarded
- Task & user routes → User controller: delegates · User requests are handled by the user controller
- Task & user routes → Task controller: delegates · Task requests are handled by the task controller
- User controller → User model: persists · User logic reads and writes user records
- Task controller → Task model: persists · Task logic reads and writes task records
- Server entry → Error handler: uses · Centralizes API error handling
