How jirasak-thongpila/nudge works
Nudge turns task input into dynamically prioritized work, detects possible avoidance, and helps users begin via a short focus session or an Action Nudge. The backend also supports Gemini text/audio parsing, LINE chat and LIFF integration, and an overview dashboard. The Flutter application source is not present in this tree, so clients are represented as external actors rather than inferred frontend modules. The graph follows documented capabilities and sampled route/service calls; unsampled subsystem links are limited to README-documented relationships.
Main entry points: app.ts Elysia API · task.service.ts Task Management · line.service.ts LINE Messaging · auth.ts Device / LINE Auth
Components 23
API and Identity
- Elysia API
backend/src/app.ts - Device / LINE Auth
backend/src/plugins/auth.ts - User Management
backend/src/services/user.service.ts - Task Routes
backend/src/routes/tasks.ts - Overview Dashboard
backend/src/routes/dashboard.ts - Focus Routes
backend/src/routes/focus.ts - Nudge Routes
backend/src/routes/nudges.ts - LINE Routes
backend/src/routes/line.ts
Task Intelligence
- Task Management
backend/src/services/task.service.ts - Priority Engine
backend/src/lib/priority.ts - Avoidance Detection
backend/src/lib/avoidance.ts - Deadline Calculation
backend/src/lib/date.ts
Focus and Nudges
- Focus Sessions
backend/src/services/focus.service.ts - Nudge Dispatch
backend/src/services/nudge.service.ts - Nudge Selection
backend/src/lib/nudge.ts
External Integrations
- Gemini Task Parser
backend/src/services/gemini.service.ts - LINE Messaging
backend/src/services/line.service.ts - Google Gemini API
- LINE Messaging API
Persistence
- PostgreSQL / Neon
backend/src/db/schema.ts
Other components
- Flutter App / LIFF
- LINE Chat
- Nudge Scheduler
backend/src/scripts/dispatch-nudges.ts
Connections 33
- Flutter App / LIFF → Elysia API: REST requests
- LINE Chat → Elysia API: Webhook events
- Nudge Scheduler → Elysia API: dispatch request
- Elysia API → Task Routes: registers routes
backend/src/app.ts - Elysia API → Overview Dashboard: registers routes
backend/src/app.ts - Elysia API → Focus Routes: registers routes
backend/src/app.ts - Elysia API → LINE Routes: registers routes
backend/src/app.ts - Elysia API → Nudge Routes: registers routes
backend/src/app.ts - Task Routes → Device / LINE Auth: authenticates
backend/src/routes/tasks.ts - Task Routes → Task Management: manages tasks
backend/src/routes/tasks.ts - Task Routes → Gemini Task Parser: parses audio
backend/src/routes/tasks.ts - Overview Dashboard → Task Management: gets dashboard
backend/src/routes/dashboard.ts - Focus Routes → Device / LINE Auth: authenticates
backend/src/routes/focus.ts - Focus Routes → Focus Sessions: manages sessions
backend/src/routes/focus.ts - Nudge Routes → Device / LINE Auth: authenticates
backend/src/routes/nudges.ts - Nudge Routes → Nudge Dispatch: dispatches nudges
backend/src/routes/nudges.ts - LINE Routes → Device / LINE Auth: authenticates
backend/src/routes/line.ts - LINE Routes → LINE Messaging: handles LINE
backend/src/routes/line.ts - Device / LINE Auth → User Management: resolves identity
backend/src/plugins/auth.ts - Task Management → Priority Engine: calculates scores
backend/src/services/task.service.ts - Task Management → Avoidance Detection: detects avoidance
backend/src/services/task.service.ts - Task Management → Deadline Calculation: calculates deadlines
backend/src/services/task.service.ts - Focus Sessions → Task Management: updates task status
backend/src/services/focus.service.ts - Nudge Dispatch → Nudge Selection: selects candidate
backend/src/services/nudge.service.ts - Nudge Dispatch → LINE Messaging: sends action nudge
backend/src/services/nudge.service.ts - LINE Messaging → LINE Messaging API: sends messages
backend/src/services/line.service.ts - LINE Messaging → Task Management: reads tasks
backend/src/services/line.service.ts - LINE Messaging → User Management: resolves LINE user
backend/src/services/line.service.ts - LINE Messaging → Gemini Task Parser: interprets messages
backend/src/services/line.service.ts - Gemini Task Parser → Google Gemini API: parses task input
- Task Management → PostgreSQL / Neon: reads and writes
backend/src/services/task.service.ts - User Management → PostgreSQL / Neon: reads and writes
backend/src/services/user.service.ts - Focus Sessions → PostgreSQL / Neon: records sessions
backend/src/services/focus.service.ts