- C# 41%
- JavaScript 31.1%
- HTML 10.4%
- SCSS 6.1%
- Less 5%
- Other 6.3%
Paul Schneider
512a0ef06f
PostIt is a desktop/mobile app talking to Yavsc.Org (https://yavsc.pschneider.fr) as an OIDC identity provider. The previous grant used the client_credentials flow with a client_secret embedded in postit-settings.json: this was both insecure (secret travels with the binary) and inappropriate for an interactive app (token had no user identity, so the API could not scope or audit). The new flow is Authorization Code + PKCE: * PostIt client (Settings/AuthenticationSettings.cs): the ClientSecret property is removed; GetOidcClientOptions now drops the secret and accepts an optional IBrowser supplied per-platform. * Settings.cs: new AndroidRedirectUri constant ('android://postit-signin') that the Android app uses; RedirectUri is no longer hard-coded in MainViewModel. * MainViewModel.cs: the manual discovery + client_credentials POST is replaced with OidcClient.LoginAsync (Authorization Code + PKCE). * Settings sample: Authority points at the real Yavsc.Org OP, not at a non-existent Keycloak-style realm path. * Yavsc.Org/Extensions/HostingExtensions.cs: the 'postit' client seed is now idempotent (MigratePostItClientToPublic) and detects legacy state on existing ConfigurationDb rows - flips RequireClientSecret=false, RequirePkce=true, drops any ClientSecret row, and replaces the legacy RedirectUris (https://yavsc.pschneider.fr/, yavsc://callback) with the current set (http://127.0.0.1:7890/, android://postit-signin). PostIt.Android: * MainActivity: explicit Name attribute so the activity alias can target a stable component; LaunchMode.SingleTask so the existing instance receives the deep-link Intent; OnNewIntent forwards the callback URI through AndroidOidcCallbackSink. * AndroidManifest.xml: activity-alias PostIt.Android.OidcCallbackActivity exposing scheme=android host=postit-signin to Android, so the OP redirect lands back in the running PostIt instance. The IdentityModel.OidcClient.Browser.SystemBrowser package and a thin AndroidSystemBrowser implementation are added in a follow-up so OidcClient.LoginAsync can actually drive Chrome Custom Tabs and consume AndroidOidcCallbackSink. |
||
|---|---|---|
| .forgejo/workflows | ||
| .github | ||
| .vscode | ||
| assets | ||
| contrib | ||
| doc | ||
| src | ||
| .dockerignore | ||
| .editorconfig | ||
| .env.sample | ||
| .eslintrc.json | ||
| .gitattributes | ||
| .gitignore | ||
| .jshintrc | ||
| Directory.Build.props | ||
| Directory.Packages.props | ||
| docker-compose.yaml | ||
| Dockerfile | ||
| Dockerfile.backend | ||
| dotnet-tools.json | ||
| esbuild.config.mjs | ||
| INSTALL.md | ||
| LICENSE | ||
| Makefile | ||
| package.json | ||
| README.md | ||
| ROADMAP.md | ||
| TODO.fr.md.archive | ||
| yavsc.sln | ||
Yavsc
C'est une application mettant en oeuvre une prise de contact entre un demandeur de services et son éventuel prestataire associé.
Statut actuel des actions GitHub
Construction et déploiement
Construction
dotnet build
et, pour execution en environment de développement
~/workspace/yavsc/Yavsc @ ASPNETCORE_ENV=Development dotnet run
Tests
Utilisez GNU/Makefile (et visitez le code, dans le dossier test ):
[TODO] Depuis le répertoire racine:
make test
Installation / Déploient / Développement
les services et l'API
La Prod
cd srv/Yavsc : make pushInProd CONFIGURATION=Release.
puis, pour une première installation
make install_service.
Fonctionnalités (encore en cours de développement)
Elle est censée aboutir à une prise commande, un payement du client, à une collecte du retour du client, et à un paiement du prestataire de services.
Elle comprendra une gestion des litiges.
Elle expose une messagerie instantanée, disponible depuis un navigateur Web ou depuis l’application mobile, pouvant garantir la preservation du secret sur toute information personnelle, du client comme du prestataire.
Ni le client ni le prestataire ne sont anonymes pour l'application, il sont même formellement authentifies, au moment de leur accord pour une première facturation en ligne, à l'occasion:
- pour le client, à la validation d'une commande facturée (de prestation à un prestataire, ou autre).
- pour le prestataire, de la validation de son profile professionnel, qui implique l’acquittement de son adhésion forfaitaire.
La séquence logique (et simplifiable) d'une prestation canonique (sans annulation ni reclamation) est la suivante :
- Une commande intervient auprès d'un prestataire, elle est chiffrée et le paiement est provisionné par PayPal, non collecté.
- Notifié, le prestataire valide un devis, avec arrhes ou avance. il signe son devis, qui peu contenir des documents attachés à faire signer par le client, un ou des contrats, stokés au format Markdown par le prestataire dans ses contrats à faire signer.
- à son tour, le client est notifié et signe le devis aussi
- Les arrhes ou avances sont débitées sur le champ
- 10 jours avant la date de la prestation le reste du paiement est collecté
Dans le cas des arrhes, à tout moment, jusqu'avant la date et l'heure de la prestation, le client ou le prestataire peuvent annuler:
- Le prestataire peut le faire, en rendant les arrhes majorées de 20%
- Le client peut le faire, en perdant les arrhes.
- Le prestataire peut déléguer à une équipe de son choix un filtrage des demandes des clients.
Limitations
- à une commande, une prestation
- Dans le cas de l'avance, une fois le paiement client autorisé, pour le moment, aucune annulation de la prestation n'est supportée.
- Une fois passée la date de la prestation, toute reclamation nécessitera l'intervention d'un système auxiliaire (un processus humain?)
- Un seul moyen de paiement: PayPal, depuis le Web ou l'application mobile, son interface dite dépréciée NVP/SOAP.
- Elle ne prendra pas en charge, du moins pas encore, ni la saisie de structures de projets complexes, ni ticketing associé à la prestation.
- Les professionnels sont tous considérés comme tierces parties, hormis le propriétaire de l'installation, dont les identifiants PayPal sont utilisés pour collecter tous les paiements. TODO Aucune edition de fiche de paye ni paiement en masse ne sont supportés pour l'instant. Seul les payments unitaires sus-cités le sont.
Paramétrage
Administration
Une fois le service disponible, s'enregistrer, et
Visiter l'url /Administration/Take
Une nouvelle activité
On gère les activité en faisant partie du groupe des commerciaux (FrontOffice),
on crée des activités en y associant des formulaires de commande et une
classe de paramétrage de profiles professionnels.
Développement
Un nouvel environnement d'execution
L'impact de l'usage d'un nouveau nom d’environnement d'execution, à l'heure de cet écrit, ressemble à ceci:
- Ajustement des listes d’environnements cités dans les pages:
- ~/Views/Shared/_Layout.cshtml
- ~/Views/Shared/_ValidationScriptsPartial.cshtml
- ~/Views/Home/Index.cshtml
- ~/Views/Home/About.cshtml
Remerciements
Photo de Dewang Guptasur Unsplash