SmartCredit 360

SmartCredit 360 is a bilingual lending demo built on Salesforce, FastAPI, React, and Flutter. It models a modern credit-origination flow with customer-facing web/mobile channels, AI-assisted scoring, internal Salesforce operations, and compliance-aware workflows.

SmartCredit 360; Salesforce, FastAPI, React ve Flutter üzerine kurulu iki dilli bir kredi platformu demosudur. Müşteri web/mobil kanalları, AI destekli skor hesaplama, Salesforce operasyon ekranları ve uyumluluk odaklı süreçleri tek akışta birleştirir.

Product Preview

Architecture

React Web Portal        Flutter Mobile App
        \                 /
         \  Bearer Auth  /
          v             v
          FastAPI Integration Gateway
             |       |         |
             |       |         +--> AI Credit Scoring
             |       +------------> Auth / Demo Customer Layer
             +--------------------> Salesforce Lending Core
                                      |
                                      +--> Apex Services / Triggers / Flows
                                      +--> Objects / Validation Rules / Tabs
                                      +--> LWC Internal UI

How The System Works

English

1. Customers use the React portal or Flutter mobile app to log in, review products, check score estimates, and submit loan applications.
2. Both clients talk only to the FastAPI gateway. No Salesforce credentials are stored in React or Flutter.
3. The FastAPI layer authenticates users, calls the AI scoring logic, and syncs applications/products/status data with Salesforce.
4. Salesforce acts as the lending core. Custom objects, Apex services, triggers, validation rules, and flows manage underwriting, collateral, agreements, collections, and compliance tracking.
5. Internal teams can use Salesforce tabs, Lightning App pages, and LWCs to review applications and operational data.

Turkce

1. Musteriler React portal veya Flutter mobil uygulama uzerinden giris yapar, urunleri gorur, skor tahmini alir ve kredi basvurusu gonderir.
2. Her iki istemci de sadece FastAPI gateway ile konusur. Salesforce sifreleri istemci tarafinda tutulmaz.
3. FastAPI katmani kullanici dogrulama, AI skor hesaplama ve Salesforce veri senkronizasyonunu yonetir.
4. Salesforce sistemin cekirdegidir. Ozel objeler, Apex servisleri, trigger'lar, validation rule'lar ve flow'lar kredi surecini yonetir.
5. Ic ekipler Salesforce icindeki tab'ler, Lightning uygulamasi ve LWC ekranlariyla operasyonlari takip eder.

Main Modules

English

• force-app/: Salesforce metadata, objects, Apex, flows, tabs, permission sets, and LWCs.
• python-api/: FastAPI gateway for authentication, products, applications, compliance, and scoring.
• react-app/: Customer-facing web experience built with Vite + React.
• smartcredit_mobile/: Flutter mobile app for the same customer journey.
• assets/branding/: Shared SmartCredit 360 logo system and app icon source.
• docs/mockups/: Approved product visuals used in this README.

Turkce

• force-app/: Salesforce metadata, objeler, Apex siniflari, flow'lar, permission set'ler ve LWC'ler.
• python-api/: Kimlik dogrulama, urunler, basvurular, compliance ve skor islemleri icin FastAPI katmani.
• react-app/: Musteri odakli web arayuzu.
• smartcredit_mobile/: Ayni yolculugun Flutter mobil uygulamasi.
• assets/branding/: Ortak logo sistemi ve app icon kaynagi.
• docs/mockups/: README icindeki urun gorselleri.

Branding

The SmartCredit shield logo is now wired into the delivery surfaces:

• Flutter app icon assets updated for Android, iOS, and Flutter Web.
• React web favicon now uses the SmartCredit brand mark.
• Shared icon source: assets/branding/smartcredit-app-icon.svg

Local Run

Backend

cd python-api
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
uvicorn main:app --reload --port 8000

React Web

cd react-app
npm install
cp .env.example .env
npm run dev

Flutter Mobile

cd smartcredit_mobile
flutter pub get
flutter run --dart-define=SMARTCREDIT_API_URL=http://10.0.2.2:8000/api

Salesforce Deployment

Recommended Commands

sf project deploy start --source-dir force-app/main/default --target-org orgpilot-dev
sf org assign permset --name SmartCredit_360_Admin --target-org orgpilot-dev
sf apex run --file scripts/apex/01_seed_products.apex --target-org orgpilot-dev

Post-Deploy Setup

• Create the SmartCredit_AI Named Credential for Apex callouts.
• Point it to a reachable FastAPI base URL, not localhost.
• Open App Launcher and launch SmartCredit 360.

Security Model

English

• React and Flutter hold only customer-facing tokens and non-secret API base URLs.
• Salesforce credentials and server secrets stay in python-api/.env.
• This keeps the browser and mobile clients isolated from direct Salesforce secret exposure.

Turkce

• React ve Flutter tarafinda sadece kullanici token'i ve gizli olmayan API adresleri bulunur.
• Salesforce giris bilgileri ve gizli anahtarlar sadece python-api/.env icinde tutulur.
• Boylece istemci uygulamalari dogrudan Salesforce sirlarina erismez.

Demo Flow

1. Seed products in Salesforce.
2. Start the FastAPI gateway.
3. Open the React app or launch Flutter.
4. Log in with the demo customer.
5. Submit an application.
6. Review the synced record and underwriting/compliance fields in Salesforce.

Notes

• This repository is a professional demo architecture, not legal or regulatory advice.
• For production use, connect real bureau, KYC, OFAC, audit, encryption, and model-governance systems.