How nitinrawat26/mapwright works
MapWright builds normalized profiles for two merchant-acquiring systems, applies domain playbooks and matching rules to produce a versioned field-mapping spec, then supports review, validation, replay, and human-readable exports. Users can work through the CLI or web application; the API and SQLite-backed stores support the web product. The graph preserves documented profile inputs, mapping outputs, AI assistance, playbooks, and web-facing capabilities. Some subsystem links are omitted where the supplied excerpts do not show the caller or data transfer.
Main entry points: MappingDocument.cs Mapping spec · CliApp.cs CLI · ProfileBuilder.cs Profile builder · MappingBuilder.cs Mapping builder
Components 19
User interfaces
- CLI
src/MapWright.Cli/CliApp.cs - Web application
web/src/app/app.routes.ts - HTTP API
src/MapWright.Api/Program.cs
System profiles
- Profile input readers
src/MapWright.Output/Readers/ProfileInputs.cs - Contract readers
src/MapWright.Core/Profile/Contracts - Profile builder
src/MapWright.Core/Profile/ProfileBuilder.cs - System profile
src/MapWright.Core/Profile/SystemProfile.cs
Mapping engine
- Domain playbooks
src/MapWright.Core/Playbooks/Playbook.cs - Playbook library
src/MapWright.Core/Playbooks/PlaybookLibrary.cs - Mapping generation
src/MapWright.Core/Matching/MappingGenerator.cs - Mapping builder
src/MapWright.Core/Matching/MappingBuilder.cs - Mapping spec
src/MapWright.Core/Spec/MappingDocument.cs - AI assistance
src/MapWright.Ai/AiMappingAssistant.cs - AI providers
src/MapWright.Ai/IAiProvider.cs
Review and execution
- Spec validation
src/MapWright.Core/Spec/MappingSpecValidator.cs - Mapping replay
src/MapWright.Core/Replay/TransformEngine.cs - Document renderers
src/MapWright.Output/Renderers
Persistence
- SQLite database
src/MapWright.Store/MapWrightDatabase.cs - Domain stores
src/MapWright.Store
Connections 20
- CLI → Profile input readers: reads inputs
src/MapWright.Cli/CliApp.cs - CLI → Profile builder: builds profiles
src/MapWright.Cli/CliApp.cs - CLI → Mapping generation: generates mappings
src/MapWright.Cli/CliApp.cs - CLI → Document renderers: renders exports
src/MapWright.Cli/CliApp.cs - Profile input readers → Contract readers: reads contracts
- Profile builder → System profile: produces profile
- Profile builder → Contract readers: uses readers
src/MapWright.Core/Profile/Contracts/XsdReader.cs - Mapping generation → Mapping builder: delegates mapping
src/MapWright.Core/Matching/MappingGenerator.cs - Mapping builder → Playbook library: matches playbooks
src/MapWright.Core/Matching/MappingBuilder.cs - Mapping builder → Mapping spec: builds spec
src/MapWright.Core/Matching/MappingBuilder.cs - Playbook library → Domain playbooks: selects active
src/MapWright.Core/Playbooks/PlaybookLibrary.cs - AI assistance → AI providers: requests completions
src/MapWright.Ai/AiMappingAssistant.cs - AI assistance → Mapping spec: suggests rows
src/MapWright.Ai/AiMappingAssistant.cs - Spec validation → Mapping spec: validates spec
src/MapWright.Core/Spec/MappingSpecValidator.cs - Mapping replay → Mapping spec: executes mappings
src/MapWright.Core/Replay/TransformEngine.cs - Document renderers → Mapping spec: renders spec
- HTTP API → SQLite database: configures database
src/MapWright.Api/Program.cs - HTTP API → Domain stores: registers stores
src/MapWright.Api/Program.cs - Domain stores → SQLite database: opens connections
src/MapWright.Store/MapWrightDatabase.cs - Web application → HTTP API: calls API