窝圈_系统开发案例-程序员客栈

技术信息

语言技术
PHP系统类型
Web行业分类
社交

作品详情

行业场景

- 社交关系重构：面向“同乡/同学/同好”三类关系，覆盖熟人连接与兴趣连接并存的社区场景。
- 双身份社交：用户在同一账号下可切换“窝主（真实）/皮囊（兴趣）”，适合现实圈层与兴趣圈层分离表达。
- 轻社群沟通：以圈子聊天+圈友私聊为核心，适配校园、异地同城、兴趣小组等高频互动场景。
- 移动优先落地：支持微信/iOS 浏览器访问，兼顾内网部署与临时公网分享（Cloudflare tunnel）。

功能介绍

- 账号与鉴权
- 显式注册+登录（已移除登录自动注册），支持用户名/手机号/邮箱登录。
- 全站鉴权（除 login.html、register.html），会话校验+30分钟空闲自动退出。
- 身份体系
- 双身份创建与切换：窝主（籍贯/学校/现居）+皮囊（昵称/标签/魂话）。
- 全局身份名展示统一：页面按当前身份显示“角色+名称”。
- 圈子与关系链
- 圈子类型：同根窝、同窗窝、同频窝。
- 权限模型：成员可退圈、圈主可踢人、仅圈主可删圈。
- 圈友申请/通过/通讯录展示/私聊准入（仅圈友可私聊）。
- 聊天与互动
- 圈聊消息、圈友私聊、@成员、免打扰、置顶、清空记录、单向删除联系人、黑名单。
- 消息列表支持“最新消息预览+时间+未读数”，并新增“好友会话”分组。
- 多媒体与增强
- 语音消息、语音转文字（ASR）、图片OCR、文本/图片翻译。
- 通话信令与稳定性处理（拒接/超时提示、媒体流绑定等）。
- 运维能力
- 一键启动/重启脚本、端口代理、隧道保活、运行状态与日志落盘。

项目实现

- 前端
- 纯静态页面 + 原生 JS：login/register/index/chat/circles/profile/settings 等。
- 核心守卫：public/auth-guard.js 负责鉴权、会话探活、token 注入、隧道跳转与 API 重映射。
- 后端
- ThinkPHP API：app/controller/Auth.php、Chat.php、Circles.php 等。
- 路由集中在 route/app.php，统一挂载 AuthMiddleware。
- 数据层
- MySQL 持久化用户、圈子、成员、圈友关系、私聊消息、清空记录、黑名单等。
- 用户唯一性双保险：应用层校验 + 数据库唯一索引（如 uk_username、uk_email_hash）。
- AI/媒体服务
- asr-service 提供 ASR/OCR/翻译能力，API 侧转发调用。
- 部署与运行
- 服务编排脚本：server/restart-all.sh。
- 典型端口：8000 API、8088 代理入口、8888 静态、9001 信令、9100 ASR。
- 可通过内