PetApp · 宠物原生社交微信小程序

PetApp 是 Emergent Balance Lab（EBL）维护的宠物原生社交 MVP。项目从微信小程序开始，围绕宠物身份、生活圈发现、稳定好友关系和安全治理逐步验证需求。

公开可查看，禁止未经授权的商业使用。 本项目采用 PolyForm Noncommercial License 1.0.0。任何商业部署、付费服务、商业集成、商业衍生产品或其他预期商业应用，均须事先与作者和 EBL 达成书面合作或另行取得商业许可。参见 商业合作说明。

Required Notice: Copyright 2026 Chun Song. Maintained with Emergent Balance Lab (EBL).

仓库

• EBL 主仓库：https://github.com/Emergent-Balance-Lab/petapp-wechat-mini-program
• 作者镜像：https://github.com/Shyr0796/petapp-wechat-mini-program

如两个仓库内容暂时不一致，以 EBL 主仓库的 main 分支为准。

项目内容

• petapp-mini-program/：可运行的微信原生小程序、Fastify/TypeScript API、PostgreSQL/PostGIS、Redis、MinIO、Docker Compose 和 Nginx 配置；
• plan/：市场研究、微信小程序 MVP 计划、开发部署与合规指南三份 HTML；
• petapp-mini-program/docs/：代码清单、使用方法、API、上线清单、服务器部署和后续迭代说明。

当前 MVP 已覆盖：

• 多宠物档案；
• 默认关闭、主动开启、自动过期的附近发现；
• 生活圈、模糊定位及最大 5km 搜索范围；
• 仅返回距离档位，不公开其他用户精确坐标；
• 动态、评论、好友申请和轻量私信；
• 举报、拉黑、注销和内容审核；
• 私有图片存储、管理员审核 API 和审计日志。

快速开始

cd petapp-mini-program
cp .env.example .env
docker compose -f deploy/compose.yml --env-file .env up -d --build

微信开发者工具导入 petapp-mini-program/miniapp/。完整步骤见 使用说明。

当前验证边界

TypeScript 编译、定位隐私单元测试、依赖审计、Fastify 健康接口注入、小程序页面结构与 Compose 配置检查已经通过。完整容器联调、微信开发者工具/真机、真实 AppID、备案域名及生产部署仍需按 验证记录 和 上线清单 完成。

参与和合作

欢迎通过 Issue 提交非商业研究建议、缺陷和改进方案。贡献代码前请阅读 贡献指南。商业合作请先阅读 商业合作说明，并通过以下方式联系作者：

• Email：songchun2307@gmail.com
• 个人主页：https://chun-song.com

License

Source available under the PolyForm Noncommercial License 1.0.0. Commercial use requires a separate written agreement with the author and Emergent Balance Lab.