feat(contracts): implement content flagging mechanism

.github/pull_request_template.md

@@ -0,0 +1,39 @@
+# Pull Request Template
+
+## Description
+
+Please include a summary of the change and which issue is fixed. Also include relevant motivation and context.
+
+---
+
+## Checklist
+- [ ] I have tested my changes locally
+- [ ] I have updated documentation as needed
+- [ ] I have run `npx prisma generate` after schema changes
+- [ ] I have run `npx prisma migrate dev` or `npx prisma migrate deploy` as appropriate
+
+---
+
+## Post-Merge Steps for Maintainers
+
+**If this PR includes changes to the Prisma schema:**
+
+1. Run the following command to apply the migration to your database:
+
+   ```sh
+   npx prisma migrate deploy
+   ```
+   or, for local development:
+   ```sh
+   npx prisma migrate dev
+   ```
+2. Ensure your CI pipeline runs the migration before tests (add this step if missing):
+   ```yaml
+   - name: Run Prisma Migrate
+     run: npx prisma migrate deploy
+   ```
+3. Make sure the database user in CI has permission to run migrations.
+
+---
+
+If you have any questions, please comment on this PR.

.github/workflows/rust.yml

@@ -0,0 +1,41 @@
+name: Contracts CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  contracts:
+    runs-on: ubuntu-latest
+
+    defaults:
+      run:
+        working-directory: contracts
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+          targets: wasm32-unknown-unknown
+
+      - name: Cache Rust dependencies
+        uses: Swatinem/rust-cache@v2
+
+      - name: Check formatting
+        run: cargo fmt --all -- --check
+
+      - name: Run clippy
+        run: cargo clippy --workspace --all-targets --all-features -- -D warnings
+
+      - name: Run tests
+        run: cargo test --workspace
+
+      - name: Build WASM artifacts
+        run: cargo build --workspace --target wasm32-unknown-unknown --release
+

.github/workflows/test.yml

@@ -0,0 +1,75 @@
+name: Run Tests
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    env:
+      DATABASE_URL: postgresql://postgres:postgres@localhost:5432/geev_test
+      JWT_SECRET: test-secret-key
+      NODE_ENV: test
+    runs-on: ubuntu-latest
+
+    defaults:
+      run:
+        working-directory: app
+
+    services:
+      postgres:
+        image: postgres:15
+        env:
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
+          POSTGRES_DB: geev_test
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          - 5432:5432
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: pnpm install --no-frozen-lockfile
+
+      - name: Generate Prisma Client
+        run: |
+          npx prisma format
+          npx prisma generate
+
+      - name: Run database migrations
+        env:
+          DATABASE_URL: postgresql://postgres:postgres@localhost:5432/geev_test
+        run: npx prisma migrate deploy
+
+      - name: Run tests
+        env:
+          DATABASE_URL: postgresql://postgres:postgres@localhost:5432/geev_test
+          JWT_SECRET: test-secret-key
+          NODE_ENV: test
+        run: npm run test:ci
+
+      - name: Upload coverage reports
+        uses: codecov/codecov-action@v3
+        if: always()
+        with:
+          files: ./app/coverage/coverage-final.json
+          flags: unittests
+          name: codecov-umbrella
+          fail_ci_if_error: false

.gitignore

@@ -9,6 +9,12 @@
 !.yarn/plugins
 !.yarn/releases
 !.yarn/versions
+.pnpm
+.turbo
+yarn.lock
+package-lock.json
+pnpm-lock.yaml
+wave-*.md
 
 # testing
 /coverage
@@ -32,10 +38,17 @@ yarn-error.log*
 
 # env files (can opt-in for committing if needed)
 .env*
+!.env.example
 
 # vercel
 .vercel
 
 # typescript
 *.tsbuildinfo
 next-env.d.ts
+
+/lib/generated/prisma
+
+# rust
+**/target/
+wave-*.md

README.md

@@ -2,6 +2,10 @@
 
 Geev is a decentralized social platform built on the Stellar blockchain that enables users to create giveaways, post help requests, and participate in community-driven mutual aid. It combines social networking features with Web3 wallet integration to facilitate transparent, trustless giving and receiving.
 
+[![Tests](https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/geevapp)
+[![Discord](https://img.shields.io/discord/1482790798016643103?style=for-the-badge&logo=discord&label=Join%20the%20community)](https://discord.gg/wQP2CkHj)
+
+
 ## FRONTEND TECHNOLOGY STACK
 
 - **Framework**: Next.js 15 (App Router)
@@ -11,6 +15,23 @@ Geev is a decentralized social platform built on the Stellar blockchain that ena
 - **State Management**: React Context API + SWR for data fetching
 - **Icons**: Lucide React
 - **Animations**: Framer Motion (for scroll animations and transitions)
+- **Theme System**: next-themes with light/dark mode support
+
+## DOCUMENTATION
+
+- [Theme System](docs/theme.md) - Light/dark mode implementation and usage guide
+- [Components](docs/components.md) - Component library documentation
+
+## BACKEND INFRASTRUCTURE
+
+The backend is integrated into the Next.js application using API Routes.
+
+- **ORM**: Prisma (PostgreSQL)
+- **API Routes**: Located in `app/api/`
+- **Utilities**:
+  - `lib/prisma.ts`: Prisma client singleton and connection testing.
+  - `lib/api-response.ts`: Standardized API response helpers (`apiSuccess`, `apiError`).
+- **Middleware**: Handles Request Logging and CORS in `middleware.ts`.
 
 ## RESOURCES
 
@@ -19,14 +40,63 @@ Geev is a decentralized social platform built on the Stellar blockchain that ena
 - [PROJECT SUMMARY](https://docs.google.com/document/d/1ZEfrbVF_rjJ3GrLYeTxTboRL15dT0kaVyioXrdPpmMU)
 - [FEATURE SPECIFICATIONS](https://docs.google.com/document/d/1qRyFhhAqBgZU8NtrVmMk6HV2qSi0nb_K3sxrgPaKymI)
 
+
+## Logout Behavior
+
+The `/api/auth/logout` route is deprecated.
+
+Use:
+- `signOut()` from next-auth/react (client-side)
+- `POST /api/auth/signout` (server-side)
+
+This ensures proper session invalidation.
+
 ## Getting Started
 
-First, run the development server:
+### Frontend Application
+
+If you're working on the frontend application, the `app` directory contains the Next.js codebase. To get started, follow these steps:
+
+1. Install dependencies:
+   ```bash
+   npm install
+   ```
+2. Configure environment variables in `.env`:
+   ```env
+   DATABASE_URL="postgresql://user:password@localhost:5432/mydb?schema=public"
+   ```
+3. Generate Prisma Client:
+   ```bash
+   npx prisma generate
+   ```
+4. Run the development server:
+   ```bash
+   npm run dev
+   ```
+   Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+You can start editing and creating pages and components. The backend API routes are located in `app/api/` and can be modified to implement the necessary functionality for the application.
+Refer to the [app/README.md](app/README.md) for more detailed information on the frontend and backend infrastructure, documentation, and resources.
 
-```bash
-npm run dev
-```
+### Smart Contracts
 
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+The `contracts` directory contains the Soroban smart contracts for the platform. To get started with the smart contracts, follow these steps:
 
-You can start editing and creating pages and components.
+1. Install Soroban CLI:
+   ```bash
+   cargo install --locked soroban-cli
+   ```
+2. Build the smart contracts:
+   ```bash
+   soroban build
+   ```
+3. Deploy the smart contracts to the Stellar testnet or a local Soroban environment:
+   ```bash
+   soroban deploy --network testnet
+   ```
+   or
+   ```bash
+   soroban deploy --network local
+   ```
+4. Interact with the deployed smart contracts using the Soroban CLI or by integrating them into the frontend application.
+   Refer to the [contracts/README.md](contracts/README.md) for more detailed information on the smart contract architecture, deployment, and interaction.

app/.env.example

@@ -0,0 +1,23 @@
+DATABASE_URL=postgresql://geev:bridgelet_pass@localhost:5432/geev
+AUTH_SECRET=
+NEXTAUTH_SECRET=
+
+AWS_REGION=us-east-1
+AWS_ACCESS_KEY_ID=...
+AWS_SECRET_ACCESS_KEY=...
+AWS_S3_BUCKET=your-bucket-name
+CDN_BASE_URL=https://cdn.yourdomain.com 
+# SEP-10 Stellar Web Authentication Configuration
+# Generate a new Stellar keypair for the server using: https://laboratory.stellar.org/#account-creator?network=public
+STELLAR_SERVER_SECRET=SBSW2XWCHXLQ4OZIQ2Q3TQ3DJC23LK3LQ3LQ3LQ3LQ3LQ3LQ3LQ3LQ3L
+STELLAR_HOME_DOMAIN=geev.app
+STELLAR_WEB_AUTH_DOMAIN=geev.app
+
+# Soroban Indexer Configuration
+SOROBAN_RPC_URL=https://soroban-testnet.stellar.org
+GEEV_CONTRACT_ID=
+SOROBAN_NETWORK=testnet
+INDEXER_POLL_INTERVAL_MS=5000
+
+# Cron Job Secret (for securing cron endpoints)
+CRON_SECRET=your-secret-key-here