safenow/hasura-alarmdata-db

Safenow调整镜像（含Postgis）

镜像概述和主要用途

本镜像为Safenow项目的定制化调整镜像，基于Postgis构建并包含特定优化，主要用于支持Safenow用户应用（SafeNow User App）和合作伙伴应用（SafeNow Partner App）的后端基础设施。作为项目monorepo的核心组件，该镜像提供地理空间数据处理能力及项目所需的定制化功能，是后端服务运行的关键环境。

核心功能和特性

• Postgis集成：内置Postgis扩展，支持地理空间数据的存储、查询与分析
• 定制化配置：针对Safenow项目需求进行专项调整与优化
• 环境适配：兼容项目复杂的Docker开发环境，支持与Hasura等后端服务协同工作
• 自动化流程：通过GitHub Actions实现自动化测试、构建与部署集成

使用场景和适用范围

• Safenow用户应用及合作伙伴应用的本地开发环境搭建
• 后端服务的集成测试与验证
• 开发环境中地理信息相关功能的调试与验证
• 基于容器化部署的后端服务基础设施

使用方法和配置说明

本地开发环境设置

前置准备

1. 熟悉Conventional Commits规范，遵循https://github.com/conventional-changelog/commitlint/tree/master/%40commitlint/config-conventional
2. 安装必要工具：

   bash
   asdf plugin add nodejs
   asdf install
   npm install
   

3. 配置提交检查：

   bash
   # 添加文件到暂存后执行提交检查
   npx commit
   

Docker环境配置

详细配置步骤请参考后端README，需严格按照步骤执行以完成复杂的Docker环境设置，包括：

• 必要工具安装
• 容器网络配置
• 数据卷挂载
• 环境变量设置

应用连接与运行

1. 确保后端服务正常运行后，可通过Intellij或Android Studio打开Safenow用户应用和合作伙伴应用
2. 运行应用时需将环境设置为"local"
3. 可使用模拟器或真实设备运行应用，具体步骤参见：
   • SafeNow User App
   • SafeNow Partner App

构建与部署流程

自动化构建（GitHub Actions）

项目通过GitHub Actions实现Docker镜像的自动化构建与推送，关键工作流包括：

• 构建工作流：.github/workflows/processors.yaml、external-api-router.yaml负责镜像构建
• 推送工作流：.github/workflows/push-docker-images-to-environment.yaml将镜像推送至ECR

部署触发条件

相关提交需满足：

• 更新处理器版本
• 在对应CHANGELOG.md文件中添加变更记录

符合条件的提交将自动触发：

1. 镜像构建与测试
2. 推送至ECR
3. 部署Helm chart至dev-alarmdata命名空间

密钥管理

部署所需密钥通过git-secret存储于monorepo中，详见密钥管理文档。

版本管理策略

1. 分支管理：

   • 基于master分支开发，需测试并审核后方可合并
   • 新功能/修复需从master创建分支，命名格式：CU-{task-ID}-{title}（如CU-861n2w4yq-Recommend_User_App）

2. 应用版本发布：

   • 更新pubspec.yaml中的构建号，确保不与现有版本冲突
   • 添加特定格式标签：
     • 开发环境：dev-user-app-v.X.X.X+XXX
     • 候选发布：rc-user-app-v.X.X.X+XXX
     • 生产环境：prod-user-app-v.X.X.X+XXX
   • 推送标签后触发GitHub Action构建（通过Codemagic）

相关链接

• 技术文档
• Hasura Cloud项目
• Hasura核心文档
• Terraform设置