amizinge/URHOBO

# Digital Urhobo Ancestral Registry A secure, modern web platform where Urhobo people anywhere in the world can register, build family profiles, and explore their cultural heritage. ## Architecture Overview ### Tech Stack **Frontend:** - Next.js 14 with TypeScript - React 18 with Server Components - Tailwind CSS for styling - React Query for data fetching and caching - i18next for multilingual support (English/Urhobo) - PWA support with offline capabilities **Backend:** - NestJS with TypeScript - PostgreSQL database with Prisma ORM - JWT-based authentication - Role-based access control - RESTful API architecture **Infrastructure:** - Docker Compose for development - File storage (local dev → S3 production) - Map visualization with Leaflet/Mapbox - Analytics with Chart.js ### Core Features 1. **Unique Ancestral Identification Number (UAIN)** - Auto-generated unique identifier for each registered person 2. **User Profiles** - Rich personal and family profiles with ancestry information 3. **Family Linkage** - Connect family members across clans, villages, and kingdoms 4. **Cultural Archive** - Repository of Urhobo traditions, rituals, and history 5. **Hall of Fame** - Recognition of notable Urhobo individuals 6. **Geo-Visualization** - Interactive map showing demographic distribution 7. **Verification System** - Governance and verification by designated representatives ### Project Structure ``` /root ├── backend/ # NestJS backend application │ ├── src/ │ │ ├── auth/ # Authentication module │ │ ├── users/ # User management │ │ ├── profiles/ # Person profiles │ │ ├── relations/ # Family relations │ │ ├── archive/ # Cultural archive │ │ ├── hof/ # Hall of Fame │ │ ├── geo/ # Geographic data │ │ ├── verification/ # Verification system │ │ └── uploads/ # File handling │ ├── prisma/ # Database schema and migrations │ └── test/ …