MyClub/DOCS/CONTACT_SYSTEM_FIX.md

Contact System Fix - Complete Summary

Issue Identified

The contact system was returning 500 Internal Server Error due to missing database tables:

• contacts table
• contact_categories table

Root Cause

The database migration 000006_create_contact_tables.up.sql had not been applied to the running database, causing all contact-related endpoints to fail.

Solution Applied

1. Database Tables Created

Executed the following SQL to create missing tables:

-- Contact Categories Table
CREATE TABLE contact_categories (
    id SERIAL PRIMARY KEY,
    name VARCHAR(255) NOT NULL UNIQUE,
    description TEXT,
    display_order INT DEFAULT 0,
    is_active BOOLEAN DEFAULT TRUE,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    deleted_at TIMESTAMP
);

-- Contacts Table  
CREATE TABLE contacts (
    id SERIAL PRIMARY KEY,
    category_id INT REFERENCES contact_categories(id) ON DELETE SET NULL,
    name VARCHAR(255) NOT NULL,
    position VARCHAR(255),
    email VARCHAR(255),
    phone VARCHAR(100),
    image_url VARCHAR(500),
    description TEXT,
    display_order INT DEFAULT 0,
    is_active BOOLEAN DEFAULT TRUE,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    deleted_at TIMESTAMP
);

-- Settings Table Extensions (for map and address)
ALTER TABLE settings ADD COLUMN IF NOT EXISTS contact_address VARCHAR(500);
ALTER TABLE settings ADD COLUMN IF NOT EXISTS contact_city VARCHAR(255);
ALTER TABLE settings ADD COLUMN IF NOT EXISTS contact_zip VARCHAR(20);
ALTER TABLE settings ADD COLUMN IF NOT EXISTS contact_country VARCHAR(100);
ALTER TABLE settings ADD COLUMN IF NOT EXISTS contact_phone VARCHAR(100);
ALTER TABLE settings ADD COLUMN IF NOT EXISTS contact_email VARCHAR(255);
ALTER TABLE settings ADD COLUMN IF NOT EXISTS location_latitude DECIMAL(10, 8);
ALTER TABLE settings ADD COLUMN IF NOT EXISTS location_longitude DECIMAL(11, 8);
ALTER TABLE settings ADD COLUMN IF NOT EXISTS map_zoom_level INT DEFAULT 15;
ALTER TABLE settings ADD COLUMN IF NOT EXISTS map_style VARCHAR(255);
ALTER TABLE settings ADD COLUMN IF NOT EXISTS show_map_on_homepage BOOLEAN DEFAULT FALSE;

2. Verified Components

Backend Components ✅

• ContactInfoController (internal/controllers/contact_info_controller.go)

  • Public endpoints: GET /api/v1/contacts, GET /api/v1/contacts/categories
  • Admin endpoints: Full CRUD for contacts and categories

• ContactController (internal/controllers/contact_controller.go)

  • Contact form submission: POST /api/v1/contact
  • Newsletter subscription: POST /api/v1/newsletter/subscribe

• Routes (internal/routes/contact_info_routes.go)

  • All routes properly registered and secured with middleware

• Models (internal/models/models.go, internal/models/contact.go)

  • Contact
  • ContactCategory
  • ContactMessage

Frontend Components ✅

• ContactsAdminPage (frontend/src/pages/admin/ContactsAdminPage.tsx)

  • Manage contacts and categories
  • Map configuration
  • Address settings

• ContactPage (frontend/src/pages/ContactPage.tsx)

  • Public contact form
  • Display contact information
  • Show map if configured

• ContactsSection (frontend/src/components/home/ContactsSection.tsx)

  • Display contacts grouped by category on homepage
  • Show map and address information
  • Collapsible accordion design

• ContactMap (frontend/src/components/home/ContactMap.tsx)

  • Interactive Leaflet map
  • Support for multiple map styles

3. API Endpoints

Public Endpoints (No Auth Required)

Method	Endpoint	Description	Status
GET	/api/v1/contacts	Get all active contacts grouped by category	✅ Working
GET	/api/v1/contacts/categories	Get all active contact categories	✅ Working
POST	/api/v1/contact	Submit contact form	✅ Working

Admin Endpoints (Auth Required)

Method	Endpoint	Description	Status
GET	/api/v1/admin/contacts	List all contacts	✅ Working
POST	/api/v1/admin/contacts	Create new contact	✅ Working
PUT	/api/v1/admin/contacts/:id	Update contact	✅ Working
DELETE	/api/v1/admin/contacts/:id	Delete contact	✅ Working
GET	/api/v1/admin/contacts/categories	List all categories	✅ Working
POST	/api/v1/admin/contacts/categories	Create category	✅ Working
PUT	/api/v1/admin/contacts/categories/:id	Update category	✅ Working
DELETE	/api/v1/admin/contacts/categories/:id	Delete category	✅ Working

4. Features Available

For Admin Users

1. Contact Management

   • Create/Edit/Delete contacts
   • Upload contact photos
   • Assign contacts to categories
   • Set display order
   • Toggle active/inactive status

2. Category Management

   • Create/Edit/Delete categories (e.g., "Management", "Coaches", "Staff")
   • Organize contacts by role
   • Set display order

3. Map & Address Configuration

   • Set club address details
   • Configure map coordinates (latitude/longitude)
   • Import coordinates from Google Maps, Mapy.cz, or OpenStreetMap links
   • Set map zoom level
   • Choose map style (default, dark, satellite)
   • Toggle map visibility on homepage

4. Contact Message Management

   • View messages submitted through contact form
   • Mark as read/unread
   • Respond to inquiries

For Public Users

1. Contact Page (/contact)

   • Submit contact form
   • View contact information
   • See club location on interactive map

2. Homepage Contact Section

   • View all active contacts grouped by category
   • Click to email or call contacts
   • See club address and map

5. Data Flow

Public User → Contact Form → POST /api/v1/contact
                                ↓
                        Save to contact_messages table
                                ↓
                        Send email notification (async)
                                ↓
                        Return success message

Admin User → Contacts Admin Page → POST /api/v1/admin/contacts
                                      ↓
                              Save to contacts table
                                      ↓
                              Return contact with category

6. Verification Steps

To verify everything is working:

1. Access Admin Panel

   http://localhost:3000/admin/contacts
   

2. Create a Contact Category

   • Click "Přidat kategorii"
   • Enter name (e.g., "Vedení")
   • Save

3. Create a Contact

   • Click "Přidat kontakt"
   • Fill in details
   • Select category
   • Save

4. Configure Map

   • Go to "Mapa a adresa" tab
   • Enter address details
   • Use "Importovat z odkazu" to paste a map link
   • Save settings

5. Test Public View

   • Visit homepage: http://localhost:3000
   • Scroll to contact section
   • Verify contacts and map display

6. Test Contact Form

   • Visit: http://localhost:3000/contact
   • Fill out form
   • Submit
   • Check Admin Panel → Messages for the submission

7. Current Status

✅ All Fixed!

• Database tables created
• All API endpoints returning 200 status
• No more 500 errors
• Frontend components render without errors
• Contact form functional
• Admin panel operational

8. Next Steps (Optional Enhancements)

• Add contact form CAPTCHA to prevent spam
• Add email templates customization
• Add bulk import for contacts
• Add contact search/filter in admin
• Add QR code generation for contact cards
• Add vCard export functionality

Maintenance Notes

If you need to reset the database in the future, run:

docker exec myclub-db psql -U postgres -d fotbal_club -f /path/to/000006_create_contact_tables.up.sql

Or manually recreate tables using the SQL provided in section 1 above.