rahulpathak-dev/RescueNetAI

# RescueNetAI RescueNetAI 是一个模块化的灾难响应平台，通过安全的协调工具将市民、志愿者、 政府机构、NGO、避难所和医院连接起来。 ## 状态 第 1-5 卷已作为增量生产构建实现。该仓库包含 Next.js 前端、FastAPI 后端、PostgreSQL/Redis 基础、ARQ worker、 隐私保护地图和 AI 决策支持契约、Docker Compose、CI/安全 工作流以及运维文档。 这不是一个经过认证的紧急情况、政府、医疗或合规系统。在完成实际的预发布部署、提供商 模拟、恢复演练和安全审查之前，请将其视为 面向生产环境的作品集/预发布基线。 ## 架构 RescueNetAI 使用带有面向功能的 API router 和 service 模块的模块化单体后端。PostgreSQL 是系统的记录数据库。Redis 支持缓存、锁、streams 和 后台队列，但绝不会被当作持久化存储。AI 功能仅用于 决策支持，并暴露标签、因素、不确定性和人工审查状态。 ## 技术栈 - 前端：Next.js, React, TypeScript, Tailwind, TanStack Query, Vitest, Playwright - 后端：FastAPI, Pydantic v2, SQLAlchemy 2, Alembic, Redis, ARQ - 基础设施：Docker Compose, GitHub Actions, 托管式 PostgreSQL/Redis 目标 ## 仓库结构 ``` apps/web/ Next.js frontend apps/api/ FastAPI backend apps/worker/ ARQ worker entrypoint packages/ Shared types and config infrastructure/ Docker, nginx, monitoring, scripts docs/ Architecture, API, security, deployment, operations, release docs tests/e2e/ Playwright smoke tests ``` ## 本地设置 1. 将 `.env.example` 复制到 `.env` 并替换 secrets。 2. 安装依赖：`make install` 3. 启动服务：`make dev` 4. 运行迁移：`make migrate` 5. 可选的种子数据：`make seed` RescueNetAI 在 Compose 中将 PostgreSQL 映射到 `localhost:5433`，以避免与其他 本地 Postgres 容器发生冲突。在 Compose 内部，服务仍然使用 `postgres:5432`。 ## 健康检查端点 - `GET /api/v1/health/live` - `GET /api/v1/health/ready` - `GET /api/v1/health/dependencies` - `GET /api/v1/version` ## 检查 ``` npm --prefix apps/web run lint npm --prefix apps/web run typecheck npm --prefix apps/web run test npm --prefix apps/web run build cd apps/api python -m ruff check . python -m mypy app --ignore-missing-imports python -m pytest python -m pytest --cov=app --cov-report=term-missing ``` ## 文档 - [系统概述](docs/architecture/system-overview.md) - [本地开发](docs/deployment/local-development.md) - [生产部署](docs/deployment/production.md) - [运维手册](docs/operations/runbook.md) - [发布检查清单](docs/release/checklist.md) - [第 5 卷差距分析](docs/release/volume-5-gap-analysis.md) - [安全基线](docs/security/security-baseline.md) ## 安全提示 请勿在生产环境中使用生成的开发凭据。生产环境设置会拒绝 mock/console 提供商、不安全的 cookie、通配符 CORS 以及缺失的 telemetry sink。 Secrets 必须通过 secret manager 或平台加密变量提供。 ## 许可证 Apache-2.0 - 请参阅 [LICENSE](LICENSE)。

标签：AV绕过, FastAPI, 人工智能, 全栈架构, 地理信息系统, 应急资源管理, 搜索引擎查询, 测试用例, 灾害响应平台, 特征检测, 用户模式Hook绕过, 请求拦截, 逆向工具