Machi Web 与统一 Python 后端

一个 Next.js Web 客户端 + Python 单文件后端 + SQLite 数据库的生产级本地生活平台，与 iOS 共用账号和 API。

技术栈

Next.js 15React 19TypeScriptTailwind CSSPythonSQLiteSSEREST API

我的角色

全栈架构、API 设计、Web 客户端、后台服务、部署与双端同步契约

核心挑战

Web 与 iOS 必须共享用户、帖子、互动、私信、通知、会员和支付状态，同时还要保留各自平台的交互差异。

解决方案

我用 Python 单文件服务承载统一 API 与 SQLite 数据库，用 Next.js 构建 Web 客户端，并通过序列化兼容字段保证 Web/iOS DTO 能稳定解码。

最终结果

系统拥有 80+ REST 端点、SSE 实时通知/私信、19 张数据表、soft delete、cursor 分页、媒体上传和会员支付状态同步能力。

项目背景

Machi Web 是和 iOS App 并行的 Web 客户端，同时也承载统一后端。它不是单独的宣传页，而是实际产品系统的一部分。

统一后端覆盖 auth、users、feed、posts、comments、search、topics、notifications、messages、media、settings、devices、drafts、events、membership 和 payment 等模块。

Web 和 iOS 可以有不同界面，但必须共享同一套数据事实。为此我在序列化层补充兼容字段，让新旧客户端都能稳定工作。

这个项目训练的是端到端产品系统能力：不仅要写页面，还要处理认证、安全、数据一致性、实时事件、支付边界、双端 DTO 和部署运维。