diff --git a/LICENSE b/LICENSE index 204eb38..b669936 100644 --- a/LICENSE +++ b/LICENSE @@ -1,6 +1,6 @@ PiOS License -Copyright (C) +Copyright (C) <2025> Permission is hereby granted by the application software developer (“Software Developer”), free of charge, to any person obtaining a copy of this application, software and associated diff --git a/README.md b/README.md index 1d25929..02ffdb2 100644 --- a/README.md +++ b/README.md @@ -1,47 +1,203 @@ # Pi Open Source (PiOS) -To view a list of open source Pi applications and libraries navigate to the [PiOS App List](/list.md) -To learn more about Pi Open Source and how to utilize it continue reading +FODUBU Unified Applications -## The License -The Pi Open Source Software License allows [Pi Community](https://minepi.com) Developers to create open source applications and tools for the Pi Ecosystem and foster collaboration among Pi community developers. In contrast to the MIT license the PiOS license grants unrestricted use of the software only within the Pi Ecosystem. Developers are encouraged to use this license when developing a Pi App. + Project Title -## Creating a PiOS application +FODUBU – Unified Pi-Powered Applications (PiOS) -We are offering projects github hosting under the `pi-apps` organization so that projects can be found easily. To request your own repo follow the steps below: +Overview -### 1. Submit a PR to the PiOS App List -Create a PR on this repository adding your application's information to the [PiOS App List](/list.md) table. Follow the formatted row template given on that doc, and fill in the below information as incomplete submissions will be rejected. - -Information necessary for the PR to be approved: -- Category (If you need a new Category add it directly in the PR) -- Title - - Can be in the form of “App_Name for Pi”, “App_Name on Pi”, “App_Name”, but not in the form of “Pi App_Name” - to avoid confusion with apps developed by the Pi Core Team - - You must include the following language in your code: Pi, Pi Network and the Pi logo are trademarks of the Pi Community Company. -- Description - Short description about what the application aims to achieve -- Programming Languages + Framework to be used -- Link to Pi Brainstorm project proposal (project name until feature is ready) +FODUBU (Force de Développement et Ubuntu au Burundi) is a Pi Network–powered utility organization and multisector company building decentralized applications (DApps) that enable real economic activity through trade, agriculture, and environmental sustainability. -Information NOT necessary for the PR to be approved: -- Link To Repo - Core Team will fill this in upon PR approval -- Link to Testnet App - Project admin to send new PR later when available -- Link to Mainnet App - Project admin to send new PR later when available +This Pi Open Source (PiOS) submission covers the FODUBU Unified Applications, a suite of three interoperable Pi-powered marketplaces that use Pi as the primary means of payment. -### 2. Pi Core Team will approve PR and create repository -We will approve your PR, create a repository under github.com/pi-apps and invite you as the admin of that repository. +🌍 Mission & Vision -The github user that submits the Pull Request to the PiOS Application Library table will be given admin privileges to this newly created repository. This will grant you full admin access to the repository to add additional team members, and perform any sensitive or destructive actions like managing security, moving or even deleting the repository. +Mission +To power inclusive trade, agricultural growth, and environmental sustainability using Pi Network as a decentralized payment and utility layer. -Other Pi community developers can also contribute to the maintenance and improvement of the application and submit Pull Requests directly to the project. As the admin you will be responsible for responding to those PRs or you can delegate this responsibility to your team members. Even though the Pi Core Team is providing you access to the github.com/pi-apps namespace for convenience, it will not maintain your repository or application code. You are fully responsible for your code. +Vision +To become a trusted Pi-powered digital infrastructure for trade and development across communities and markets. -In the future should you wish to remove your application from the Pi Open Source Library you will be able to do this by simply moving your project out and sending a PR to remove the link to your code from the list. As an admin of your repository you can move it or remove it anytime without the approval of the Pi Core Team. -### 3. Edit License in your application's code repository and start coding -To add the license to your code follow the below steps: -- Edit the Copyright line of the LICENSE file in your repo +🧩 Applications Covered (3 DApps) -Note: source of the PiOS license is also available here [https://github.com/pi-apps/PiOS/blob/main/LICENSE](https://github.com/pi-apps/PiOS/blob/main/LICENSE) +1️⃣ FODUBU – Main Unified App -#### Disclaimer -This is just a suggested license to limit use of your Software to Pi Network applications. Pi Network does not take any responsibility for the use of this license by you or others. All developers should consult their own counsel to ensure the license meets their needs and are solely liable for all consequences arising from the use of the license. To be included in the PiOS app list you are required to use this license without alterations, aside from the copyright notice. If you make alterations or use a different license, you may still be eligible to be included in other lists that may be established at some later time by Pi Network. +Central marketplace and utility hub + +Trade and service aggregation + +Entry point to the FODUBU ecosystem + + +2️⃣ TRACO – Agri-Connect Marketplace + +(Trade-Agri-Connect) + +Digital agricultural marketplace + +Buying and selling of agricultural products + +Seed distribution to branches and farmers + +Agricultural value-chain connectivity + + +3️⃣ SETRA – Eco Marketplace + +(Save Environmental Trade) + +Environment-focused marketplace + +Sustainable and eco-friendly trade + +Promotion of environmental responsibility through commerce + + +💱 Pi Network Integration + +All FODUBU applications: + +Use Pi as the means of payment + +Run inside the Pi Browser + +Integrate Pi authentication + +Verify payments via secure backend validation + + +> Important Disclaimer +FODUBU is an independent community-built project. + +Pi, Pi Network, and the Pi logo are trademarks of Pi Community Company. +This project is not affiliated with nor endorsed by Pi Network Core Team + +🏗 Technical Architecture + +Frontend + +ReactJS + +Vite + +Pi JavaScript SDK (@pi-apps/pi-sdk) + +Pi Browser–compatible UI + + +Backend + +Node.js + +Express.js + +Pi Backend SDK (@pi-apps/backend) + +Stellar SDK (@stellar/stellar-sdk) + +Secure Pi payment verification + + +Database & Infrastructure + +MongoDB Atlas + +Environment-based configuration + +CI-ready structure + + +🔗 Repositories & Links + +Backend (Unified API) + +FODUBU Unified API +https://github.com/FODUBU/fodubu-api + + +Pi Brainstorm + +FODUBU Pi Brainstorm Project +https://brainstorm.pinet.com/project/68b6d0be045f663593b54b34 + + +Live Frontends + +FODUBU Trade Portal +https://trade.fodubu.com + +TRACO Marketplace +https://traco.fodubu.com + +SETRA Marketplace +https://setra.fodubu.com + +🔐 Security & Compliance + +All Pi payments are verified server-side + +Secrets are managed via environment variables + +No private keys are exposed in frontend code + +Backend follows Pi Network payment verification flow + +Repository includes: + +SECURITY.md + +.env.example + +Controlled access for production secrets + +Review & Transparency + +Core backend is maintained in a private repository + +Read-only access or temporary reviewer access can be granted upon request + +CI pipelines are used for: + +Code quality checks + +Build verification + + +Public documentation and architecture are fully transparent + +Open Source & Community + +This project supports: + +Open standards + +Community contributions + +Ethical development principles + +Respect for Pi Network ecosystem rules + + +Contribution guidelines and code of conduct are provided in the repository. + +📜 License + +This project is released under the MIT License, allowing open use, modification, and distribution while protecting contributors. + +Summary + +FODUBU PiOS represents a real-world Pi utility ecosystem combining: + +Trade + +Agriculture + +Environmental sustainability + + +All powered by Pi Network, built with modern web technologies, and designed for scalable, secure, and inclusive commerce. + +© FODUBU — Force de Développement et Ubuntu au Burundi \ No newline at end of file diff --git a/list.md b/list.md index b0acd09..7456bb1 100644 --- a/list.md +++ b/list.md @@ -26,8 +26,8 @@ To add your project to the list follow the instructions [here](/README.md) ### Adding a new row to the table **To add a new row copy the formated line below, paste a copy onto the line below the last row of the Pi-OS contributions table and update it with your app's information** -| Title | Description | Category | Programming Language/Framework | Updated by Pi-CT |Brainstorm link | (When available) | (When available) | - +| Demo | This application showcases the authentication and payment functionalities of the Pi SDK. | Consumer Utility | , MongoDB | [demo](https://github.com/pi-apps/demo) | N/A | [pi://demo.pi](pi://demo.pi) | N/A | +| Pi Commerce Apps | Mock Ups and Material for the Pi Commerce Hackathon in 2024 | Social Media | Figma | [pi-commerce-app](https://github.com/pi-apps/pi-commerce-app)| | | | ### Potential App Categories - Social Media @@ -84,3 +84,5 @@ To add your project to the list follow the instructions [here](/README.md) | BLIYYAN | A marketplace that was founded at the urging of pioneers who needed a means to exchange pi currency for the goods and services they needed.We are ready to serve and provide all pioneer needs, we will immediately present all product proposals on our market.Together we fight for the success of the PiNet project. | Marketplace | PHP/Laravel, JS/Vue, DB/Mysql | [bliyyaan](https://github.com/bliyyaan/bliyyaan) | [https://brainstorm.pinet.com/project/67a468399b2522003c31de97](https://brainstorm.pinet.com/project/67a468399b2522003c31de97) | [BLIYYAAN TESTNET](https://test.bliyyaan.com) | [BLIYYAN MAINNET](https://bliyyaan.com) | | BLJ FOR PI| Berkah Lestari Jambi (BLJ FOR PI) is a application used to conduct buying and selling transactions using Pi as the means of payment | Marketplace | ReactJS - Laravel, MYSQL| [BLJ FOR PI](https://github.com/Berkahlestarijambi/Berkahlestarijambi)| [https://brainstorm.pinet.com/project/671ccd37ed1252004d30e295](https://brainstorm.pinet.com/project/671ccd37ed1252004d30e295)|[Testnet](https://testnet.bljambi.com)|[Mainnet](https://mainet.bljambi.com) | | Orbit | Post once, share everywhere, track growth, and get AI insights. Your all-in-one social management tool. | Business tool | JS/React | [Orbit](https://github.com/pi-apps/orbit) | https://brainstorm.pinet.com/project/68c9638fd8dec8dc8f3bce00 | [Testnet](https://orbit-test.web.app) | [Mainnet](https://tryorbit.web.app) | +|FODUBU,TRACO,SETRA| Fodubu Global Powering Trade;Growth with Pi is an Utility Organisation Application and Multisector Company that working in 3 Dapps all in one used to conduct buying and selling transactions using Pi as the means of payment | Marketplace | ReactJS/vite,pijavascript/sdkjs,Pi-nodejs/express ,Atlas| [FODUBU-UNIFIED-API](https://github.com/FODUBU/fodubu-api)||(https://brainstorm.pinet.com/project/68b6d0be045f663593b54b34)| |when available||when Available| +