#
CREATE TABLE `tt_teams` (
`id` int(11) NOT NULL auto_increment, # team id
- `timestamp` timestamp default CURRENT_TIMESTAMP, # modification timestamp
+ `timestamp` timestamp default CURRENT_TIMESTAMP, # Modification timestamp. TODO: redo all timestamps to survive beyond 2038.
`name` varchar(80) default NULL, # team name
`currency` varchar(7) default NULL, # team currency symbol
`decimal_mark` char(1) NOT NULL default '.', # separator in decimals
);
+#
+# Structure for table tt_roles. This table stores customized team roles.
+#
+CREATE TABLE `tt_roles` (
+ `id` int(11) NOT NULL auto_increment, # Role id. Identifies roles for all groups on the server.
+ `team_id` int(11) NOT NULL, # Team id the role is defined for.
+ `name` varchar(80) default NULL, # Role name - custom role name. In case we are editing a
+ # predefined role (USER, etc.), we can rename the role here.
+ `description` varchar(255) default NULL, # Role description.
+ `rank` int(11) default 0, # Role rank, an integer value between 0-324. Predefined role ranks:
+ # USER - 4, CLIENT - 16, COMANAGER - 68, MANAGER - 324.
+ # Rank is used to determine what "lesser roles" are in each group
+ # for sutuations such as "manage_users".
+ # It also identifies a role within a team (by its "rank").
+ # Value of rank is to be used in role field in tt_users table,
+ # just like standard roles now.
+ `rights` text default NULL, # Comma-separated list of rights assigned to a role.
+ # NULL here for predefined roles (4, 16, 68, 324 - manager)
+ # means a hard-coded set of default access rights.
+ `status` tinyint(4) default 1, # Role status.
+ PRIMARY KEY (`id`)
+);
+
+# Create an index that guarantees unique active and inactive role ranks in each group.
+create unique index role_idx on tt_roles(team_id, rank, status);
+
+# Insert site-wide roles - site administrator and top manager.
+INSERT INTO `tt_roles` (`team_id`, `name`, `rank`, `rights`) VALUES (0, 'Site administrator', 1024, 'administer_site');
+INSERT INTO `tt_roles` (`team_id`, `name`, `rank`, `rights`) VALUES (0, 'Top manager', 512, 'track_own_time,track_own_expenses,view_own_reports,view_own_charts,view_own_invoices,manage_own_settings,view_users,track_time,track_expenses,view_reports,view_charts,override_punch_mode,override_own_punch_mode,override_date_lock,override_own_date_lock,swap_roles,approve_timesheets,manage_users,manage_projects,manage_tasks,manage_custom_fields,manage_clients,manage_invoices,manage_features,manage_basic_settings,manage_advanced_settings,manage_roles,export_data,manage_subgroups');
+
+
#
# Structure for table tt_users. This table is used to store user properties.
#
`password` varchar(50) default NULL, # password hash
`name` varchar(100) default NULL, # user name
`team_id` int(11) NOT NULL, # team id
- `role` int(11) default 4, # user role ("manager", "co-manager", "client", or "user")
+ `role_id` int(11) default NULL, # role id
`client_id` int(11) default NULL, # client id for "client" user role
`rate` float(6,2) NOT NULL default '0.00', # default hourly rate
`email` varchar(100) default NULL, # user email
+ `created` datetime default NULL, # creation timestamp
+ `created_ip` varchar(45) default NULL, # creator ip
+ `created_by` int(11) default NULL, # creator user_id (null for self)
+ `modified` datetime default NULL, # modification timestamp
+ `modified_ip` varchar(45) default NULL, # modifier ip
+ `modified_by` int(11) default NULL, # modifier user_id
+ `accessed` datetime default NULL, # last access timestamp
+ `accessed_ip` varchar(45) default NULL, # last access ip
`status` tinyint(4) default 1, # user status
PRIMARY KEY (`id`)
);
# Create admin account with password 'secret'. Admin is a superuser, who can create teams.
DELETE from `tt_users` WHERE login = 'admin';
-INSERT INTO `tt_users` (`login`, `password`, `name`, `team_id`, `role`) VALUES ('admin', md5('secret'), 'Admin', '0', '1024');
+INSERT INTO `tt_users` (`login`, `password`, `name`, `team_id`, `role_id`) VALUES ('admin', md5('secret'), 'Admin', '0', (select id from tt_roles where rank = 1024));
#
#
CREATE TABLE `tt_log` (
`id` bigint NOT NULL auto_increment, # time record id
- `timestamp` timestamp default CURRENT_TIMESTAMP, # modification timestamp
`user_id` int(11) NOT NULL, # user id
`date` date NOT NULL, # date the record is for
`start` time default NULL, # record start time (for example, 09:00)
`comment` text, # user provided comment for time record
`billable` tinyint(4) default 0, # whether the record is billable or not
`paid` tinyint(4) default 0, # whether the record is paid
+ `created` datetime default NULL, # creation timestamp
+ `created_ip` varchar(45) default NULL, # creator ip
+ `created_by` int(11) default NULL, # creator user_id
+ `modified` datetime default NULL, # modification timestamp
+ `modified_ip` varchar(45) default NULL, # modifier ip
+ `modified_by` int(11) default NULL, # modifier user_id
`status` tinyint(4) default 1, # time record status
PRIMARY KEY (`id`)
);
`show_client` tinyint(4) NOT NULL default 0, # whether to show client column
`show_invoice` tinyint(4) NOT NULL default 0, # whether to show invoice column
`show_paid` tinyint(4) NOT NULL default 0, # whether to show paid column
+ `show_ip` tinyint(4) NOT NULL default 0, # whether to show ip column
`show_project` tinyint(4) NOT NULL default 0, # whether to show project column
`show_start` tinyint(4) NOT NULL default 0, # whether to show start field
`show_duration` tinyint(4) NOT NULL default 0, # whether to show duration field
# This table lists expense items.
#
CREATE TABLE `tt_expense_items` (
- `id` bigint NOT NULL auto_increment, # expense item id
- `date` date NOT NULL, # date the record is for
- `user_id` int(11) NOT NULL, # user id the expense item is reported by
- `client_id` int(11) default NULL, # client id
- `project_id` int(11) default NULL, # project id
- `name` text NOT NULL, # expense item name (what is an expense for)
- `cost` decimal(10,2) default '0.00', # item cost (including taxes, etc.)
- `invoice_id` int(11) default NULL, # invoice id
- `paid` tinyint(4) default 0, # whether the item is paid
- `status` tinyint(4) default 1, # item status
+ `id` bigint NOT NULL auto_increment, # expense item id
+ `date` date NOT NULL, # date the record is for
+ `user_id` int(11) NOT NULL, # user id the expense item is reported by
+ `client_id` int(11) default NULL, # client id
+ `project_id` int(11) default NULL, # project id
+ `name` text NOT NULL, # expense item name (what is an expense for)
+ `cost` decimal(10,2) default '0.00', # item cost (including taxes, etc.)
+ `invoice_id` int(11) default NULL, # invoice id
+ `paid` tinyint(4) default 0, # whether the item is paid
+ `created` datetime default NULL, # creation timestamp
+ `created_ip` varchar(45) default NULL, # creator ip
+ `created_by` int(11) default NULL, # creator user_id
+ `modified` datetime default NULL, # modification timestamp
+ `modified_ip` varchar(45) default NULL, # modifier ip
+ `modified_by` int(11) default NULL, # modifier user_id
+ `status` tinyint(4) default 1, # item status
PRIMARY KEY (`id`)
);
#
-# Structure for table tt_roles. This table stores customized team roles.
+# Structure for table tt_site_config. This table stores configuration data
+# for Time Tracker site as a whole.
+# For example, database version, code version, site language, etc.
#
-CREATE TABLE `tt_roles` (
- `id` int(11) NOT NULL auto_increment, # Role id. Identifies roles for all groups on the server.
- `team_id` int(11) NOT NULL, # Team id the role is defined for.
- `name` varchar(80) default NULL, # Role name - custom role name. In case we are editing a
- # predefined role (USER, etc.), we can rename the role here.
- `description` varchar(255) default NULL, # Role description.
- `rank` int(11) default 0, # Role rank, an integer value between 0-324. Predefined role ranks:
- # USER - 4, CLIENT - 16, COMANAGER - 68, MANAGER - 324.
- # Rank is used to determine what "lesser roles" are in each group
- # for sutuations such as "manage_users".
- # It also identifies a role within a team (by its "rank").
- # Value of rank is to be used in role field in tt_users table,
- # just like standard roles now.
- `rights` text default NULL, # Comma-separated list of rights assigned to a role.
- # NULL here for predefined roles (4, 16, 68, 324 - manager)
- # means a hard-coded set of default access rights.
- `status` tinyint(4) default 1, # Role status.
- PRIMARY KEY (`id`)
+CREATE TABLE `tt_site_config` (
+ `param_name` varchar(32) NOT NULL, # parameter name
+ `param_value` text default NULL, # parameter value
+ `created` datetime default NULL, # creation timestamp
+ `modified` datetime default NULL, # modification timestamp
+ PRIMARY KEY (`param_name`)
);
-# Create an index that guarantees unique active and inactive role ranks in each group.
-create unique index role_idx on tt_roles(team_id, rank, status);
+INSERT INTO `tt_site_config` (`param_name`, `param_value`, `created`) VALUES ('version_db', '1.17.64', now()); # TODO: change when structure changes.