frappe-app-dev

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

Use bare
```
bench
```
. Not
```
./env/bin/bench
```
. Not a full path.
Do not run
```
which bench
```
,
```
bench --version
```
,
```
bench --help
```
, or check frappe version. No discovery commands.
Do not delegate bench detection to a subagent. Run
```
ls apps/ sites/ Procfile
```
yourself.
Do not create DocType folders with
```
mkdir
```
. Frappe creates them via
```
bench migrate
```
.
Run
```
bench start
```
in a background process only.
Before running
```
bench start
```
, check if it's already running in an existing terminal. Do not start a second instance.
Always pass
```
--site <site>
```
explicitly to bench commands. Never run bare
```
bench migrate
```
.

Determine which flow applies, then read ONLY the relevant file:

确定适用的流程后，仅阅读相关文件：

Read new-app.md — covers bench setup, app scaffolding, site creation, and installation.

阅读new-app.md —— 涵盖bench配置、应用脚手架搭建、站点创建与安装。

Read existing-app.md — covers finding the bench, locating the app, confirming site, and extending features.

阅读existing-app.md —— 涵盖查找bench、定位应用、确认站点及扩展功能。

Load ONLY the references needed for the current task:

Topic	When to load	File
Site management	Finding/creating/managing sites	site-management.md
DocTypes	Creating/modifying DocTypes, fields, naming	doctypes.md
Controllers	Document lifecycle, server logic	controllers.md
Whitelisted APIs	REST endpoints, `@frappe.whitelist()`	api.md
Database & ORM	`frappe.db` , queries, raw SQL	database.md
Caching	Redis, `frappe.cache`	caching.md
Realtime	WebSocket, `publish_realtime`	realtime.md
Background jobs	`frappe.enqueue` , scheduled jobs	background-jobs.md
Hooks	`hooks.py` patterns	hooks.md
Permissions	Roles, DocType permissions, `has_permission`	permissions.md
Testing	Writing & running tests	testing.md
Frontend & UI	Desk UI, Vue SPA, portal pages	frontend.md (router → 3 sub-files)
Bench CLI	All bench commands reference	bench-operations.md

仅加载当前任务所需的参考文档：

主题	加载时机	文件路径
站点管理	查找/创建/管理站点时	site-management.md
DocTypes	创建/修改DocTypes、字段、命名规则时	doctypes.md
控制器	文档生命周期、服务器逻辑开发时	controllers.md
白名单API	REST端点开发、使用 `@frappe.whitelist()` 时	api.md
数据库与ORM	使用 `frappe.db` 、查询、原生SQL时	database.md
缓存	Redis、 `frappe.cache` 相关操作时	caching.md
实时功能	WebSocket、 `publish_realtime` 使用时	realtime.md
后台任务	`frappe.enqueue` 、定时任务开发时	background-jobs.md
钩子函数	`hooks.py` 模式开发时	hooks.md
权限管理	角色、DocType权限、 `has_permission` 使用时	permissions.md
测试	编写与运行测试时	testing.md
前端与UI	桌面UI、Vue SPA、门户页面开发时	frontend.md (路由 → 3个子文件)
Bench CLI	所有bench命令参考时	bench-operations.md