项目目录

服务端、各端 SDK 与配套宿主分别维护。开发时保持约定的相邻目录，避免本地源码依赖指向错误的位置。

popoim/
├─ web/                 IM 服务端、管理后台、内置宿主 HTTP
├─ sdk-web/             Web SDK
├─ app-web/             配套 Web 宿主
├─ android/             Android SDK 与接入样例
├─ app-android/         Android 宿主
├─ ios/                 iOS SDK
├─ app-ios/             iOS 宿主
├─ harmony/             HarmonyOS SDK
├─ app-harmony/         HarmonyOS 宿主
├─ uniapp/              uni_modules/popo-im
├─ app-uniapp/          uni-app 宿主
└─ developers/          本开发文档

服务端

目录或文件	作用
app/	业务服务、HTTP 入口、实时进程与管理后台
plugin/sdk/	SDK 控制器、鉴权、响应组装与协议
config/	进程、数据库、会话等配置
public/	站点公开目录；Nginx 根目录只指向这里
public/uploads/	用户资源与头像
runtime/	日志、会话、缓存和进程状态
popoim_install.sql	全新安装结构
deploy/	MySQL 与 Docker / Nginx 配置
start.php	Linux 进程入口
windows.php	Windows 聚合开发入口

需要保留的部署数据

安装向导生成 config/database.php 与 plugin/sdk/config/auth.php。它们包含部署密钥，不提交到代码仓库。发布更新时还应保留资源、runtime/sessions 和必要的部署配置，见版本更新。

各客户端的具体源码依赖、目录和构建命令见对应的 SDK 接入页。