How dustywoods/reminder works
拾序(Reminder) is a Flutter task-management app backed by FastAPI. Users authenticate, enter a natural-language task request, and receive task changes or a planning summary: the documented ReAct workflow plans, acts, observes/retries, then summarizes. The app also exposes task-list/calendar views and local reminders. The README documents the major frontend/backend capabilities; sampled backend files confirm routing, persistence, and agent behavior. Frontend implementation excerpts were not provided, so its internal links follow documented architecture rather than inspected calls; voice input is described as not yet integrated.
Main entry points: main.py FastAPI app · graph.py Workflow routing · database.py SQLite data · Page Task and account pages
Components 27
Flutter app
- App entry and routes
frontend/lib/main.dart - Task and account pages
frontend/lib/Page - Task state
frontend/lib/stores/TaskManager.dart - Login state
frontend/lib/stores/LoginManager.dart - API clients
frontend/lib/api - Local reminders
frontend/lib/Services/NotificationService.dart
Backend API
- FastAPI app
backend/main.py - Auth routes
backend/routers/auth.py - Task routes
backend/routers/task.py - Text interaction
backend/routers/text.py - Voice routes
backend/routers/voice.py - Request schemas
backend/models/schemas.py
ReAct agent
- Plan
backend/agent/nodes.py - Act
backend/agent/nodes.py - Observe and retry
backend/agent/nodes.py - Summarize
backend/agent/nodes.py - Workflow routing
backend/agent/graph.py - Task operations
backend/agent/actions.py - Agent prompts
backend/agent/prompts.py - Agent state
backend/agent/state.py
Backend services
- LLM helper
backend/utils/llm_helpers.py - Authentication service
backend/services/auth.py - Speech recognition
backend/services/asr.py
Persistence and state
- SQLite data
backend/utils/database.py - Backend settings
backend/config/settings.py
Other components
- User
- DeepSeek LLM
Connections 35
- User → App entry and routes: uses
README.md - App entry and routes → Task and account pages: routes to
README.md - Task and account pages → API clients: requests
README.md - Task and account pages → Task state: updates
README.md - Task and account pages → Login state: uses
README.md - Task and account pages → Local reminders: schedules reminders
README.md - API clients → FastAPI app: HTTP requests
README.md - FastAPI app → Auth routes: registers
backend/main.py - FastAPI app → Task routes: registers
backend/main.py - FastAPI app → Text interaction: registers
backend/main.py - FastAPI app → Voice routes: registers
backend/main.py - Auth routes → Authentication service: calls
backend/routers/auth.py - Auth routes → SQLite data: loads tasks
backend/routers/auth.py - Authentication service → SQLite data: accesses
backend/services/auth.py - Task routes → SQLite data: reads and writes
backend/routers/task.py - Text interaction → Workflow routing: runs agent
backend/routers/text.py - Voice routes → Speech recognition: recognizes audio
backend/routers/voice.py - Voice routes → Workflow routing: processes transcript
backend/routers/voice.py - Workflow routing → Plan: runs
backend/agent/graph.py - Workflow routing → Act: dispatches
backend/agent/graph.py - Workflow routing → Observe and retry: routes
backend/agent/graph.py - Workflow routing → Summarize: routes
backend/agent/graph.py - Plan → Agent prompts: builds prompt
backend/agent/nodes.py - Plan → LLM helper: creates LLM
backend/agent/nodes.py - Plan → SQLite data: loads task context
backend/agent/nodes.py - Act → Task operations: executes steps
backend/agent/nodes.py - Act → SQLite data: loads task context
backend/agent/nodes.py - Summarize → Agent prompts: builds prompt
backend/agent/nodes.py - Summarize → LLM helper: creates LLM
backend/agent/nodes.py - Task operations → SQLite data: manages tasks
backend/agent/actions.py - LLM helper → DeepSeek LLM: invokes
- Speech recognition → Backend settings: reads configuration
backend/services/asr.py - FastAPI app → Backend settings: reads configuration
backend/main.py - Task state → API clients: synchronizes tasks
- Login state → API clients: authenticates