poojamourya9346-creat/Crisislens.AI

# CrisisLens AI [](https://fastapi.tiangolo.com/) [](https://react.dev/) [](https://www.typescriptlang.org/) [](https://www.postgresql.org/) [](https://www.docker.com/) ## 项目概述 CrisisLens AI 是一个生产就绪的原型，可帮助团队记录事件、借助 AI 辅助进行分析、跟踪响应进度、查看历史数据并导出分析结果。该平台结合了 FastAPI 后端、React 前端以及容器化的基础设施，既可以在本地运行，也可以通过 Docker 进行部署。 ### 包含的功能 - 事件记录与结构化分析工作流 - 用于分类、风险评分和响应规划的 AI 编排 endpoint - 事件仪表板和历史记录视图 - 分析与支持导出的报告功能 - 基于 Toast 的通知和稳健的 UI 外壳 - 请求验证、速率限制和一致的错误处理 ## 功能 - AI 辅助的事件分析和报告生成 - 用于危机评估任务的多 agent 编排流程 - 带有历史记录和过滤功能的响应式事件仪表板 - 带有摘要卡片和导出操作的分析页面 - 生产就绪的前端错误边界和 API 客户端弹性机制 - 用于请求上下文、认证和限流的后端 middleware - 对后端、前端和 PostgreSQL 的 Docker 和 Docker Compose 支持 ## 架构 应用程序采用模块化结构，后端和前端层可以独立演进。 ``` frontend/ React + TypeScript + Vite + Tailwind backend/ FastAPI + Pydantic + SQLAlchemy + Alembic infra/ Cloud Run deployment assets ``` ### 后端结构 - api/：HTTP 路由和带有版本控制的 endpoint - application/：服务、验证器和编排用例 - core/：配置、middleware、日志和异常处理 - domain/：实体、repository 和领域服务 - infrastructure/：数据库适配器和 repository 实现 - models/：SQLAlchemy ORM 模型 - schemas/：API 请求和响应模型 ### 前端结构 - app/：应用引导程序和 provider - features/：事件记录、仪表板和分析体验 - components/：共享 UI 基础组件 - lib/：API 客户端和实用工具 - routes/：路由和布局定义 ## 安装说明 ### 前置条件 - Node.js 20+ - Python 3.12+ - Docker 和 Docker Compose - PostgreSQL 16（使用 Docker Compose 时可选） ### 克隆与配置 ``` git clone cd crisislens cp .env.example .env cp backend/.env.example backend/.env cp frontend/.env.example frontend/.env ``` ## 运行后端 ``` cd backend python -m venv .venv source .venv/bin/activate # Windows: .venv\\Scripts\\activate pip install -r requirements/dev.txt uvicorn crisislens.main:app --reload --host 0.0.0.0 --port 8000 ``` API 将在以下地址可用： - http://localhost:8000/api/v1 - http://localhost:8000/api/v1/docs ## 运行前端 ``` cd frontend npm install npm run dev ``` 前端将在以下地址可用： - http://localhost:5173 ## 环境变量 仓库包含了根目录、后端和前端环境的示例文件。 ### 根变量 - APP_ENV - APP_DEBUG - BACKEND_PORT - FRONTEND_PORT - POSTGRES_DB - POSTGRES_USER - POSTGRES_PASSWORD - DATABASE_URL - JWT_SECRET_KEY - GEMINI_API_KEY - LOG_LEVEL - CORS_ORIGINS ### 前端变量 - VITE_API_BASE_URL - VITE_APP_NAME ## Docker 用法 ### 本地技术栈 ``` docker compose up --build ``` ### 开发环境覆盖配置 ``` docker compose -f docker-compose.yml -f docker-compose.dev.yml up --build ``` ### 服务 - 前端：http://localhost:5173 - 后端：http://localhost:8000/api/v1 - PostgreSQL：localhost:5432 ## API Endpoint ### AI endpoint - POST /api/v1/ai/analyze - POST /api/v1/ai/report - POST /api/v1/ai/orchestrate ### 认证 endpoint - POST /api/v1/auth/register - POST /api/v1/auth/login - POST /api/v1/auth/refresh ## 测试 ### 后端 ``` cd backend pytest -q ``` ### 前端 ``` cd frontend npm run build npm run lint ``` ## 截图 占位截图将在未来的发布周期中添加。 - 截图 1：事件记录工作流 - 截图 2：事件仪表板 - 截图 3：分析视图 ## 生产就绪清单 - [x] 后端测试通过 - [x] 前端生产构建通过 - [x] API 验证和错误响应已标准化 - [x] 已启用请求限流和安全的配置处理 - [x] 存在用于本地部署的 Docker 和 Compose 文件 - [ ] 外部密钥和生产数据库凭证应由部署环境提供 - [ ] 可选的云端部署清单应根据目标环境进行定制 ## 安全性、性能和日志记录说明 - 敏感配置值通过环境设置处理。 - 启用了请求上下文和结构化日志记录以提高可观测性。 - 速率限制有助于减少恶意流量。 - 前端错误边界提高了应对意外 runtime 故障的弹性。 ## 许可证 专有 —— CrisisLens AI 团队。保留所有权利。

标签：AV绕过, FastAPI, GIS地图, React, Syscalls, 人工智能, 代码示例, 决策智能, 数据分析, 测试用例, 灾害响应, 用户模式Hook绕过, 自动化攻击, 请求拦截