🏢 Organization Service

The Organization Service manages the lifecycle and retrieval of organizations within the system. It supports full CRUD functionality, lookup by various identifiers, and pagination.

---

🧾 Organization Structure

Organization Fields

Field	Type	Description
id	uint32	Unique identifier for the organization
name	string	Name of the organization
owner	uint32	User ID of the owner
slug	string	Unique slug/handle for URL usage
pan	string	PAN (Permanent Account Number) or business ID
zoho_customer_id	string	External Zoho CRM identifier
logo	string	URL or path to organization logo
created_at	timestamp	Creation timestamp
updated_at	timestamp	Last modification timestamp
created_by	uint32	ID of user who created this record
updated_by	uint32	ID of user who last modified the record
is_active	bool	Whether the organization is currently active

---

🚀 Services

OrganizationService

RPC Method	Request Type	Response Type	Description
CreateOrganization	CreateOrganizationRequest	OrganizationResponse	Creates a new organization
UpdateOrganization	UpdateOrganizationRequest	OrganizationResponse	Updates an existing organization
ActivateOrganization	ActivateOrganizationRequest	CheckResponse	Marks an organization as active
DeactivateOrganization	DeactivateOrganizationRequest	CheckResponse	Marks an organization as inactive
GetOrganizationByID	GetOrganizationRequest	OrganizationResponse	Fetches an organization by its ID
GetOrganizationBySlug	GetOrganizationBySlugRequest	OrganizationResponse	Fetches an organization by its slug
GetOrganizationByPan	GetOrganizationByPanRequest	OrganizationResponse	Fetches an organization by PAN
ListAllOrganizations	ListOrganizationRequest	OrganizationResponse	Lists all organizations with pagination and search

---

📦 Go Models Overview

models.Organization

Represents the organization entity in the database using GORM.

Field	Type	Notes
ID	uint32	Auto-incremented primary key
Name	string	Unique organization name
Owner	uint32	Owner user ID
Slug	string	Unique, URL-safe identifier
PAN	string	Permanent Account Number or tax identifier
ZohoCustomerID	string	External reference to Zoho CRM
Logo	string	URL or path to logo
CreatedAt	time.Time	Auto-managed creation timestamp
UpdatedAt	time.Time	Auto-managed update timestamp
CreatedBy	uint32	User ID who created it
UpdatedBy	uint32	Last editor user ID
IsActive	bool	Indicates if active/inactive

---

models.ClientsOrganization

Used for internal client-facing operations or legacy sync tables. Maps to the clients_organization table.

Field	Type	Description
ID	uint	Primary key
Name	string	Organization name
Created	time.Time	Record creation timestamp
Modified	time.Time	Record last modification timestamp
IsActive	bool	Status flag
BillingStatus	string	Internal billing status
Slug	string	URL-safe handle
Description	string	Long-form description
CreatedAt	time.Time	Record created time (redundant legacy)
UpdatedAt	time.Time	Last updated time

✅ Note: This struct is mapped manually using .TableName() to the clients_organization table and may be used for syncing or reporting.

---

🔍 Query Options

Pagination & Filtering

• page_number: Page index (starting from 1)
• page_size: Number of results per page
• search: Optional keyword to filter organization names or slugs

---

📡 Response Structures

OrganizationResponse

Used in listing and retrieval APIs.

{
  "message": "string",
  "code": "string",
  "data": [
    /* array of Organization */
  ],
  "total": 100
}

CheckResponse

Generic status for update/activate/deactivate actions.

{
  "message": "Operation successful",
  "code": "200",
  "check": true
}