Career

Port: REST :3140 · gRPC :5140

The largest domain service, managing all business-side entities: businesses, branches, employees, customers, products, services, stores, and inventory stock.

Collections

Collection	Path	Purpose
Businesses	/career/businesses	Top-level business or organization
Branches	/career/branches	Business subdivisions
Employees	/career/employees	Staff records
Customers	/career/customers	Customer records
Products	/career/products	Product catalog items
Services	/career/services	Service offerings
Stores	/career/stores	Physical or logical stores / warehouses
Stocks	/career/stocks	Inventory records per product

career/businesses

Top-level business or organization record.

Required Create Fields

Field	Required	Type	Description
name	✅	string	Business name
type	✅	BusinessType	SOLE_PROPRIETORSHIP, PARTNERSHIP, LLC, CORPORATION, COOPERATIVE, NONPROFIT
status	✅	Status	ACTIVE, INACTIVE

Common Optional Fields

Field	Type	Description
code	string	Short identifier
alias	string	Alternative name
slogan	string	Slogan
website	URL	Website URL
address	string	Address
location	MongoId	logistic/locations reference
categories	string[]	Category labels
logo / cover	MongoId	special/files references (raw, not populatable)
foundation_date	date	Foundation date

Population

Path	Collection
location	logistic/locations

career/branches

Business subdivision (main branch, warehouse, office, store, etc.).

Required Create Fields

Field	Required	Type	Description
type	✅	BranchType	MAIN, SECONDARY, WAREHOUSE, OFFICE, STORE, VIRTUAL
business	✅	MongoId	Parent business
status	✅	Status	ACTIVE, INACTIVE

Population

Path	Collection
parent	career/branches
manager	career/employees
business	career/businesses
location	logistic/locations

career/employees

Staff record linked to a business, optionally to a branch, manager, and services.

Required Create Fields

Field	Required	Type	Description
type	✅	EmployeeType	PERMANENT, CONTRACT, PART_TIME, INTERN, FREELANCE
job_title	✅	string	Role / job title
business	✅	MongoId	Parent business
status	✅	Status	ACTIVE, INACTIVE

Population

Path	Collection
branch	career/branches
manager	career/employees
business	career/businesses
location	logistic/locations
currency	financial/currencies
profile	identity/profiles

career/customers

Customer record associated with a business.

Required Create Fields

Field	Required	Type	Description
type	✅	CustomerType	INDIVIDUAL, CORPORATE, GOVERNMENT, NONPROFIT
business	✅	MongoId	Parent business

Population

Path	Collection
profile	identity/profiles
stores	career/stores
branch	career/branches
services	career/services
business	career/businesses
employees	career/employees
location / addresses	logistic/locations
documents / certifications	special/files

career/products

Catalog item offered by a business, branch, or store.

Required Create Fields

Field	Required	Type	Description
name	✅	string	Product name

Nested features Object

Products may have a features array of nested objects — each with type (COLOR, SIZE, WEIGHT, MATERIAL, STYLE, OTHER), title, and value. Features are embedded objects, not referenced IDs.

Population

Path	Collection
store	career/stores
branch	career/branches
business	career/businesses
cover / gallery	special/files

career/services

Service offering attached to a business.

Required Create Fields

Field	Required	Type	Description
name	✅	string	Service name
type	✅	ServiceType	ONLINE, OFFLINE, HYBRID
status	✅	Status	ACTIVE, INACTIVE
business	✅	MongoId	Parent business

Population

Path	Collection
branch	career/branches
business	career/businesses
location	logistic/locations

career/stores

Physical or logical store / warehouse.

Required Create Fields

Field	Required	Type	Description
name	✅	string	Store name
type	✅	StoreType	RETAIL, WHOLESALE, WAREHOUSE, VIRTUAL
fork	✅	StoreFork	Store fork classification
business	✅	MongoId	Parent business

Population

Path	Collection
parent	career/stores
manager	career/employees
business	career/businesses
location	logistic/locations

career/stocks

Inventory entry for a product.

Required Create Fields

Field	Required	Type	Description
type	✅	StockType	AVAILABLE, RESERVED, DAMAGED, RETURNED, TRANSIT
product	✅	MongoId	Parent product
inventory	✅	number	Current inventory level

Population

Path	Collection
store	career/stores
branch	career/branches
product	career/products
business	career/businesses
location	logistic/locations
currency	financial/currencies

Query Tips

• Scope most branch, employee, service, store, customer, product, and stock queries by business.
• Use branch for branch-local records.
• Use store for retail- or warehouse-local products and stocks.