企业官网建设流程全解析

RubberDuck Playground（rubberduck-use-case-playground）是一个围绕 Rubber Duck Pizzeria 披萨店演示应用打造的开源项目：它用Flask + SQLite搭建了一个结构完整、可一键启动的餐厅管理后台，并内置了 UC-01 到 UC-10 共十个 AI 实战用例。本文带你快速看懂这个 Flask+SQLite 演示应用的架构分层、数据设计与启动流程，适合新手和普通用户上手参考。

一、项目速览：一个"有剧本"的演示应用

这个仓库只有一条清晰路径：demo-projects/下的启动 Hub + 披萨店演示应用。各部分职责如下：

💡 注意：代码中的安全弱点与逻辑 Bug 是有意埋设的实验点（lab sinks），只用于学习，切勿当作生产代码。

二、快速上手：三步跑起 Flask+SQLite 演示应用

第 1 步：克隆仓库

git clone https://gitcode.com/gh_mirrors/ru/rubberduck-use-case-playground cd rubberduck-use-case-playground/demo-projects

第 2 步：打开启动 Hub

• Windows：双击start-hub.bat
• Linux/macOS：执行./start-hub.sh

浏览器访问http://127.0.0.1:5055/，选择Rubber Duck Pizzeria并点击 Launch，健康检查会依次点亮 venv → deps → DB → API → UI 五个环节。

第 3 步：直接启动（可选）

也可以跳过 Hub，在演示应用目录执行python setup_and_run.py。setup_and_run.py 会按顺序完成四件事：

1. ensure_venv()— 创建/复用.venv虚拟环境
2. install_deps()— 按 requirements.txt 安装 Flask 3.0.2 等依赖
3. init_database()— 初始化 SQLite 并写入种子数据
4. start_server()— 启动前端（http://127.0.0.1:5000/）与 Kitchen API（/api/health）

完整图文流程见官方指南 GUIDE.md。

三、分层架构：入口 → 蓝图 → 数据层

整个后端只有 6 个 Python 模块，分层非常清晰，是学习 Flask 项目组织方式的好样本：

• 入口层：main.py 仅 6 行，把职责交给工厂函数create_app()
• 应用工厂：init.py 创建 Flask 实例、初始化数据库、注册两个蓝图
• 页面路由层：routes.py 中的main蓝图，负责 50+ 个页面路由（Dashboard、Order List、Email、Charts 等），全部只做"渲染模板"一件事
• 接口层：api.py 中的kitchen_api蓝图，挂载在/api前缀下，处理订单、菜单、评论、登录等数据接口
• 数据层：db.py 封装 SQLite 连接、建表、种子数据与查询函数
• 业务辅助层：queries.py（聚合计算）、services.py（配置消费方）、config.py（运行时配置）

请求流向可以概括为：

浏览器 → Flask →main/kitchen_api蓝图 →db.py/queries.py→data/pizzeria.db（SQLite）

四、数据层解剖：SQLite 七张表与种子数据

db.py 的init_db()负责建库建表，一共 7 张表，覆盖了一家披萨店的完整业务模型：

两个值得新手关注的设计细节：

• 幂等初始化：若staff表已有数据则直接跳过种子写入，重复启动不会报错或重复插数据
• 单文件数据库：SQLite 库文件生成在 data/pizzeria.db，随data/目录自动创建，零配置

菜单种子数据中的意式辣肉酱意面（Medium Spicy Spagethi Italiano）对应的就是应用内展示的真实菜品图片：

五、Kitchen API：接口清单与"内埋"的实验点

api.py 是十个用例的主要"靶场"，核心接口一览：

每个实验点命中时都会返回形如FLAG{...}的标记，方便你在 AI 助手的分析结果中快速对答案。配套的逻辑 Bug 藏在 queries.py 的get_aggregation()中：discount掩码在处理第一笔金额后即被移除，导致折扣永远为 0——这正是"定位并修复 Bug"用例的目标。

六、十大用例如何落在架构上

Hub 的 Generate prompts 页会按 prompts.json 生成项目专属提示词，十个用例与架构模块的对应关系如下：

七、关键文件导航

写在最后

Rubber Duck Playground 用一个轻量但完整的披萨店系统，把Flask 蓝图分层、SQLite 种子数据、Jinja2 模板渲染这三个新手最需要的知识点串在了一起：入口 6 行、后端 6 个模块、数据库 1 个文件，却五脏俱全。建议先按本文"三步启动"把应用跑起来，再对照 UC-01 让 AI 助手沿main.py→ 蓝图 →db.py走一遍代码链路——这比单读文档快得多。

⚠️ 再次提醒：项目内的"漏洞"与 Bug 均为教学用途的实验设计，请勿将api.py中的处理方式用于任何生产环境。