Cityhealth

<div align="center"> <br> <img src="docs/screenshots/LOGO.png" width="82" alt="城市健康" /> <br><br> <h1>城市健康</h1> <p><strong>阿尔及利亚的验证健康基础设施 — 作为平台提供</strong></p> <p>一个验证的网络。实时访问。零阻力。</p> <br> <!-- 行 1 — 核心链接 --> <a href="https://cityhealthdz.com"><img src="https://img.shields.io/badge/🌐_官网-cityhealthdz.com-01696f?style=for-the-badge&logoColor=white" alt="官网" /></a>&nbsp; <a href="https://mcp.cityhealthdz.com/mcp"><img src="https://img.shields.io/badge/🤖_MCP_API-在线-4f98a3?style=for-the-badge" alt="MCP API" /></a>&nbsp; <a href="mailto:contact@cityhealthdz.com"><img src="https://img.shields.io/badge/✉️_联系方式-contact@cityhealthdz.com-01696f?style=for-the-badge" alt="联系方式" /></a> <br><br> <!-- 行 2 — 技术栈 --> <img src="https://img.shields.io/badge/React-18-61DAFB?style=flat-square&logo=react&logoColor=black" alt="React" />&nbsp; <img src="https://img.shields.io/badge/TypeScript-5-3178C6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript" />&nbsp; <img src="https://img.shields.io/badge/Supabase-PostgreSQL-3ECF8E?style=flat-square&logo=supabase&logoColor=white" alt="Supabase" />&nbsp; <img src="https://img.shields.io/badge/Google_Gemini-2.5_Flash-4285F4?style=flat-square&logo=google&logoColor=white" alt="Gemini" />&nbsp; <img src="https://img.shields.io/badge/Railway-部署-0B0D0E?style=flat-square&logo=railway&logoColor=white" alt="Railway" />&nbsp; <img src="https://img.shields.io/badge/MCP-协议-7C3AED?style=flat-square" alt="MCP" />&nbsp; <img src="https://img.shields.io/badge/Vite-5-646CFF?style=flat-square&logo=vite&logoColor=white" alt="Vite" />&nbsp; <img src="https://img.shields.io/badge/Tailwind_CSS-3-06B6D4?style=flat-square&logo=tailwindcss&logoColor=white" alt="Tailwind" /> <br><br> <!-- 行 3 — 状态 --> <img src="https://img.shields.io/badge/网页门户-✅_在线-01696f?style=flat-square" alt="网页" />&nbsp; <img src="https://img.shields.io/badge/移动端PWA-✅_在线-01696f?style=flat-square" alt="移动端" />&nbsp; <img src="https://img.shields.io/badge/浏览器扩展-✅_在线-01696f?style=flat-square" alt="扩展" />&nbsp; <img src="https://img.shields.io/badge/开发者API-✅_活跃-4f98a3?style=flat-square" alt="API" />&nbsp; <img src="https://img.shields.io/badge/覆盖范围-西迪贝尔阿贝斯, 阿尔及利亚-lightgrey?style=flat-square" alt="覆盖范围" /> <br><br> </div> --- <br> | 🏥 验证提供者 | 🤖 6 个 MCP 工具 | 📦 4 个平台 | 🌍 覆盖范围 | | :---: | :---: | :---: | :---: | | 活跃且不断增长 | MCP · REST · 免费/专业/企业 | 网页 · 移动端 · 扩展 · API | 西迪贝尔阿贝斯 → 整个阿尔及利亚 | <br> --- <br> ## 目录 - [问题](#问题) - [解决方案](#解决方案) - [工作原理](#工作原理) - [平台 — 网页门户](#平台—网页门户) - [平台 — 为提供者](#平台—为提供者) - [平台 — 移动应用](#平台—移动应用) - [平台 — 浏览器扩展](#平台—浏览器扩展) - [什么是验证](#什么是验证) - [核心能力](#核心能力) - [开发者和企业API](#开发者和企业API) - [技术](#技术) - [路线图](#路线图) - [平台状态](#平台状态) - [团队](#团队) <br> --- <br> ## 问题 > 在阿尔及利亚，紧急情况下访问关键医疗服务是**分散的、手动的和不可靠的**。 <br> | 现有问题 | 真实成本 | | :--- | :--- | | 🔴 **没有验证的提供者目录** | 患者在紧急情况下浏览 WhatsApp 群和过时的纸质列表。 | | 🔴 **没有实时药店值班状态** | 家庭在夜间从一个药店开车到另一个，不知道哪个药店开业。 | | 🔴 **没有结构化的血液捐献系统** | 紧急的血液请求分散在社交媒体上，没有匹配，没有紧急跟踪，没有系统。 | | 🔴 **没有紧急资源地图** | 紧急设施没有实时状态。到达时发现门关闭。 | | 🔴 **没有提供者身份验证** | 没有办法在进入之前确认医生的资质。 | <br> **城市健康取代了所有这些** — 通过单一的、验证的、实时的医疗基础设施，适用于患者、提供者和运营商。 <br> --- <br> ## 解决方案 <div align="center"> <br> > **四个渠道。一个真实来源。为现实条件而建。** <br> | &nbsp; | 产品 | 服务对象 | 解决问题 | | :---: | :--- | :--- | :--- | | 🌐 | **网页门户** | 患者和公众 | 基于GPS的医生、诊所、药店和紧急服务的搜索 — 验证结果，立即显示。 | | 📱 | **移动应用** | 移动中的患者 | 可安装，离线可用，带有紧急情况和血液捐献提醒的推送通知。 | | 🔌 | **浏览器扩展** | 高级用户 | 值班状态和紧急分诊 — 从任何浏览器选项卡，一键即可。 | | 🤖 | **开发者API（MCP）** | 医院 · 保险公司 · AI | 验证目录的完全编程访问，用于企业和第三方集成。 | </div> <br> --- <br> ## 工作原理 <div align="center"> <br> <img src="docs/screenshots/website/roadmap.png" width="88%" alt="城市健康工作原理 — 3 步" /> <br><br> | 步骤 | 操作 | 发生情况 | | :---: | :--- | :--- | | **01 · 搜索** | 按专业、名称或位置查找 | 每个结果都来自我们的验证数据库 — 绝无未经确认的列表。 | | **02 · 比较** | 查看个人资料、评论和可用性 | 详细的提供者卡片，实时开放/关闭状态、评分和联系信息。 | | **03 · 联系** | 预约、拨打电话或获取方向 | 一键联系提供者 — 在线预约、直接拨打电话或GPS导航。 | </div> <br> --- <br> ## 平台 — 网页门户 ### 面向患者 <div align="center"> <br> <img src="docs/screenshots/website/homepage.png" width="90%" alt="城市健康首页 — 查找您的医生" /> _{<b>首页</b> — 基于GPS的提供者搜索。医生、诊所、药店和紧急服务在一个地方。} <br><br> <table> <tr> <td align="center" width="25%"> <img src="docs/screenshots/website/map.png" width="100%" alt="交互式地图视图" /><br> _{<b>交互式地图视图</b><br>基于GPS的地图上的距离排名提供者。找到最近的提供者。} </td> <td align="center" width="25%"> <img src="docs/screenshots/website/search.png" width="100%" alt="高级搜索" /><br> _{<b>高级搜索和筛选</b><br>按专业、城市、语言和实时可用性筛选。每个结果都是验证的。} </td> <td align="center" width="25%"> <img src="docs/screenshots/website/blood%20donation.png" width="100%" alt="血液捐献和紧急情况" /><br> _{<b>血液捐献和紧急情况</b><br>按血型和距离匹配紧急请求。紧急设施具有实时状态。} </td> <td align="center" width="25%"> <img src="docs/screenshots/website/client%20public%20ccard.png" width="100%" alt="医疗紧急卡" /><br> _{<b>数字医疗紧急卡</b><br>可扫描的二维码，包含患者的紧急医疗数据 — 在任何紧急情况下都可以访问。} </td> </tr> </table> <br> <table> <tr> <td align="center" width="50%"> <img src="docs/screenshots/website/public%20provider%20profil.png" width="100%" alt="公共提供者个人资料" /><br> _{<b>公共提供者个人资料</b><br>完整的验证个人资料 — 专业、评论、评分、联系方式、位置和实时可用性。} </td> </tr> </table> </div> <br> --- <br> ## 平台 — 为提供者 > 提供者拥有自己的专用工作空间来管理他们在城市健康的存在、资格和患者互动。 <div align="center"> <br> <table> <tr> <td align="center" width="33%"> <img src="docs/screenshots/website/join%20CityHealth.png" width="100%" alt="加入城市健康" /><br> _{<b>加入城市健康</b><br>验证的医疗专业人员免费注册。列出您的诊所并主动联系寻找医疗服务的患者。} </td> <td align="center" width="33%"> <img src="docs/screenshots/website/providers%20regiter.png" width="100%" alt="提供者注册" /><br> _{<b>城市健康专业注册</b><br>结构化注册 — 专业、咨询、地址和资格提交给OCR验证。} </td> <td align="center" width="33%"> <img src="docs/screenshots/website/provider%20dashboard.png" width="100%" alt="提供者仪表盘" /><br> _{<b>提供者仪表盘</b><br>管理您的公共个人资料、跟踪患者互动、更新可用性和监控您的验证状态。} </td> </tr> </table> </div> <br> --- <br> ## 平台 — 移动应用 <div align="center"> <br> <table> <tr> <td align="center" width="20%"> <img src="docs/screenshots/apk/home%20screen.png" width="100%" alt="移动端首页" /><br> _{<b>首页</b><br>一览所有服务 — 设计用于在压力下单手操作。} </td> <td align="center" width="20%"> <img src="docs/screenshots/apk/map.png" width="100%" alt="移动端GPS地图" /><br> _{<b>GPS提供者地图</b><br>移动端的地图视图。离线可用，缓存关键数据。} </td> <td align="center" width="20%"> <img src="docs/screenshots/apk/urg%20map.png" width="100%" alt="紧急地图" /><br> _{<b>紧急地图</b><br>紧急护理的红色警报覆盖。立即显示最近的紧急设施。} </td> <td align="center" width="20%"> <img src="docs/screenshots/apk/chat%20bot.png" width="100%" alt="AI聊天机器人套件" /><br> _{<b>AI聊天机器人套件</b><br>4个不同的Gemini驱动的机器人：地图、症状分诊、医生和提供者个人资料。} </td> <td align="center" width="20%"> <img src="docs/screenshots/apk/search.png" width="100%" alt="移动端搜索" /><br> _{<b>搜索和筛选</b><br>移动端的完整提供者搜索 — 相同的验证数据，相同的实时结果。} </td> </tr> </table> <br> _{可在Android和iOS上安装 · 离线可用 · 紧急情况下的推送通知 · 包含AI聊天机器人套件} </div> <br> --- <br> ## 平台 — 浏览器扩展 <div align="center"> <br> <table> <tr> <td align="center" width="48%"> <img src="docs/screenshots/extention/extention.png" width="72%" alt="浏览器扩展弹窗" /><br> _{<b>快速访问弹窗</b><br>药店值班状态、紧急提供者和血液捐献提醒 — 从任何浏览器选项卡，一键即可。} </td> <td align="center" width="48%"> <img src="docs/screenshots/extention/settings.png" width="72%" alt="浏览器扩展设置" /><br> _{<b>设置和偏好</b><br>配置您的省份、通知触发器和警报阈值，无需离开浏览器。} </td> </tr> </table> <br> _{适用于Chrome和Firefox · 清单V3 · 零数据收集} </div> <br> --- <br> ## 什么是验证 每个出现在城市健康结果中的提供者都经过了结构化的资格认证过程。这就是我们与所有通用目录的区别。 <br> ``` 验证流程 ────────────────────────────────────────────────────────────────── ① 提交文件 → 上传许可证、注册和身份 ② OCR提取 → AI驱动的文本提取（阿拉伯语/法语/英语） ③ 交叉验证 → 通过加权评分与官方注册匹配 法律注册号 ········ 50% 联系身份 ········ 30% 企业名称 ······· 20% ④ 地址和GPS确认 → 物理位置验证并固定在地图上 ⑤ 实时状态监控 → 值班标志实时更新 ⑥ 持续审查 → 定期重新验证 + 用户报告的标志 ────────────────────────────────────────────────────────────────── 结果：目录中的每个列表在上线前都经过验证。 ``` <br> --- <br> ## 核心能力 <br> | 能力 | 它做什么 | | :--- | :--- | | **验证提供者目录** | 医生、专家、诊所、医院 — 可按专业、语言和实时可用性搜索。 | | **药店值班查找器** | 实时夜间药店值班状态。知道哪个药店开业后再出发。 | | **24/7紧急索引** | 验证的紧急设施，实时开放/关闭状态 — 始终当前，从不过时。 | | **血液捐献网络** | 紧急请求与合格捐献者按血型、紧急程度和距离匹配。 | | **医疗紧急卡** | 可扫描的患者二维码，包含关键医疗数据 — 在任何紧急情况下都可访问。 | | **AI聊天机器人套件** | 4个不同的Gemini驱动的助手：地图、症状分诊、提供者个人资料和医生。 | | **基于GPS的搜索** | 与用户实时位置相关的距离排名结果。不需要手动输入城市。 | | **提供者仪表盘** | 提供者管理存在、凭证和患者互动的完整CRM工作空间。 | | **开发者API（MCP）** | 所有平台数据的结构化编程访问，用于企业和AI集成。 | <br> --- <br> ## 开发者和企业API 城市健康通过结构化的**MCP（模型上下文协议）API**和**开发者REST API**公开其整个验证目录 — 允许医院、健康保险公司、非政府组织、公民平台和AI健康系统直接将真实的阿尔及利亚健康数据集成到他们的产品中。 <div align="center"> <br> <img src="docs/screenshots/website/dev%20api.png" width="88%" alt="城市健康开发者API — 核心端点" /> _{核心端点 — REST API，具有API密钥身份验证、速率限制和免费/专业/企业分级权限} </div> <br> ``` API端点 https://mcp.cityhealthdz.com/mcp 身份验证 REST API → x-api-key 头部 · 作用域权限 · 免费/专业/企业分级 MCP → 任何MCP兼容的AI客户端的工具调用（Claude、ChatGPT、自定义代理） 可用MCP工具 ────────────────────────────────────────────────────────────────── find_nearby_providers → 按GPS半径搜索所有提供者类型 get_emergency_providers → 所有24/7和紧急护理设施，实时状态 get_pharmacy_on_duty → 夜班药店，实时更新 search_providers → 关键词+专业+可用性筛选 find_blood_donors → 按血型和位置查找活跃的捐献请求 get_provider_details → 按提供者ID获取完整验证的个人资料 ────────────────────────────────────────────────────────────────── 企业用例 ────────────────────────────────────────────────────────────────── 医院系统 → 现实世界的附近提供者和专家查找 健康保险公司 → 验证的网络目录同步 非政府组织和救援组织 → 紧急资源映射和协调 AI健康助手 → 接地、验证的提供者响应（本地MCP） 公民健康平台 → 嵌入的验证健康基础设施层 ────────────────────────────────────────────────────────────────── ``` <br> <div align="center"> **对API访问或合作感兴趣？** → [contact@cityhealthdz.com](mailto:contact@cityhealthdz.com) </div> <br> --- <br> ## 技术 城市健康的堆栈围绕三个原则构建：**核心的验证数据**，**边缘的实时访问**，以及**从第一天起就支持AI就绪**，通过MCP层。 <br> <div align="center"> <img src="docs/architecture/teck.png" width="92%" alt="城市健康完整系统架构" /> <br> _{完整系统架构 — 外部AI客户端和API消费者 → MCP服务器 + 开发者REST API → Supabase生态系统 → PostgreSQL + Google Gemini} </div> <br> **四个不同的层协同工作： - **前端应用程序** — Vite协调React + TypeScript单页应用程序，处理所有客户端UI、SPA路由和实时数据同步 - **外部访问层** — AI客户端（Claude、ChatGPT、自定义代理）通过MCP服务器使用工具调用连接；API消费者通过REST API连接，使用`x-api-key`身份验证、速率限制和免费/专业/企业分级权限 - **后端和API层（Supabase生态系统）** — 开发者REST API、PostgREST自动生成的核心API和边缘函数（无服务器Deno运行时）用于复杂的AI工作流和OCR验证 - **AI集成** — Google Gemini 2.5 Flash驱动的4机器人套件（地图、诊断、医生、个人资料）和通过边缘函数的AI编排 <br> | 层 | 技术 | | :--- | :--- | | 前端 | React 18、TypeScript、Tailwind CSS、Vite | | 地图 | Leaflet.js、OpenStreetMap | | 状态和数据 | TanStack Query、Zustand | | 后端 | Supabase — PostgreSQL（ACID · RLS · 实时 · 视图） | | 核心API | PostgREST — 从模式自动生成的REST | | 开发者API | REST · x-api-key身份验证 · 速率限制 · 免费/专业/企业 | | 无服务器 | 边缘函数 — Deno运行时 | | AI聊天机器人套件 | Google Gemini 2.5 Flash — 地图、诊断、医生和个人资料 | | OCR引擎 | Tesseract.js — 阿拉伯语、法语、英语 | | 模糊匹配 | fuse.js — 加权多字段评分 | | MCP服务器 | Node.js，托管在Railway — 6个健康工具 | | 移动端 | 进步式网页应用 — 可安装、离线可用 | | 浏览器扩展 | 清单V3 — Chrome和Firefox | <br> --- <br> ## 路线图 ``` 下一步计划 ────────────────────────────────────────────────────────────────── ✅ v1.0 网站门户 + 移动端渐进式网页应用 + 浏览器扩展 已上线 ✅ v1.1 MCP 服务器 — 可查询人工智能的健康数据 已上线 ✅ v1.2 开发者REST API — 免费 / 专业 / 企业级服务 已上线 🔄 v1.3 B2B API 控制面板 — 使用分析与密钥管理 进行中 🔄 v1.4 React Native 移动应用 — 更深层次的原生集成 进行中 🔄 v1.5 扩展至10个阿尔及利亚省 进行中 🔜 v2.0 预约服务 — 实时时间段管理 计划中 🔜 v2.1 患者健康记录 — 安全、按提供者划分的记录 计划中 🔜 v2.2 全国覆盖 — 所有58个省 计划中 ────────────────────────────────────────────────────────────────── ``` <br> --- <br> ## 平台状态 <div align="center"> <br> | 服务 | 状态 | URL | | :---: | :---: | :--- | | 网站门户 | ✅ &nbsp;已上线 | [cityhealthdz.com](https://cityhealthdz.com) | | 移动端渐进式网页应用 | ✅ &nbsp;已上线 | 可安装 — Android & iOS | | 浏览器扩展 | ✅ &nbsp;已上线 | Chrome & Firefox | | MCP 服务器 | ✅ &nbsp;活跃中 | [mcp.cityhealthdz.com/mcp](https://mcp.cityhealthdz.com/mcp) | | 开发者REST API | ✅ &nbsp;活跃中 | 免费 / 专业 / 企业级服务 | | 提供者目录 | ✅ &nbsp;维护中 | 仅验证列表 | | 人工智能聊天套件 | ✅ &nbsp;活跃中 | Gemini 2.5 Flash | </div> <br> --- <br> ## 团队 <br> **阿卜德拉伊拉赫·贝利亚古比** — 创始人 & 工程师 计算机科学硕士（网络、系统与信息安全） 阿尔及利亚西迪·贝尔·阿贝斯大学 <br> | | | | :--- | :--- | | 🌐 平台 | [cityhealthdz.com](https://cityhealthdz.com) | | 📧 项目 | [contact@cityhealthdz.com](mailto:contact@cityhealthdz.com) | | 📧 个人 | [belyagoubiabdillah@gmail.com](mailto:belyagoubiabdillah@gmail.com) | | 💻 GitHub | [github.com/BELYAGOUBIABDELILAH](https://github.com/BELYAGOUBIABDELILAH) | | 📸 Instagram | [@belyabdelilah](https://instagram.com/belyabdelilah) | <br> --- <br> <div align="center"> **城市健康** &nbsp;·&nbsp; 阿尔及利亚西迪·贝尔·阿贝斯 [cityhealthdz.com](https://cityhealthdz.com) &nbsp;·&nbsp; [contact@cityhealthdz.com](mailto:contact@cityhealthdz.com) <br> _{© 2026 城市健康。版权所有。 &nbsp;|&nbsp; 为阿尔及利亚人民打造。} </div>