46 |
47 |
FinReconcile and RuleEngine
48 |
56 |
57 |
58 |
Technologies Used
59 |
60 | - C#
61 | - ASP.NET MVC 5
62 | - Bootstrap,Jquery
63 | - Specflow for BDD (http://specflow.org/)
64 | -
65 | Microsoft Azure for Hosting
66 |
67 | -
68 | CI/CD using Appveyor/Azure Team Services
69 |
70 | -
71 | Living Documentation Generation using http://www.picklesdoc.com/
72 |
73 |
74 |
75 |
76 |
Basic Architecture
77 |
78 |
79 |
80 |
81 |
Rule Engine
82 |
83 | - is used match the transactions for reconciliation
84 |
85 | - Wiki
86 |
87 |
88 |
93 |
104 |
105 |
106 |
107 |
108 |
109 |
110 |
111 |
--------------------------------------------------------------------------------
/Tests/FinConcile.Tests/Properties/Resources.Designer.cs:
--------------------------------------------------------------------------------
1 | //------------------------------------------------------------------------------
2 | //
3 | // This code was generated by a tool.
4 | // Runtime Version:4.0.30319.42000
5 | //
6 | // Changes to this file may cause incorrect behavior and will be lost if
7 | // the code is regenerated.
8 | //
9 | //------------------------------------------------------------------------------
10 |
11 | namespace FinConcile.Tests.Properties {
12 | using System;
13 |
14 |
15 | ///
16 | /// A strongly-typed resource class, for looking up localized strings, etc.
17 | ///
18 | // This class was auto-generated by the StronglyTypedResourceBuilder
19 | // class via a tool like ResGen or Visual Studio.
20 | // To add or remove a member, edit your .ResX file then rerun ResGen
21 | // with the /str option, or rebuild your VS project.
22 | [global::System.CodeDom.Compiler.GeneratedCodeAttribute("System.Resources.Tools.StronglyTypedResourceBuilder", "15.0.0.0")]
23 | [global::System.Diagnostics.DebuggerNonUserCodeAttribute()]
24 | [global::System.Runtime.CompilerServices.CompilerGeneratedAttribute()]
25 | internal class Resources {
26 |
27 | private static global::System.Resources.ResourceManager resourceMan;
28 |
29 | private static global::System.Globalization.CultureInfo resourceCulture;
30 |
31 | [global::System.Diagnostics.CodeAnalysis.SuppressMessageAttribute("Microsoft.Performance", "CA1811:AvoidUncalledPrivateCode")]
32 | internal Resources() {
33 | }
34 |
35 | ///
36 | /// Returns the cached ResourceManager instance used by this class.
37 | ///
38 | [global::System.ComponentModel.EditorBrowsableAttribute(global::System.ComponentModel.EditorBrowsableState.Advanced)]
39 | internal static global::System.Resources.ResourceManager ResourceManager {
40 | get {
41 | if (object.ReferenceEquals(resourceMan, null)) {
42 | global::System.Resources.ResourceManager temp = new global::System.Resources.ResourceManager("FinConcile.Tests.Properties.Resources", typeof(Resources).Assembly);
43 | resourceMan = temp;
44 | }
45 | return resourceMan;
46 | }
47 | }
48 |
49 | ///
50 | /// Overrides the current thread's CurrentUICulture property for all
51 | /// resource lookups using this strongly typed resource class.
52 | ///
53 | [global::System.ComponentModel.EditorBrowsableAttribute(global::System.ComponentModel.EditorBrowsableState.Advanced)]
54 | internal static global::System.Globalization.CultureInfo Culture {
55 | get {
56 | return resourceCulture;
57 | }
58 | set {
59 | resourceCulture = value;
60 | }
61 | }
62 |
63 | ///
64 | /// Looks up a localized string similar to ProfileName,TransactionDate,TransactionAmount,TransactionNarrative,TransactionDescription,TransactionID,TransactionType,WalletReference
65 | ///Card Campaign,2014-01-11 22:27:44,-20000,*MOLEPS ATM25 MOLEPOLOLE BW,DEDUCT,0584011808649511,1,P_NzI2ODY2ODlfMTM4MjcwMTU2NS45MzA5,
66 | ///Card Campaign,2014-01-11 22:39:11,-10000,*MOGODITSHANE2 MOGODITHSANE BW,DEDUCT,0584011815513406,1,P_NzI1MjA1NjZfMTM3ODczODI3Mi4wNzY5,
67 | ///Card Campaign,2014-01-11 23:28:11,-5000,CAPITAL BANK MOGODITSHANE B [rest of string was truncated]";.
68 | ///
69 | internal static string BankMarkoffFile20140113 {
70 | get {
71 | return ResourceManager.GetString("BankMarkoffFile20140113", resourceCulture);
72 | }
73 | }
74 |
75 | ///
76 | /// Looks up a localized string similar to ProfileName,TransactionDate,TransactionAmount,TransactionNarrative,TransactionDescription,TransactionID,TransactionType,WalletReference
77 | ///Card Campaign,2014-01-11 22:27:44,-20000,*MOLEPS ATM25 MOLEPOLOLE BW,DEDUCT,0584011808649511,1,P_NzI2ODY2ODlfMTM4MjcwMTU2NS45MzA5,
78 | ///Card Campaign,2014-01-11 22:39:11,-10000,*MOGODITSHANE2 MOGODITHSANE BW,DEDUCT,0584011815513406,1,P_NzI1MjA1NjZfMTM3ODczODI3Mi4wNzY5,
79 | ///Card Campaign,2014-01-11 23:28:11,-5000,CAPITAL BANK MOGODITSHANE B [rest of string was truncated]";.
80 | ///
81 | internal static string ClientMarkoffFile20140113 {
82 | get {
83 | return ResourceManager.GetString("ClientMarkoffFile20140113", resourceCulture);
84 | }
85 | }
86 | }
87 | }
88 |
--------------------------------------------------------------------------------
/src/FinConcile.Web/Views/Transaction/UnmatchedDetailedReportPartial.cshtml:
--------------------------------------------------------------------------------
1 | @model FinReconcile.Models.CompareResult
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 | | @Model.ClientMarkOffFile |
10 | |
11 | |
12 | @Model.BankMarkOffFile |
13 | |
14 | |
15 |
16 |
17 |
18 |
19 | | Date |
20 | Amount |
21 | Reference |
22 | Id |
23 | Description |
24 | ProfileName |
25 | Narrative |
26 | Type |
27 | Date |
28 | Amount |
29 | Reference |
30 | Id |
31 | Description |
32 | ProfileName |
33 | Narrative |
34 | Type |
35 |
36 |
37 |
38 |
39 | @for (int i = 0; i < Model.Result.NotMatchedItems.Count; i++)
40 | {
41 | var clientTrans = Model.Result.NotMatchedItems[i].ClientTransaction;
42 | var bankTrans = Model.Result.NotMatchedItems[i].BankTransaction;
43 |
44 | @if (clientTrans != null)
45 | {
46 | | @clientTrans.Date.ToString() |
47 | @clientTrans.Amount.ToString() |
48 | @clientTrans.WalletReference |
49 | @clientTrans.Id |
50 | @clientTrans.Description |
51 | @clientTrans.ProfileName |
52 | @clientTrans.Narrative |
53 | @clientTrans.Type |
54 | }
55 | else
56 | {
57 | |
58 | |
59 | |
60 | |
61 | |
62 | |
63 | }
64 | @if (bankTrans != null)
65 | {
66 | @bankTrans.Date.ToString() |
67 | @bankTrans.Amount.ToString() |
68 | @bankTrans.WalletReference |
69 | @bankTrans.Id |
70 | @bankTrans.Description |
71 | @bankTrans.ProfileName |
72 | @bankTrans.Narrative |
73 | @bankTrans.Type |
74 | }
75 | else
76 | {
77 | |
78 | |
79 | |
80 | |
81 | |
82 | |
83 | }
84 |
85 | }
86 |
87 |
88 |
89 |
90 |
91 |
92 |
--------------------------------------------------------------------------------
/src/FinConcile.Web/Controllers/TransactionController.cs:
--------------------------------------------------------------------------------
1 | using FinReconcile.Core.Domain.Interfaces;
2 | using FinReconcile.Core.Engines;
3 | using FinReconcile.Infra;
4 | using FinReconcile.Infra.Parsers;
5 | using FinReconcile.Infra.Providers;
6 | using FinReconcile.Models;
7 | using System;
8 | using System.Collections.Generic;
9 | using System.IO;
10 | using System.Linq;
11 | using System.Web;
12 | using System.Web.Mvc;
13 |
14 | namespace FinReconcile.Controllers
15 | {
16 | [RoutePrefix("transaction")]
17 | public class TransactionController : Controller
18 | {
19 | private IMarkOffFileProvider _markOffFileProvider;
20 | private IMarkOffFileParser _csvFileReader;
21 | private IReconcileEngine _reconcileEngine;
22 | public TransactionController(IMarkOffFileProvider markoffFileProvider, IMarkOffFileParser csvFileReader, IReconcileEngine reconcileEngine)
23 | {
24 | _markOffFileProvider = markoffFileProvider;
25 | _csvFileReader = csvFileReader;
26 | _reconcileEngine = reconcileEngine;
27 | }
28 | // GET: Transaction
29 | public ActionResult Compare()
30 | {
31 | ViewBag.Title = "Compare Files";
32 | return View();
33 | }
34 | [HttpPost]
35 | public ActionResult Compare(CompareModel compareFiles)
36 | {
37 | try
38 | {
39 | if (ModelState.IsValid)
40 | {
41 | string clientFileName = null, bankFileName = null, sessionId;
42 | if (compareFiles.ClientMarkOffFile.ContentLength > 0 && compareFiles.BankMarkOfffile.ContentLength > 0)
43 | {
44 | clientFileName = Path.GetFileName(compareFiles.ClientMarkOffFile.FileName);
45 | sessionId = SessionIdGenerator.CreateNewId();
46 |
47 |
48 | ParserResult result = _csvFileReader.Validate(compareFiles.ClientMarkOffFile.InputStream);
49 | if (!result.IsValid)
50 | {
51 | ModelState.AddModelError("ClientMarkOffFile", result.Errors[1]);
52 | return View();
53 | }
54 | else
55 | {
56 | _markOffFileProvider.SaveMarkOffFile(compareFiles.ClientMarkOffFile.InputStream, sessionId, clientFileName);
57 | }
58 |
59 | result = _csvFileReader.Validate(compareFiles.BankMarkOfffile.InputStream);
60 | if (!result.IsValid)
61 | {
62 | ModelState.AddModelError("BankMarkOfffile", result.Errors[1]);
63 | return View();
64 | }
65 | else
66 | {
67 | bankFileName = Path.GetFileName(compareFiles.BankMarkOfffile.FileName);
68 | _markOffFileProvider.SaveMarkOffFile(compareFiles.BankMarkOfffile.InputStream, sessionId, bankFileName);
69 | }
70 | return RedirectToAction("compareresult", new { sid = sessionId, cfn = clientFileName, tfn = bankFileName });
71 | }
72 | }
73 |
74 | return View();
75 | }
76 | catch (Exception)
77 | {
78 |
79 | throw;
80 | }
81 | }
82 |
83 | [HttpGet]
84 | [Route("transaction/{sessionid}/compareresult",Name ="compareresult")]
85 | public ActionResult CompareResult(string sid,string cfn,string tfn)
86 | {
87 | var clientTransactions = _csvFileReader.GetRecords(_markOffFileProvider.GetMarkOffFile(sid, cfn));
88 | var bankTransactions = _csvFileReader.GetRecords(_markOffFileProvider.GetMarkOffFile(sid, tfn));
89 | IReconcileResult result = _reconcileEngine.Reconcile(clientTransactions, bankTransactions);
90 | CompareResult model = new CompareResult(cfn, tfn,result);
91 | ViewBag.Title = "Compare Files Result";
92 | return View("CompareResult", model);
93 | }
94 |
95 | [HttpGet]
96 | [Route("transaction/unmatchedreport", Name = "unmatchedreport")]
97 | public ActionResult UnmatchedReport(string sid, string cfn, string tfn)
98 | {
99 | var clientTransactions = _csvFileReader.GetRecords(_markOffFileProvider.GetMarkOffFile(sid, cfn));
100 | var bankTransactions = _csvFileReader.GetRecords(_markOffFileProvider.GetMarkOffFile(sid, tfn));
101 | IReconcileResult result = _reconcileEngine.Reconcile(clientTransactions, bankTransactions);
102 | CompareResult model = new CompareResult(cfn, tfn, result);
103 | ViewBag.Title = "Compare Files Result";
104 | return View("UnmatchedReport", model);
105 | }
106 | }
107 | }
--------------------------------------------------------------------------------
/src/FinConcile.Web/docs/js/featureSearch.js:
--------------------------------------------------------------------------------
1 |
2 | // feature navigation namespace
3 | (function(window) {
4 |
5 | window.FeatureNavigation = {
6 | getCurrent : getCurrentFeature,
7 | setCurrent: setCurrentFeature,
8 | getCurrentLink: getCurrentFeatureLink
9 | };
10 |
11 | function getCurrentFeature() {
12 | var query = window.location.search;
13 |
14 | if (query == null || query == '') {
15 | // support previous style relative path in hash ...
16 | var hash = window.location.hash;
17 | if (hash != null && hash != '') {
18 | // clear hash from url
19 | window.location.hash = '';
20 | // trim leading hash before returning
21 | return removeBeginningHash(hash);
22 | }
23 |
24 | return '';
25 | }
26 |
27 | // trim leading question mark
28 | query = query.substring(1);
29 |
30 | var queryVars = query.split('&');
31 |
32 | // find feature query param
33 | for (var i=0;i
-1;
99 | }
100 |
101 | function matchesFeatureTag(searchString, feature) {
102 | var foundMatch = false;
103 | var tags = searchString.split(" ");
104 | $.each(tags, function (index, tag) {
105 | tag = tag.toLowerCase();
106 | if (tag.indexOf("@") > -1) {
107 | $.each(feature.Feature.Tags, function (key, scenarioTag) {
108 | var lowerCasedTag = scenarioTag.toLowerCase();
109 | if (lowerCasedTag.indexOf(tag) > -1) {
110 | foundMatch = true;
111 | }
112 | });
113 | }
114 | });
115 |
116 | return foundMatch;
117 | }
118 |
119 | function matchesScenarioName(searchString, feature) {
120 | for (var i = 0; i < feature.Feature.FeatureElements.length; i++) {
121 | var scenarioName = feature.Feature.FeatureElements[i].Name.toLowerCase();
122 | if (scenarioName.indexOf(searchString) > -1) {
123 | return true;
124 | }
125 | }
126 | return false;
127 | }
128 |
129 | function matchesScenarioTag(searchString, feature) {
130 | var foundMatch = false;
131 | var tags = searchString.split(" ");
132 | $.each(tags, function (index, tag) {
133 | tag = tag.toLowerCase();
134 | if (tag.indexOf("@") > -1) {
135 | for (var i = 0; i < feature.Feature.FeatureElements.length; i++) {
136 | $.each(feature.Feature.FeatureElements[i].Tags, function (key, scenarioTag) {
137 | var lowerCasedTag = scenarioTag.toLowerCase();
138 | if (lowerCasedTag.indexOf(tag) > -1) {
139 | foundMatch = true;
140 | }
141 | });
142 | if (foundMatch) { break; }
143 | }
144 | }
145 | });
146 | return foundMatch;
147 | }
148 |
--------------------------------------------------------------------------------
/src/FinConcile.Web/docs/TransactionCompare.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | Compare Transactions
6 |
7 |
8 |
9 |
10 |
15 |
16 |
17 |
18 |
19 |
20 |
43 |
44 |
Compare Transactions
45 |
46 |
In order to reconcile transactions
47 | As a user
48 | I want to compare client and bank markoff files
49 |
50 |
51 | -
52 |
53 |
Tags: @tranascationcompare
54 |
Browse Compare Page
55 |
57 |
58 | -
59 | When the user goes to compare user screen
60 | -
61 | Then the compare user view should be displayed
62 |
63 |
68 | -
69 |
70 |
Tags: @transactioncompare
71 |
On Successful upload of Transaction Files,user should be shown Comparison Result Page
72 |
74 |
75 | -
76 | Given ClientMarkOffFile and BankMarkOffFile
77 | -
78 | When the user clicks on the Compare button
79 | -
80 | Then user should be redirected to compare result Page
81 |
82 |
87 | -
88 |
89 |
Tags: @transactioncompare
90 |
Details in Comparison Result Page
91 |
93 |
94 | -
95 | Given ClientMarkOffFile and BankMarkOffFile
96 | -
97 | When the user clicks on the Compare button
98 | -
99 | Then Comparison Result should contain Both Names of the Files 'ClientMarkoffFile20140113' and 'BankMarkoffFile20140113'
100 |
101 |
106 |
107 |
108 |
113 |