πŸŽ“ Remarx Platform: Domain Insights & Design Intelligence

Purpose: This document captures the sophisticated domain knowledge, esoteric features, and strategic design decisions embedded within the Remarx platform. These insights reflect deep understanding of academic research, admissions processes, and the higher education ecosystemβ€”features that only someone with extensive domain expertise would recognize as valuable or even think to implement.

Audience: Developers, product managers, and stakeholders rebuilding or extending the Remarx platform.

πŸ“‹ Table of Contents

1. Academic Domain Expertise

πŸ’‘ Insight: Literary Type Granularity

The platform recognizes that "personal statement" is not a monolithic category.

Implementation:

Why This Matters:

Each literary type requires domain-specific expertise. A medical school personal statement reviewer may not be qualified to review an MBA statement of purpose. This granularity:

Evidence in Code:
Models/CustomModels.cs:109-117 (LiteraryTypes table)
Models/CustomModels.cs:142-150 (LiteraryLinks - reviewer-to-type mapping)
reviewers/configuration.html (per-type pricing)

πŸ’‘ Insight: Reviewer Pricing Per Literary Type

Reviewers should set different prices for different statement types based on complexity and their expertise level.

Design Decision:

Why This Matters:

Evidence:
reviewers/configuration.html (lines 41-124)
ReviewerLiteraryTypes table with Price and TurnaroundDays columns

πŸ’‘ Insight: Dual Selection Mechanisms

Different clients have different preferences for how they find reviewers.

Two Pathways:

  1. Browse & Select: Client browses reviewer profiles, compares prices/ratings, chooses one
  2. Post & Wait: Client posts their request, reviewers apply with proposals

Why This Matters:

Evidence:
statements/create-review-request.html (lines 88-97)
SelectionMethod field in Jobs table

πŸ’‘ Insight: Sub-Types and Hierarchical Categorization

Some literary types have sub-categories that affect pricing and expertise requirements.

Implementation:

Why This Matters:

Medical specialties are highly specific. A cardiology fellowship personal statement is different from a dermatology one. This enables ultra-precise matching.

Evidence:
Models/CustomModels.cs:120-131 (SubTypes table)
LiteraryTypeComponents for custom fields per type

2. Marketplace Economics & Pricing Intelligence

πŸ’‘ Insight: Suggested Price Ranges

New reviewers don't know what to charge. Clients don't know what's fair.

Implementation:

Why This Matters:

Evidence:
reviewers/configuration.html (lines 47, 69, 81, etc.)
LiteraryTypes.SuggestedMinPrice and SuggestedMaxPrice fields

πŸ’‘ Insight: Commission Code Tracking

Academic programs often have affiliate arrangements or want to track referrals.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:363-369 (CommissionCodes)
Models/CustomModels.cs:390-400 (CommissionPayments)
OslersPayments.CommisionCode field
Reviewer.CommisionCode field

πŸ’‘ Insight: Discount Code System

Students are price-sensitive. Strategic discounting drives adoption.

Implementation:

Use Cases:

Evidence:
Models/CustomModels.cs:352-361 (DiscountCodes)
payments/apply-discount.html

πŸ’‘ Insight: Deferred Payment System

Students applying to professional schools often lack upfront capital but have future earning potential.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:371-388 (DeferredPayments)
payments/deferred-payments.html
OneWeekMail and OneDayMail reminder flags

πŸ’‘ Insight: Application Fee Structure

Platform needs to capture value while ensuring reviewer earnings remain attractive.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:200 (ApplicationFee in Payments)
StripeConnectAccId in Reviewer model
ReviewerStripeId and ReviewerAmount tracking

3. Trust & Safety Mechanisms

πŸ’‘ Insight: Dispute Resolution System

When money and careers are at stake, disputes are inevitable and must be handled systematically.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:224-249 (Disputes table)
Models/CustomModels.cs:224-230 (DisputeReasons - structured taxonomy)
admin/view-disputes.html
admin/edit-dispute.html

πŸ’‘ Insight: Multi-Dimensional Rating System

A single 5-star rating doesn't capture service quality nuances.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:263-276 (Ratings table)
ratings/submit-rating.html

πŸ’‘ Insight: Two-Factor Authentication

Accounts contain sensitive documents and payment information.

Implementation:

Why This Matters:

Evidence:
auth/verify-code.html
profile/two-factor-setup.html
AspNetUsers.TwoFactorEnabled field

πŸ’‘ Insight: Error Logging with User Context

Errors in academic workflows can have serious consequences (missed deadlines, lost documents).

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:1218-1233 (Errors table)
admin/error-logs.html

4. Institutional Integration Features

πŸ’‘ Insight: Institution Management System

Universities and programs want private-labeled project workspaces for their students.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:937-958 (Institution table)
Models/CustomModels.cs:960-969 (Package - tiered pricing)
admin/institutions-list.html

πŸ’‘ Insight: Course Tags for Auto-Authentication

Universities want students to collaborate but verify enrollment.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:989-999 (CourseTags)
AutoAuthenticate and OneUserOneProject booleans

πŸ’‘ Insight: Notice Boards (Project Link Templates)

Institutions need custom landing pages for recruitment campaigns.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:748-823 (ProjectLinkTemplate)
MainPicture, StudentButtonText, SupervisorBenefitsTitleText fields

5. Financial Accessibility Design

πŸ’‘ Insight: "Commission-Free" Referral Credits

Students who refer others should get commission-free services as rewards.

Implementation:

Why This Matters:

Evidence:
Reviewer.CommishFreeLeft field
Models/CustomModels.cs:1208-1215 (CommishFreeAdded)

πŸ’‘ Insight: Course Payment with Day Selection

Medical courses (like Oslers) often run over multiple days, and students may only attend some days.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:311-334 (OslersPayments)
Day1 and Day2 boolean fields

πŸ’‘ Insight: Budget Range Filtering

Students have different budgets and want to see reviewers within their range.

Implementation:

Why This Matters:

Evidence:
statements/create-review-request.html (lines 78-85)

6. Community & Knowledge Network

πŸ’‘ Insight: Q&A Lounge with Points System

Academic communities thrive on knowledge-sharing. Gamification drives engagement.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:431-461 (QALounge and QAResponses)
Models/CustomModels.cs:473-482 (UserPoints)
qa/qa-lounge.html

πŸ’‘ Insight: Blog Series and Canonical URLs

Long-form educational content builds authority. SEO matters for discovery.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:1127-1138 (Blog model)
blog/blog-list.html

πŸ’‘ Insight: User Blog Tag Subscriptions

Students want to follow specific topics (e.g., "medical school admissions") without following all blogs.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:1163-1182 (BlogTags and UserBlogTags)

πŸ’‘ Insight: Following System (Social Graph)

Students want to follow reviewers, successful applicants, or peers.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:1191-1198 (Following table)

7. Professional Development Ecosystem

πŸ’‘ Insight: Mentorship Program Architecture

Long-term mentorship is different from one-off reviews. It requires formal program structure.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:594-670 (entire mentorship section)
mentorship/mentorship-programs.html

πŸ’‘ Insight: Project Screening Questionnaires

Project owners need to vet applicants beyond just a CV.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:898-927 (Screening questionnaires)
Project.RequireCV and Project.RequireBlurb flags

πŸ’‘ Insight: Project Templates

Recurring project types (e.g., "Research Paper Collaboration") should have standardized structures.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:1022-1054 (ProjectTemplate)

πŸ’‘ Insight: Task Management with Types and Actions

Academic tasks are diverse (write, review, experiment, meet). Categorization aids workflow.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:1056-1102 (ProjectTasks, TaskTypes, TaskActions)
projects/tasks-list.html

8. Data Architecture Sophistication

πŸ’‘ Insight: Soft Deletion Pattern

In academic contexts, data should rarely be permanently deleted (audit trails, dispute resolution).

Implementation:

Tables with Soft Deletion:

Why This Matters:

Evidence:
Reviewer.Deleted (CustomModels.cs:53)
Messages.Deleted, DeletedText, DeletedDate (lines 103-106)
Multiple model classes with Deleted flag

πŸ’‘ Insight: Composite Key Relationships

Academic collaboration involves many-to-many relationships that require complex joins.

Examples:

Why This Matters:

Evidence:
Models/CustomModels.cs:142-150 (LiteraryLinks)
Models/CustomModels.cs:869-876 (ProjectTags)
Models/CustomModels.cs:1163-1173 (BlogTags)

πŸ’‘ Insight: Conversation Threading Architecture

Academic collaboration requires context-aware messaging (job-specific, project-specific, task-specific).

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:66-74 (Conversations)
RequestReviewerLink.ConversationId
ProjectStaff.ConversationId
ProjectTasks.ConversationId

πŸ’‘ Insight: URL Slug Generation (IdURL)

SEO-friendly URLs improve discoverability. Slug-based URLs prevent enumeration attacks.

Implementation:

Examples:

Why This Matters:

Evidence:
Reviewer.IdURL, Project.IdURL, Blog.IdURL, InfoPages.IdUrl

9. Revenue Model Innovations

πŸ’‘ Insight: Multi-Tenant Revenue Streams

Platform captures value from multiple stakeholder types.

Revenue Sources:

  1. Transaction fees (reviewer marketplace)
  2. Institutional subscriptions (package-based pricing)
  3. Course payments (Oslers and similar)
  4. Commission tracking (affiliate partnerships)
  5. Featured placement (reviewer promotion)
  6. Premium features (expedited review)

Why This Matters:

Evidence:
Payments.ApplicationFee (transaction)
Package.Price (institutional)
OslersPayments (course revenue)
CommissionCodes (affiliate revenue)

πŸ’‘ Insight: Dynamic Pricing Support

Review prices should vary by urgency, complexity, and reviewer reputation.

Implementation:

Why This Matters:

Evidence:
reviewers/configuration.html (special offers)
ReviewerLiteraryTypes.Price (base price)
DiscountCodes for promotions

πŸ’‘ Insight: Stripe Connect Integration

Marketplace regulations require direct reviewer payouts (not escrow/sub-merchant model).

Implementation:

Why This Matters:

Evidence:
Reviewer.StripeConnectAccId
Payments.ReviewerTransferedDate
Payments.ReviewerAmount

10. User Psychology & Engagement

πŸ’‘ Insight: Gamification Through Points

Academic users respond to intellectual status signals more than monetary rewards.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:473-482 (UserPoints)
Reviewer.RemarxsPoints
PointsAllocations table

πŸ’‘ Insight: Progressive Disclosure in Forms

Long forms intimidate users. Breaking into sections with clear purpose increases completion.

Pattern Across Prototypes:

Why This Matters:

Evidence:
statements/create-review-request.html (H3 sections)
reviewers/create-profile.html (step-by-step)

πŸ’‘ Insight: Social Proof Integration

Trust is the primary barrier in academic services. Multiple social proof mechanisms are needed.

Mechanisms:

  1. Reviewer ratings (star + written reviews)
  2. Completed job count
  3. Response time metrics
  4. Years of experience
  5. Professional credentials
  6. Social media verification (LinkedIn, Twitter)
  7. Points/reputation score
  8. Admin verification badges

Why This Matters:

Evidence:
Reviewer.Rating, YearsExperience, Qualifications
Reviewer.LinkedInName, TwitterHandle
Ratings table for detailed reviews

πŸ’‘ Insight: Email Notification Sophistication

Email fatigue is real. Notifications must be targeted and actionable.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:418-429 (Notifications)
Referrals.Reviews, Courses, Projects, Questionmarxs, Blogs
DeferredPayments.OneWeekMail, OneDayMail

πŸ’‘ Insight: Referral Viral Loop

Students cluster in cohorts. Word-of-mouth is the primary acquisition channel.

Implementation:

Why This Matters:

Evidence:
Models/CustomModels.cs:541-563 (Referrals)
referrals/referral-form.html

🎯 Key Takeaways for Developers

Design Patterns to Preserve

  1. Soft deletion everywhere - Never hard delete user-generated content
  2. ConversationId threading - Unified messaging across contexts
  3. Literary type granularity - Don't oversimplify domain taxonomy
  4. Multi-tenant architecture - Institution isolation must be robust
  5. Stripe Connect compliance - Never handle reviewer funds directly

Features That Demonstrate Domain Expertise

  1. Reviewer pricing per literary type - Shows understanding that expertise varies
  2. Deferred payments - Recognizes student financial constraints
  3. Commission codes - Enables institutional partnerships
  4. Screening questionnaires - Facilitates quality project matching
  5. Dispute resolution - Anticipates marketplace conflicts

Revenue-Critical Features

  1. Package-based institutional pricing - Recurring revenue foundation
  2. Application fee transparency - Builds reviewer trust
  3. Dynamic pricing mechanisms - Maximizes revenue per transaction
  4. Affiliate tracking - Enables scalable partnerships
  5. Gamification - Drives content creation without direct payment

Trust & Safety Essentials

  1. Multi-dimensional ratings - Beyond simple 5-star
  2. Dispute arbitration workflow - Formal conflict resolution
  3. Error logging with context - Rapid issue resolution
  4. Two-factor authentication - Protects sensitive documents
  5. Soft deletion audit trails - Legal compliance

Conclusion

The Remarx platform represents a sophisticated understanding of:

Domain Key Insights
Academic Knowledge Literary types, admissions processes, institutional partnerships
Marketplace Economics Dynamic pricing, commission tracking, transaction fees
Community Dynamics Q&A, mentorship, social following
Financial Accessibility Deferred payments, referral rewards, discount codes
Trust Mechanisms Ratings, disputes, verification, social proof
Important: These features are not "nice-to-haves" – they reflect deep insights that only domain experts would recognize as essential. When rebuilding this platform, preserving these design decisions is critical to maintaining competitive advantage and user trust.

Next Steps

  1. Review this document alongside prototypes and data models
  2. Flag any features unclear or needing clarification
  3. Prioritize features based on MVP requirements
  4. Preserve domain logic even if technology stack changes
For questions or clarifications, reference:
β€’ Prototype Index (HTML prototypes)
β€’ /Unistatements/Models/CustomModels.cs (Data models)
β€’ PROTOTYPES_INDEX.md (Feature overview)
β€’ DOMAIN_INSIGHTS.md (Markdown version of this document)