增加每章节 README 文件

2026-09-22 15:57:59 +08:00
parent 8e86665096
commit 9445061c76
49 changed files with 3815 additions and 6 deletions
@@ -0,0 +1,54 @@
+# 软件工程与基础设施
+
+> 所属：阶段一 · 前置核心基础
+> 目标：补上 Git、FastAPI、Docker、PostgreSQL、Redis 这四根工程地基，让 Agent 能从「跑通」变成「可维护」。
+
+---
+
+## 📌 学习目的
+
+补上 Git、FastAPI、Docker、PostgreSQL、Redis 这四根工程地基，让 Agent 能从「跑通」变成「可维护」。
+
+## ✅ 学习要求（前置条件）
+
+已完成阶段一前 7 个小点中的任意 4 个。
+
+## 📚 主要学习内容
+
+- Git 进阶：rebase vs merge / 分支流 / cherry-pick
+- FastAPI：路由 / Pydantic 模型 / SSE 流式 / Depends 依赖注入
+- 容器化：Dockerfile 分层 / docker-compose 一键拉起
+- 数据库：PostgreSQL 事务 / Redis TTL / SQLAlchemy 2.x
+
+## 📖 对应 docs
+
+- 目录：[`docs/01-阶段一-前置核心基础/`](../../docs/01-阶段一-前置核心基础/)（按目录名里的 `第 X 篇` 对应）
+- 在 docs 目录里找到对应的小点 markdown 文件阅读详细理论。
+
+## 🛠️ 建议练习
+
+- [ ] 实现一个带 SSE 流式的 FastAPI 接口并 curl 测试
+- [ ] 写一个多阶段 Dockerfile，按「先拷依赖再拷源码」分层
+- [ ] 用 SQLAlchemy 写一段「写任务 + 写明细」的事务代码
+
+## 🏁 完成后达成标准
+
+- [ ] 能用 FastAPI 实现 SSE 流式接口并跑通
+- [ ] 能编写多阶段 Dockerfile 并 compose 拉起应用 + Redis
+- [ ] 会用 Redis TTL 与 PostgreSQL 事务
+
+---
+
+## 🚀 运行提示
+
+```bash
+# 激活根目录的虚拟环境
+cd /Users/jack/source/Demo/py/demo_python_agent
+source .venv/bin/activate   # 或直接用 uv run ...
+
+# 进入本章目录
+cd code/001_phase1_foundations/08_software_engineering_basics
+
+# 跑你的练习文件
+uv run python your_exercise.py
+```