copilot-instructions.md 2.2 KB

Copilot Instructions for FISApp UI

Project Overview

  • This is a modular Angular application for the Financial Information System (FISApp UI).
  • Major dependencies are managed in src/dependencies/:
    • angularlib: SWOPT's shared Angular components
    • dp-ui: Domain Proxy UI library
    • fis: FIS library for TypeScript
  • The main app code is in src/app/ with feature modules under subfolders (e.g., dashboard/, menu/).

Developer Workflows

  • Initialize: Run ./init-project (or init-project.ps1 on Windows) after cloning to install dependencies.
  • Clean: Use ./clean-project (or clean-project.ps1) if you encounter dependency issues, especially with Angular libraries.
  • Development server: Use ng serve to start the app at http://localhost:4200/.
  • Build: Use ng build to generate production assets in dist/.
  • Unit tests: Run ng test (Karma).
  • E2E tests: Run ng e2e (add a platform if not present).

Key Conventions & Patterns

  • Shared Angular modules and components are in src/dependencies/angularlib/.
  • Domain-specific UI logic is in src/dependencies/dp-ui/.
  • Project-specific configuration is in src/config/ and src/assets/.
  • Use Angular CLI for scaffolding (ng generate ...).
  • If you see TS-993004 errors about CommonModule, clean the angularlib/node_modules/@angular folder as described in the main README.

Integration & Data Flow

  • The app is structured for modularity: each feature (dashboard, menu, etc.) is a subfolder in src/app/.
  • Cross-cutting services and base classes are in the shared libraries under src/dependencies/.
  • External dependencies are managed via package.json and the init-project script.

Examples

  • To add a new component: ng generate component my-feature
  • To clean Angular dependencies (Windows): powershell rm -r -force src/dependencies/angularlib/node_modules/@angular ./clean-project.ps1 ## References - Main app: src/app/ - Shared libraries: src/dependencies/angularlib/, src/dependencies/dp-ui/, src/dependencies/fis/ - Configuration: src/config/, src/assets/ - Build/test scripts: root directory and build/ For more, see the main README.md and library-specific README.md files in src/dependencies/.