# 1.本地创建新项目
npx create-sonicjs@latest my-app

# 2.进入项目目录
cd my-app

# 3.登录cloudflare
npx wrangler login

# 4.创建 D1 数据库（记录下database_id)：
npx wrangler d1 create my-sonicjs-db

# 5.创建 R2 存储桶（用于存放上传的图片/文件）：
npx wrangler r2 bucket create my-sonicjs-media

# 修改配置文件 (wrangler.toml)
[[d1_databases]]
binding = "DB"
database_name = "my-sonicjs-db" # 你创建的名字
database_id = "xxxx-xxxx-xxxx" # 刚才创建后生成的 ID
[[r2_buckets]]
binding = "MEDIA_BUCKET"
bucket_name = "my-sonicjs-media" # 你创建的桶名字

**# 核心步骤：执行数据库迁移（初始化表结构）**
npm run db:migrate

# 启动开发服务器
npm run dev

# 访问 <http://localhost:8787>

**# 核心步骤：同步到远程数据库D1**
npm run db:migrate -- --remote

# 部署到cloudflare
npm run deploy

# 初始化本地数据库
# 这一步会创建本地的 .wrangler 文件夹并生成 SQLite 数据库文件，DB必须是配置文件绑定的数据库名
npx wrangler d1 migrations apply DB --local

# 如果遇到无法新增和保存内容，可以用以下命令手动补全缺失的字段
npx wrangler d1 execute DB --local --command="ALTER TABLE content ADD COLUMN created_by TEXT;"
npx wrangler d1 execute DB --local --command="ALTER TABLE content ADD COLUMN updated_by TEXT;"

# 同步数据库表结构（核心步骤）
npx wrangler d1 migrations apply DB --remote

# 线上环境补齐
npx wrangler d1 execute DB --remote --command="ALTER TABLE content ADD COLUMN created_by TEXT;"
npx wrangler d1 execute DB --remote --command="ALTER TABLE content ADD COLUMN updated_by TEXT;"

# 再部署
npm run deploy

# 查询迁移状态（本地）
wrangler d1 migrations list DB --local

# 应用本地迁移
wrangler d1 migrations apply DB --local

# 应用生产迁移
wrangler d1 migrations apply DB --remote

sonicjs-ai/
├── packages/
│   ├── core/              # 主CMS包，发布为 @sonicjs-cms/core
│   │   ├── src/
│   │   │   ├── routes/    # 路由处理（管理、API、认证）
│   │   │   ├── templates/ # HTML模板和组件
│   │   │   ├── middleware/# 认证与中间件
│   │   │   ├── utils/     # 工具函数
│   │   │   └── db/        # 数据库模式与迁移
│   │   └── package.json
│   ├── templates/         # 模板系统包
│   └── scripts/           # 构建脚本
├── my-sonicjs-app/        # 测试应用（git忽略）
├── www/                   # 网站营销页
├── tests/e2e/             # 端到端测试
└── drizzle/               # 数据库迁移管理

INSERT INTO collections (id, name, display_name, description, schema) VALUES (
  'blog-posts', 'blog_posts', '博客文章', '文章内容集合',
  '{"type":"object","properties":{"title":{"type":"string","required":true}}}'
);

INSERT INTO content_fields (collection_id, field_name, field_type, field_label, field_options) VALUES
  ('blog-posts', 'title', 'text', '标题', '{"maxLength": 200, "required": true}'),
  ('blog-posts', 'content', 'richtext', '内容', '{"toolbar": "full", "height": 400}'),
  ('blog-posts', 'excerpt', 'text', '摘要', '{"maxLength": 500, "rows": 3}'),
  ('blog-posts', 'featured_image', 'media', '特色图片', '{"accept": "image/*"}'),
  ('blog-posts', 'publish_date', 'date', '发布日期', '{"defaultToday": true}'),
  ('blog-posts', 'is_featured', 'boolean', '精选文章', '{"default": false}');

# wrangler.toml
name = "my-sonicjs-app"
main = "src/index.ts"
compatibility_date = "2024-01-01"

[[d1_databases]]
binding = "DB"
database_name = "my-app-db"
database_id = "your-database-id"

[[r2_buckets]]
binding = "MEDIA_BUCKET"
bucket_name = "my-app-media"

# 运行单元测试
npm test

# 监听模式运行测试
npm run test:watch

# 端到端测试
npm run test:e2e

# 带UI的端到端测试
npm run test:e2e:ui

// src/plugins/my-plugin/index.ts
import { Plugin } from '@sonicjs/core'

export default {
  name: 'my-plugin',
  hooks: {
    'content:beforeCreate': async (content) => {
      // 插件逻辑
      return content
    }
  }
} as Plugin