# Cocoon 发展规划（自主维护）

> 此文件由 cron 任务每3小时更新，记录项目状态与下一步计划。

## 路线图

### Phase 1 — 核心稳定（当前）
- [x] HTTP/1.1 请求解析
- [x] 响应头格式化
- [x] 静态文件服务（sendfile）
- [x] 目录浏览
- [x] Range 请求
- [x] MIME 类型识别
- [x] 多线程 M:N 调度
- [x] 命令行参数
- [x] 优雅关闭

### Phase 2 — 健壮性
- [ ] HTTP 缓存（ETag / Last-Modified / If-None-Match）
- [ ] Gzip / Brotli 压缩
- [ ] 完整的单元测试框架
- [ ] 压力测试 + 性能基准
- [ ] 连接超时管理（空闲连接自动清理）
- [ ] 请求体解析（POST 支持）

### Phase 3 — 扩展
- [ ] 配置文件支持（JSON / YAML）
- [ ] 虚拟主机 / 多站点
- [ ] 反向代理支持
- [ ] HTTPS / TLS
- [ ] HTTP/2

### Phase 4 — 生态
- [ ] WebSocket 支持
- [ ] 中间件机制
- [ ] 插件系统

## 当前状态

- 编译通过，基本功能可用
- 示例页面正常
- 缺少测试和性能数据

## 待办池

1. **添加缓存支持** — ETag + Last-Modified + 304 Not Modified ✅ 已完成（2026-06-03）
   - 请求头解析：If-None-Match、If-Modified-Since
   - ETag 生成（基于文件大小+修改时间）
   - Last-Modified 生成（HTTP 日期格式）
   - 304 响应（协商命中时返回，无 body）
2. **添加测试** — 用 curl/bats 或写 C 单元测试
3. **性能基准** — wrk/ab 压测，记录 RPS 和延迟
4. **修复编译警告** — 还有几个 stringop-truncation 警告
5. **连接池管理** — 空闲连接超时、最大连接数限制
6. **日志系统** — 结构化日志、分级输出

## 最近行动记录

- 2026-06-03: 项目初始化，核心模块全部实现
- 2026-06-03: 添加缓存协商（ETag + Last-Modified + 304），修复编译警告