Add branches management module with database schema and validation

- Introduced `BranchesModule` to manage organizational branches, including read and write controllers.
- Created database migrations for the `branches` table, including constraints and unique indexes.
- Implemented validation for branch fields such as name, code, and address with corresponding utility functions.
- Developed service and repository layers for handling branch data operations.
- Added unit tests for the branches service, repository, and controllers to ensure functionality and correctness.
- Updated application module to include the new `BranchesModule` for better organization.
This commit is contained in:
shancheas
2026-08-24 13:42:19 +07:00
parent a8faea20ff
commit d28506e878
22 changed files with 3686 additions and 13 deletions
+244
View File
@@ -0,0 +1,244 @@
import { INestApplication } from '@nestjs/common';
import { Test, TestingModule } from '@nestjs/testing';
import { eq } from 'drizzle-orm';
import request from 'supertest';
import { App } from 'supertest/types';
import { AppModule } from '../src/app.module';
import { configureApp } from '../src/common/configure-app';
import { DRIZZLE, type DrizzleDB } from '../src/database/database.module';
import {
privilegeDetails,
privilegeKeys,
privileges,
users,
} from '../src/database/schema';
import { PRIVILEGE_ACTIONS } from '../src/modules/privileges/privilege-action';
describe('Branches (e2e)', () => {
let app: INestApplication<App>;
let db: DrizzleDB;
const password = 'password123';
const adminUsername = `br_admin_${Date.now()}`;
const otherUsername = `br_other_${Date.now()}`;
let adminAccessToken: string;
let adminUserId: string;
let otherAccessToken: string;
let divisionId: string;
const payload = {
code: `JKT_${Date.now().toString().slice(-6)}`,
name: 'Jakarta Pusat',
phone: '+6281234567890',
address: 'Jl Sudirman No 1',
workingDaysStart: 'monday',
workingDaysEnd: 'friday',
workingHoursStart: '08:00',
workingHoursEnd: '17:00',
};
beforeAll(async () => {
const moduleFixture: TestingModule = await Test.createTestingModule({
imports: [AppModule],
}).compile();
app = moduleFixture.createNestApplication();
configureApp(app, {
NODE_ENV: 'test',
SWAGGER_ENABLED: 'false',
});
await app.init();
db = app.get(DRIZZLE);
const adminReg = await request(app.getHttpServer())
.post('/auth/register')
.send({ username: adminUsername, password })
.expect(201);
adminAccessToken = (adminReg.body as { accessToken: string }).accessToken;
const adminMe = await request(app.getHttpServer())
.get('/auth/me')
.set('Authorization', `Bearer ${adminAccessToken}`)
.expect(200);
adminUserId = (adminMe.body as { id: string }).id;
const otherReg = await request(app.getHttpServer())
.post('/auth/register')
.send({ username: otherUsername, password })
.expect(201);
otherAccessToken = (otherReg.body as { accessToken: string }).accessToken;
const now = Date.now();
const [priv] = await db
.insert(privileges)
.values({
name: 'Branch Admin',
code: `BR_ADMIN_${now}`,
status: 'active',
createdAt: now,
updatedAt: now,
createdBy: adminUserId,
updatedBy: adminUserId,
})
.returning();
const keys = await db.select().from(privilegeKeys);
const detailRows = keys.flatMap((key) =>
PRIVILEGE_ACTIONS.map((action) => ({
privilegeId: priv.id,
privilegeKeyId: key.id,
action,
value: true,
})),
);
await db.insert(privilegeDetails).values(detailRows);
await db
.update(users)
.set({ privilegeId: priv.id, updatedAt: Date.now() })
.where(eq(users.id, adminUserId));
const division = await request(app.getHttpServer())
.post('/divisions')
.set('Authorization', `Bearer ${adminAccessToken}`)
.send({
name: 'Jakarta Division',
code: `JD_${Date.now().toString().slice(-6)}`,
})
.expect(201);
divisionId = (division.body as { id: string }).id;
});
afterAll(async () => {
await app.close();
});
it('forbids branches list without permission', async () => {
await request(app.getHttpServer())
.get('/branches')
.set('Authorization', `Bearer ${otherAccessToken}`)
.expect(403);
});
it('rejects unauthenticated access', async () => {
await request(app.getHttpServer()).get('/branches').expect(401);
});
it('CRUD branches with phone, hours, optional geo/NFC/division, and bulk', async () => {
const created = await request(app.getHttpServer())
.post('/branches')
.set('Authorization', `Bearer ${adminAccessToken}`)
.send(payload)
.expect(201);
expect(created.body).toMatchObject({
code: payload.code,
name: 'Jakarta Pusat',
phone: '+6281234567890',
status: 'draft',
createdBy: adminUserId,
latitude: null,
nfcId: null,
divisionId: null,
});
const id = (created.body as { id: string }).id;
await request(app.getHttpServer())
.post('/branches')
.set('Authorization', `Bearer ${adminAccessToken}`)
.send({ ...payload, code: 'BAD 01', name: 'Other Branch' })
.expect(400);
await request(app.getHttpServer())
.post('/branches')
.set('Authorization', `Bearer ${adminAccessToken}`)
.send({ ...payload, code: 'PHN_01', phone: '081234567890' })
.expect(400);
await request(app.getHttpServer())
.post('/branches')
.set('Authorization', `Bearer ${adminAccessToken}`)
.send({ ...payload, code: 'DAY_01', workingDaysStart: 'Monday' })
.expect(400);
await request(app.getHttpServer())
.get(`/branches/${id}`)
.set('Authorization', `Bearer ${adminAccessToken}`)
.expect(200);
await request(app.getHttpServer())
.patch(`/branches/${id}`)
.set('Authorization', `Bearer ${adminAccessToken}`)
.send({
name: 'Jakarta Selatan',
latitude: -6.2,
longitude: 106.8,
nfcId: 'NFC-001',
divisionId,
})
.expect(200);
await request(app.getHttpServer())
.patch(`/branches/${id}`)
.set('Authorization', `Bearer ${adminAccessToken}`)
.send({ status: 'active' })
.expect(400);
await request(app.getHttpServer())
.patch(`/branches/${id}/status`)
.set('Authorization', `Bearer ${adminAccessToken}`)
.send({ status: 'active' })
.expect(200);
const list = await request(app.getHttpServer())
.get('/branches?search=Jakarta')
.set('Authorization', `Bearer ${adminAccessToken}`)
.expect(200);
expect(
(list.body as { data: unknown[] }).data.length,
).toBeGreaterThanOrEqual(1);
expect((list.body as { meta?: unknown }).meta).toBeDefined();
const extra = await request(app.getHttpServer())
.post('/branches')
.set('Authorization', `Bearer ${adminAccessToken}`)
.send({
...payload,
code: `BDG_${Date.now().toString().slice(-6)}`,
name: 'Bandung Kota',
})
.expect(201);
await request(app.getHttpServer())
.post('/branches/bulk-status')
.set('Authorization', `Bearer ${adminAccessToken}`)
.send({ ids: [(extra.body as { id: string }).id], status: 'archived' })
.expect(200);
await request(app.getHttpServer())
.post('/branches/bulk-delete')
.set('Authorization', `Bearer ${adminAccessToken}`)
.send({ ids: [(extra.body as { id: string }).id] })
.expect(200);
await request(app.getHttpServer())
.delete(`/branches/${id}`)
.set('Authorization', `Bearer ${adminAccessToken}`)
.expect(204);
});
it('imports branches from CSV', async () => {
const suffix = Date.now().toString().slice(-6);
const csv =
'code,name,phone,address,workingDaysStart,workingDaysEnd,workingHoursStart,workingHoursEnd,status\n' +
`IMP_${suffix},Imported Branch,+6281234567890,Jl Imported No 1,monday,friday,08:00,17:00,draft\n`;
const res = await request(app.getHttpServer())
.post('/branches/import')
.set('Authorization', `Bearer ${adminAccessToken}`)
.attach('file', Buffer.from(csv, 'utf8'), 'branches.csv')
.expect(201);
expect(res.body as { imported: number }).toMatchObject({ imported: 1 });
});
});