TDvorak/MyClub
1
0
Fork 0
mirror of https://github.com/Dvorinka/MyClubServer.git synced 2026-06-04 02:32:57 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
Files
547da76548777c05dff0b8eb27d4a926dec86f80
MyClub/DOCS/CONTACT_SYSTEM_FIX.md
T
Tomáš Dvořák 12cba639b9 upload
2025-10-16 13:32:05 +02:00

243 lines
7.9 KiB
Markdown
Raw Blame History

# 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:
```sql
-- 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:
```bash
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.
Reference in New Issue View Git Blame Copy Permalink