File size: 3,764 Bytes
d03d74d
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
# Vault - Project Documentation Index

**Generated:** 2026-02-11  
**Project:** Vault  
**Author:** VJ  
**Scan Type:** Exhaustive Scan

---

## Documentation Overview

This documentation was generated by BMad Master to provide comprehensive reference for AI-assisted development. The project started with BMAD planning artifacts and has evolved through multiple implementation cycles.

### Available Documentation

| Document | Description |
|----------|-------------|
| [Project Overview](./project-overview.md) | High-level project summary, goals, and architecture |
| [Source Tree](./source-tree.md) | Annotated directory structure with purpose descriptions |
| [Data Models](./data-models.md) | Database schema, tables, and relationships |
| [API Contracts](./api-contracts.md) | API routes, server actions, and endpoints |
| [UI Components](./ui-components.md) | Component inventory and design system |
| [Inngest Workflows](./inngest-workflows.md) | Background job functions and event flows |
| [Development Guide](./development-guide.md) | Setup, testing, and deployment instructions |

---

## Quick Reference

### Technology Stack

| Category | Technology | Version |
|----------|------------|---------|
| Framework | Next.js (App Router) | 15.5.12 |
| Language | TypeScript | 5.x |
| Styling | Tailwind CSS | 4.x |
| UI Components | shadcn/ui + Radix | Latest |
| Database | PostgreSQL (Supabase) | - |
| ORM | Drizzle ORM | 0.45.1 |
| Authentication | Better Auth | 1.4.18 |
| Background Jobs | Inngest | 3.49.1 |
| Caching | Upstash Redis | 1.36.1 |
| AI/Vision | Google Gemini, HuggingFace | - |
| Marketplace APIs | Amazon PA-API, eBay, Etsy | - |
| Monitoring | Sentry | 10.38.0 |

### Project Structure

```
vault/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ app/              # Next.js 15 App Router pages and API routes
β”‚   β”œβ”€β”€ components/       # Shared UI components (shadcn/ui)
β”‚   β”œβ”€β”€ features/         # Feature-based modules
β”‚   β”œβ”€β”€ inngest/          # Background job functions
β”‚   β”œβ”€β”€ lib/              # Core utilities (auth, db, redis)
β”‚   └── config/           # Configuration files
β”œβ”€β”€ drizzle/              # Database migrations
β”œβ”€β”€ public/               # Static assets
└── _bmad-output/         # BMAD planning artifacts
```

### Key Features

1. **AI Object Detection** - Automated product detection from video frames
2. **Marketplace Matching** - Multi-platform affiliate link generation (Amazon, eBay, Etsy)
3. **Creator Dashboard** - Moderation queue, analytics, revenue tracking
4. **Public Vault Grid** - Mobile-first, SEO-optimized product discovery
5. **Interest Capture** - "I want this" waitlist for out-of-stock items
6. **Admin Operations** - High-ambiguity moderation, platform oversight

---

## Original BMAD Planning Artifacts

The following planning documents were created during the initial BMAD workflow and remain in `_bmad-output/planning-artifacts/`:

- [`prd.md`](../_bmad-output/planning-artifacts/prd.md) - Product Requirements Document
- [`architecture.md`](../_bmad-output/planning-artifacts/architecture.md) - Architecture Decision Document
- [`epics.md`](../_bmad-output/planning-artifacts/epics.md) - Epic and Story Breakdown
- [`product-brief-Vault-2026-02-01.md`](../_bmad-output/planning-artifacts/product-brief-Vault-2026-02-01.md) - Product Brief

---

## Implementation Status

Implementation artifacts are tracked in `_bmad-output/implementation-artifacts/`:

- Sprint status: [`sprint-status.yaml`](../_bmad-output/implementation-artifacts/sprint-status.yaml)
- Story files: Individual story markdown files

---

*This documentation is maintained for AI-assisted development. For the most current implementation details, refer to the source code.*