How 2746267826/pim-platform works
PIM is a self-hosted personal information hub that collects PC and phone activity, processes it into deterministic summaries, and presents those conclusions for review and planning. The main flow is client collection and upload → server-side domain processing and storage → Web or Android views. The graph also covers calendar planning, files and notes, AI/MCP, and operations. Some capabilities are documented in the README but their implementation was not sampled; those links are based on documentation, and uncertain internal wiring is omitted.
Main entry points: Program.cs API host · TodayEndpoints.cs Today view API · SchedulingEngine.cs Schedule engine · Pim.Module.Files File services
Components 22
Collection clients
- Android app
src/client-android/app/src/main/java/com/pim/app - Windows tracker
- Browser extension
PIM server
- API host
src/Pim.Api/Program.cs - Today view API
src/Pim.Api/Endpoints/TodayEndpoints.cs - MCP service
src/modules/Pim.Module.Mcp/Services/McpInProcessPipeline.cs - Operations
src/Pim.Infrastructure/Operations
Domain services
- Mobile ingest
src/modules/Pim.Module.Mobile/Services/MobileUsageIngestService.cs - Mobile analytics
src/modules/Pim.Module.Mobile/Services/MobileUsageQueryService.cs - Location queries
src/modules/Pim.Module.Mobile/Services/MobileLocationQueryService.cs - Calendar domain
src/modules/Pim.Module.Calendar - Schedule engine
src/modules/Pim.Module.Calendar/Services/SchedulingEngine.cs - PC activity domain
src/modules/Pim.Module.PcTracker - File services
src/modules/Pim.Module.Files - Quick Notes
src/modules/Pim.Module.QuickNotes/Services/OneDriveQuickNoteObjectStorage.cs - AI gateway
src/Pim.Infrastructure/Ai/AiGateway.cs
User experience
- Web app
src/client-web - Android views
src/client-android/app/src/main/java/com/pim/app/ui
External services
- PostgreSQL
- Microsoft OneDrive
- Monitoring tools
Other components
- PIM user
Connections 25
- PIM user → Android app: uses
- PIM user → Web app: uses
- Android app → API host: uploads activity
- Windows tracker → API host: reports events
- Browser extension → API host: syncs tabs
- API host → Mobile ingest: dispatches upload
- Mobile ingest → PostgreSQL: writes batches
- Mobile analytics → PostgreSQL: reads activity
- Location queries → PostgreSQL: reads location
- PC activity domain → PostgreSQL: stores records
- Calendar domain → PostgreSQL: reads and writes
- Schedule engine → PostgreSQL: reads tasks and events
- Schedule engine → Calendar domain: generates plans
- API host → Today view API: maps endpoints
- Today view API → Web app: serves conclusions
- Today view API → Android views: serves conclusions
- Android views → API host: requests summaries
- File services → Microsoft OneDrive: reads and writes files
- File services → PostgreSQL: stores metadata
- Quick Notes → Microsoft OneDrive: stores attachments
- AI gateway → PostgreSQL: records usage
- AI gateway → MCP service: provides AI capability
- MCP service → API host: dispatches requests
- Operations → PostgreSQL: inspects system data
- Monitoring tools → API host: collects telemetry