bilgrami/hijricalendar

巴基斯坦节假日与伊斯兰历API镜像

镜像概述

本镜像基于Django框架构建，提供巴基斯坦节假日和伊斯兰历（Hijri）日历的RESTful API服务。数据来源于巴基斯坦官方网站pakmoonsighting.com.pk，支持公开访问且无需认证，方便开发者快速集成相关日历信息到应用系统中。

核心功能

• 获取巴基斯坦节假日列表的API接口
• 查询2019-2020年伊斯兰历日历数据的API接口
• 通过CSV文件导入新日历数据的功能
• 支持PostgreSQL/SQLite双数据库存储
• 提供Admin管理界面维护节假日和日历数据

使用场景

• 开发者需在应用中集成巴基斯坦节假日信息
• 需要伊斯兰历与公历转换数据的业务场景
• 搭建巴基斯坦地区相关的日历服务平台

配置说明

1. 安装方式

方法1：从Docker Hub拉取镜像

bash
docker pull bilgrami/hijricalendar:latest

方法2：本地构建镜像

bash
git clone https://github.com/bilgrami/hijri-calendar.git
cd hijri-calendar
docker build -t bilgrami/hijricalendar:latest .

2. 运行容器

方法1：SQLite数据库模式

bash
docker run --rm -it -p 5000:5000/tcp bilgrami/hijricalendar:latest

方法2：Docker Compose + PostgreSQL模式

bash
docker-compose up

3. 初始化数据

连接容器执行初始化脚本：

bash
docker-compose exec web bash
cd /usr/local/project/hijri_calendar_project
chmod +x ./shell_scripts/init_script.sh
./shell_scripts/init_script.sh

脚本完成数据库迁移、数据导入及日历与节假日关联标记。

4. 访问服务

部署后通过浏览器访问：http://127.0.0.1:5000，可查看网站界面及API接口。

维护说明

• 修改节假日数据后更新日历关联：

  bash
  docker-compose exec web bash
  cd /usr/local/project/hijri_calendar_project
  python manage.py populate_holidays
  

• 支持Azure等云平台部署，可参考镜像文档中的云配置指引。