安装命令
npx skills add https://github.com/abelv22/project-foundation --skill offline-sync🇨🇳中文介绍
离线优先与数据同步专家技能
此技能使助手能够设计和实现一个健壮的同步系统，以解决“无离线队列”问题（P0）。
知识领域
1. 本地存储（原生）
- Room 数据库： 在 Android 端实现本地 SQLite 存储以缓冲位置更新。
- 数据实体： 定义与 Supabase
registros_reten结构匹配的OfflineLocation模式。
2. 同步策略
- 后台同步： 使用
WorkManager在连接恢复时可靠地上传数据。 - 冲突解决： 针对位置数据使用基于时间戳的简单解决方案。
- 批量上传： 通过单个 HTTP 请求向 Supabase 发送多条记录的策略，以节省电量。
3. 连接监控
- 网络状态： 在 Web（React）和原生（Java）端对连接变化做出反应。
- 故障转移逻辑： 在直连 Supabase 模式和本地优先模式之间优雅切换。
4. 数据完整性
- 去重： 确保同一位置点不会被发送两次。
- 队列管理： 如果设备长时间离线，则截断旧日志，以防止存储膨胀。
响应指南
- 优先考虑批量请求以最大限度地提高电池效率。
🇺🇸English
Offline-First & Data Sync Specialist Skill
This skill enables the assistant to design and implement a robust synchronization system to solve the "No Offline Queue" issue (P0).
Knowledge Areas
1. Local Storage (Native)
- Room Database: Implementing a local SQLite storage on the Android side to buffer location updates.
- Data Entities: Defining schema for
OfflineLocationthat matches the Supabaseregistros_retenstructure.
2. Synchronization Strategies
- Background Sync: Using
WorkManagerfor reliable data upload when connectivity returns. - Conflict Resolution: Simple timestamp-based resolution for location data.
- Batched Uploads: Strategies for sending multiple records in a single HTTP request to Supabase to save battery.
3. Connection Monitoring
- Network State: Reacting to connectivity changes on both the Web (React) and Native (Java) sides.
- Failover Logic: Gracefully switching between direct-to-Supabase and local-first modes.
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
