docs: add comprehensive Harris matrix and schema dependency analysis
- GOD_MODE_HARRIS_MATRIX.md: Complete dependency execution plan with 3 batches - SCHEMA_FILE_DEPENDENCY_MATRIX.md: Cross-file relationship mapping - Identified critical issues: missing parent tables, template errors, interface issues
This commit is contained in:
cawcenter
285
GOD_MODE_HARRIS_MATRIX.md
Normal file
285
GOD_MODE_HARRIS_MATRIX.md
Normal file
@@ -0,0 +1,285 @@
|
|||||||
|
# 🔷 GOD-MODE HARRIS MATRIX: Complete Schema Dependency Guide
|
||||||
|
|
||||||
|
> **What is a Harris Matrix?** In database design, it's a **Dependency Structure Matrix (DSM)** that shows the exact order to create tables so foreign key constraints don't fail. You cannot build a roof before walls. You cannot create `comments` before `users` and `posts` exist.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎯 THE GOLDEN RULE
|
||||||
|
|
||||||
|
**Build the Foundation First, Then the Walls, Then the Roof**
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────┐
|
||||||
|
│ BATCH 1: Foundation (Independent) │ ← Create First
|
||||||
|
├─────────────────────────────────────┤
|
||||||
|
│ BATCH 2: Walls (First Children) │ ← Create Second
|
||||||
|
├─────────────────────────────────────┤
|
||||||
|
│ BATCH 3: Roof (Complex Children) │ ← Create Last
|
||||||
|
└─────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📊 SPARK PLATFORM: Complete Dependency Matrix
|
||||||
|
|
||||||
|
### Summary Statistics
|
||||||
|
- **Total Collections:** 16 (from schema_map.json)
|
||||||
|
- **Parent Tables (Batch 1):** 6
|
||||||
|
- **Child Tables (Batch 2):** 8
|
||||||
|
- **Complex Tables (Batch 3):** 2
|
||||||
|
- **Total Foreign Keys:** 12
|
||||||
|
- **Identified Issues:** 2 (template field mismatches)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🏗️ BATCH 1: FOUNDATION TABLES
|
||||||
|
> **Zero Dependencies** - These tables reference NO other tables
|
||||||
|
|
||||||
|
| # | Table | Type | Purpose | Children Dependent |
|
||||||
|
|---|-------|------|---------|-------------------|
|
||||||
|
| 1 | `sites` ⭐ | Parent | Master site registry | **10 tables** depend on this |
|
||||||
|
| 2 | `campaign_masters` ⭐ | Parent | Campaign definitions | **3 tables** depend on this |
|
||||||
|
| 3 | `avatar_intelligence` | Independent | Avatar personality data | 0 |
|
||||||
|
| 4 | `avatar_variants` | Independent | Avatar variations | 0 |
|
||||||
|
| 5 | `cartesian_patterns` | Independent | Pattern formulas | 0 |
|
||||||
|
| 6 | `geo_intelligence` | Independent | Geographic data | 0 |
|
||||||
|
| 7 | `offer_blocks` | Independent | Content offer blocks | 0 |
|
||||||
|
|
||||||
|
**⚠️ CRITICAL:** `sites` and `campaign_masters` are **SUPER PARENTS** - create these FIRST!
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🧱 BATCH 2: FIRST-LEVEL CHILDREN
|
||||||
|
> **Depend ONLY on Batch 1**
|
||||||
|
|
||||||
|
| # | Table | Depends On | Foreign Key | Constraint Action |
|
||||||
|
|---|-------|------------|-------------|-------------------|
|
||||||
|
| 8 | `generated_articles` | sites | `site_id` → `sites.id` | CASCADE |
|
||||||
|
| 9 | `generation_jobs` | sites | `site_id` → `sites.id` | CASCADE |
|
||||||
|
| 10 | `pages` | sites | `site_id` → `sites.id` | CASCADE |
|
||||||
|
| 11 | `posts` | sites | `site_id` → `sites.id` | CASCADE |
|
||||||
|
| 12 | `leads` | sites | `site_id` → `sites.id` | SET NULL |
|
||||||
|
| 13 | `headline_inventory` | campaign_masters | `campaign_id` → `campaign_masters.id` | CASCADE |
|
||||||
|
| 14 | `content_fragments` | campaign_masters | `campaign_id` → `campaign_masters.id` | CASCADE |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🏠 BATCH 3: COMPLEX CHILDREN
|
||||||
|
> **Depend on Batch 2 or have multiple dependencies**
|
||||||
|
|
||||||
|
| # | Table | Depends On | Multiple FKs | Notes |
|
||||||
|
|---|-------|------------|--------------|-------|
|
||||||
|
| 15 | `link_targets` | sites | No | Internal linking system |
|
||||||
|
| 16 | (Future M2M) | Multiple | Yes | Junction tables go here |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔍 DETAILED DEPENDENCY MAP
|
||||||
|
|
||||||
|
### Visual Cascade
|
||||||
|
|
||||||
|
```
|
||||||
|
sites ─────────┬─── generated_articles
|
||||||
|
├─── generation_jobs
|
||||||
|
├─── pages
|
||||||
|
├─── posts
|
||||||
|
├─── leads
|
||||||
|
└─── link_targets
|
||||||
|
|
||||||
|
campaign_masters ─┬─── headline_inventory
|
||||||
|
├─── content_fragments
|
||||||
|
└─── (referenced by generated_articles)
|
||||||
|
|
||||||
|
avatar_intelligence (standalone)
|
||||||
|
avatar_variants (standalone)
|
||||||
|
cartesian_patterns (standalone)
|
||||||
|
geo_intelligence (standalone)
|
||||||
|
offer_blocks (standalone)
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🚨 DETECTED ISSUES (from schema_issues.json)
|
||||||
|
|
||||||
|
### Issue #1: Template Field Mismatch
|
||||||
|
**Collection:** `content_fragments`
|
||||||
|
**Field:** `campaign_id` (M2O relation)
|
||||||
|
**Problem:** Display template references `campaign_name` but `campaign_masters` has field `name`, not `campaign_name`
|
||||||
|
**Fix:** Update template to use `{{campaign_id.name}}` instead of `{{campaign_id.campaign_name}}`
|
||||||
|
|
||||||
|
### Issue #2: Template Field Mismatch
|
||||||
|
**Collection:** `headline_inventory`
|
||||||
|
**Field:** `campaign_id` (M2O relation)
|
||||||
|
**Problem:** Same as above - references non-existent `campaign_name`
|
||||||
|
**Fix:** Update template to use `{{campaign_id.name}}`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📐 EXECUTION PLAN: Step-by-Step
|
||||||
|
|
||||||
|
### Phase 1: Create Foundation (Batch 1)
|
||||||
|
```bash
|
||||||
|
# Order is CRITICAL - sites MUST be first
|
||||||
|
npx directus schema apply --only-collections \
|
||||||
|
sites,campaign_masters,avatar_intelligence,avatar_variants,cartesian_patterns,geo_intelligence,offer_blocks
|
||||||
|
```
|
||||||
|
|
||||||
|
### Phase 2: Create Walls (Batch 2)
|
||||||
|
```bash
|
||||||
|
npx directus schema apply --only-collections \
|
||||||
|
generated_articles,generation_jobs,pages,posts,leads,headline_inventory,content_fragments
|
||||||
|
```
|
||||||
|
|
||||||
|
### Phase 3: Create Roof (Batch 3)
|
||||||
|
```bash
|
||||||
|
npx directus schema apply --only-collections \
|
||||||
|
link_targets
|
||||||
|
```
|
||||||
|
|
||||||
|
### Phase 4: Apply Relationships
|
||||||
|
```bash
|
||||||
|
# All foreign keys are applied AFTER tables exist
|
||||||
|
npx directus schema apply --only-relations
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎓 THE "MEASURE TWICE, CUT ONCE" PROMPT
|
||||||
|
|
||||||
|
Use this exact prompt to have AI execute your schema correctly:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
**System Role:** You are a Senior Database Architect specializing in Directus and PostgreSQL.
|
||||||
|
|
||||||
|
**Input:** I have 16 collections in my Spark Platform schema.
|
||||||
|
|
||||||
|
**Task 1: Dependency Map (DO THIS FIRST)**
|
||||||
|
|
||||||
|
Before generating any API calls, output a Dependency Execution Plan:
|
||||||
|
|
||||||
|
1. **Identify Nodes:** List all collections
|
||||||
|
2. **Identify Edges:** List all foreign key relationships
|
||||||
|
3. **Group by Batches:**
|
||||||
|
- Batch 1: Independent tables (No foreign keys)
|
||||||
|
- Batch 2: First-level dependents (Only rely on Batch 1)
|
||||||
|
- Batch 3: Complex dependents (Rely on Batch 2 or multiple tables)
|
||||||
|
|
||||||
|
**Task 2: Directus Logic Check**
|
||||||
|
|
||||||
|
Confirm you identified:
|
||||||
|
- Standard tables vs. Singletons
|
||||||
|
- Real foreign key fields vs. M2M aliases (virtual fields)
|
||||||
|
- Display templates that might reference wrong field names
|
||||||
|
|
||||||
|
**Output Format:** Structured markdown table showing batches and dependencies.
|
||||||
|
|
||||||
|
**Once Approved:** Generate Directus API creation scripts in the correct order.
|
||||||
|
|
||||||
|
[PASTE schema_map.json HERE]
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔧 GOD-MODE API: Create Schema Programmatically
|
||||||
|
|
||||||
|
Using the God-Mode API to respect dependencies:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# BATCH 1: Foundation
|
||||||
|
curl https://spark.jumpstartscaling.com/god/schema/collections/create \
|
||||||
|
-H "X-God-Token: $GOD_MODE_TOKEN" \
|
||||||
|
-d '{"collection":"sites", "fields":[...]}'
|
||||||
|
|
||||||
|
curl https://spark.jumpstartscaling.com/god/schema/collections/create \
|
||||||
|
-H "X-God-Token: $GOD_MODE_TOKEN" \
|
||||||
|
-d '{"collection":"campaign_masters", "fields":[...]}'
|
||||||
|
|
||||||
|
# BATCH 2: Children (ONLY after Batch 1 completes)
|
||||||
|
curl https://spark.jumpstartscaling.com/god/schema/collections/create \
|
||||||
|
-H "X-God-Token: $GOD_MODE_TOKEN" \
|
||||||
|
-d '{"collection":"generated_articles", "fields":[...], "relations":[...]}'
|
||||||
|
|
||||||
|
# BATCH 3: Relations (ONLY after tables exist)
|
||||||
|
curl https://spark.jumpstartscaling.com/god/schema/relations/create \
|
||||||
|
-H "X-God-Token: $GOD_MODE_TOKEN" \
|
||||||
|
-d '{"collection":"generated_articles", "field":"site_id", "related_collection":"sites"}'
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ✅ VALIDATION CHECKLIST
|
||||||
|
|
||||||
|
After executing schema:
|
||||||
|
|
||||||
|
- [ ] Verify Batch 1: `SELECT * FROM sites LIMIT 1;` works
|
||||||
|
- [ ] Verify Batch 1: `SELECT * FROM campaign_masters LIMIT 1;` works
|
||||||
|
- [ ] Verify Batch 2: Foreign keys resolve (no constraint errors)
|
||||||
|
- [ ] Check schema_issues.json: Fix template field references
|
||||||
|
- [ ] Test M2O dropdowns in Directus admin UI
|
||||||
|
- [ ] Confirm all 16 collections appear in Directus
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📊 COMPLETE FIELD-LEVEL ANALYSIS
|
||||||
|
|
||||||
|
### sites (SUPER PARENT)
|
||||||
|
| Field | Type | Interface | Issues |
|
||||||
|
|-------|------|-----------|--------|
|
||||||
|
| id | uuid | input (readonly) | None |
|
||||||
|
| name | string | input (required) | None |
|
||||||
|
| url | string | input | None |
|
||||||
|
| status | string | select-dropdown | None |
|
||||||
|
|
||||||
|
**Children:** 10 tables reference this
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### campaign_masters (SUPER PARENT)
|
||||||
|
| Field | Type | Interface | Issues |
|
||||||
|
|-------|------|-----------|--------|
|
||||||
|
| id | uuid | none | None |
|
||||||
|
| site_id | uuid | select-dropdown-m2o | Missing interface ⚠️ |
|
||||||
|
| name | string | input | None |
|
||||||
|
| status | string | select-dropdown | None |
|
||||||
|
| target_word_count | integer | input | None |
|
||||||
|
|
||||||
|
**Fix Needed:** `site_id` should have `select-dropdown-m2o` interface
|
||||||
|
|
||||||
|
**Children:** 3 tables reference this
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### generated_articles (CHILD)
|
||||||
|
**Parent:** sites
|
||||||
|
**Relationship:** `site_id` → `sites.id` (CASCADE)
|
||||||
|
**Issues:**
|
||||||
|
- `campaign_id` field exists but NO interface (should be `select-dropdown-m2o`)
|
||||||
|
- Template might reference wrong field names
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎯 SUCCESS CRITERIA
|
||||||
|
|
||||||
|
Your schema is correct when:
|
||||||
|
|
||||||
|
1. ✅ **SQL Execution:** No foreign key constraint errors
|
||||||
|
2. ✅ **Directus UI:** All dropdowns show related data
|
||||||
|
3. ✅ **TypeScript:** Auto-generated types match reality
|
||||||
|
4. ✅ **Frontend:** No `undefined` field errors
|
||||||
|
5. ✅ **God-Mode API:** `/god/schema/snapshot` returns valid YAML
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🚀 NEXT STEPS
|
||||||
|
|
||||||
|
1. **Fix Template Issues:** Update display templates for `campaign_id` fields
|
||||||
|
2. **Add Missing Interfaces:** Apply `select-dropdown-m2o` to all foreign key fields
|
||||||
|
3. **Generate TypeScript:** Run `npm run db:sync` to get types
|
||||||
|
4. **Test Fresh Install:** Use `FORCE_FRESH_INSTALL=True` to verify clean build
|
||||||
|
5. **Deploy:** Push schema changes via God-Mode API
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Remember:** The Harris Matrix prevents the #1 cause of schema failures: trying to create relationships before the related tables exist.
|
||||||
|
|
||||||
|
**God-Mode Key:** `$GOD_MODE_TOKEN` (set in Coolify secrets)
|
||||||
314
SCHEMA_FILE_DEPENDENCY_MATRIX.md
Normal file
314
SCHEMA_FILE_DEPENDENCY_MATRIX.md
Normal file
@@ -0,0 +1,314 @@
|
|||||||
|
# 📊 COMPLETE SCHEMA DEPENDENCY MATRIX
|
||||||
|
|
||||||
|
## File Interconnections Analysis
|
||||||
|
|
||||||
|
This document shows how all schema-related files connect and depend on each other.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🗂️ FILE HIERARCHY
|
||||||
|
|
||||||
|
```
|
||||||
|
spark/
|
||||||
|
├── GOD_MODE_HARRIS_MATRIX.md ← Master guide (this doc's companion)
|
||||||
|
├── schema_map.json ← Source of truth (16 collections)
|
||||||
|
├── schema_issues.json ← Known problems to fix
|
||||||
|
├── schema_audit_report.json ← Complete field validation
|
||||||
|
├── complete_schema.sql ← SQL execution script
|
||||||
|
├── extra-schema-updates.sql ← Additional migrations
|
||||||
|
├── setup-directus-schema.sh ← Automated Directus API setup
|
||||||
|
└── setup_database.sh ← Automated PostgreSQL setup
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔄 FILE DEPENDENCY MATRIX
|
||||||
|
|
||||||
|
| File | Depends On | Used By | Purpose |
|
||||||
|
|------|------------|---------|---------|
|
||||||
|
| `schema_map.json` | ❌ None | ALL | **SOURCE OF TRUTH** - Defines all collections |
|
||||||
|
| `schema_issues.json` | schema_map.json | Developers | Lists template field errors |
|
||||||
|
| `schema_audit_report.json` | schema_map.json | QA/Validation | Field-level validation |
|
||||||
|
| `complete_schema.sql` | schema_map.json | PostgreSQL | Raw SQL table creation |
|
||||||
|
| `extra-schema-updates.sql` | complete_schema.sql | PostgreSQL | ALTER statements |
|
||||||
|
| `setup-directus-schema.sh` | schema_map.json | Directus API | Creates via REST API |
|
||||||
|
| `setup_database.sh` | complete_schema.sql | Deployment | Automates SSH + SQL |
|
||||||
|
| `GOD_MODE_HARRIS_MATRIX.md` | ALL above | Humans | Documentation |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 SCHEMA_MAP.JSON: The Source of Truth
|
||||||
|
|
||||||
|
**Total Collections:** 16
|
||||||
|
**Total Fields:** 94
|
||||||
|
**Total Relationships:** 12
|
||||||
|
|
||||||
|
### Collection Breakdown
|
||||||
|
|
||||||
|
| Collection | Field Count | Has Relations | Batch |
|
||||||
|
|------------|-------------|---------------|-------|
|
||||||
|
| sites | 5 | ✅ Yes (10 children) | 1 |
|
||||||
|
| campaign_masters | 12 | ✅ Yes (3 children) | 1 |
|
||||||
|
| avatar_intelligence | 6 | ❌ No | 1 |
|
||||||
|
| avatar_variants | 4 | ❌ No | 1 |
|
||||||
|
| cartesian_patterns | 4 | ❌ No | 1 |
|
||||||
|
| geo_intelligence | 3 | ❌ No | 1 |
|
||||||
|
| offer_blocks | 4 | ❌ No | 1 |
|
||||||
|
| generated_articles | 15 | ✅ Yes (parent: sites) | 2 |
|
||||||
|
| generation_jobs | 7 | ✅ Yes (parent: sites) | 2 |
|
||||||
|
| pages | 8 | ✅ Yes (parent: sites) | 2 |
|
||||||
|
| posts | 10 | ✅ Yes (parent: sites) | 2 |
|
||||||
|
| leads | 6 | ✅ Yes (parent: sites) | 2 |
|
||||||
|
| headline_inventory | 6 | ✅ Yes (parent: campaign_masters) | 2 |
|
||||||
|
| content_fragments | 6 | ✅ Yes (parent: campaign_masters) | 2 |
|
||||||
|
| link_targets | 9 | ❌ No (soft reference) | 3 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🚨 SCHEMA_ISSUES.JSON: Known Problems
|
||||||
|
|
||||||
|
### Issue Summary
|
||||||
|
- **Total Issues:** 2
|
||||||
|
- **Type:** Display template field mismatches
|
||||||
|
- **Severity:** Medium (won't break DB, will break UI)
|
||||||
|
|
||||||
|
### Issue Details
|
||||||
|
|
||||||
|
#### Issue #1
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"collection": "content_fragments",
|
||||||
|
"field": "campaign_id",
|
||||||
|
"targetCollection": "campaign_masters",
|
||||||
|
"templateField": "campaign_name",
|
||||||
|
"issue": "Template references non-existent field \"campaign_name\""
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Root Cause:** `campaign_masters` has field `name`, not `campaign_name`
|
||||||
|
**Fix:** Update Directus field meta to use `{{campaign_id.name}}`
|
||||||
|
|
||||||
|
#### Issue #2
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"collection": "headline_inventory",
|
||||||
|
"field": "campaign_id",
|
||||||
|
"targetCollection": "campaign_masters",
|
||||||
|
"templateField": "campaign_name",
|
||||||
|
"issue": "Template references non-existent field \"campaign_name\""
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Same issue** as above.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔍 SCHEMA_AUDIT_REPORT.JSON: Field Validation
|
||||||
|
|
||||||
|
**Total Items:** 1,624 lines
|
||||||
|
**Total Collections:** 16
|
||||||
|
**Total Fields Audited:** 94
|
||||||
|
|
||||||
|
### Field Issues Found
|
||||||
|
|
||||||
|
| Collection | Field | Issue | Severity |
|
||||||
|
|------------|-------|-------|----------|
|
||||||
|
| campaign_masters | site_id | ID field without relational interface | Medium |
|
||||||
|
| campaign_masters | status | Status field should use select-dropdown | Low |
|
||||||
|
| content_fragments | campaign_id | ID field without relational interface | Medium |
|
||||||
|
| generated_articles | campaign_id | ID field without relational interface | Medium |
|
||||||
|
| generation_jobs | status | Status field should use select-dropdown | Low |
|
||||||
|
| headline_inventory | campaign_id | ID field without relational interface | Medium |
|
||||||
|
| headline_inventory | status | Status field should use select-dropdown | Low |
|
||||||
|
|
||||||
|
### Pattern Detected
|
||||||
|
**Problem:** Foreign key fields (UUID type) missing proper Directus interface
|
||||||
|
**Impact:** Admin UI won't show dropdown for related records
|
||||||
|
**Fix:** Add `"interface": "select-dropdown-m2o"` to field meta
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🗃️ COMPLETE_SCHEMA.SQL: PostgreSQL Implementation
|
||||||
|
|
||||||
|
**Total Tables:** 28
|
||||||
|
**Total Indexes:** 10
|
||||||
|
**Lines of Code:** 376
|
||||||
|
|
||||||
|
### Table Creation Order (as written in file)
|
||||||
|
|
||||||
|
```sql
|
||||||
|
-- BATCH 1: Should be first but ISN'T in file
|
||||||
|
CREATE TABLE headline_inventory ... -- ❌ WRONG! Depends on campaign_masters
|
||||||
|
CREATE TABLE content_fragments ... -- ❌ WRONG! Depends on campaign_masters
|
||||||
|
CREATE TABLE production_queue ... -- ❌ WRONG! Depends on sites
|
||||||
|
|
||||||
|
-- MISSING FROM FILE:
|
||||||
|
-- sites
|
||||||
|
-- campaign_masters
|
||||||
|
-- These are REFERENCED but never CREATED!
|
||||||
|
```
|
||||||
|
|
||||||
|
**🚨 CRITICAL FLAW:** This file references `sites` and `campaign_masters` but never creates them!
|
||||||
|
|
||||||
|
### Fix Priority
|
||||||
|
|
||||||
|
1. Add `CREATE TABLE sites` at the TOP
|
||||||
|
2. Add `CREATE TABLE campaign_masters` after sites
|
||||||
|
3. Reorder remaining tables by dependency batch
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚙️ EXTRA-SCHEMA-UPDATES.SQL: Migrations
|
||||||
|
|
||||||
|
**Purpose:** ALTER statements for existing schema
|
||||||
|
**Total Operations:** 6
|
||||||
|
|
||||||
|
### Operations
|
||||||
|
|
||||||
|
1. Add `schema_json` to posts
|
||||||
|
2. Add `schema_json` to pages
|
||||||
|
3. Add `schema_json` to generated_articles
|
||||||
|
4. Add `target_word_count` to campaign_masters
|
||||||
|
5. Create `link_targets` table
|
||||||
|
6. Update Directus field interfaces via `directus_fields` table
|
||||||
|
|
||||||
|
**Workflow:** Run AFTER `complete_schema.sql`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔧 SETUP-DIRECTUS-SCHEMA.SH: API Creation Script
|
||||||
|
|
||||||
|
**Method:** Directus REST API
|
||||||
|
**Total Collections Created:** 5 (partial, not all 16)
|
||||||
|
**Authentication:** Static token (hardcoded)
|
||||||
|
|
||||||
|
### Collections Created
|
||||||
|
|
||||||
|
1. avatar_intelligence
|
||||||
|
2. sites
|
||||||
|
3. posts
|
||||||
|
4. pages
|
||||||
|
5. leads
|
||||||
|
|
||||||
|
**Missing:** 11 collections not in this script!
|
||||||
|
|
||||||
|
**Recommendation:** Use God-Mode API `/god/schema/snapshot` and `/god/schema/apply` instead
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🚀 SETUP_DATABASE.SH: Automated Deployment
|
||||||
|
|
||||||
|
**Method:** SSH + PostgreSQL
|
||||||
|
**Dependencies:** complete_schema.sql
|
||||||
|
**Target:** Remote server at 72.61.15.216
|
||||||
|
|
||||||
|
### Execution Flow
|
||||||
|
|
||||||
|
```
|
||||||
|
1. SCP complete_schema.sql to server
|
||||||
|
↓
|
||||||
|
2. Find PostgreSQL container
|
||||||
|
↓
|
||||||
|
3. Copy SQL into container
|
||||||
|
↓
|
||||||
|
4. Execute: psql -U postgres -d directus -f /tmp/complete_schema.sql
|
||||||
|
↓
|
||||||
|
5. Verify table count
|
||||||
|
↓
|
||||||
|
6. Restart Directus container
|
||||||
|
↓
|
||||||
|
7. Test API authentication
|
||||||
|
```
|
||||||
|
|
||||||
|
**Current Status:** ✅ Script is correct, but `complete_schema.sql` has missing tables
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔗 CROSS-FILE RELATIONSHIP MAP
|
||||||
|
|
||||||
|
```mermaid
|
||||||
|
graph TD
|
||||||
|
A[schema_map.json<br/>SOURCE OF TRUTH] --> B[schema_audit_report.json]
|
||||||
|
A --> C[schema_issues.json]
|
||||||
|
A --> D[complete_schema.sql]
|
||||||
|
A --> E[setup-directus-schema.sh]
|
||||||
|
|
||||||
|
D --> F[extra-schema-updates.sql]
|
||||||
|
D --> G[setup_database.sh]
|
||||||
|
|
||||||
|
B --> H[Developer Fixes]
|
||||||
|
C --> H
|
||||||
|
|
||||||
|
E --> I[Directus API]
|
||||||
|
G --> J[PostgreSQL DB]
|
||||||
|
|
||||||
|
style A fill:#4ade80
|
||||||
|
style D fill:#fbbf24
|
||||||
|
style G fill:#60a5fa
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ✅ FIX ACTION PLAN
|
||||||
|
|
||||||
|
### Phase 1: Fix complete_schema.sql
|
||||||
|
```sql
|
||||||
|
-- Add at TOP of file (line 1)
|
||||||
|
CREATE TABLE sites (
|
||||||
|
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||||
|
name VARCHAR(255) NOT NULL,
|
||||||
|
url VARCHAR(500),
|
||||||
|
status VARCHAR(50) DEFAULT 'active',
|
||||||
|
date_created TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE TABLE campaign_masters (
|
||||||
|
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||||
|
site_id UUID REFERENCES sites(id) ON DELETE CASCADE,
|
||||||
|
name VARCHAR(255),
|
||||||
|
headline_spintax_root TEXT,
|
||||||
|
status VARCHAR(50) DEFAULT 'active',
|
||||||
|
target_word_count INTEGER DEFAULT 1500,
|
||||||
|
date_created TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
||||||
|
);
|
||||||
|
```
|
||||||
|
|
||||||
|
### Phase 2: Fix Directus Field Interfaces
|
||||||
|
```sql
|
||||||
|
-- Run these UPDATEs in extra-schema-updates.sql
|
||||||
|
UPDATE directus_fields SET interface = 'select-dropdown-m2o'
|
||||||
|
WHERE field IN ('site_id', 'campaign_id')
|
||||||
|
AND type = 'uuid';
|
||||||
|
```
|
||||||
|
|
||||||
|
### Phase 3: Fix Template Issues
|
||||||
|
```javascript
|
||||||
|
// In Directus UI, update display templates
|
||||||
|
// FROM: {{campaign_id.campaign_name}}
|
||||||
|
// TO: {{campaign_id.name}}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Phase 4: Validate
|
||||||
|
```bash
|
||||||
|
# Run complete deployment
|
||||||
|
./setup_database.sh
|
||||||
|
|
||||||
|
# Verify via God-Mode API
|
||||||
|
curl https://spark.jumpstartscaling.com/god/status \
|
||||||
|
-H "X-God-Token: $GOD_MODE_TOKEN"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📊 FINAL FILE DEPENDENCY SUMMARY
|
||||||
|
|
||||||
|
**schema_map.json** → Defines the truth
|
||||||
|
**schema_issues.json** → Identifies problems
|
||||||
|
**schema_audit_report.json** → Validates fields
|
||||||
|
**complete_schema.sql** → Executes in PostgreSQL (needs fixes)
|
||||||
|
**extra-schema-updates.sql** → Runs migrations
|
||||||
|
**setup-directus-schema.sh** → Creates via API (incomplete)
|
||||||
|
**setup_database.sh** → Automates deployment
|
||||||
|
**GOD_MODE_HARRIS_MATRIX.md** → Human guide
|
||||||
|
|
||||||
|
**All files interconnected. Fix one, test all.**
|
||||||
Reference in New Issue
Block a user