@simitgroup/simpleapp-generator 1.6.7-o-alpha → 2.0.0-b-alpha

package/templates/nest/src/simple-app/.core/features/log/log.service.ts.eta

@@ -0,0 +1,68 @@
+/**
+ * This file was automatically generated by simpleapp generator. Every
+ * MODIFICATION OVERRIDE BY GENERATEOR
+ * last change 2023-10-28
+ * Author: Ks Tan
+ */
+import { InjectModel } from '@nestjs/mongoose';
+import { Injectable } from '@nestjs/common';
+import { UserContext } from '../user-context/user.context';
+import { Model } from 'mongoose';
+import { DocumentEvent, ApiEvent } from './schemas';
+
+@Injectable()
+export class SimpleAppLogService {
+  constructor(@InjectModel('DocumentEvent') private doc: Model<DocumentEvent>) {}
+
+  // addEvent(data: any) {
+  //   console.log('Add event into db:', data);
+  // }
+  async addEvent(appUser: UserContext, documentName: string, id: string, eventType: string, data: any) {
+    const eventdata: DocumentEvent = {
+      _id: crypto.randomUUID(),
+      documentName: documentName,
+      documentId: id,
+      eventType: eventType,
+      eventData: data,
+      created:'',
+      createdBy:'',
+      updated: '',
+      updatedBy:'',
+      tenantId:0,
+      orgId:0,
+      branchId:0,
+    };
+    Object.assign(eventdata, appUser.getCreateFilter());
+    // console.log('add event', documentName, id, eventType);
+    // console.log('Add event into db:', eventdata);
+    const newdoc = new this.doc(eventdata);
+    const dbsession = appUser.getDBSession();
+    const result = await newdoc.save({ session: dbsession });
+  }
+
+  async addManyEvents(appUser: UserContext, documentName: string, eventType: string, datas: any[]) {
+    // console.log('add many event', documentName, eventType);
+    const alldata: DocumentEvent[] = [];
+    for (const data of datas) {
+      Object.assign(data, appUser.getCreateFilter());
+      const eventdata: DocumentEvent = {
+        _id: crypto.randomUUID(),
+        documentName: documentName,
+        documentId: data.id,
+        eventType: eventType,
+        eventData: data,
+        created:'',
+        createdBy:'',
+        updated: '',
+        updatedBy:'',
+        tenantId:0,
+        orgId:0,
+        branchId:0,
+      };
+      Object.assign(eventdata, appUser.getCreateFilter());
+      alldata.push(eventdata);
+    }
+    const dbsession = appUser.getDBSession();
+    this.doc.insertMany(alldata, { session: dbsession });
+  }
+}

package/templates/nest/src/simple-app/.core/features/log/schemas/api-event.schema.ts.eta

@@ -0,0 +1,57 @@
+import { Prop, Schema, SchemaFactory } from '@nestjs/mongoose';
+// const schemasetting = {
+//   _id: { type: String },
+//   created: { type: String },
+//   updated: { type: String },
+//   duration: { type: Number },
+//   createdBy: { type: String },
+//   path: { type: String },
+//   ip: { type: String },
+//   method: { type: String },
+//   headers: { type: Object },
+//   data: { type: Object },
+//   statusCode: { type: Number },
+//   status: { type: String },
+//   errMsg: { type: String },
+//   errData: { type: Object },
+// };
+@Schema()
+export class ApiEvent {
+  @Prop()
+  _id: string;
+  @Prop()
+  created: string;
+  @Prop()
+  updated?: string;
+  @Prop()
+  duration: number;
+  @Prop()
+  createdBy: string;
+  @Prop()
+  path: string;
+  @Prop()
+  ip: string;
+  @Prop()
+  method: string;
+  @Prop({type:Object})
+  headers: Object;  
+  @Prop({type:Object})
+  data?: Object;
+  @Prop()
+  statusCode: number;
+  @Prop()
+  status: string;
+  @Prop()
+  errMsg?: string;
+  @Prop({type:Object})
+  errData?: Object;
+}
+
+export const ApiEventMongoSchema = SchemaFactory.createForClass(ApiEvent)
+  .pre('save', function (next) {
+    this.increment();
+    return next();
+  })
+
+  .index({ tenantId: 1 })
+  .index({ created: 1 });

package/templates/nest/src/simple-app/.core/features/log/schemas/document-event.schema.ts.eta

@@ -0,0 +1,87 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { Field, ObjectType, ID } from '@nestjs/graphql';
+import GraphQLJSON, { GraphQLJSONObject } from 'graphql-type-json';
+import { Prop, Schema, SchemaFactory } from '@nestjs/mongoose';
+
+@ObjectType()
+@Schema()
+export class DocumentEvent {
+  @Prop()
+  @Field()
+  @ApiProperty({ type: 'string', required: false, format: 'uuid', default: '' })
+  _id: string;
+  @Prop()
+  @Field()
+  @ApiProperty({ type: 'string', required: false, default: '' })
+  created: string;
+  @Prop()
+  @Field()
+  @ApiProperty({ type: 'string', required: false, default: '' })
+  updated: string;
+  @Prop()
+  @Field()
+  @ApiProperty({ type: 'string', required: false, default: '' })
+  createdBy: string;
+  @Prop()
+  @Field()
+  @ApiProperty({ type: 'string', required: false, default: '' })
+  updatedBy: string;
+  @Prop()
+  @Field()
+  @ApiProperty({ type: 'number', required: false, default: 1 })
+  tenantId: number;
+  @Prop()
+  @Field()
+  @ApiProperty({ type: 'number', required: false, default: 1 })
+  orgId: number;
+  @Prop()
+  @Field()
+  @ApiProperty({ type: 'number', required: false, default: 1 })
+  branchId: number;
+  @Prop()
+  @Field()
+  @ApiProperty({ type: 'string', required: false, default: '' })
+  documentName: string;
+  @Prop()
+  @Field()
+  @ApiProperty({ type: 'string', required: false, format: 'uuid', default: '' })
+  documentId: string;
+  @Prop()
+  @Field()
+  @ApiProperty({ type: 'string', required: false, example: ['create', 'delete'], default: '' })
+  eventType: string;
+  @Prop({type: ()=>Object})
+  @Field(() => GraphQLJSON)
+  @ApiProperty({ type: () => Object, required: false, default: {} })
+  eventData: Object;
+}
+
+/***************************************** Start Auto Complete *****************************************/
+@ObjectType()
+@Schema()
+export class DocumenteventAutoComplete {
+  @Prop()
+  @Field()
+  @ApiProperty({ type: 'string', required: true, default: '' })
+  _id: string;
+
+  @Prop()
+  @Field()
+  @ApiProperty({ type: 'string', required: true, default: '' })
+  code: string;
+
+  @Prop()
+  @Field()
+  @ApiProperty({ type: 'string', required: true, default: '' })
+  label: string;
+}
+/****************************************** End Auto Complete ******************************************/
+
+/************************************** Customized Code Begin Here *************************************/
+
+// create mongodb schema
+
+export const DocumentEventMongoSchema = SchemaFactory.createForClass(DocumentEvent).pre('save', function (next) {
+  this.increment();
+  return next();
+});

package/templates/nest/src/simple-app/.core/features/log/schemas/index.ts.eta

@@ -0,0 +1,2 @@
+export * from './api-event.schema'
+export * from './document-event.schema'

package/templates/nest/src/simple-app/.core/features/maintenance/maintenance.controller.ts.eta

@@ -0,0 +1,84 @@
+/**
+ * This file was automatically generated by simpleapp generator. Every
+ * MODIFICATION OVERRIDE BY GENERATEOR
+ * last change 2025-09-01
+ * Author: Ks Tan
+ */
+import { Controller, Get, Post, Param, Logger, HttpCode } from '@nestjs/common';
+import { MaintenanceService } from './maintenance.service';
+import { ApiTags, ApiBody, ApiResponse, ApiOperation, ApiQuery } from '@nestjs/swagger';
+import { Roles } from 'src/simple-app/.core/features/auth/role-guard/roles.decorator';
+import { Role } from 'src/simple-app/.core/features/auth/role-guard/roles.enum';
+import * as schemas from './schemas';
+import { UserContext } from 'src/simple-app/.core/features/user-context/user.context';
+import { AppUser } from 'src/simple-app/.core/features/user-context/appuser.decorator';
+@ApiTags('maintenance')
+@Controller('maintenance')
+@Roles(Role.SuperAdmin)
+export class MaintenanceController {
+  private logger = new Logger();
+  constructor(private readonly maintenanceSvc: MaintenanceService) {}
+
+  @Get('/get-updates')
+  @Roles(Role.SuperAdmin)
+  @ApiResponse({
+    status: 200,
+    description: 'Sample 200 response',
+    type: [schemas.UpgradeScript],
+  })
+  async getUpdate(@AppUser() appuser: UserContext) {
+    const result = await this.maintenanceSvc.getUpdates(appuser);
+    return result;
+  }
+
+  @Post('/run-updates/:id')
+  @HttpCode(200)
+  @Roles(Role.SuperAdmin)
+  @ApiResponse({
+    status: 200,
+    description: 'Sample 200 response',
+    type: [String],
+  })
+  async runUpdate(@AppUser() appuser: UserContext, @Param('id') id: string) {
+    const result: string = await this.maintenanceSvc.runUpdates(appuser, id);
+    return result;
+  }
+
+  @Get('/service-status')
+  @Roles(Role.SuperAdmin)
+  @ApiResponse({
+    status: 200,
+    description: 'Sample 200 response',
+    type: Boolean,
+  })
+  async runGetServiceStatus(@AppUser() appuser: UserContext) {
+    const result: Boolean = await this.maintenanceSvc.runGetServiceStatus(appuser);
+    return result;
+  }
+
+  @Post('/stop-service')
+  @HttpCode(200)
+  @Roles(Role.SuperAdmin)
+  @ApiResponse({
+    status: 200,
+    description: 'Sample 200 response',
+    type: String,
+  })
+  async runStopService(@AppUser() appuser: UserContext) {
+    const result: string = await this.maintenanceSvc.runStopService(appuser);
+    return result;
+  }
+
+  @Post('/start-service')
+  @HttpCode(200)
+  @Roles(Role.SuperAdmin)
+  @ApiResponse({
+    status: 200,
+    description: 'Sample 200 response',
+    type: String,
+  })
+  async runStartService(@AppUser() appuser: UserContext) {
+    const result: string = await this.maintenanceSvc.runStartService(appuser);
+    return result;
+  }
+}

package/templates/nest/src/simple-app/.core/features/maintenance/maintenance.module.ts.eta

@@ -0,0 +1,19 @@
+/**
+ * This file was automatically generated by simpleapp generator. Every
+ * MODIFICATION OVERRIDE BY GENERATEOR
+ * last change 2024-04-02
+ * Author: Ks Tan
+ */
+import { Module } from '@nestjs/common';
+import { MongooseModule } from '@nestjs/mongoose';
+import { EnvironmentMongoSchema } from './schemas';
+import { MaintenanceService } from './maintenance.service';
+import { MaintenanceController } from './maintenance.controller';
+const mymongo = MongooseModule.forFeature([{ name: 'Environment', schema: EnvironmentMongoSchema }])
+@Module({
+  imports: [mymongo],
+  controllers: [MaintenanceController],
+  providers: [MaintenanceService],
+  exports: [mymongo,MaintenanceService],
+})
+export class MaintenanceModule {}

package/templates/nest/src/simple-app/.core/features/maintenance/maintenance.service.ts.eta

@@ -0,0 +1,86 @@
+/**
+ * This file was automatically generated by simpleapp generator. Every
+ * MODIFICATION OVERRIDE BY GENERATEOR
+ * last change 2025-09-01
+ * Author: Ks Tan
+ */
+
+import { BadRequestException, Injectable, InternalServerErrorException } from '@nestjs/common';
+import { Model } from 'mongoose';
+import { InjectModel } from '@nestjs/mongoose';
+import * as dbupdate from './db-update';
+import * as schemas from './schemas';
+import { UserContext } from 'src/simple-app/.core/features/user-context/user.context';
+@Injectable()
+export class MaintenanceService {
+  constructor(@InjectModel('Environment') private sysEnvdoc: Model<schemas.Environment>) {
+    this.initEnv();
+  }
+
+  async initEnv() {
+    const res = await this.sysEnvdoc.find();
+    if (res.length == 0) {
+      const newdoc = new this.sysEnvdoc({
+        systemEnable: true,
+      });
+      await newdoc.save();
+    }
+  }
+
+  async getUpdates(appuser: UserContext) {
+    const keys = Object.keys(dbupdate);
+    const updatescripts: schemas.UpgradeScript[] = [];
+    const key = keys[0];
+    // console.log(dbupdate[key]())
+
+    keys.forEach((k) => {
+      const item = dbupdate[k]();
+      if (item.execute && item.subject) {
+        updatescripts.push({
+          id: k,
+          subject: item.subject,
+          description: item.description,
+        });
+      }
+    });
+
+    return Promise.resolve(updatescripts);
+  }
+
+  async runUpdates(appuser: UserContext, versionId: string) {
+    try {
+      if (dbupdate[versionId]) {
+        const result = await dbupdate[versionId]().execute();
+        return Promise.resolve(result);
+      } else {
+        throw new BadRequestException(`invalid update script ${versionId}`);
+      }
+    } catch (e) {
+      throw new InternalServerErrorException(`Error db update (${versionId}): ${e.message}`);
+    }
+  }
+  async runGetServiceStatus(appuser: UserContext) {
+    const res = await this.sysEnvdoc.find();
+    if (res.length > 0) {
+      return res[0].systemEnable;
+    } else {
+      return true;
+    }
+  }
+  async runStopService(appuser: UserContext) {
+    const res = await this.sysEnvdoc.find();
+    if (res.length > 0) {
+      res[0].systemEnable = false;
+      res[0].save();
+    }
+    return Promise.resolve(`status: ${res[0].systemEnable}`);
+  }
+  async runStartService(appuser: UserContext) {
+    const res = await this.sysEnvdoc.find();
+    if (res.length > 0) {
+      res[0].systemEnable = true;
+      res[0].save();
+    }
+    return Promise.resolve(`status: ${res[0].systemEnable}`);
+  }
+}

package/templates/nest/src/simple-app/.core/features/maintenance/schemas/environment.ts.eta

@@ -0,0 +1,23 @@
+/**
+ * This file was automatically generated by simpleapp generator. Every
+ * MODIFICATION OVERRIDE BY GENERATEOR
+ * last change 2025-08-27
+ * Author: Ks Tan
+ */
+import { Prop, Schema, SchemaFactory } from '@nestjs/mongoose';
+ @Schema()
+export class Environment {
+        @Prop()
+    systemEnable: Boolean
+        @Prop()
+    stopUntil: String
+        @Prop()
+    maintenanceMessage: String
+};
+
+
+export const EnvironmentMongoSchema = SchemaFactory.createForClass(Environment)
+  .pre('save', function (next) {
+    this.increment();
+    return next();
+  })

package/templates/nest/src/{simpleapp/maintenance/apischemas → simple-app/.core/features/maintenance/schemas}/index.ts.eta

@@ -4,5 +4,5 @@
  * last change 2025-08-27
  * Author: Ks Tan
  */
-export * from './dbupdate'
+export * from './db-update'
 export * from './environment'

package/templates/nest/src/simple-app/.core/features/mini-app/developer-portal/developer-portal-bridge.service.ts.eta.eta

@@ -0,0 +1,31 @@
+import { BadRequestException, Injectable, NotFoundException } from '@nestjs/common';
+import { UserContext } from 'src/simpleapp/generate/commons/user.context';
+import _ from 'lodash';
+import { InjectModel } from '@nestjs/mongoose';
+import { Model } from 'mongoose';
+import { Miniapp } from 'src/simpleapp/generate/apischemas';
+import { DynamicParam } from 'src/simpleapp/generate/types';
+import { DeveloperPortalEnvDevelopmentService } from './developer-portal-env-development.service';
+import { DeveloperPortalEnvProductionService } from './developer-portal-env-production.service';
+import { DeveloperPortalService } from './developer-portal.service';
+
+@Injectable()
+export class DeveloperPortalBridgeService {
+  constructor(
+    private readonly devService: DeveloperPortalEnvDevelopmentService,
+    private readonly prodService: DeveloperPortalEnvProductionService,
+    private readonly service: DeveloperPortalService,
+  ) {}
+
+  async runDeveloperPublishDev(appUser: UserContext, developerPortalAppId: string, dto: Miniapp) {
+    return await this.devService.publish(appUser, developerPortalAppId, dto);
+  }
+
+  async runDeveloperPublish(appUser: UserContext, developerPortalAppId: string, dto: Miniapp) {
+    return await this.prodService.publish(appUser, developerPortalAppId, dto);
+  }
+
+  async runDeveloperInstalledXOrgs(appUser: UserContext, developerPortalAppId: string) {
+    return await this.service.getInstalledMiniAppXOrgs(appUser, developerPortalAppId);
+  }
+}

package/templates/nest/src/simple-app/.core/features/mini-app/developer-portal/developer-portal-env-development.service.ts.eta

@@ -0,0 +1,124 @@
+import { BadRequestException, Injectable, InternalServerErrorException } from '@nestjs/common';
+import { MiniAppManagerEnvDevelopmentService } from '../mini-app-manager/mini-app-manager-env-development.service';
+import { UserService } from 'src/simpleapp/services/user.service';
+import { PermissionService } from 'src/simpleapp/services/perm.service';
+import { UserContext } from 'src/simpleapp/generate/commons/user.context';
+import { Miniapp, User } from 'src/simpleapp/generate/types';
+import _ from 'lodash';
+import { MiniAppError } from '../mini-app-manager/mini-app-manager.error';
+import { MiniAppManagerEnvEnum } from '../mini-app-manager/mini-app-manager.enum';
+import { InjectModel } from '@nestjs/mongoose';
+import { Model } from 'mongoose';
+import { DeveloperPortalService } from './developer-portal.service';
+
+@Injectable()
+export class DeveloperPortalEnvDevelopmentService {
+  constructor(
+    private readonly userService: UserService,
+    private readonly permissionService: PermissionService,
+    private readonly miniAppManagerService: MiniAppManagerEnvDevelopmentService,
+
+    @InjectModel('Miniapp')
+    protected miniAppDoc: Model<Miniapp>,
+  ) {
+    // super(miniAppDoc);
+  }
+
+  async findMiniApp(developerPortalAppId: string, env: MiniAppManagerEnvEnum) {
+    const miniApp = await this.miniAppDoc.findOne({
+      'developerPortal.appId': developerPortalAppId,
+      env,
+    });
+
+    return miniApp;
+  }
+
+  async publish(appUser: UserContext, developerPortalAppId: string, dto: Miniapp) {
+    this.assertDemoCompanyDefined();
+
+    appUser.setAsStaticUser(dto.author.uid, dto.author.email, dto.author.name, dto.author.email, process.env.DEMO_COMPANY_XORG);
+    appUser.setPackage('enterprise'); // else cannot install mini app
+
+    const miniApp = await this.findMiniApp(developerPortalAppId, MiniAppManagerEnvEnum.DEV);
+    if (!miniApp) {
+      return await this.createMiniApp(appUser, developerPortalAppId, dto);
+    } else {
+      return await this.updateMiniApp(appUser, miniApp.toObject(), dto);
+    }
+  }
+
+  async createMiniApp(appUser: UserContext, developerPortalAppId: string, dto: Miniapp) {
+    await this.inviteDeveloperToDemoCompany(appUser);
+    const miniApp = await this.miniAppManagerService.createMiniApp(appUser, developerPortalAppId, dto);
+    await this.miniAppManagerService.runInstallMiniApp(appUser, miniApp);
+
+    return miniApp;
+  }
+
+  async updateMiniApp(appUser: UserContext, miniApp: Miniapp, dto: Miniapp) {
+    const updatedMiniApp = await this.miniAppManagerService.updateMiniApp(appUser, miniApp, dto);
+
+    return updatedMiniApp;
+  }
+
+  private assertDemoCompanyDefined() {
+    if (_.isEmpty(process.env.DEMO_COMPANY_XORG)) {
+      const msg = MiniAppError.format(MiniAppError.ERR.UNDEFINED_DEMO_COMPANY);
+      throw new InternalServerErrorException(msg);
+    }
+  }
+
+  private async inviteDeveloperToDemoCompany(appUser: UserContext) {
+    const demoCompany = appUser.decodeXOrg(process.env.DEMO_COMPANY_XORG);
+
+    // Already setAsStaticUser author info in previous step, so by right can get correct author info
+    const users = await this.userService.search(appUser, {
+      email: appUser.getEmail(),
+    });
+
+    if (users && users.length > 0) {
+      return;
+    }
+
+    const user = await this.createUserRecordInDemoCompany(appUser, demoCompany);
+    await this.assignPermissionToDemoDeveloper(appUser, demoCompany, user);
+  }
+
+  private async createUserRecordInDemoCompany(
+    appUser: UserContext,
+    demoCompany: {
+      tenantId: number;
+      orgId: number;
+      branchId: number;
+    },
+  ) {
+    return await this.userService.create(appUser, {
+      email: appUser.getEmail(),
+      fullName: appUser.getFullname(),
+      uid: appUser.getUid(),
+      tenantId: demoCompany.tenantId,
+      orgId: demoCompany.orgId,
+      branchId: demoCompany.branchId,
+      active: true,
+    });
+  }
+
+  private async assignPermissionToDemoDeveloper(
+    appUser: UserContext,
+    demoCompany: {
+      tenantId: number;
+      orgId: number;
+      branchId: number;
+    },
+    user: User,
+  ) {
+    await this.permissionService.create(appUser, {
+      tenantId: demoCompany.tenantId,
+      orgId: demoCompany.orgId,
+      branchId: demoCompany.branchId,
+      groups: ['admin'],
+      uid: appUser.getUid(),
+      userId: user._id,
+    });
+  }
+}

package/templates/nest/src/simple-app/.core/features/mini-app/developer-portal/developer-portal-env-production.service.ts.eta

@@ -0,0 +1,50 @@
+import { Injectable } from '@nestjs/common';
+import { UserContext } from 'src/simpleapp/generate/commons/user.context';
+import { Miniapp } from 'src/simpleapp/generate/types';
+import _ from 'lodash';
+import { MiniAppManagerEnvEnum } from '../mini-app-manager/mini-app-manager.enum';
+import { InjectModel } from '@nestjs/mongoose';
+import { Model } from 'mongoose';
+import { MiniAppManagerEnvProductionService } from '../mini-app-manager/mini-app-manager-env-production.service';
+import { DeveloperPortalService } from './developer-portal.service';
+
+@Injectable()
+export class DeveloperPortalEnvProductionService {
+  constructor(
+    private readonly miniAppManagerService: MiniAppManagerEnvProductionService,
+
+    @InjectModel('Miniapp')
+    protected miniAppDoc: Model<Miniapp>,
+  ) {
+    // super(miniAppDoc);
+  }
+
+  async findMiniApp(developerPortalAppId: string, env: MiniAppManagerEnvEnum) {
+    const miniApp = await this.miniAppDoc.findOne({
+      'developerPortal.appId': developerPortalAppId,
+      env,
+    });
+
+    return miniApp;
+  }
+
+  async publish(appUser: UserContext, developerPortalAppId: string, dto: Miniapp) {
+    const miniApp = await this.findMiniApp(developerPortalAppId, MiniAppManagerEnvEnum.PROD);
+
+    if (!miniApp) {
+      return await this.createMiniApp(appUser, developerPortalAppId, dto);
+    } else {
+      return await this.updateMiniApp(appUser, miniApp.toObject(), dto);
+    }
+  }
+
+  async createMiniApp(appUser: UserContext, developerPortalAppId: string, dto: Miniapp) {
+    return await this.miniAppManagerService.createMiniApp(appUser, developerPortalAppId, dto);
+  }
+
+  async updateMiniApp(appUser: UserContext, miniApp: Miniapp, dto: Miniapp) {
+    const updatedMiniApp = await this.miniAppManagerService.updateMiniApp(appUser, miniApp, dto);
+
+    return updatedMiniApp;
+  }
+}