How deriandev17/asistenteqa-desktop works
QA Assistant Desktop is a local-first Windows project and task workspace, with optional Microsoft 365 mail and calendar integrations. The main workflow runs from the React dashboard through the preload/IPC boundary into workspace use cases and local repositories, then returns snapshots for planning and follow-up. Separate branches cover email-to-task review, calendar synchronization and meeting preparation, plus reminders and automation. The README documents these capabilities; some renderer, repository and reminder internals were not sampled, so only supported wiring is shown.
Main entry points: main.ts Electron main · email/service.ts Mail sync service · calendar/service.ts Calendar service · workspace.ts Workspace use cases
Components 29
Desktop boundary
- Preload API
src/main/preload.ts - Typed API
src/shared/api.ts - Electron main
src/main/main.ts - Workspace IPC
src/main/ipc/handlers.ts - Mail IPC
src/main/ipc/mail.ipc.ts - Email-task IPC
src/main/ipc/email-tasks.ipc.ts - Calendar IPC
src/main/ipc/calendar.ipc.ts - Reminder delivery
src/application/reminders.ts - Reminder receipts
src/infrastructure/database/reminder-receipts.ts
Local workspace
- Workspace use cases
src/application/workspace.ts - Domain rules
src/domain/validation.ts - Project and task repositories
src/infrastructure/database/repositories.ts - SQLite workspace
src/infrastructure/database/client.ts
Microsoft 365
- Email task review
src/application/email/tasks.ts - Mail sync service
src/application/email/service.ts - Encrypted mail storage
src/infrastructure/database/mail-repository.ts - Credential vault
src/infrastructure/security/mail-vault.ts - Microsoft sign-in
src/infrastructure/email/microsoft-auth.ts - Microsoft Graph mail
src/infrastructure/email/microsoft-graph.ts - Mail task source
src/infrastructure/email/task-source.ts - Calendar service
src/application/calendar/service.ts - Microsoft calendar provider
src/infrastructure/calendar/microsoft-calendar.ts - Calendar cache
src/infrastructure/database/calendar-repository.ts
Planning experience
- React interface
src/renderer/app/App.tsx - Workspace hook
src/renderer/hooks/useWorkspace.ts - Agenda and meetings
src/renderer/components/Agenda.tsx - Dashboard planning
src/renderer/pages/Dashboard.tsx
Other components
- User
- Microsoft 365
Connections 32
- User → React interface: uses
- React interface → Workspace hook: loads workspace
src/renderer/app/App.tsx - Workspace hook → Preload API: requests snapshot
src/renderer/hooks/useWorkspace.ts - Preload API → Typed API: exposes API
src/shared/api.ts - Electron main → Workspace IPC: registers handlers
src/main/main.ts - Electron main → Mail IPC: registers handlers
src/main/main.ts - Electron main → Email-task IPC: registers handlers
src/main/main.ts - Electron main → Calendar IPC: registers handlers
src/main/main.ts - Workspace IPC → Workspace use cases: dispatches requests
src/main/ipc/handlers.ts - Workspace use cases → Domain rules: validates inputs
src/application/workspace.ts - Workspace use cases → Project and task repositories: reads and writes
src/application/workspace.ts - Electron main → SQLite workspace: opens database
src/main/main.ts - Email-task IPC → Email task review: dispatches task actions
src/main/ipc/email-tasks.ipc.ts - Email task review → Project and task repositories: creates email tasks
src/application/email/tasks.ts - Email task review → Mail task source: resolves messages
src/application/email/tasks.ts - Mail IPC → Mail sync service: dispatches mail actions
src/main/main.ts - Mail sync service → Credential vault: loads credentials
src/application/email/service.ts - Mail sync service → Encrypted mail storage: applies and lists mail
src/application/email/service.ts - Mail sync service → Microsoft sign-in: obtains tokens
src/main/main.ts - Mail sync service → Microsoft Graph mail: fetches mail pages
- Mail task source → Encrypted mail storage: resolves messages
- Microsoft sign-in → Microsoft 365: authorizes
- Microsoft Graph mail → Microsoft 365: reads inbox
- Calendar IPC → Calendar service: dispatches calendar actions
src/main/ipc/calendar.ipc.ts - Calendar service → Mail sync service: uses account session
src/application/calendar/service.ts - Calendar service → Microsoft calendar provider: fetches events
src/application/calendar/service.ts - Calendar service → Calendar cache: reads and saves cache
src/application/calendar/service.ts - Microsoft calendar provider → Microsoft 365: reads calendar
- React interface → Dashboard planning: shows planning
src/renderer/app/App.tsx - Dashboard planning → Agenda and meetings: renders agenda
src/renderer/pages/Dashboard.tsx - Electron main → Reminder delivery: delivers notices
src/main/main.ts - Electron main → Reminder receipts: deduplicates notices
src/main/main.ts