用途
platform-engineering 是一份跨平台开发规则手册,用于在构建或评审 SPA、PWA、移动端(iOS/Android)和桌面端应用时,提供统一的安全、架构与性能规则。每条规则都标注严重级别(MUST/DO/DON'T)和适用平台,并附有真实世界事故参考。
主要能力
三大支柱
规则手册由三个支柱构成:安全(Security)、架构(Architecture)、性能(Performance)。
平台决策矩阵
提供快速平台决策矩阵,覆盖 SPA、PWA、Mobile、Electron、Tauri 五类平台,针对以下关注点给出建议:
- 认证令牌存储:SPA/PWA 使用 JS 内存 + httpOnly cookies;移动端使用平台 Keychain/Keystore;Electron/Tauri 使用操作系统凭据存储。
- OAuth 流程:SPA/PWA 使用 Auth Code + PKCE;移动端使用系统浏览器 + PKCE;Electron/Tauri 使用标准 PKCE。
- XSS 影响:SPA 为会话劫持;PWA 额外包含持久化 Service Worker 劫持;移动端为 WebView 桥接访问;Electron 可从 XSS 升级到 RCE;Tauri 限于 Web 上下文。
- CSP:SPA/PWA/Electron 为关键;移动端仅 WebView 相关;Tauri 相关。
- 离线策略:PWA 使用 IndexedDB + Cache API + Service Worker;移动端使用 Room/CoreData + 同步队列;其余为可选。
- 包体积目标:SPA/PWA 压缩后 JS <170KB;移动端 APK/IPA <20MB;Electron 80-150MB(Chromium);Tauri 总计 <10MB。
- API 风格:SPA 使用 REST 或 GraphQL;PWA 使用 REST(Service Worker 缓存);移动端使用 GraphQL(减少往返);Electron 使用 REST(服务端聚合);Tauri 使用 REST。
- 状态管理:SPA 使用 Zustand/Redux + TanStack Query;PWA 使用 IndexedDB + Cache API;移动端使用 ViewModel+StateFlow / SwiftUI;Electron 使用 IPC + 上下文隔离;Tauri 使用 Rust invoke 命令。
参考文档加载指引
- 安全评审或审计:加载 server-validation、auth-tokens、passkeys-webauthn、api-security、xss-csp、secrets-management、platform-security。
- 架构决策:加载 client-server-architecture、api-design、offline-first、infrastructure。
- 性能优化:加载 frontend-performance、backend-and-platform-performance。
- 完整平台评审:加载全部 13 份参考。
参考材料
安全(第一部分)
- server-validation.md:服务端校验规则、信任边界、真实绕过事故。
- auth-tokens.md:各平台令牌存储、OAuth 2.1 流程、JWT 最佳实践、安全存储 API。
- passkeys-webauthn.md:WebAuthn Level 3 / passkey 模式、服务端验证、跨平台支持、克隆认证器检测。
- api-security.md:端点认证、速率限制、CORS、OWASP API 风险、Peloton/Parler 案例研究。
- xss-csp.md:各平台 XSS 严重性、CSP 指令、反 CSRF、净化、British Airways 事故。
- secrets-management.md:密钥暴露风险、环境变量、保险库服务、GitGuardian 统计。
- platform-security.md:移动端(Keychain/Keystore、证书固定)、Electron(nodeIntegration、contextIsolation、sandbox)、Tauri(默认拒绝)、PWA(Service Worker 作用域、Cache API 风险)、安全头矩阵。
架构(第二部分)
- client-server-architecture.md:瘦客户端原则、BFF 模式、服务端权威设计。
- api-design.md:按平台划分的 REST 与 GraphQL 权衡、分页策略、各平台状态管理。
- offline-first.md:冲突解决策略(LWW、CRDT、OT)、乐观 UI、同步模式。
- infrastructure.md:单体优先原则、数据库访问模式、各平台 CI/CD 流水线、可观测性、功能开关生命周期。
性能(第三部分)
- frontend-performance.md:包体积优化、图片格式与响应式加载、Core Web Vitals(LCP、INP、CLS)及业务影响数据。
- backend-and-platform-performance.md:API/数据库性能(分页、索引、连接池)、移动端电池/内存、SSR/SSG/ISR 渲染策略、CDN 缓存模式。
使用方式
根据当前任务类型(安全评审、架构决策、性能优化或完整平台评审)加载对应的参考文档。规则以 MUST/DO/DON'T 标注,可直接用于构建或评审流程中的检查清单。
适用场景
适用于构建或评审 SPA、PWA、移动端(iOS/Android)和桌面端应用时的安全、架构与性能决策。
限制
资料未提供具体安装命令、收费方式、价格、平台支持范围或使用效果数据,这些内容暂未提供。