Infrastructure Cleanup Analysis

Generated: 2025-07-24 12:20 UTC
Status: Analysis Complete
Verified: Domain mapping working / SSL certificate active

Domain Mapping & SSL Status

Current Configuration

Custom Domain: convert-to-markdown.knowcode.tech
Mapped Service: convert-api (unified API)
SSL Status: Certificate provisioned and active
CNAME Record: ghs.googlehosted.com

Verification Tests

# Both domains working correctly:
curl -I https://convert-to-markdown.knowcode.tech/v1          # ✅ HTTP/2 200
curl -I https://convert-api-qpg64cvnga-uk.a.run.app/v1       # ✅ HTTP/2 200

SSL Certificate Details

Status: CertificateProvisioned = True
Domain: Ready and routable
Last Update: 2025-07-24T10:10:25.912104Z

Function Cleanup Analysis

Current Functions

convert-api KEEP
- Purpose: Unified API with all converters
- Status: Active and fully functional
- Usage: Production API endpoint
- Region: us-east4
free-tier-signup CANDIDATE FOR REMOVAL
- Purpose: User signup and API key generation
- Status: Active but appears non-functional
- Created: 2025-07-23T16:25:37Z
- Last Test: Returns error message
- Analysis: Redundant - we now have Firestore-based API key management

Legacy Files Found

functions/free-tier-signup/ - Complete function code
deploy-free-tier-signup.sh - Deployment script
test-free-signup-local.js - Local test script

Recommendations

1. Keep Current Domain Setup

The domain mapping is working perfectly:

Custom domain properly mapped to unified API
SSL certificate active and valid
No changes needed

2. Remove Legacy Signup Function

Reasoning:

Current unified API has proper Firestore authentication
Test API keys are already available and working
Signup function returns errors and appears broken
No references found in current codebase

Safe Removal Steps:

Verify no dependencies on signup function
Delete Cloud Function: gcloud functions delete free-tier-signup
Archive legacy files to archive/ directory
Update documentation

3. Clean Up Legacy Files

Files to Archive:

functions/free-tier-signup/ → archive/functions/free-tier-signup/
deploy-free-tier-signup.sh → archive/deploy-free-tier-signup.sh
test-free-signup-local.js → archive/test-free-signup-local.js

Current Production State

Working Infrastructure

Primary API: convert-api function
Domain: convert-to-markdown.knowcode.tech
SSL: Valid certificate
Authentication: Firestore-based API keys
Test Keys: Available and functional

No Critical Dependencies

No other services depend on free-tier-signup
Domain mapping points to convert-api only
All functionality provided by unified API

Cleanup Commands

Safe Removal of Legacy Function

# Delete the non-functional signup function
gcloud functions delete free-tier-signup \
  --region=us-east4 \
  --project=convert-to-markdown-us-east4 \
  --quiet

# Verify cleanup
gcloud functions list --project=convert-to-markdown-us-east4

Archive Legacy Files

# Create archive directory
mkdir -p archive/{functions,scripts}

# Move legacy files
mv functions/free-tier-signup archive/functions/
mv deploy-free-tier-signup.sh archive/scripts/
mv test-free-signup-local.js archive/scripts/

# Commit cleanup
git add archive/
git commit -m "Archive legacy signup function files

- Moved free-tier-signup function to archive
- Unified API now provides all functionality
- Cleanup completed as part of deployment finalization"

Post-Cleanup Verification

After cleanup, verify:

Unified API still working: curl https://convert-to-markdown.knowcode.tech/v1
Authentication functional: curl -H "X-API-Key: test_..." /v1/usage/summary
Domain mapping intact: Check domain still resolves
Only essential functions remain: gcloud functions list

Final Infrastructure State

Production Functions:

convert-api - Unified document conversion API

Domain Mapping:

convert-to-markdown.knowcode.tech → convert-api

SSL:

Valid certificate for custom domain

Authentication:

Firestore-based API key validation
Working test keys for immediate use

This represents a clean, minimal production deployment with no legacy components.