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 必须保持同步。
双端同步的真实难点
Web 和 iOS 共用后端时，最怕的是接口语义慢慢分叉。今天 Web 多一个字段，明天 iOS 少一个兼容值，几次迭代后两个客户端就会开始互相拖累。
我会固定哪些契约
用户身份、帖子状态、互动计数、评论关系、私信会话、通知事件、会员状态和支付边界都要来自同一个真相源。平台差异应该留在界面和交互层，而不是数据事实层。
复盘
这个项目让我更确定：全栈能力不是会写前后端，而是能维护端到端的一致性。