Back to .md Directory

MEMOPYK Blog System - Comprehensive Report

**Date:** November 17, 2025

May 2, 2026
0 downloads
0 views
ai prompt claude workflow
View source

MEMOPYK Blog System - Comprehensive Report

Date: November 17, 2025
Purpose: Team discussion on integrating existing blog system with new Content Production Planner


EXECUTIVE SUMMARY

MEMOPYK currently has a fully functional, production-ready blog management system with AI-assisted content creation, rich-text editing, and comprehensive SEO management. The system is built directly into the admin interface and supports bilingual (EN/FR) content with Supabase PostgreSQL as the primary database.

Key Metrics:

  • 102 pre-researched blog topics ready for production
  • 3-tab interface: Manage Posts, Create a Post (AI), Tags
  • Full workflow: Draft → In Review → Published
  • Zero external dependencies (self-contained in MEMOPYK admin)

CURRENT SYSTEM ARCHITECTURE

1. Database Schema (Supabase PostgreSQL)

Core Tables:

blog_posts
├── id (uuid, primary key)
├── title, slug, language (en-US | fr-FR)
├── status (draft | in_review | published)
├── content_html (full HTML content)
├── description (excerpt/summary)
├── hero_url, hero_caption
├── read_time_minutes
├── seo (jsonb: title, description, keywords, og_image)
├── is_featured, featured_order
├── published_at (timestamp)
├── source_topic_id (links to content_topics)
├── generation_prompt, generation_date
├── primary_keyword, secondary_keywords
├── created_at, updated_at

blog_tags
├── id, name, slug, color, icon

blog_post_tags
├── post_id → blog_posts.id
├── tag_id → blog_tags.id

blog_post_views (analytics)
├── post_slug, session_id, language
├── time_on_page, created_at

Integration Point: The source_topic_id field already exists to link blog posts to the Content Production Topics system we just built.


2. User Interface Components

A) Blog Management Hub (BlogManagement.tsx)

3-tab navigation system:

  • Tab 1: Manage Posts - List, search, edit, delete posts
  • Tab 2: Create a Post (AI) - AI-assisted content generation
  • Tab 3: Tags - Manage topic tags

B) AI Blog Creator (BlogAICreator.tsx)

4-Step Workflow:

Step 1: Configure

  • Topic input
  • Language selection (EN/FR)
  • Status (draft/in_review/published)
  • Publish date picker
  • SEO keywords
  • Tag selection

Step 2: Generate Prompt

  • Click "Generate Prompt" → Creates AI-ready prompt
  • Uses master template with placeholders:
    • {{TOPIC}}, {{LOCALE}}, {{STATUS}}, {{SEO_KEYWORDS}}
  • Includes detailed HTML structure guidelines
  • Enforces JSON output format

Step 3: AI Response → Validation

  • User copies prompt → Uses external AI (Claude, ChatGPT)
  • Pastes AI's JSON response → System validates:
    • ✅ Required fields (title, slug, language, status, content, seo)
    • ✅ Language enum matches
    • ✅ Status enum matches
    • ✅ SEO structure correct
  • If validation passes → Unlock Step 4

Step 4: Refine & Publish

  • TinyMCE WYSIWYG editor with full formatting
  • Edit title, slug, description
  • Upload hero image to Supabase Storage
  • Tag assignment
  • Featured post toggle
  • Click "Publish to Supabase" → Creates blog post in database

C) Blog Editor (BlogEditor.tsx)

Full-featured editor for existing posts:

  • TinyMCE rich text editor with custom toolbar
  • Image upload & management:
    • Upload new images to Supabase Storage
    • Browse existing images in modal picker
    • Search images by filename
  • Hero image upload/replace
  • Tag management (add/remove)
  • Status updates (draft → in_review → published)
  • Featured post settings
  • Translation Assistant button:
    • Launches AI-assisted translation modal
    • Preserves HTML structure
    • Maintains image placeholders
  • Save & Preview buttons

3. Content Creation Workflow

Current Process:

1. Admin clicks "Create a Post" tab
2. Fills in: Topic, Language, SEO Keywords, Tags
3. Clicks "Generate Prompt" → Copies prompt
4. Opens external AI assistant (Claude.ai, ChatGPT, etc.)
5. Pastes prompt → AI generates JSON response
6. Copies AI JSON → Pastes into "AI Response" textarea
7. Clicks "Validate & Edit" → System validates JSON
8. If valid → Unlocks TinyMCE editor
9. Refines content, uploads hero image, assigns tags
10. Clicks "Publish to Supabase" → Post created
11. Post appears in "Manage Posts" tab

Time Estimate: 15-20 minutes per post (including AI generation)


TECHNICAL STRENGTHS

✅ What Works Well

  1. Self-Contained System

    • No external CMS dependencies (like WordPress, Directus)
    • Direct Supabase integration
    • Admin interface built-in
  2. Bilingual Architecture

    • Separate EN/FR posts
    • Language-specific SEO
    • Proper URL structure
  3. SEO Optimization

    • Meta titles/descriptions
    • Open Graph tags
    • Twitter Cards
    • Structured JSON-LD
    • Keywords management
  4. Rich Content Editing

    • TinyMCE with full formatting
    • Image upload to Supabase Storage
    • Image library browser
    • HTML sanitization (DOMPurify)
  5. Analytics Integration

    • Blog post views tracked
    • Time on page
    • Popular posts dashboard
    • Language filtering
  6. Future-Ready Schema

    • source_topic_id field exists
    • generation_prompt field tracks AI prompts
    • generation_date timestamps

CURRENT GAPS & OPPORTUNITIES

🔶 Areas for Improvement

  1. No Calendar/Planning Integration

    • AI Creator works per-post
    • No weekly scheduling
    • No visual content calendar
    • ← This is what we just built!
  2. Manual AI Workflow

    • User must copy/paste between systems
    • External AI dependency (Claude.ai)
    • No direct API integration
    • 2-step validation process
  3. Limited Topic Management

    • 102 topics exist in backlog
    • No filtering by category
    • No priority system
    • No status tracking (backlog → planned)
    • ← We just built this!
  4. Keyword Research Disconnect

    • Keywords entered manually
    • No link to keyword database
    • No search volume data shown
    • ← We have keyword tables built
  5. No Batch Operations

    • One post at a time
    • No bulk status updates
    • No bulk tag assignment
  6. Image Workflow

    • Manual upload per post
    • No image bank integration
    • No reuse tracking
    • ← We have image_bank table

INTEGRATION WITH CONTENT PRODUCTION PLANNER

What We Just Built (Last 3 Hours):

  1. Weekly Planning Calendar

    • Monday-Sunday view with week navigation
    • Click day → Assign topic modal
    • Visual badges: Category, Keyword, Word Count, Priority, Type
  2. Topic Management

    • 102 topics in database
    • Filter by search, category, status
    • Auto-status updates (backlog → planned)
  3. Database Schema

    • content_topics (102 rows)
    • content_keywords (keyword research)
    • content_daily_assignments (calendar)
    • content_weekly_plans (planning)
    • content_image_bank (asset management)

Integration Pathways:

Option 1: Calendar-First Workflow (Recommended)

Weekly Planner → Assign Topic to Day → "Create Post" Button → 
Pre-filled AI Creator → Generate → Edit → Publish

Benefits:

  • Topics pre-selected from calendar
  • Keyword/word count pre-filled
  • Status auto-set to "planned"
  • Links post to source_topic_id

Changes Needed:

  • Add "Create Post" button to calendar assignments
  • Pre-fill AI Creator from topic data
  • Update post status when published

Option 2: Topic Management Integration

Content Production Topics → Select Topic → "Generate Post" → 
AI Creator with pre-filled data → Publish → Update topic status

Benefits:

  • Direct topic → post workflow
  • Status tracking (backlog → in_progress → completed)
  • Clear progress visibility

Changes Needed:

  • Add "Generate Post" action to topics table
  • Track which topics have posts created
  • Link post back to topic

Option 3: Enhanced AI Creator

Enhance existing AI Creator with:

  • Dropdown: "Select from Content Topics"
  • Auto-fill: Title, keywords, word count, category
  • Link: Create relationship to topic
  • Update: Mark topic as "in_progress"

Benefits:

  • Minimal UI changes
  • Backwards compatible
  • Optional feature

RECOMMENDATIONS FOR TEAM DISCUSSION

🎯 Strategic Questions:

  1. Which workflow fits your team best?

    • Calendar-first (assign days → create posts)?
    • Topic-first (manage backlog → create posts)?
    • Keep separate (planning vs. execution)?
  2. AI Integration Preference:

    • Keep external AI (Claude.ai) + copy/paste?
    • Add direct OpenAI API integration?
    • Hybrid (both options available)?
  3. Timeline Priorities:

    • Connect calendar to post creation?
    • Add keyword database to AI Creator?
    • Build image bank integration?
  4. Batch Operations:

    • Need bulk post creation from weekly plan?
    • Auto-generate posts for assigned days?
    • Schedule posts to publish dates?

💡 Quick Wins (Low Effort, High Impact):

  1. Add "Create Post" button to weekly calendar

    • Links to AI Creator with topic pre-filled
    • Takes 1-2 hours to implement
  2. Show keyword data in AI Creator

    • Dropdown search from keywords table
    • Auto-fill primary/secondary keywords
    • Takes 2-3 hours to implement
  3. Link posts back to topics

    • Update source_topic_id when creating post
    • Show "Post Created" badge in topics table
    • Takes 1 hour to implement
  4. Status synchronization

    • Topic status → "in_progress" when post created
    • Topic status → "completed" when post published
    • Takes 1 hour to implement

🚀 Advanced Features (Higher Effort):

  1. Direct AI API Integration

    • OpenAI/Claude API calls
    • Eliminate copy/paste step
    • Estimated: 6-8 hours
  2. Automated Posting

    • Bulk generate posts from weekly plan
    • Schedule to published_at dates
    • Estimated: 8-10 hours
  3. Image Bank Integration

    • Suggest images from bank when creating posts
    • Track image usage
    • Estimated: 4-6 hours
  4. Translation Workflow

    • Auto-create FR version from EN post
    • AI-assisted translation
    • Estimated: 6-8 hours

CURRENT SYSTEM METRICS

Posts Created:

  • Check with: SELECT COUNT(*) FROM blog_posts;

Tags Available:

  • Managed through Tags tab
  • Full CRUD interface

Analytics:

  • Post views tracked
  • Popular posts dashboard
  • Language filtering (7d, 30d, 90d)

NEXT STEPS

For This Meeting:

  1. Review Current Blog System (you're here! ✅)
  2. Discuss Integration Preferences
    • Which workflow pathway?
    • Priority features?
  3. Define Success Metrics
    • Posts per week target?
    • Time savings goals?
  4. Agree on Timeline
    • Which features first?
    • Rollout schedule?

After Meeting:

  1. I'll implement agreed features
  2. Test integration workflows
  3. Update documentation
  4. Train team on new workflow

APPENDIX: File Reference

Frontend Components:

  • client/src/admin/BlogManagement.tsx - Main hub
  • client/src/admin/BlogAICreator.tsx - AI creation workflow
  • client/src/admin/BlogEditor.tsx - Post editing
  • client/src/admin/BlogManagePosts.tsx - Post listing
  • client/src/admin/BlogTagManagement.tsx - Tag management
  • client/src/components/admin/ContentProductionPlanner.tsx - Weekly calendar (NEW)
  • client/src/components/admin/ContentProductionTopics.tsx - Topic management (NEW)

Backend:

  • server/routes.ts - API endpoints
  • server/hybrid-storage.ts - Database layer
  • shared/schema.ts - Database schema

Documentation:

  • blog-production-system/HANDOFF_DOCUMENT.md
  • blog-production-system/PROJECT_TRACKER.md
  • blog-production-system/templates/CONTENT_GENERATION_PROMPT.md

Questions? Let's discuss during our team meeting!

Related Documents