Welcome to the Backend Docs
Everything a .NET developer needs to work on the eKYC 3.0 backend (ASP.NET Core 8.0).
Sections
Getting Started
Prerequisites, clone, dotnet restore, run. Swagger, Hangfire dashboard.
Mock Mode
GlobalMockEnabled, per-provider mock_mode, fixed OTPs, test scenarios.
Project Tour
5 projects (Api, Application, Domain, Infrastructure, Shared), folder layout.
Architecture
Clean architecture layers, dependency rules, links to full diagrams.
Coding Patterns
8 patterns: Clean Architecture, Provider Chain, Filter Pipeline, Command/Result, and more.
Stage Walkthrough
Trace Stage 1 Registration from HTTP request to DB write end-to-end.
Controllers
All 33 controllers, routes, stage filters, admin roles.
Services
45+ stage-specific and common services with responsibilities.
External Providers
60+ providers: PAN, Bank, Face Match, eSign, SMS, Payment, more.
Database & Sync Tables
75 entities, schema, EF Core, data lake sync tables (22 total).
Debugging
Serilog, Swagger, Hangfire, EF query logs, common issues.
How-To Guides
Add controller, service, provider, entity, migration.
FAQ & Glossary
Common backend questions + glossary.
Sonar Analysis
SonarAnalyzer.CSharp setup, SARIF reports, HTML via sarif-tools, auto-fixer scripts.
Master Dev Help
One-page lookup: "I want to change X — which file do I open?" Covers controllers, services, providers, DB, jobs, config.
Architecture & Deep Dives
- Backend Architecture (diagrams) - component diagram, clean-arch layers, provider chain, sequence diagrams
- Sync Tables Master List - 22 tables we expect to sync from the existing data lake / legacy DB
- DB Actions Checklist - all DB setup tasks required for go-live
- PostgreSQL Compatibility Audit - Oracle/SQL Server → PostgreSQL porting notes
Per-Stage BRD Analysis
These are exhaustive stage-by-stage BRD documents prepared during the Flutter rewrite. They contain detailed backend flow, DB writes, provider calls, and gap notes:
- 01 - Registration Backend
- 02 - Login / Resume Backend
- 03 - Stage 1 Registration
- 05 - Stage 2 OTP + PAN + KRA
- 06 - Stage 3 Email Verification
- 08 - Stage 4 PAN Confirmation
- 09 - Stage 5 Aadhaar + DigiLocker
- 11 - Stage 6 Bank Verification
- 12 - Stage 7 Liveness + Photo Match
- 14 - Stage 8 Signature
- 15 - Stage 9 Personal Details
- 17 - Stage 10 Income Proof
- 18 - Stage 11 Final Validation
- 20 - Stage 12 Document Generation
- 21 - Stage 13 eSign
- 23 - Stage 14 Account Creation
- 24 - Stage 15 Activation + Payment