feat(teams): implement team management core with RBAC and metadata

Author: soorq

src/modules/teams/entities/enums.ts

@@ -0,0 +1,9 @@
+import { baseSchema } from 'src/shared/entities';
+
+export const roleEnum = baseSchema.enum('team_role', ['admin', 'moderator', 'member']);
+export const statusEnum = baseSchema.enum('member_status', [
+    'pending',
+    'active',
+    'declined',
+    'banned',
+]);

src/modules/teams/entities/index.ts

@@ -0,0 +1,2 @@
+export { tags, teamsToTags, teams, teamMembers } from './teams.entity';
+export { roleEnum, statusEnum } from './enums';

src/modules/teams/entities/teams.entity.ts

@@ -0,0 +1,66 @@
+import { primaryKey, timestamp, text, varchar, index } from 'drizzle-orm/pg-core';
+import { createId } from '@paralleldrive/cuid2';
+import { roleEnum, statusEnum } from './enums';
+import { baseSchema, users } from 'src/shared/entities';
+
+export const teams = baseSchema.table(
+    'teams',
+    {
+        id: text('id')
+            .primaryKey()
+            .$defaultFn(() => createId()),
+        slug: varchar('slug', { length: 120 }).unique().notNull(),
+        name: varchar('name', { length: 100 }).notNull(),
+        description: text('description'),
+        avatarUrl: text('avatar_url'),
+        coverUrl: text('cover_url'),
+        ownerId: text('owner_id').references(() => users.id),
+        createdAt: timestamp('created_at').defaultNow().notNull(),
+        updatedAt: timestamp('updated_at').defaultNow().notNull(),
+    },
+    (t) => ({
+        slugIdx: index('team_slug_idx').on(t.slug),
+    }),
+);
+
+export const teamMembers = baseSchema.table(
+    'team_members',
+    {
+        teamId: text('team_id')
+            .references(() => teams.id, { onDelete: 'cascade' })
+            .notNull(),
+        userId: text('user_id')
+            .references(() => users.id, { onDelete: 'cascade' })
+            .notNull(),
+        role: roleEnum('role').default('member').notNull(),
+        status: statusEnum('status').default('pending').notNull(),
+        joinedAt: timestamp('joined_at'),
+        createdAt: timestamp('created_at').defaultNow().notNull(),
+    },
+    (t) => ({
+        pk: primaryKey({ columns: [t.teamId, t.userId] }),
+        statusIdx: index('member_status_idx').on(t.status),
+    }),
+);
+
+export const tags = baseSchema.table('tags', {
+    id: text('id')
+        .primaryKey()
+        .$defaultFn(() => createId()),
+    name: varchar('name', { length: 50 }).unique().notNull(),
+});
+
+export const teamsToTags = baseSchema.table(
+    'teams_to_tags',
+    {
+        teamId: text('team_id')
+            .references(() => teams.id, { onDelete: 'cascade' })
+            .notNull(),
+        tagId: text('tag_id')
+            .references(() => tags.id, { onDelete: 'cascade' })
+            .notNull(),
+    },
+    (t) => ({
+        pk: primaryKey({ columns: [t.teamId, t.tagId] }),
+    }),
+);

src/modules/teams/repository/index.ts

@@ -0,0 +1,2 @@
+export { TeamsRepository } from './teams.repository';
+export { ITeamsRepository } from './teams.repository.interface';

src/modules/teams/repository/teams.repository.interface.ts

@@ -0,0 +1 @@
+export interface ITeamsRepository {}

src/modules/teams/repository/teams.repository.ts

@@ -0,0 +1,11 @@
+import { Inject } from '@nestjs/common';
+import { ITeamsRepository } from './teams.repository.interface';
+import { DATABASE_SERVICE, DatabaseService } from '@libs/database';
+import * as schema from '../entities';
+
+export class TeamsRepository implements ITeamsRepository {
+    constructor(
+        @Inject(DATABASE_SERVICE)
+        private readonly db: DatabaseService<typeof schema>,
+    ) {}
+}

src/modules/teams/services/teams.service.ts

@@ -1,4 +1,10 @@
-import { Injectable } from '@nestjs/common';
+import { Inject, Injectable } from '@nestjs/common';
+import { ITeamsRepository } from '../repository';
 
 @Injectable()
-export class TeamsService {}
+export class TeamsService {
+    constructor(
+        @Inject('ITeamsRepository')
+        private readonly teamsRepo: ITeamsRepository,
+    ) {}
+}

src/modules/teams/teams.module.ts

@@ -1,11 +1,13 @@
 import { Module } from '@nestjs/common';
 import { TeamsController } from './controller';
 import { TeamsService } from './services';
+import { TeamsRepository } from './repository';
+
+const REPOSITORY = { provide: 'ITeamsRepository', useClass: TeamsRepository };
 
 @Module({
     imports: [],
     controllers: [TeamsController],
-    providers: [TeamsService],
-    exports: [],
+    providers: [REPOSITORY, TeamsService],
 })
 export class TeamsModule {}

src/shared/entities/index.ts

@@ -1,3 +1,4 @@
 export { baseSchema } from './schema';
 export * from '../../modules/user/entities';
 export * from '../../modules/auth/entities';
+export * from '../../modules/teams/entities';