add overall Gift Economies organization to this repo and refactor
This commit is contained in:
@@ -1,60 +1,5 @@
|
||||
---
|
||||
alwaysApply: false
|
||||
alwaysApply: true
|
||||
---
|
||||
# Time Safari / Endorser Search Tech Ecosystem
|
||||
|
||||
### Purpose
|
||||
|
||||
This describes the overall purpose and design across code repositories.
|
||||
|
||||
The Time Safari project (in the crowd-funder-for-time-pwa repository) is a front-end to make it intuitive and interesting to help people connect over activities. The intent is to enable people to find others with similar interests, to start activities and relationships via offers of help, and to encourage creative experiments for deeper and more widespread connections.
|
||||
|
||||
There are 3 kinds of actions in Time Safari:
|
||||
|
||||
- Gives, recognizing something given (whether time or physical goods) and the resulting impact
|
||||
|
||||
- Offers of help, to individuals or projects, which can be fulfilled by subsequent gives
|
||||
|
||||
- Projects, which aggregate offers and/or gives for a common purpose
|
||||
|
||||
The Endorser Server is an HTTP API service that allows recording of cryptographically signed assertions in a privacy-preserving fashion. Each participant chooses whether to allow any other participant to see their name attached to activity. The service is a convenient way to get basic functions; it is expected to provide direct P2P communications to support the same functionality for anyone who wants the alternative.
|
||||
|
||||
Web and mobile apps allow users to interact with the Endorser Server. The endorser-mobile project is a powerful interface but is not very user-friendly.
|
||||
|
||||
### Structure
|
||||
|
||||
The primary repos contain the majority of the functionality; the secondary repos are helpful but not absolutely necessary.
|
||||
|
||||
These repos are found on the local filesystem in the `repos` directory, ie. `../../repos` relative to this directory.
|
||||
|
||||
Primary Repos:
|
||||
|
||||
- endorser-ch is the back-end, written in Typescript
|
||||
|
||||
- crowd-funder-for-time-pwa is the front-end named Time Safari, written in Typescript with Vue & Vite, with deployments for mobile as well as web
|
||||
|
||||
Secondary Repos:
|
||||
|
||||
- image-api is a service for storing images, in Typescript
|
||||
|
||||
- py-push-server is a service to send push notifications
|
||||
|
||||
- lives-of-gifts is the website for the overall vision for humanity
|
||||
|
||||
- gifting-org-content is for design and other creative artifacts
|
||||
|
||||
- kickstarter-for-time is a playground to implement HTML designs that are subsequently moved into crowd-funder-for-time-pwa
|
||||
|
||||
- uport-demo is the web-facing front-end to explain the Endorser server
|
||||
|
||||
- endorser-docs is the documentation explaining the Endoser server design, in Restructured Text format
|
||||
|
||||
- time-safari-web is for the single pages at timesafari.org & timesafari.com
|
||||
|
||||
- endorser-mobile is the previous native app to talk to the Endorser server -- very powerful but harder to use
|
||||
|
||||
### Hosting
|
||||
|
||||
These repos are hosted by GitHub: endorser-ch, endorser-mobile, lives-of-gifts uport-demo, endorser-docs, time-safari-web
|
||||
|
||||
The remaining repos are hosted by gitea.anomalistdesign.com
|
||||
- If any work involves code or tech, read from the "tech directory in this folder.
|
||||
|
||||
69
.cursor/rules/tech/README.mdc
Normal file
69
.cursor/rules/tech/README.mdc
Normal file
@@ -0,0 +1,69 @@
|
||||
---
|
||||
alwaysApply: false
|
||||
---
|
||||
# Time Safari / Endorser Search Tech Ecosystem
|
||||
|
||||
> **Note**: For strategic planning and project vision, see the [main README](../../README.md) and [strategic planning docs](../../docs/). This file focuses on technical implementation details.
|
||||
|
||||
### Purpose
|
||||
|
||||
This describes the overall purpose and design across code repositories.
|
||||
|
||||
The Time Safari project (in the crowd-funder-for-time-pwa repository) is a front-end to make it intuitive and interesting to help people connect over activities. The intent is to enable people to find others with similar interests, to start activities and relationships via offers of help, and to encourage creative experiments for deeper and more widespread connections.
|
||||
|
||||
There are 3 kinds of actions in Time Safari:
|
||||
|
||||
- Gives, recognizing something given (whether time or physical goods) and the resulting impact
|
||||
|
||||
- Offers of help, to individuals or projects, which can be fulfilled by subsequent gives
|
||||
|
||||
- Projects, which aggregate offers and/or gives for a common purpose
|
||||
|
||||
The Endorser Server is an HTTP API service that allows recording of cryptographically signed assertions in a privacy-preserving fashion. Each participant chooses whether to allow any other participant to see their name attached to activity. The service is a convenient way to get basic functions; it is expected to provide direct P2P communications to support the same functionality for anyone who wants the alternative.
|
||||
|
||||
Web and mobile apps allow users to interact with the Endorser Server. The endorser-mobile project is a powerful interface but is not very user-friendly.
|
||||
|
||||
### Structure
|
||||
|
||||
The primary repos contain the majority of the functionality; the secondary repos are helpful but not absolutely necessary.
|
||||
|
||||
These repos are found on the local filesystem in the `repos` directory, ie. `../../repos` relative to this directory.
|
||||
|
||||
### Related Documentation
|
||||
|
||||
- **[Time Safari / Endorser Overview](../../tech/README-time-safari-endorser.md)** - High-level technical overview
|
||||
- **[Endorser.ch API Context](../../tech/README-endorser-context.md)** - Detailed API documentation
|
||||
- **[Active Projects & Tasks](../../tech/progress/)** - Current technical projects and tasks
|
||||
- **[Strategic Planning](../../docs/)** - Project vision and strategic planning documents
|
||||
|
||||
Primary Repos:
|
||||
|
||||
- endorser-ch is the back-end, written in Typescript
|
||||
|
||||
- crowd-funder-for-time-pwa is the front-end named Time Safari, written in Typescript with Vue & Vite, with deployments for mobile as well as web
|
||||
|
||||
Secondary Repos:
|
||||
|
||||
- image-api is a service for storing images, in Typescript
|
||||
|
||||
- py-push-server is a service to send push notifications
|
||||
|
||||
- lives-of-gifts is the website for the overall vision for humanity
|
||||
|
||||
- gifting-org-content is for design and other creative artifacts
|
||||
|
||||
- kickstarter-for-time is a playground to implement HTML designs that are subsequently moved into crowd-funder-for-time-pwa
|
||||
|
||||
- uport-demo is the web-facing front-end to explain the Endorser server
|
||||
|
||||
- endorser-docs is the documentation explaining the Endoser server design, in Restructured Text format
|
||||
|
||||
- time-safari-web is for the single pages at timesafari.org & timesafari.com
|
||||
|
||||
- endorser-mobile is the previous native app to talk to the Endorser server -- very powerful but harder to use
|
||||
|
||||
### Hosting
|
||||
|
||||
These repos are hosted by GitHub: endorser-ch, endorser-mobile, lives-of-gifts uport-demo, endorser-docs, time-safari-web
|
||||
|
||||
The remaining repos are hosted by gitea.anomalistdesign.com
|
||||
39
README.md
39
README.md
@@ -1,11 +1,38 @@
|
||||
# README-first
|
||||
|
||||
Context for all the technical info for Time Safari and the Endorser Search server.
|
||||
# Gift Economies / Lives of Impact
|
||||
|
||||
Other repos are located in the `repos` directory.
|
||||
Let's build gift economies.
|
||||
|
||||
For more details, see [the cursor rules README](./.cursor/rules/README.mdc).
|
||||
> This is my overarching purpose, to help align people's hearts & minds with the things in life that will do that the most good. I believe that humans achieve their highest purpose when we have a culture of sharing and gratitude, much like what has been taught by spiritual people like Jesus, Buddha, and Gandhi, and "gift economies" is a concrete and compelling catch-phrase to get to these ideas. - Trent
|
||||
|
||||
Kudos:
|
||||
One intent is to enable alternative ways of supporting one another, outside the traditional exchanges of money.
|
||||
|
||||
- Some of the .mdc files are templates from https://github.com/PatrickJS/awesome-cursorrules
|
||||
This shift will causes changes in govenance as well, making monopoly government less relevant as other motivations take over.
|
||||
|
||||
These projects are typically open source. They aim for a sustainable project, and if they yield a profit then it won't be extravagant. This is to follow the principle of benefitting as many people as possible, as quickly as possible.
|
||||
|
||||
The following projects contribute to this overall purpose. All projects are open-source.
|
||||
|
||||
- Time Safari is a mobile app (also available on the web) for any user to build a network of people, show them direct gratitude, and also enable them to initiate projects together. It aims to ease the onboarding to the Endorser Server, as well as the sharing of public/private key credentials.
|
||||
|
||||
- Endorser Server is a server-side application that maintains a chain of cryptographically-signed claims, revealing personal data or metadata only as permissioned by each user. The goal is to allow all the functions to be run in a P2P network, such that users can migrate to peer-to-peer or at least have the ability to choose which servers they use for their work.
|
||||
|
||||
## Organization
|
||||
|
||||
This repository contains the overall vision and strategic planning for the Lives of Gifts project, along with technical documentation for the Time Safari and Endorser applications.
|
||||
|
||||
### Setup
|
||||
|
||||
We may include links to the [./repos](repos) which are other repositories involved. These are typically located in the parent directory, so we recommend users create a soft link to that directory, eg `ln -s .. repos`
|
||||
|
||||
### Strategic Planning Files
|
||||
|
||||
This project uses a structured planning system located in `doc/` to maintain strategic clarity and provide context for AI conversations:
|
||||
|
||||
- **[Strategic Overview](./strategic-overview.md)** - Long-term vision and goals
|
||||
- **[Project Inventory](./projects.md)** - Complete repository status
|
||||
- **[Success Metrics](./metrics.md)** - KPIs and measurement framework
|
||||
|
||||
### Technical Documentation
|
||||
|
||||
Refer to the [Project Inventory](./projects.md) to find specific application & code details.
|
||||
|
||||
54
metrics.md
Normal file
54
metrics.md
Normal file
@@ -0,0 +1,54 @@
|
||||
|
||||
# Success Metrics & KPIs
|
||||
|
||||
## Quantitative Metrics
|
||||
|
||||
### Platform Impact
|
||||
- [ ] **Lives Supported**: Number/percentage of livelihoods supported with gifts
|
||||
- [ ] **Project Initiations**: Number of collaborative projects started
|
||||
- [ ] **Funds Recorded**: Number of hours or amounts of currency recorded
|
||||
- [ ] **Connections Made**: New relationships formed through the platform
|
||||
- [ ] **Gift Recording**: Number of gifts/acts of kindness recorded per day
|
||||
- [ ] **Trust Building**: Number of endorsements/verifications exchanged
|
||||
|
||||
### User Adoption
|
||||
- [ ] **Active Users**: Daily/Weekly/Monthly active users
|
||||
- [ ] **User Retention**: % of users who return after 1 week, 1 month
|
||||
- [ ] **Network Growth**: Rate of new user registrations
|
||||
- [ ] **Geographic Spread**: Number of cities/countries with active users
|
||||
|
||||
### Technical Performance
|
||||
- [ ] **System Uptime**: Platform availability percentage
|
||||
- [ ] **Response Time**: Average API response times
|
||||
- [ ] **Data Security**: Zero security breaches
|
||||
- [ ] **P2P Readiness**: Percentage of functions that can run peer-to-peer
|
||||
|
||||
## Qualitative Indicators
|
||||
|
||||
### Cultural Impact
|
||||
- [ ] **Community Stories**: Documented cases of gifting economy success
|
||||
- [ ] **Behavior Change**: Evidence of users shifting from monetary to gift-based exchanges
|
||||
- [ ] **Ripple Effects**: Secondary impacts in users' offline communities
|
||||
- [ ] **Media Coverage**: Positive coverage of gifting economy concept
|
||||
|
||||
### User Experience
|
||||
- [ ] **User Satisfaction**: Survey scores and feedback sentiment
|
||||
- [ ] **Ease of Use**: Time to complete key actions (record gift, find collaborator)
|
||||
- [ ] **Feature Adoption**: Which features are most/least used
|
||||
- [ ] **Support Requests**: Volume and nature of user support needs
|
||||
|
||||
## Milestone Targets / Goals ?
|
||||
|
||||
## Leading vs Lagging Indicators
|
||||
|
||||
### Leading Indicators (Predict Future Success)
|
||||
- User engagement depth (time spent, features used)
|
||||
- Community formation rate
|
||||
- Developer contributions to open source repos
|
||||
- Partnership inquiries
|
||||
|
||||
### Lagging Indicators (Measure Past Success)
|
||||
- Total user base size
|
||||
- Revenue/sustainability metrics
|
||||
- Media mentions and recognition
|
||||
- Academic research citations
|
||||
27
projects.md
Normal file
27
projects.md
Normal file
@@ -0,0 +1,27 @@
|
||||
|
||||
# Project Inventory & Status
|
||||
|
||||
## Documentation & Planning Repos
|
||||
|
||||
- `endorser-docs/` - Technical documentation
|
||||
- `README-time-safari/` - Time Safari specific docs
|
||||
- `lives-of-gifts/` - General project content
|
||||
- `uport-demo/` - Endorser web pages
|
||||
- `gifting-org-content/` - Marketing/educational content
|
||||
|
||||
## Technology Repos
|
||||
|
||||
### Time Safari (Mobile/Web App)
|
||||
- **Purpose**: User-friendly interface for recording gifts, building networks, & initiating projects
|
||||
- **Repository**: `crowd-funder-for-time-pwa/`
|
||||
- **Technology**: PWA, Vue.js, Capacitor for mobile
|
||||
|
||||
### Endorser Server
|
||||
- **Purpose**: Backend for cryptographically-signed claims with user-controlled privacy
|
||||
- **Repository**: `endorser-ch/`
|
||||
- **Technology**: Node.js backend
|
||||
|
||||
### Utilities & Tools
|
||||
- `image-api/` - Image handling service
|
||||
- `py-push-server/` - Push notification service
|
||||
- `daily-notification-plugin/` - Notification system
|
||||
35
strategic-overview.md
Normal file
35
strategic-overview.md
Normal file
@@ -0,0 +1,35 @@
|
||||
|
||||
# Strategic Overview: Gift Economies Vision
|
||||
|
||||
## Mission Statement
|
||||
Build gift economies that align people's hearts & minds with things that do the most good, creating a culture of sharing and gratitude.
|
||||
|
||||
## Long-Term Goals (3-5 Years)
|
||||
|
||||
### 1. Cultural Transformation
|
||||
- **Goal**: Create sustainable alternative economic model shifting society toward sharing, gratitude, and mutual support
|
||||
- **Success Indicator**: Measurable reduction in purely monetary exchanges within user communities
|
||||
- **Timeline**: 3-5 years
|
||||
|
||||
### 2. Technical Infrastructure
|
||||
- **Goal**: Build robust, decentralized platform ecosystem
|
||||
- **Components**: Time Safari app + Endorser Server + supporting tools
|
||||
- **Success Indicator**: P2P network capability with user-controlled data migration
|
||||
- **Timeline**: 2-3 years
|
||||
|
||||
### 3. Community Adoption
|
||||
- **Goal**: Achieve meaningful user adoption with network effects
|
||||
- **Success Indicator**: Active daily users recording gifts, finding collaborators, initiating projects
|
||||
- **Timeline**: 1-3 years
|
||||
|
||||
### 4. Governance Innovation
|
||||
- **Goal**: Demonstrate reduced dependence on traditional monetary systems and centralized governance
|
||||
- **Success Indicator**: Communities operating primarily through gifting economy principles
|
||||
- **Timeline**: 3-5+ years
|
||||
|
||||
## Core Principles
|
||||
- Open source everything
|
||||
- Sustainable projects (profit is not extravagant)
|
||||
- Benefit as many people as possible, as quickly as possible
|
||||
- Enable alternative ways of supporting one another outside traditional money exchange
|
||||
- Cryptographically-signed claims with user-controlled privacy
|
||||
@@ -1,5 +1,7 @@
|
||||
# Endorser.ch Context
|
||||
|
||||
> **Note**: This is technical API documentation. For the overall project vision, see the [main README](../README.md). For the tech ecosystem overview, see [Time Safari / Endorser Tech Overview](./README-time-safari-endorser.md).
|
||||
|
||||
## Project Overview
|
||||
Endorser.ch is an API for creating and querying claims in privacy-preserving ways. The system allows users to make cryptographically signed claims (attestations) and confirmations while maintaining control over their personal identifiers' visibility.
|
||||
|
||||
16
tech/README-time-safari-endorser.md
Normal file
16
tech/README-time-safari-endorser.md
Normal file
@@ -0,0 +1,16 @@
|
||||
# Time Safari / Endorser Tech Ecosystem
|
||||
|
||||
Context for all the technical info for Time Safari and the Endorser Search server.
|
||||
|
||||
> **Note**: This is technical documentation. For the overall project vision and strategic planning, see the [main README](../README.md).
|
||||
|
||||
Other repos are located in the `repos` directory.
|
||||
|
||||
For more details, see:
|
||||
- [Tech Ecosystem Cursor Rules](../.cursor/rules/tech/README.mdc) - Detailed technical context for AI conversations
|
||||
- [Endorser.ch API Context](./README-endorser-context.md) - Detailed API documentation
|
||||
- [Active Projects & Tasks](./progress/) - Current technical projects and tasks
|
||||
|
||||
Kudos:
|
||||
|
||||
- Some of the .mdc files are templates from https://github.com/PatrickJS/awesome-cursorrules
|
||||
5
tech/progress/PROJECT-contacts.md
Normal file
5
tech/progress/PROJECT-contacts.md
Normal file
@@ -0,0 +1,5 @@
|
||||
# Contacts App
|
||||
|
||||
Problem: no cross-platform contact-management app that allow
|
||||
|
||||
Value Proposition
|
||||
Reference in New Issue
Block a user