README.md



BettaFish 应用层目录

版本：v1.1

状态：Active

更新时间：2026-04-09


1. 目录用途

apps/ 用于承接所有面向用户的应用入口，是当前仓库的 canonical 应用层。

当前一级目录：

apps/
├─ web_api/
├─ web_ui/
└─ engine_console/


2. 子目录说明


目录
作用
推荐入口


apps/web_api/
Flask + Socket.IO 主站装配层
python -m apps.web_api


apps/web_ui/
Vue 3 + Vite + TypeScript 前端工程
npm --prefix apps/web_ui run dev


apps/engine_console/
Query / Media / Insight 三个 Streamlit 单引擎入口
streamlit run apps/engine_console/query_engine_streamlit_app.py --server.port 8503


3. 当前约束


历史目录 frontend/ 和 SingleEngineApp/ 已移除，不再作为入口。
根目录 app.py 已在 T-525 删除；Web API 的 Python 启动入口固定为 apps/web_api/。
新增应用入口时，优先放入 apps/，不要再回流到仓库根目录。