This page mirrors the contents of README_ADDENDUM.md.
# quotation.3000dollar.com AI 智能体任务说明书
## 1. 任务定位
你接手的不是一个从零开始的新项目，而是一个“基础设施已创建完成、业务代码尚未开始”的项目。
你的任务不是再次初始化 GitHub、Vercel、Supabase，而是直接在现有仓库中继续构建真实业务代码，并最终把占位页替换成正式应用。
## 2. 立即可用的资源
- GitHub 仓库：https://github.com/ychocm-stack/quotation.3000dollar.com
- Vercel 控制台：https://vercel.com/dashboard/quotation.3000dollar.com
- Vercel 生产域名：https://quotation.3000dollar.com.vercel.app
- Supabase 控制台：https://supabase.com/dashboard/project/pqlmaqyotkpjhzxaicws
- Supabase Project Ref：`pqlmaqyotkpjhzxaicws`
- Supabase 使用模式：复用现有 Supabase 项目
- 数据库表前缀：`quotation_3000dollar_com`
## 3. 已自动完成的初始化动作
以下动作已经完成，不要重复执行：
1. GitHub 私有仓库已创建并初始化。
2. Vercel 项目已创建并绑定 GitHub 仓库。
3. Vercel 环境变量已注入：
- `VITE_SUPABASE_URL`
- `VITE_SUPABASE_ANON_KEY`
4. Supabase 数据库连通性已验证。
5. 默认 `Hello World` 示例表已创建。
6. 当前交接文件已生成：
- `.env.example`
- `README_ADDENDUM.md`
- `index.html`
## 4. 你的核心目标
从现在开始，你应该把这个仓库推进到“可运行、可部署、可继续迭代的业务项目”状态。
最低目标：
1. 建立真实业务代码。
2. 建立与 Supabase 的实际读写能力。
3. 设计并落地正式业务表。
4. 替换占位 `index.html`。
5. 确保 GitHub -> Vercel -> Supabase 的链路可持续工作。
## 5. 执行顺序
请按以下顺序推进：
### 第一步：检查仓库当前内容
确认仓库中当前只有初始化产物，业务代码尚未真正落地。
检查重点：
- 是否已有真实业务代码；
- 是否已有真实页面或交互入口；
- 是否已有数据库读写相关代码；
- 是否已有数据库结构变更记录；
- 是否已有正式业务表定义。
### 第二步：开始建立真实业务代码
在确认仓库现状后，直接开始落地真实业务代码，不再停留在初始化产物状态。
这一阶段的目标是：
1. 建立实际可运行的业务代码。
2. 建立与 Supabase 的实际连接代码。
3. 让首页不再只是纯静态交接页。
### 第三步：验证 Supabase 接入
先不要急着设计完整业务系统，先做一个最小可验证闭环：
1. 读取 `public.quotation_3000dollar_com_messages` 的数据。
2. 向 `public.quotation_3000dollar_com_messages` 插入一条测试数据。
3. 在页面中显示读取结果。
4. 确认 Vercel 部署后也能正常访问该链路。
如果这一步不通，先修通基础链路，再进入业务表设计。
### 第四步：设计正式业务数据模型
正式业务表开始建设时，必须遵守此前缀策略：
- 所有新增业务表统一使用 `quotation_3000dollar_com_` 前缀。
正确示例：
- `quotation_3000dollar_com_orders`
- `quotation_3000dollar_com_customers`
- `quotation_3000dollar_com_tasks`
错误示例：
- `orders`
- `customers`
- `tasks`
### 第五步：建立数据库变更管理方式
不要长期依赖手工改表。接手后应明确数据库结构如何持续变更、如何记录、如何回溯，并确保后续新增表和策略变更都有一致的管理方式。
### 第六步：替换占位首页
当前线上域名中的 `/index.html` 只是初始化结果展示页，不是正式产品页面。
最终应做到：
1. 首页变成真实业务入口。
2. 页面内容来自实际业务代码，而不是交接文档镜像。
3. 部署后访问 `https://quotation.3000dollar.com.vercel.app` 能看到正式应用，而不是占位摘要。
## 6. 你必须知道的数据库现状
当前已存在的示例表为：
- `public.quotation_3000dollar_com_messages`
当前表结构如下：
```sql
create table if not exists public.quotation_3000dollar_com_messages (
id bigserial primary key,
name text,
content text,
created_at timestamptz default now()
);
```
当前示例表已具备：
- Row Level Security 已启用
- `anon` / `authenticated` 的基础访问授权
- 公开读取策略
- 公开插入策略
请注意：
- 这个表是样板和连通性验证产物，不是正式业务模型。
- 正式业务开发时，可以保留它做调试，也可以在确认无依赖后逐步废弃。
- 但无论新增什么表，都必须遵守 `quotation_3000dollar_com_` 命名规则。
## 7. 环境变量规则
当前约定的变量名如下：
- `VITE_SUPABASE_URL`
- `VITE_SUPABASE_ANON_KEY`
说明：
- Vercel 中已经注入；
- 本地开发时需要自行创建本地环境文件并填写真实值；
- 不要随意改变量名，除非你同步调整整个项目读取逻辑；
- 不要把高权限密钥直接提交到仓库。
## 8. 严格禁止事项
以下行为默认禁止：
1. 不要再次创建新的 GitHub 仓库。
2. 不要再次创建新的 Vercel 项目。
3. 不要再次创建新的 Supabase 项目，除非明确要求变更基础设施方案。
4. 不要创建无前缀的业务表。
5. 不要删除或改动其他前缀开头的共享表。
6. 不要把 Token、数据库密码、Service Role Key 提交进仓库。
7. 不要把当前 `public.quotation_3000dollar_com_messages` 误认成最终业务模型。
## 9. 建议你优先交付的内容
如果你是程序员或 AI 智能体，建议第一轮直接交付以下结果：
1. 一套真实业务代码，而不再只是初始化产物。
2. 一段可以连接 Supabase 的实际代码。
3. 一个能展示数据库读取结果的最小可运行页面。
4. 一套正式业务表设计草案。
5. 一份数据库变更管理说明。
6. 一次完整的本地运行和部署验证记录。
## 10. 完成标准
只有满足以下条件，才算真正进入“业务开发已开始”的状态：
1. 仓库中已经存在真实业务代码，而不只是初始化产物。
2. 本地可以启动项目。
3. 页面可以通过 Supabase 完成至少一次真实读写。
4. 线上 Vercel 页面已不再只是交接说明页。
5. 新增数据库对象已经遵守 `quotation_3000dollar_com_` 前缀规范。
## 11. 交接给 AI 的执行指令
如果你是接手该项目的 AI 智能体，请直接执行以下策略：
1. 先阅读仓库现状，判断是否已经存在真实业务工程。
2. 若不存在，则在当前仓库中开始建立真实业务代码。
3. 建立与 Supabase 的实际连接逻辑，并用 `public.quotation_3000dollar_com_messages` 做最小读写验证。
4. 在验证通过后，开始建设正式业务表与实际页面。
5. 全程遵守共享 Supabase 项目的前缀隔离规则。
6. 不要重复做基础设施初始化。
## 12. 一句话任务摘要
你的任务是：在现有仓库和现有云资源基础上，直接开始构建正式业务应用，打通页面、Supabase、部署链路，并严格遵守 `"quotation_3000dollar_com_"` 数据表前缀隔离规则。