深度剖析Plexus架构:Elixir/PhoenixPostgreSQL打造高可用兼容性数据库【免费下载链接】plexusRemove the fear of Android app compatibility on de-Googled devices.项目地址: https://gitcode.com/gh_mirrors/ple/plexusPlexus 是一个面向 de-Googled(移除 Google 服务)Android 设备的社区众包应用兼容性数据库。它用 Elixir/Phoenix 框架 PostgreSQL 数据库搭建后端,记录 LineageOS、CalyxOS(microG)等环境下各应用的可用程度,帮用户消除换 ROM 后 App 还能不能用的恐惧。本文将带你完整拆解它的技术选型、分层架构、数据模型与高可用部署策略,即使你是 Elixir 新手也能轻松读懂。一、Plexus 要解决什么问题?大多数 Android 设备都深度依赖 Google Play 服务。当你刷入无 GMS 的自定义 ROM,或改用 microG 替代方案后,不少应用会出现功能缺失甚至完全无法使用的情况。Plexus 的解法很直接:把兼容性变成可查询的数据每个应用按两种环境分别评分:native(纯 de-Googled)和micro_g(microG 环境)分数为 1~4 分,对应四档:Broken(不可用)、Bronze(勉强可用)、Silver(部分功能受限)、Gold(完全可用)所有数据由社区用户通过 App 提交,真正做到众包数据,服务众包二、技术选型全景:Elixir Phoenix PostgreSQL整个后端仅依赖一套 Elixir 生态即可完成 API、实时网站与运维监控,核心组件如下(见 mix.exs):组件技术职责Web 框架Phoenix 1.7 LiveViewREST API 与实时网页HTTP 服务器Bandit高性能并发请求处理数据访问Ecto Postgrex对象-关系映射,连接 PostgreSQL分页Scrivener统一的分页查询能力消息推送Phoenix.PubSub评分提交后实时刷新页面指标监控Telemetry性能指标采集与告警接口文档OpenApiSpex自动生成 Swagger API 文档三、高可用基石:OTP 监督者模型Elixir 建立在 Erlang/OTP 之上,高可用不是额外买来的,而是语言内建的 在 lib/plexus/application.ex 中,应用启动时构建了一棵监督者(Supervisor)树:Plexus.Repo:数据库连接池,连接断开自动重连Phoenix.PubSub:发布/订阅系统,评分变更后实时广播到前端PlexusWeb.Endpoint:HTTP 端点,配置变更可热更新Finch:HTTP 客户端进程池Registry.Device:设备注册表,追踪在线设备监督者采用:one_for_one策略——任何一个子进程崩溃都会被自动重启,而其他进程不受影响。这意味着单点故障不会拖垮整个服务,这正是高可用的第一道防线。四、分层架构:从请求到数据库项目严格遵循 Phoenix 的分层思想,目录结构非常清晰:Web 层(lib/plexus_web/):路由器 router.ex 划分出会话路由与api/v1版本化 API;控制器(如 app_controller.ex)只负责参数校验与响应序列化,业务逻辑一概不写领域层(lib/plexus/):核心业务模块Plexus.Apps与Plexus.Ratings封装全部增删改查;QueryHelpers和PaginationHelpers负责过滤与分页参数的合并数据层(lib/plexus/schemas/):Ecto Schema 定义表结构与变更集(Changeset)校验这种瘦控制器 厚 Context的写法,让 API 与 LiveView 网页可以复用同一套业务逻辑,大幅降低维护成本。五、PostgreSQL 数据模型:3 张表 模糊搜索数据库设计是 Plexus 的精髓所在,迁移文件全部位于priv/repo/migrations/目录:5.1 apps 表:应用主数据见 20230226040516_create_apps.exs:主键不是自增 ID,而是Android 包名(package字段,如com.example.app)启用citext扩展——大小写不敏感文本类型,查com.tencent.mm和COM.TENCENT.MM返回同一条记录启用pg_trgm与fuzzystrmatch扩展,支撑后文的模糊搜索5.2 ratings 表:兼容性评分app_package字符串外键关联 apps 表,记录 ROM 名称、构建号、Android 版本、评分环境等完整上下文score字段用变更集强校验 1~4 分范围(rating.ex)delete_token_hash字段存删除凭证的哈希值——用户无需注册账号,凭提交时返回的一次性 token 即可删除自己提交的数据,兼顾隐私与归属校验5.3 模糊搜索:输错也能找到应用在 lib/plexus/apps.ex 的搜索逻辑中,查询同时使用了SIMILARITY(三元组相似度 0.30)与LEVENSHTEIN(编辑距离排序)。也就是说,即使用户把应用名拼错,数据库层也能直接算出最像的结果并智能排序,无需在应用层做繁重的字符串处理——把模糊匹配交给 PostgreSQL,是典型的让数据库干数据库擅长的事。六、数据迁移演进:产品迭代的数据微缩史6 个迁移文件完整记录了项目的演化轨迹:迁移说明了什么create_apps / create_ratings奠定双表核心模型remove_apps_name_unique_index允许同名应用(不同包名)共存make_rating_app_version_nullableApp 版本号改为可选,降低提交门槛change_app_build_number_to_bigint构建号溢出风险的前瞻性修复add_delete_token_hash_to_ratings引入无账号删除机制,强化隐私每一次alter都是产品决策在数据库层的投射,迁移文件即历史档案,可追溯、可重放。七、高可用部署:多阶段 Docker 构建 OTP Release生产部署围绕 Dockerfile 展开,采用多阶段构建:builder 阶段:基于官方 Elixir 1.19.5 / OTP 28 镜像,安装依赖、编译资产、执行mix release生成自包含的 OTP Releaserunner 阶段:精简的 Debian 运行镜像,只拷贝编译产物,以nobody 非 root 用户运行,攻击面更小配合 config/runtime.exs 在容器启动时注入环境变量、fly.toml 与 compose.yml 编排部署,实现一个镜像,任意环境可跑。Release 模式还内建了进程热重载与优雅停机能力,是 Elixir 应用零停机发布的关键。八、关键要点速记 ✅高可用三层防线:OTP 监督者自动重启 → PostgreSQL 连接池自愈 → 容器化非 root 部署兜底数据模型以包名为锚:apps 表以package为主键,天然去重且贴合 Android 生态模糊搜索下推到数据库层:pg_trgm 编辑距离,拼错也能搜到无账号隐私设计:删除 token 哈希,让用户随时撤回自己的贡献API 版本化 LiveView 复用:一套 Context 同时服务 REST 与实时网页想本地跑起来?克隆仓库(仓库地址:https://gitcode.com/gh_mirrors/ple/plexus),准备一个 PostgreSQL 实例,执行mix setup即可完成依赖安装、建库迁移与种子数据,mix phx.server后打开 Live Dashboard 即可观察实时指标——亲手体验这套 Elixir/Phoenix PostgreSQL 兼容性数据库的完整运转吧 【免费下载链接】plexusRemove the fear of Android app compatibility on de-Googled devices.项目地址: https://gitcode.com/gh_mirrors/ple/plexus创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 深度剖析Plexus架构:Elixir/Phoenix+PostgreSQL打造高可用兼容性数据库
深度剖析Plexus架构:Elixir/PhoenixPostgreSQL打造高可用兼容性数据库【免费下载链接】plexusRemove the fear of Android app compatibility on de-Googled devices.项目地址: https://gitcode.com/gh_mirrors/ple/plexusPlexus 是一个面向 de-Googled(移除 Google 服务)Android 设备的社区众包应用兼容性数据库。它用 Elixir/Phoenix 框架 PostgreSQL 数据库搭建后端,记录 LineageOS、CalyxOS(microG)等环境下各应用的可用程度,帮用户消除换 ROM 后 App 还能不能用的恐惧。本文将带你完整拆解它的技术选型、分层架构、数据模型与高可用部署策略,即使你是 Elixir 新手也能轻松读懂。一、Plexus 要解决什么问题?大多数 Android 设备都深度依赖 Google Play 服务。当你刷入无 GMS 的自定义 ROM,或改用 microG 替代方案后,不少应用会出现功能缺失甚至完全无法使用的情况。Plexus 的解法很直接:把兼容性变成可查询的数据每个应用按两种环境分别评分:native(纯 de-Googled)和micro_g(microG 环境)分数为 1~4 分,对应四档:Broken(不可用)、Bronze(勉强可用)、Silver(部分功能受限)、Gold(完全可用)所有数据由社区用户通过 App 提交,真正做到众包数据,服务众包二、技术选型全景:Elixir Phoenix PostgreSQL整个后端仅依赖一套 Elixir 生态即可完成 API、实时网站与运维监控,核心组件如下(见 mix.exs):组件技术职责Web 框架Phoenix 1.7 LiveViewREST API 与实时网页HTTP 服务器Bandit高性能并发请求处理数据访问Ecto Postgrex对象-关系映射,连接 PostgreSQL分页Scrivener统一的分页查询能力消息推送Phoenix.PubSub评分提交后实时刷新页面指标监控Telemetry性能指标采集与告警接口文档OpenApiSpex自动生成 Swagger API 文档三、高可用基石:OTP 监督者模型Elixir 建立在 Erlang/OTP 之上,高可用不是额外买来的,而是语言内建的 在 lib/plexus/application.ex 中,应用启动时构建了一棵监督者(Supervisor)树:Plexus.Repo:数据库连接池,连接断开自动重连Phoenix.PubSub:发布/订阅系统,评分变更后实时广播到前端PlexusWeb.Endpoint:HTTP 端点,配置变更可热更新Finch:HTTP 客户端进程池Registry.Device:设备注册表,追踪在线设备监督者采用:one_for_one策略——任何一个子进程崩溃都会被自动重启,而其他进程不受影响。这意味着单点故障不会拖垮整个服务,这正是高可用的第一道防线。四、分层架构:从请求到数据库项目严格遵循 Phoenix 的分层思想,目录结构非常清晰:Web 层(lib/plexus_web/):路由器 router.ex 划分出会话路由与api/v1版本化 API;控制器(如 app_controller.ex)只负责参数校验与响应序列化,业务逻辑一概不写领域层(lib/plexus/):核心业务模块Plexus.Apps与Plexus.Ratings封装全部增删改查;QueryHelpers和PaginationHelpers负责过滤与分页参数的合并数据层(lib/plexus/schemas/):Ecto Schema 定义表结构与变更集(Changeset)校验这种瘦控制器 厚 Context的写法,让 API 与 LiveView 网页可以复用同一套业务逻辑,大幅降低维护成本。五、PostgreSQL 数据模型:3 张表 模糊搜索数据库设计是 Plexus 的精髓所在,迁移文件全部位于priv/repo/migrations/目录:5.1 apps 表:应用主数据见 20230226040516_create_apps.exs:主键不是自增 ID,而是Android 包名(package字段,如com.example.app)启用citext扩展——大小写不敏感文本类型,查com.tencent.mm和COM.TENCENT.MM返回同一条记录启用pg_trgm与fuzzystrmatch扩展,支撑后文的模糊搜索5.2 ratings 表:兼容性评分app_package字符串外键关联 apps 表,记录 ROM 名称、构建号、Android 版本、评分环境等完整上下文score字段用变更集强校验 1~4 分范围(rating.ex)delete_token_hash字段存删除凭证的哈希值——用户无需注册账号,凭提交时返回的一次性 token 即可删除自己提交的数据,兼顾隐私与归属校验5.3 模糊搜索:输错也能找到应用在 lib/plexus/apps.ex 的搜索逻辑中,查询同时使用了SIMILARITY(三元组相似度 0.30)与LEVENSHTEIN(编辑距离排序)。也就是说,即使用户把应用名拼错,数据库层也能直接算出最像的结果并智能排序,无需在应用层做繁重的字符串处理——把模糊匹配交给 PostgreSQL,是典型的让数据库干数据库擅长的事。六、数据迁移演进:产品迭代的数据微缩史6 个迁移文件完整记录了项目的演化轨迹:迁移说明了什么create_apps / create_ratings奠定双表核心模型remove_apps_name_unique_index允许同名应用(不同包名)共存make_rating_app_version_nullableApp 版本号改为可选,降低提交门槛change_app_build_number_to_bigint构建号溢出风险的前瞻性修复add_delete_token_hash_to_ratings引入无账号删除机制,强化隐私每一次alter都是产品决策在数据库层的投射,迁移文件即历史档案,可追溯、可重放。七、高可用部署:多阶段 Docker 构建 OTP Release生产部署围绕 Dockerfile 展开,采用多阶段构建:builder 阶段:基于官方 Elixir 1.19.5 / OTP 28 镜像,安装依赖、编译资产、执行mix release生成自包含的 OTP Releaserunner 阶段:精简的 Debian 运行镜像,只拷贝编译产物,以nobody 非 root 用户运行,攻击面更小配合 config/runtime.exs 在容器启动时注入环境变量、fly.toml 与 compose.yml 编排部署,实现一个镜像,任意环境可跑。Release 模式还内建了进程热重载与优雅停机能力,是 Elixir 应用零停机发布的关键。八、关键要点速记 ✅高可用三层防线:OTP 监督者自动重启 → PostgreSQL 连接池自愈 → 容器化非 root 部署兜底数据模型以包名为锚:apps 表以package为主键,天然去重且贴合 Android 生态模糊搜索下推到数据库层:pg_trgm 编辑距离,拼错也能搜到无账号隐私设计:删除 token 哈希,让用户随时撤回自己的贡献API 版本化 LiveView 复用:一套 Context 同时服务 REST 与实时网页想本地跑起来?克隆仓库(仓库地址:https://gitcode.com/gh_mirrors/ple/plexus),准备一个 PostgreSQL 实例,执行mix setup即可完成依赖安装、建库迁移与种子数据,mix phx.server后打开 Live Dashboard 即可观察实时指标——亲手体验这套 Elixir/Phoenix PostgreSQL 兼容性数据库的完整运转吧 【免费下载链接】plexusRemove the fear of Android app compatibility on de-Googled devices.项目地址: https://gitcode.com/gh_mirrors/ple/plexus创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考