wangjunqing-coder/rabbit-agent/super-dev-architect

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Browser   │────▶│  API (REST) │────▶│   Database   │
│   (Vue 3)   │◀────│  (Express)  │◀────│  (PostgreSQL) │
└─────────────┘     └─────────────┘     └─────────────┘

src/
├── components/
│   ├── Button.vue
│   ├── Modal.vue
│   └── ...
├── views/
├── composables/
├── api/
├── stores/
├── utils/
└── App.vue

CREATE TABLE users (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    email VARCHAR(255) NOT NULL UNIQUE,
    display_name VARCHAR(100) NOT NULL,
    created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
    updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
-- 索引：email 已通过 UNIQUE 约束自动创建 B-tree 索引
-- 意图：email 是登录凭证，唯一约束保证账户唯一性

# ADR-001: 选择 Vue 3 作为前端框架
## Context
项目需要快速开发、团队熟悉 Vue、需求中有大量表单和列表页面。
## Decision
使用 Vue 3 + Composition API + shadcn-vue。
## Alternatives Considered
-React：更灵活但团队不熟悉，学习成本高
-Svelte：性能更好但生态不成熟
## Consequences
-正面：开发效率高、组件生态成熟、响应式系统天然适合表单
-负面：大型项目虚拟 DOM 性能不如 Svelte，需关注性能优化