# Aexol Language - Landing Page Definition

# Type Definitions
type Page {
    id: string
    title: string
    url: string
    createdAt: datetime
}

type Feature {
    name: string
    description: string
    icon: string
    docLink: string
}

enum UserType {
    visitor
    authenticated
    contributor
    maintainer
}

# Role Definitions with Permissions
role VisitorRole {
    permission landing_page {
        read,
        view
    }
    permission features {
        read
    }
    permission documentation {
        read
    }
    permission examples {
        read,
        view
    }
    permission downloads {
        read
    }
}

role AdminRole {
    permission landing_page {
        create,
        read,
        update,
        delete
    }
    permission documentation {
        create,
        read,
        update,
        delete
    }
    permission examples {
        create,
        read,
        update,
        delete
    }
    permission users {
        read,
        update
    }
    permission analytics {
        read,
        write
    }
    permission releases {
        create,
        read,
        update,
        delete,
        publish
    }
}

# Workflow for Page Visitor Journey
workflow LandingPageFlow {
    state arrival -> explore
    state explore -> engage, leave
    state engage -> signup, download, leave
    state signup -> dashboard
    state download -> completed
    state dashboard -> explore
}

# Main Visitor - Anonymous User Journey
visitor {
    "view landing_page" {
        "read hero_section" {
            "read headline"
            "read subheadline"
            "click demo_button"
            "click docs_button"
        }
        "scroll to features_section" {
            "read features" {
                "understand declarative_syntax"
                "understand role_definitions"
                "understand workflow_support"
                "understand agent_system"
            }
            "expand feature_details"
        }
        "scroll to examples_section" {
            "view quick_example" {
                "see todo_example"
                "see ecommerce_example"
                "copy_code"
            }
        }
        "scroll to documentation_section" {
            "read docs_intro"
            "navigate to installation_guide"
            "navigate to language_tutorial"
            "navigate to api_reference"
        }
        "scroll to testimonials_section" {
            "read user_feedback"
            "see community_stats"
        }
        "scroll to footer" {
            "access github_link"
            "access social_media"
            "subscribe_newsletter"
            "view sitemap"
        }
    }
    "download aexol_cli"
    "view getting_started_guide"
    "access github_repository"
    "report issue"
}

# Admin User Journey
visitor {
    "access admin_panel" {
        "manage_landing_page" {
            "edit hero_content"
            "update features"
            "manage examples"
            "publish updates"
        }
        "manage_documentation" {
            "create_documentation" {
                "write_markdown"
                "add_code_samples"
                "preview_rendering"
            }
            "review_submissions"
            "approve_contributions"
            "reject_content"
            "merge_pull_requests"
        }
        "manage_releases" {
            "create_release"
            "write_release_notes"
            "tag_versions"
            "publish_to_registry"
        }
        "manage_users" {
            "view_user_stats"
            "assign_roles"
            "manage_permissions"
            "handle_reports"
        }
        "view_analytics_dashboard" {
            "see download_statistics"
            "see engagement_metrics"
            "see community_growth"
            "export_reports"
        }
    }
}

# Workflow Definitions
workflow ContentPublishing {
    state draft -> review
    state review -> approved, rejected
    state approved -> published
    state rejected -> draft
    state published -> updated, archived
}

workflow ReleaseProcess {
    state planning -> development
    state development -> testing
    state testing -> staging, development
    state staging -> production
    state production -> released
}

# Agent Definitions
agent LandingPageOptimizer: AdminRole {
    "analyze page_metrics"
    "suggest improvements"
    "update_hero_content"
    "optimize_cta_placement"
    "track_user_behavior"
    "generate_analytics_reports"
}

agent DocumentationManager: AdminRole {
    "validate documentation"
    "check_code_examples"
    "verify_links_valid"
    "publish_documentation"
    "maintain_versioning"
}

agent CommunityModerator: AdminRole {
    "monitor discussions"
    "respond_to_questions"
    "flag inappropriate_content"
    "highlight_quality_contributions"
    "engage_community_members"
}