angelaracheldev/community-response-hub

# 社区事件报告与响应平台 一个以移动端为先的平台，用于村庄和住宅区接收、跟踪和解决社区投诉——包括证据上传、居民验证、隐私控制和活动日志。 ## 问题 - 没有单一的渠道来报告问题或获取更新 - 不完整、无效或恶作剧的投诉浪费了员工的时间 - 没有集中的投诉跟踪 - 隐私问题阻碍居民报告 ## 解决方案 - 带有照片和视频证据的移动/网页投诉报告 - 提交前居民验证 - 投诉人身份对响应者隐藏（仅管理员访问） - 实时状态更新、官员分配和活动日志 - 解决声明和证据以实现问责制 ### MVP | 居民 | 村庄 / 住宅区 | |------|------------------------| | 注册、登录、验证 | 投诉仪表板 | | 提交投诉 + 媒体 | 查看证据、分配官员 | | 跟踪状态和活动日志 | 更新状态、解决证据 | | 常见问题解答和紧急热线 | 活动日志 | **类别：** 噪音、非法停车、垃圾处理、动物问题、基础设施。 ## 为什么选择这个项目 社区仍然依赖于没有审计轨迹的非正式渠道（短信、社交媒体、现场咨询）。这个系统解决了真正的本地需求——更快的响应、透明度和隐私——同时涵盖了全栈技能：认证、角色、文件上传、实时更新和关系数据。 ## 技术栈 | 层 | 技术 | |-------|------------| | 前端 | React (Expo / React Native) | | 后端 | Node.js + Express | | 数据库 | PostgreSQL 15 | | 媒体 | Cloudinary | | 认证 | JWT | | 实时 | Socket.IO | | API 文档 | Swagger (OpenAPI 3) | | 本地开发 | Docker Compose | ### 为什么选择这些技术 - **React (Expo)** — 移动和网页的单一代码库；适合证据上传和未来的 GPS 功能。 - **Node.js + Express** — 与前端使用相同的语言；轻量级 REST API，带有 JWT 和 Socket.IO。 - **PostgreSQL** — 用户、投诉、分配和审计日志的关系模型；强大的数据完整性。 - **Cloudinary** — 管理照片/视频存储；数据库仅保留 URL。 - **JWT + Socket.IO + Swagger** — 无状态认证、实时状态更新和团队共享的 API 合同。 ## 项目结构 ``` community-response-hub/ ├── backend/ # init-db.sql, .env.example ├── frontend/ # Expo app (resident, admin, auth) ├── docs/swagger.yml # API specification └── docker-compose.yml ``` ## 入门 ``` # 克隆并启动数据库 git clone https://github.com/angelaracheldev/community-response-hub.git cd community-response-hub docker-compose up -d # 前端 cd frontend && npm install && npm start ``` 将 `backend/.env.example` 复制到 `backend/.env.local`，并查看 [DATABASE_SETUP.md](./DATABASE_SETUP.md) 以获取数据库连接详情。 **API 基础 URL（本地）：** `http://localhost:5000/api/v1` ## 角色 | 角色 | 访问 | |------|--------| | 居民 | 提交和跟踪自己的投诉 | | 响应者 | 管理分配的投诉（无投诉人 PII） | | 管理员 | 验证、分配、完整仪表板、投诉人详细信息 | ## 未来增强 GPS 验证 · AI 分类 · 垃圾邮件检测 · 热图分析 · 短信 · 实时响应者跟踪 · 消息

标签：API文档, Cloudinary, Docker, Express, GNU通用公共许可证, JWT, MITM代理, Node.js, PostgreSQL, React, React Native, SEO优化, Socket.IO, Syscalls, 事件报告, 动物问题, 响应平台, 噪音问题, 垃圾处理, 基础设施, 安全防御评估, 实时更新, 审计跟踪, 居民验证, 应急热线, 投诉管理系统, 活动日志, 测试用例, 社区管理, 移动端应用, 自动化攻击, 认证, 证据上传, 请求拦截, 问题跟踪, 隐私控制, 非法停车