Skip to content

rixtrayker/medical-rep

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ₯ Go Medical Rep CRM

Go Report Card GoDoc License: MIT Go Version PostgreSQL

An advanced, modular, and scalable Customer Relationship Management (CRM) system meticulously tailored for the dynamic needs of Medical Representatives, built with the power and efficiency of Go.

🌟 Overview

This project is engineered to provide a truly robust platform for managing sophisticated client interactions, from initial contact to ongoing engagement. It handles intricate visit planning, streamlined order processing, and insightful reporting. The system prioritizes:

  • ⚑ Exceptional performance for demanding workloads
  • πŸ› οΈ Enhanced maintainability through clean code
  • πŸ”„ Clear boundaries for better scalability
  • πŸš€ Future extensibility towards SaaS model

✨ Key Features

πŸ—οΈ Modular Architecture

  • Clear separation of concerns
  • Independent module development
  • Scalable component design
  • Future-proof architecture

πŸ‘₯ User Management

  • πŸ” Role-based access control (RBAC)
  • πŸ”‘ Secure authentication
  • πŸ“ Detailed permission settings
  • πŸ”’ Future: 2FA & audit trails

πŸ—ΊοΈ Territory Management

  • Hierarchical geographical structure
  • Performance tracking
  • Workload distribution
  • Sales strategy execution

πŸ‘¨β€βš•οΈ Client Management

  • 360-degree HCP profiles
  • Detailed demographics
  • Interaction history
  • Communication preferences
  • Client segmentation

πŸ“… Visit Planning & Logging

  • Optimized routing
  • Compliance reporting
  • Field intelligence capture
  • Visit feedback tracking

πŸ“¦ Product & Order Management

  • Detailed product catalog
  • Inventory integration
  • Order processing
  • Pricing tier management
  • Status tracking

πŸ“Š Activity & Expense Tracking

  • Non-visit activity logging
  • Expense report management
  • Approval workflows
  • Budget control
  • Operational insights

πŸ“ˆ Reporting & Analytics (Planned)

  • KPI tracking
  • Trend analysis
  • Comparative dashboards
  • Basic forecasting

πŸ”” Notifications & Messaging (Planned)

  • Real-time alerts
  • Visit reminders
  • Approval requests
  • Team coordination
  • Internal messaging

πŸ› οΈ Technology Stack

Category Technology Description
Backend Go (Golang) High performance, concurrency, standard library
Database PostgreSQL ACID compliance, JSONB support, extensibility
API GraphQL (gqlgen) Flexible data fetching, type safety
Auth JWT Stateless authentication
AuthZ Casbin Flexible access control models
Web Framework Gin/Echo/Chi Lightweight, efficient routing
ORM/DB GORM/Ent/sqlx Database interaction
Messaging NATS/RabbitMQ Async communication

πŸ“‚ Project Structure

.
β”œβ”€β”€ api/              # API definitions (GraphQL, OpenAPI)
β”œβ”€β”€ cmd/              # Application entry points
β”œβ”€β”€ configs/          # Configuration files
β”œβ”€β”€ internal/         # Private application code
β”‚   β”œβ”€β”€ app/         # Application services
β”‚   β”œβ”€β”€ domain/      # Business logic
β”‚   β”œβ”€β”€ handler/     # HTTP/GraphQL handlers
β”‚   β”œβ”€β”€ infra/       # Infrastructure implementations
β”‚   └── platform/    # Shared utilities
β”œβ”€β”€ pkg/             # Public library code
β”œβ”€β”€ migrations/      # Database migrations
β”œβ”€β”€ graph/           # GraphQL generated code
└── scripts/         # Helper scripts

πŸš€ Getting Started

Prerequisites

  • Go 1.21+
  • PostgreSQL 15+
  • Docker & Docker Compose
  • golang-migrate CLI
  • make (optional)

Quick Start

# Clone the repository
git clone https://github.com/rixtrayker/medical-rep.git

# Navigate to project directory
cd medical-rep

# Start development environment
make dev

# Run migrations
make migrate-up

# Start the server
make run

Development

# Run tests
make test

# Build binary
make build

# Run linter
make lint

πŸ“š Documentation

🀝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgments


Made with ❀️ by Your Team Name

About

A high-performance, clean architecture CRM platform built for medical rep. Supports visit planning, comprehensive client management, and data-driven insights.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors