一个基于Flask的简易待办事项应用，专为Aicoding训练营设计，综合运用Python、Linux、Git、Docker和数据库开发等技能。

• Python Flask框架 - 轻量级Web应用开发
• Linux命令操作 - 服务器环境管理
• Docker容器化 - 应用部署和隔离
• PostgreSQL数据库 - 关系型数据库操作
• Git版本控制 - 代码管理和协作
• 单元测试 - 代码质量保证
• 响应式前端 - Bootstrap + JavaScript

• Flask 2.3.3 - Web框架
• SQLAlchemy - ORM数据库操作
• PostgreSQL - 关系型数据库
• Flask-Migrate - 数据库迁移
• Gunicorn - WSGI服务器

• Bootstrap 5 - 响应式UI框架
• Font Awesome - 图标库
• Vanilla JavaScript - 原生JS交互

• Docker - 容器化部署
• Docker Compose - 多容器编排
• Nginx - 反向代理

todo_app/
├── app.py                 # Flask主应用
├── requirements.txt       # Python依赖
├── Dockerfile            # Docker镜像构建
├── docker-compose.yml    # 容器编排
├── nginx.conf            # Nginx配置
├── init.sql              # 数据库初始化
├── env.example           # 环境变量示例
├── .gitignore            # Git忽略文件
├── templates/
│   └── index.html        # 前端页面
├── tests/
│   └── test_app.py       # 单元测试
└── README.md             # 项目文档

确保已安装以下工具：

• Python 3.9+
• Docker & Docker Compose
• Git

git clone https://cnb.cool/sashavagals/todo_app.git
cd todo_app

# 复制环境变量文件
cp env.example .env

# 编辑环境变量（可选）
nano .env

# 构建并启动所有服务
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看日志
docker-compose logs -f todo-app

# 停止并删除所有服务
docker-compose down -v

# 创建虚拟环境
conda create -n todo_app python=3.10
conda activate todo_app

# 安装依赖
pip install -r requirements.txt

# 启动应用
python app.py

• 创建待办事项（标题、描述、优先级、截止时间）
• 查看待办事项列表
• 编辑待办事项
• 删除待办事项
• 切换完成状态
• 按状态筛选（全部/待完成/已完成）

• 高优先级（红色标识）
• 中优先级（黄色标识）
• 低优先级（绿色标识）

• 总待办事项数量
• 已完成事项数量
• 完成率统计

GET /api/todos

POST /api/todos
Content-Type: application/json

{
    "title": "待办事项标题",
    "description": "详细描述",
    "priority": "high|medium|low",
    "due_date": "2024-12-31T23:59:59"
}

GET /api/todos/{id}

PUT /api/todos/{id}
Content-Type: application/json

{
    "title": "新标题",
    "completed": true
}

POST /api/todos/{id}/toggle

DELETE /api/todos/{id}

CREATE TABLE todos (
    id SERIAL PRIMARY KEY,
    title VARCHAR(200) NOT NULL,
    description TEXT,
    completed BOOLEAN DEFAULT FALSE,
    priority VARCHAR(20) DEFAULT 'medium',
    due_date TIMESTAMP,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

# 运行单元测试
pytest tests/

# 运行测试并生成覆盖率报告
pytest --cov=app tests/

# 运行特定测试文件
pytest tests/test_app.py::test_create_todo

1. 配置环境变量

export DATABASE_URL=postgresql://user:password@host:port/database
export SECRET_KEY=your-secret-key
export FLASK_ENV=production

2. 使用Docker Compose部署

docker-compose -f docker-compose.prod.yml up -d

3. 配置Nginx反向代理

# 复制nginx配置
sudo cp nginx.conf /etc/nginx/sites-available/todo-app
sudo ln -s /etc/nginx/sites-available/todo-app /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

通过这个项目，学员将掌握：

• Flask Web框架使用
• SQLAlchemy ORM操作
• RESTful API设计
• 单元测试编写

• 命令行基础操作
• 文件系统管理
• 进程和服务管理
• 日志查看和分析

• 代码版本管理
• 分支操作
• 合并和冲突解决
• 协作开发流程

• 容器镜像构建
• 多容器编排
• 网络和存储管理
• 生产环境部署

• PostgreSQL数据库操作
• SQL查询优化
• 数据库迁移
• 备份和恢复

docker-compose down -v
docker-compose up -d

docker-compose logs -f todo-app

docker-compose exec db pg_dump -U todo_user todo_db > backup.sql

• 添加用户认证系统
• 实现数据分页
• 添加搜索功能
• 集成消息通知

---

Aicoding训练营 - 让编程学习更简单！