pyar/asoc_members

Asoc Members：阿根廷Python民间协会会员管理Web应用

镜像概述

Asoc Members是阿根廷Python民间协会（PyAr）开发的会员管理Web应用，旨在提供会员资格管理、用户认证等核心功能。该应用采用Docker化部署，支持开发、暂存和生产环境，通过自动化流程简化部署和维护。

核心功能与特性

• 会员管理：提供会员信息的添加、查询、更新等功能
• 用户认证：集成Django超级用户系统，支持管理员账户创建与权限管理
• Docker化部署：基于Docker和Docker Compose，简化环境配置与依赖管理
• 自动化流程：通过Travis CI实现持续集成，支持自动构建和测试
• 多环境支持：区分开发、暂存和生产环境，满足不同阶段需求

使用场景与适用范围

• 阿根廷Python民间协会内部会员信息管理
• 协会管理员处理会员资格相关事务
• 开发团队进行应用功能开发与测试
• 生产环境下的稳定部署与运行

系统依赖

使用该项目需在系统中安装以下依赖：

• Docker（安装指南）
• Python 3
• Docker Compose

Debian/Ubuntu系统安装示例

bash
sudo apt install python3 docker docker-compose

开发环境使用方法

常用开发命令

• make bootstrap：首次设置项目或依赖/基础设施变更后执行（变更前建议先执行clean）
• make test：运行所有测试
• make run：启动本地所有服务，准备本地开发环境
• make stop：停止所有服务（不删除数据）
• make clean：停止并移除所有服务及数据，清理环境

创建Django超级用户

如需创建管理员账户，执行以下命令：

bash
$ make createsuperuser
Username (leave blank to use 'root'): admin
Email address: admin@example.com
Password:
Password (again):
Superuser created successfully.

部署流程

暂存环境部署（待配置）

合并代码到master分支后，将自动生成带有latest标签的镜像并更新部署。

生产环境部署

创建格式为x.y.z的标签后，将自动生成带有stable和prod-x.y.z标签的Docker镜像，镜像生成后将自动部署到生产环境。

生产环境文档

生产环境详细配置请参考：https://github.com/PyAr/pyar_infra/

贡献指南

贡献方式

您可以通过报告bug、验证bug有效性等方式贡献。代码贡献步骤如下：

1. 阅读CONTRIBUTING.md文件，了解git、git-flow工作流程及代码质量要求
2. 对修改内容编写测试（尽管当前测试覆盖率有限，但这是我们正在改进的方向）
3. 完成后，提交Pull Request到项目master分支（https://github.com/PyAr/asoc_members/%EF%BC%89%EF%BC%8C%E5%B9%B6%E5%BC%95%E7%94%A8%E7%9B%B8%E5%85%B3issue

您的Pull Request审核通过后，代码将合并到项目中。