Machi Web 与统一后端的双端同步设计

Machi Web 不是孤立官网，而是和 iOS App 共享同一套账号、数据库、API 和内容状态的 Web 客户端。

技术栈

• 后端：Python 单文件服务 server.py
• 数据库：SQLite，WAL、索引、soft delete 和 cursor 分页
• Web 客户端：Next.js 15、React 19、TypeScript、Tailwind、Zustand、TanStack Query
• 实时能力：Server-Sent Events，用于通知与私信更新

API 覆盖

统一后端覆盖注册登录、Feed、帖子 CRUD、点赞、收藏、转发、评论、搜索、话题、通知、私信、媒体上传、设置、设备、草稿、反馈、会员与支付等 80+ REST 端点。

同步原则

后端是唯一真相源。Web 和 iOS 可以拥有不同布局和交互，但用户、帖子、资讯、会员、支付状态、互动数据、城市语言筛选和核心 API 必须保持同步。