Competitor entity classification, competitive-power scoring, and data-quality confidence for market research — industry-agnostic.
| Tier | domain |
| Role | unclassified (baselined) |
| Path | crates/domain/competitive-intel |
| Edition | 2021 |
| Targets | domain_competitive_intel |
| Public items | 23 across 5 modules |
| Tests | 47 |
What it is for
# domain-competitive-intel
Competitor entity classification, competitive-power scoring, and data-quality confidence for market research — industry-agnostic.
Lifted from plumber's src/validation/mod.rs, which validated and classified competitor entities for a Phoenix-plumbing engagement. The logic itself never referenced plumbing, HVAC-vs-electrical categories aside — those are input strings, not baked-in assumptions — so it lands here unchanged in behavior, renamed only where a name presumed a verdict instead of describing what was actually computed. See CHANGELOG.md for the specific renames and why.
Core types
CompetitorClass/EntityClassification/EntityClassifier—
buckets a competitor by observable market-presence signals, with the supporting evidence kept alongside the verdict.
CompetitivePower/CompetitiveSeverity— five-dimension
competitive-power scoring (reputation, SERP, content, technical, brand) collapsed to a severity tier plus a strengths/weaknesses rationale.
DataConfidence/DataQualitySummary— how much of a report
section's underlying data was actually observed vs. inferred vs. missing.
ReviewIntegrity/ReviewValidator— review-count velocity and
location-count estimation, flagging patterns outside the typical range as anomalies to check, not fraud to assert.
KeywordValidation/KeywordValidator— boilerplate detection
and frequency-anomaly flagging for keyword-density data.
Capabilities
CompetitorClass
Competitor entity classification.
| Item |
|---|
pub enum CompetitorClass |
CompetitorClass :: fn as_str(& self) -> & 'static str |
CompetitorClass :: fn is_comparable_to_local(& self) -> bool |
EntityClassification
Competitor entity classification.
| Item |
|---|
pub struct EntityClassification |
EntityClassifier
Competitor entity classification.
| Item |
|---|
pub struct EntityClassifier |
EntityClassifier :: fn classify(review_count : Option <i32>, categories : & String, domain_age_days : Option <i32>, discovered_addresses : Option <i32>,) -> EntityClassification |
KeywordValidator
Keyword frequency validation.
| Item |
|---|
pub struct KeywordValidator |
KeywordValidator :: fn is_boilerplate(frequency : i32, page_count : i32, total_pages : i32) -> bool |
KeywordValidator :: fn is_frequency_anomaly(frequency : i32, page_count : i32) -> bool |
CompetitivePower
Multi-dimensional competitive-power scoring.
| Item |
|---|
pub struct CompetitivePower |
CompetitiveSeverity
Multi-dimensional competitive-power scoring.
| Item |
|---|
pub enum CompetitiveSeverity |
CompetitiveSeverity :: fn as_str(& self) -> & 'static str |
EntityClassifier
Competitor entity classification.
| Item |
|---|
EntityClassifier :: fn calculate_power(review_count : Option <i32>, avg_rating : Option <f32>, mobile_score : Option <i32>, desktop_score : Option <i32>, total_pages : i32, domain_age_days : Option <i32>, keywords_ranked : i32, page_1_rankings : i32,) -> CompetitivePower |
DataConfidence
Data-quality indicators for a competitor's report.
| Item |
|---|
pub enum DataConfidence |
DataConfidence :: fn symbol(& self) -> & 'static str |
DataQualitySummary
Data-quality indicators for a competitor's report.
| Item |
|---|
pub struct DataQualitySummary |
DataQualitySummary :: fn overall_completeness(& self) -> f64 |
KeywordValidation
Data-quality indicators for a competitor's report.
| Item |
|---|
pub struct KeywordValidation |
ReviewIntegrity
Data-quality indicators for a competitor's report.
| Item |
|---|
pub struct ReviewIntegrity |
ReviewValidator
Review velocity and location-count estimation.
| Item |
|---|
pub struct ReviewValidator |
ReviewValidator :: fn estimate_velocity(review_count : i32, domain_age_days : Option <i32>) -> f64 |
ReviewValidator :: fn is_velocity_anomaly(reviews_per_month : f64) -> bool |
ReviewValidator :: fn estimate_locations(review_count : i32, _categories : & String, discovered_addresses : Option <i32>,) -> Option <i32> |
How to use it
No examples/ target and no doctest in this crate's rustdoc. The tests listed under Verification are the closest executable usage.
Module structure
domain_competitive_intel
classificationkeyword_validatorpowerqualityreview_validator
flowchart TD n_domain_competitive_intel["domain_competitive_intel"] n_domain_competitive_intel --> n_classification["classification"] n_domain_competitive_intel --> n_keyword_validator["keyword_validator"] n_domain_competitive_intel --> n_power["power"] n_domain_competitive_intel --> n_quality["quality"] n_domain_competitive_intel --> n_review_validator["review_validator"]
Public surface
`classification`
| Item | What it is |
|---|---|
pub enum CompetitorClass | Classification of a competitor entity based on observable market-presence signals (review count, category tags, domain age, discovered locations). |
CompetitorClass :: fn as_str(& self) -> & 'static str | — |
CompetitorClass :: fn is_comparable_to_local(& self) -> bool | Returns true if this class should be compared with local operators. |
pub struct EntityClassification | Entity classification with supporting evidence. |
pub struct EntityClassifier | Classifies and scores competitor entities from observable signals. |
EntityClassifier :: fn classify(review_count : Option <i32>, categories : & String, domain_age_days : Option <i32>, discovered_addresses : Option <i32>,) -> EntityClassification | Classify a competitor based on available data. |
`keyword_validator`
| Item | What it is |
|---|---|
pub struct KeywordValidator | Validates keyword data for a competitor. |
KeywordValidator :: fn is_boilerplate(frequency : i32, page_count : i32, total_pages : i32) -> bool | Check if a keyword is likely boilerplate based on its distribution. |
KeywordValidator :: fn is_frequency_anomaly(frequency : i32, page_count : i32) -> bool | Check whether keyword frequency per page is an outlier relative to the typical range — a pattern to investigate, not an accusation. |
`power`
| Item | What it is |
|---|---|
pub enum CompetitiveSeverity | Severity of the competitive pressure a scored entity's public signals indicate, derived from the average of its five power dimensions. |
CompetitiveSeverity :: fn as_str(& self) -> & 'static str | — |
pub struct CompetitivePower | Multi-dimensional competitive-power analysis. |
EntityClassifier :: fn calculate_power(review_count : Option <i32>, avg_rating : Option <f32>, mobile_score : Option <i32>, desktop_score : Option <i32>, total_pages : i32, domain_age_days : Option <i32>, keywords_ranked : i32, page_1_rankings : i32,) -> CompetitivePower | Calculate multi-dimensional competitive power scores. |
`quality`
| Item | What it is |
|---|---|
pub struct ReviewIntegrity | Review data integrity validation results. |
pub struct KeywordValidation | Keyword frequency validation to detect boilerplate pollution. |
pub enum DataConfidence | Data quality indicators for report sections. |
DataConfidence :: fn symbol(& self) -> & 'static str | — |
pub struct DataQualitySummary | Data quality summary for a competitor's report. |
DataQualitySummary :: fn overall_completeness(& self) -> f64 | — |
`review_validator`
| Item | What it is |
|---|---|
pub struct ReviewValidator | Review integrity validator. |
ReviewValidator :: fn estimate_velocity(review_count : i32, domain_age_days : Option <i32>) -> f64 | Estimate review velocity (reviews per month). |
ReviewValidator :: fn is_velocity_anomaly(reviews_per_month : f64) -> bool | Check whether review velocity is outside the range typical for a single-location entity. |
ReviewValidator :: fn estimate_locations(review_count : i32, _categories : & String, discovered_addresses : Option <i32>,) -> Option <i32> | Estimate number of locations based on review count and other signals. |
Re-exports. Exported here, defined elsewhere.
| Export | Defined in |
|---|---|
KeywordValidator | keyword_validator::KeywordValidator |
ReviewValidator | review_validator::ReviewValidator |
{CompetitivePower,CompetitiveSeverity} | power::{CompetitivePower,CompetitiveSeverity} |
{CompetitorClass,EntityClassification,EntityClassifier} | classification::{CompetitorClass,EntityClassification,EntityClassifier} |
{DataConfidence,DataQualitySummary,KeywordValidation,ReviewIntegrity} | quality::{DataConfidence,DataQualitySummary,KeywordValidation,ReviewIntegrity} |
Boundary
Depends on no other workspace tier.
Shares tier domain with 41 other crates: domain-agreements, domain-ai-report, domain-billing, domain-catalog, domain-classify, domain-comments, domain-contact, domain-conversation-engine, … (41 total).
_What this crate deliberately does NOT own is a judgment. No committed registry records one for it, so none is stated here._
Where it sits
| Tier (ontology) | domain |
| Architectural role (taxonomy) | unclassified (baselined) |
| Location | crates/domain/competitive-intel |
| Vocabulary in force (lexicon) | current |
Dependencies
Runtime, from outside the workspace.
| Crate | Requirement | Features | Optional | Only on |
|---|---|---|---|---|
serde | ^1 | derive | no | always |
serde_json | ^1 | — | no | always |
Development. None.
Build. None.
Depended on by. 1 workspace crate.
Signal flow — what reaches this crate, and what it reaches.
flowchart LR n_application_party_discovery["application-party-discovery"] -->|uses| SELF SELF["domain-competitive-intel"] classDef self fill:#1f883d,stroke:#1f883d,color:#fff; class SELF self;
Feature flags
No Cargo features are defined: every capability is unconditional, so no consumer can receive a half-wired crate.
Targets
| Kind | Name | Source |
|---|---|---|
| lib | domain_competitive_intel | `src/lib.rs` |
Error model
No public error type was detected: no public item declares a type named *Error, and no public signature returns one.
Operational characteristics
| Property | Evidence |
|---|---|
| async public surface | none detected |
| async runtime | none detected |
| database access | none detected |
| network I/O | none detected |
| unsafe code | none detected |
| environment variables | none detected |
No unsafe block, unsafe fn, unsafe impl or unsafe trait was found by the parser anywhere in this crate's source.
Configuration
No environment variable is read with a literal name anywhere in this crate. A variable whose key is computed at run time cannot be listed here, and is not claimed to be absent.
Related capabilities
1 workspace crate depends on this one: application-party-discovery.
Verification
| Kind | Count |
|---|---|
| Unit tests | 47 |
| Integration tests | 0 |
| Examples | 0 |
| Doctests | 0 |
Evidence by module. How often each public module is named by something executable.
| Module | Tests | Examples | Consumers |
|---|---|---|---|
classification | 3 | 0 | 2 |
keyword_validator | 1 | 0 | 0 |
power | 2 | 0 | 0 |
quality | 4 | 0 | 0 |
review_validator | 1 | 0 | 0 |
What the tests establish, by name:
as_str_covers_every_variant—src/classification.rsclassification_round_trips_through_serde—src/classification.rsenterprise_network_with_few_addresses_keeps_base_confidence—src/classification.rsenterprise_network_with_multiple_addresses_gets_higher_confidence—src/classification.rshigh_review_count_classifies_as_enterprise_network—src/classification.rslow_review_count_with_no_domain_age_falls_back_to_local_operator—src/classification.rslow_review_count_with_old_domain_classifies_as_dormant—src/classification.rslow_review_count_with_young_domain_falls_back_to_local_operator—src/classification.rsmid_range_review_count_defaults_to_local_operator—src/classification.rsmid_review_count_classifies_as_regional_brand—src/classification.rsmissing_review_count_defaults_to_zero_and_local_operator—src/classification.rsmulti_service_categories_classify_as_brand_aggregator—src/classification.rsmulti_service_check_is_case_insensitive—src/classification.rsonly_local_and_regional_are_comparable_to_local—src/classification.rsregional_brand_with_established_domain_gets_higher_confidence—src/classification.rsboundary_exactly_fifty_per_page_is_not_an_anomaly—src/keyword_validator.rshigh_average_frequency_is_an_anomaly—src/keyword_validator.rsnarrow_coverage_is_not_boilerplate—src/keyword_validator.rstypical_average_frequency_is_not_an_anomaly—src/keyword_validator.rswide_coverage_with_high_frequency_is_not_boilerplate—src/keyword_validator.rswide_low_frequency_coverage_is_boilerplate—src/keyword_validator.rszero_page_count_is_never_a_frequency_anomaly—src/keyword_validator.rszero_total_pages_is_never_boilerplate—src/keyword_validator.rsas_str_covers_every_variant—src/power.rsminimal_inputs_land_on_medium_with_thin_content_weakness—src/power.rsmixed_strengths_and_weaknesses_produce_a_contrast_rationale—src/power.rspower_round_trips_through_serde—src/power.rsseverity_is_ordered_low_to_critical—src/power.rsseverity_threshold_boundaries—src/power.rsstrong_inputs_across_every_dimension_land_on_critical—src/power.rs- _… 17 more_
Documentation coverage
| Measure | Documented | Total |
|---|---|---|
| Public items with rustdoc | 19 | 23 |
Public modules with a //! block | 5 | 5 |
pie showData
title Public items with rustdoc
"Documented" : 19
"No rustdoc detected" : 4
Metrics
| Metric | Value |
|---|---|
| Rust source files | 6 |
| Source lines | 1065 |
| Code lines | 794 |
| Public API items | 23 |
| Public modules | 5 |
| Tests | 47 |
| Examples | 0 |
| Cargo features | 0 |
| Direct runtime dependencies | 2 |
| Workspace reverse dependencies | 1 |
pie showData
title Public API by kind
"enum" : 3
"method" : 12
"struct" : 8
pie showData
title Rust source composition
"Code" : 794
"Blank or comment" : 271
Generation
Rendered by tools-corpus corpus readme from repository evidence alone, renderer schema 2, lexicon current. No model, network service or database was consulted. Regenerate with tools-corpus corpus readme --write; verify with --check.