added and updated models

specs/models/biz/shareholder.v

@@ -12,16 +12,16 @@ pub enum ShareholderType {
 
 // Shareholder represents a shareholder of a company
 pub struct Shareholder {
-	base.Base // Base struct for common fields
+	base.Base // Provides id u32, creation_time, mod_time, comments []u32
 pub mut:
-	id         u32
-	company_id u32
-	user_id    u32
-	name       string
-	shares     f64
-	percentage f64
+	// id u32 is provided by base.Base
+	company_id u32                // Reference to Company.id
+	user_id    u32                // Reference to User.id (if individual) or another entity ID (if corporate)
+	name       string             // Denormalized name of the shareholder (user or corporate entity)
+	shares     f64                // Number of shares held
+	percentage f64                // Percentage of ownership
 	type_      ShareholderType
-	since      ourtime.OurTime
-	created_at ourtime.OurTime
-	updated_at ourtime.OurTime
+	since      ourtime.OurTime    // Date since becoming a shareholder
+	// created_at is provided by base.Base.creation_time
+	// updated_at is provided by base.Base.mod_time
 }