AI Interior Design

面向 C 端业主的 AI 家装方案规划工具。

当前版本聚焦 MVP 骨架：家的信息创建、方案列表、方案详情、云端数据持久化，以及后续户型分析、装修方向生成、效果图和预算范围流程的数据基础。

比赛提交入口

如果用于 AI+应用比赛评审，建议先阅读：

• docs/SPECS.md：初赛项目提案
• docs/EVALUATION.md：评测标准
• docs/SUBMISSION.md：提交说明和文件映射
• skills/interior-design/SKILL.md：家装 AI skill

产品定位

AI Interior Design 不是施工图工具，也不是 CAD 编辑器。它的目标是帮助业主基于户型图和生活方式需求，快速获得可理解、可比较、可继续深化的家装初步方案。

核心流程：

填写家的基本信息
→ 上传户型图
→ AI 分析空间问题
→ 确认生活需求
→ 生成装修方向
→ 生成预算与效果图
→ 查看完整方案

当前能力

• 方案列表和状态概览
• 新建家装方案表单
• 方案详情页
• 云端数据库作为业务数据源
• 对象存储作为户型图存储目标
• 基础数据模型：项目、户型图、房间、设计方案、效果图、预算估算和 AI 任务
• 未配置数据服务时展示配置提示，不静默回退到本地 mock 数据

技术栈

• Next.js
• React
• TypeScript
• Tailwind CSS
• PostgreSQL

本地启动

安装依赖：

npm install

创建本地环境变量文件：

cp .env.example .env.local

编辑 .env.local：

SUPABASE_URL=""
SUPABASE_SERVICE_ROLE_KEY="your-service-role-key"

注意：SUPABASE_SERVICE_ROLE_KEY 只能在服务端使用，不要加 NEXT_PUBLIC_ 前缀，也不要提交真实密钥。

启动开发服务器：

npm run dev

默认访问：

http://localhost:3000

常用命令

npm run dev
npm run build
npm run typecheck

管理端

管理端入口：

http://localhost:3000/admin

管理端用于查看注册用户、项目使用、AI 任务和关键使用状态。它读取 Supabase Auth 用户和业务表聚合数据，因此必须配置服务端数据服务。

启用管理端前，请设置 Basic Auth 环境变量：

ADMIN_USERNAME=""
ADMIN_PASSWORD=""

未配置 ADMIN_USERNAME 和 ADMIN_PASSWORD 时，/admin 不会读取或展示用户数据。

用户使用情况按 projects.user_id 归因。旧数据库如果还没有这个字段，管理端会降级展示全局使用数据，并提示需要应用最新 schema。

数据服务

数据服务配置说明见 docs/SUPABASE.md。仓库只保留占位符，不提交真实项目地址、密钥或 Dashboard 链接。

数据库 schema 草案位于 supabase/schema.sql。

如果需要重新初始化数据库，请先确认目标环境和数据影响，不要直接对生产环境执行破坏性变更。

产品文档

完整 PRD 见 docs/PRD.md。

PRD 包含：

• 产品目标和 MVP 范围
• 核心工作流
• 页面要求
• 数据模型草案
• API 草案
• AI 工作流
• 风险和验收标准
• 后续路线图

AI 生成流程和 skill 维护规则见：

• docs/AI_WORKFLOW.md
• docs/AI_EXECUTOR.md
• docs/SKILL_MAINTENANCE.md
• skills/interior-design/SKILL.md

开发约束

• 业务数据以云端数据库为事实来源。
• 真实工作流不得静默保存到 local storage、本地 SQLite 或本地文件。
• AI 生成内容必须保留用户确认和编辑空间。
• 预算只能作为范围估算，不能表达为最终报价。
• 效果图是视觉方案，不是施工级输出。

当前开发重点

建议按以下顺序推进：

1. 完成项目基础 CRUD 和数据服务错误处理。
2. 接入户型图上传到对象存储。
3. 构建户型分析和结构确认页面。
4. 增加 AI task 状态跟踪和重试。
5. 生成方案、预算和用户可读的 HTML 方案页。