Buffalo项目目录结构职责明确：bin存可执行文件，grifts放任务脚本，models管数据库实体，actions处理HTTP逻辑并调度models，assets管前端源码，templates管HTML渲染，conf、docker、locales分别负责配置、容器化和多语言。
要快速理解一个新创建的Buffalo框架项目里每个文件夹是干什么的，必须从项目初始化那一刻开始看起——不是靠猜，而是靠buffalo new命令实际生成的结构来定位职责边界。
顶层目录：bin、grifts、models等固定成员
执行buffalo new myapp后，你会看到这些一级目录：bin/、grifts/、models/、actions/、assets/、templates/、mailers/、locales/、docker/、go.mod和main.go。
bin/存放编译后的可执行文件，比如myapp二进制，它由main.go构建而来；grifts/是Grift（Buffalo的轻量级任务脚本）存放地，类似Rails的Rake任务，用于数据库种子填充、批量处理等；models/严格对应数据库实体，每个Go struct定义一个表，且自动绑定GORM或Pop迁移逻辑。
【models/目录下不能放非数据库映射的结构体，否则Pop迁移会报错】
前端资源集中地：assets与templates分工明确
assets/管“源”，templates/管“渲染”。前者包含js/、css/、images/原始文件，经Webpack或ESBuild打包后输出到public/assets/；后者存放.html模板，使用Plush语法，支持布局继承、局部渲染和上下文传参。
注意：templates/里的文件名决定路由匹配路径，比如actions/home.go中c.Render(200, r.HTML("home/index.html"))会去找templates/home/index.html，路径必须完全一致。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
业务逻辑中枢：actions目录的三层结构
第一步：进入actions/目录，你会看到app.go——这是整个HTTP服务的注册中心，所有中间件、路由、错误处理器都在这里装配。
第二步：子目录如users/或posts/对应资源型控制器，每个目录下有actions.go（定义HTTP方法处理函数）和test.go（配套测试）。
第三步：每个actions.go里的函数接收buffalo.Context，调用c.Render()返回HTML，或c.JSON()输出API数据。这里不写SQL，只调度models/里的方法。
这一步操作起来很简单，直接把业务判断逻辑写在action函数里就行，但要注意别把数据库查询写进action——那是models该干的事。
配置与环境隔离：conf、docker、locales各司其职
conf/只放app.toml，定义不同环境（development/test/production）下的端口、数据库URL、日志级别等；docker/下是Dockerfile和docker-compose.yml，专为容器部署准备，与本地开发完全解耦；locales/存多语言翻译文件，格式为TOML，键名需与模板中t("welcome.message")调用严格对应。
如果你改了locales/en-US.toml但页面没变，先检查conf/app.toml里default_locale是否设为"en-US"。
