console-dev/AGENTS.md

V0 项目边界

本仓库属于 V0：Nuxt、Vue、OpenVue 和 Deni 会员前端。V0 只保留前端，不承载后端项目。

仓库隔离

• 本仓库远端为 https://git.crash.work/cieanyau/console-dev.git。
• V1 位于 /Users/cieanyau/Documents/ChatGPT/V1；其中 Next.js、React 和 Shadcn 前端使用 https://git.crash.work/cieanyau/console-new.git，PHP 后端在其 backend/ 子目录保持独立 Git 仓库。
• V0 任务只修改本前端；V1 的前端、后端、依赖、分支和构建产物需要在各自任务范围处理，不互相合并或作为彼此的发布源。
• 推送前核对工作树、分支和远端；只暂存本任务明确涉及的文件。
• 提交说明使用中文，新增解释性代码注释使用中文。

发布隔离

• V0 正式站为 console.crash.work，发布根目录为 /www/wwwroot/crashwork-console，会员前端进程为 PM2 的 crashwork-console。
• V1 开发站为 console-dev.crash.work，发布根目录为 /www/wwwroot/console-dev.crash.work，使用独立的 console-dev.service；这些目标不属于 V0 发布范围。
• V0 发布只操作已经核实的 V0 目标，保留旧版本及回滚点；不得重启全部 PM2 进程或 V1 服务。
• 构建、依赖目录、发布归档、运行配置及验收记录分别归属各自项目，不跨项目复用。

共享后端边界

• /console/v1 是 V10 业务系统的 API 前缀，与名为 V1 的前端项目不是同一个概念。
• 两个前端目前共用该后端；前端仓库独立不代表 API 或数据库独立。
• V0 前端发布不自动授权修改共享后端契约、执行数据库迁移或复制生产数据。影响共享后端的变更必须另行核对全部使用方，并按用户确认的后端范围发布。
• 后端主仓库已经迁至 /Users/cieanyau/Documents/ChatGPT/V1/backend；关联工作树在 V1/backend-worktrees/，交付包在 V1/backend-deliveries/。不得在 V0 重建后端目录，也不得将完整后端源码或配置推送至本仓库。
• 目录迁移不改变生产 API 或数据库。共享后端契约尚未配套发布时，不发布依赖该新契约的 V0 前端产物。