fengruixiang
/
AML
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
AML/CLAUDE.md

5.1 KiB
Raw Blame History

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Repository Overview

This is a monorepo composed of four subprojects, each maintained as its own git repository under gitea.iconsz.com/iCON/:

Subproject Tech stack Repository
AML_Backend ASP.NET Core backend using the ABP (ASP.NET Boilerplate) framework https://gitea.iconsz.com/iCON/AML_Backend.git
AML_Frontend Angular 11 frontend using the ABP Angular framework https://gitea.iconsz.com/iCON/AML_Frontend.git
justsolutionsWeb Angular 16 web app (justsolutions-web v1.2.0, Angular CLI 16.2.14) https://gitea.iconsz.com/iCON/justsolutionsWeb.git
justsolutionsWebV2 Node.js + Express hosted static site (justsolutions-web v2.0.0); supports one-click API switching across test/dev/stag/prod (default test uses a local mock) https://gitea.iconsz.com/iCON/justsolutionsWebV2.git

The sections below focus on the two primary applications, AML_Backend and AML_Frontend.

Build Commands

Frontend (AML_Frontend)

cd AML_Frontend
npm install --legacy-peer-deps      # Install dependencies
npm start                           # Start dev server with --open
npm run build:dev                    # Build for development
npm run build:prod                  # Build for production
npm run build:prod2                 # Build for production2 (alternative env)
npm test                            # Run unit tests
npm run lint                        # Run linter
npm run e2e                         # Run e2e tests

Backend (AML_Backend)

# Build with dotnet CLI
dotnet build iCON.Abp.AMLSolution.sln

# Run migrations (Visual Studio Package Manager Console)
# 1. Set EntityFrameworkCore.DbMigrations as startup project
# 2. Set default project to: src\EntityFrameworkCore.DbMigrations
# 3. Run: Add-Migration <MigrationName>

Architecture

Backend Architecture (ABP Framework)

Solution Structure: AML_Backend/iCON.Abp.AMLSolution.sln

Core Modules:

  • modules/iCON.Abp.AML/ - Main AML (Anti-Money Laundering) module with:
    • Application.Contracts - Service interfaces and DTOs
    • Application - Service implementations
    • Domain - Entities, domain logic
    • Domain.Shared - Shared enums, constants
    • EntityFrameworkCore - Repositories, DbContext
    • HttpApi - API controllers

Key Services in iCON.Abp.AML:

  • DetectionService - AML detection logic
  • CRCheckerService - Compliance checking
  • ConsumerPortalService - Consumer-facing portal operations
  • CorporationService / IndividualService - Entity management
  • DataCollectService - Data collection pipeline
  • STRService - Suspicious Transaction Reporting
  • ReportService - Report generation

Host Projects:

  • src/iCON.Abp.FX.HttpApi.Host - Main API host (Program.cs entry point)
  • src/iCON.Abp.FX.Web.Public - Public web portal
  • src/iCON.Abp.FX.DbMigrator - Database migration runner

Infrastructure Projects:

  • infrastructure/iCON.Core.Infrastructure.* - Shared infrastructure utilities

Frontend Architecture (Angular 11 + ABP)

Main Application (AML_Frontend/src/app/):

  • app.module.ts - Root module with ABP configuration
  • Feature modules under modules/:
    • aml-query/, agent/, configuration/, document/, form/, home/, investigate-setting/, llm/, log/, operator/, plan/, realtime-screening/, report/, risk-report/, screen-report/, stats/, str/, tenant-info/, transaction-report/, white-list/

Shared Components (src/app/shared/):

  • shared.module.ts - Shared module exports

Viewer Components (src/app/components/components-viewer/):

  • viewer-account-select/, viewer-account-form/, viewer-confirm-status/, viewer-customer-info/, viewer-print-list/, viewer-scan-modal/, viewer-upload-modal/

External Module Dependencies:

  • @volo/abp.ng.* - ABP Angular modules (account, identity, saas, audit-logging, language-management, etc.)
  • @abp/ng.* - ABP Angular core modules
  • ng-zorro-antd - UI component library
  • primeng - PrimeNG components
  • @ngxs/store - State management
  • ngx-echarts - Charting
  • @syncfusion/ej2-angular-* - Syncfusion components

Build Configuration:

  • Angular 11 with angular.json defining build targets
  • Multiple environment configurations (environment.ts, environment.dev.ts, environment.prod.ts, environment.prod2.ts)
  • Uses SCSS for styling, HashLocationStrategy for routing

Database Migrations

Migrations use Entity Framework Core. To create a migration:

  1. Set EntityFrameworkCore.DbMigrations as the startup project in Visual Studio
  2. Open Package Manager Console, set default project to src\EntityFrameworkCore.DbMigrations
  3. Run Add-Migration <MigrationName>
  4. Migrations apply automatically on next run

Notes

  • The backend uses ABP's modular architecture - each module (AML, AMLPortal, Basic, MediaStore) follows the same layer pattern
  • Frontend proxies API calls through the Angular dev server configuration
  • Both frontend and backend share the same solution but are in separate directories