Page 1 of 5
System Requirements Document (SRD)
Project Name: honest-models
1. Introduction
The honest-models project, developed for Channel Myanmar, aims to redefine the ADO AI platform with a focus on transparency, simplicity, and profitability. By leveraging OpenRouter API integration and dynamic pricing linked to Myanmar Kyat (MMK), the platform will deliver cutting-edge AI capabilities while ensuring user trust and sustainable business margins.
This document outlines the system requirements for the honest-models project, including functional and non-functional specifications, user personas, design concepts, and technical architecture.
2. System Overview
The honest-models platform will serve as an AI-powered service hub, offering text generation, image generation, and deep research functionalities. Key features include:
- Integration with OpenRouter API for seamless model access.
- Dynamic pricing linked to admin-pricing.html to account for currency fluctuations.
- Transparent user dashboards for honest usage tracking.
- Restructured subscription plans with exclusive model access per tier.
- Cloudflare R2 for stable image storage.
The system will prioritize simplicity, transparency, and user satisfaction while maintaining strong profit margins.
3. Functional Requirements
Page 2 of 5
As User:
- I should be able to generate high-quality images using a stable model integrated into ado-ai.html.
- I should be able to perform deep research and search functionalities seamlessly.
- I should be able to view a transparent usage dashboard showing:
- Cost breakdown per individual message.
- When image generations were performed and their associated cost.
- Total messages and credits consumed to date.
As Admin:
- I should be able to dynamically update pricing via admin-pricing.html, linked to the MMK exchange rate.
- I should be able to manage monthly usage limits for text messages and image generation per plan.
- I should be able to assign exclusive models to each subscription tier.
- I should be able to store generated images securely in Cloudflare R2.
As Guest:
- I should be able to access limited features without premium models.
4. User Personas
Admin
Description: Responsible for managing pricing, subscription plans, and system configurations.
Goals: Ensure profitability, maintain system stability, and provide user transparency.
User
Description: Subscribed members accessing AI functionalities based on their plan tier.
Goals: Generate text and images, perform research, and track usage transparently.
Guest
Description: Non-subscribed visitors exploring limited features.
Goals: Experience basic functionalities to evaluate the platform before subscribing.
5. Visuals Colors and Theme
Page 3 of 5
Color Palette
The honest-models platform will feature a clean, professional aesthetic with the following unique color palette:
- Background: #F4F4F9 (Soft Mist White)
- Surface: #EAEAEA (Gentle Gray)
- Text: #2E2E38 (Charcoal Black)
- Accent: #FF6F61 (Coral Red)
- Muted Tones: #B0B0B8 (Slate Gray)
This palette conveys trust, clarity, and modernity, aligning with the project's emphasis on transparency and honesty.
6. Signature Design Concept
Transparent Dashboard with Interactive Cost Breakdown
The homepage will feature a transparent usage dashboard as its centerpiece. Upon login, users will see:
- Dynamic Graphs: A live graph showing monthly usage trends for messages and images.
- Interactive Cost Breakdown: Hovering over any graph point will reveal detailed costs for individual actions (e.g., message generation or image creation).
- Plan Comparison Table: A collapsible table comparing all subscription tiers, highlighting allowances and exclusive model access.
Animations:
- Smooth transitions between dashboard sections.
- Subtle pulsating highlights on key metrics (e.g., remaining credits).
Micro-Interactions:
- Clicking on a graph point zooms into a detailed timeline view.
- Hovering over plan features reveals tooltips explaining benefits.
This design ensures users feel informed and engaged, fostering trust and satisfaction.
7. Non-Functional Requirements
- Performance: The system must handle up to 10,000 concurrent users without latency.
- Scalability: Cloudflare R2 and OpenRouter API must scale seamlessly with user growth.
- Security: All user data must be encrypted at rest and in transit.
- Availability: Ensure 99.9% uptime for critical services.
- Localization: Support dynamic currency conversion for MMK.
Page 4 of 5
8. Tech Stack
Frontend
Backend
Database
- MySQL (with Alembic for migrations)
AI Models
- GPT-5.4 for user-friendly responses
- Claude Sonnet 4.6 for academic or coding work
- Gemini 3.1 Pro for friendly responses
- Google Nano Banana for image generation
AI Tools
- Litellm for LLM Routing
- Langchain
Local Orchestration
Server-Side Orchestration
Page 5 of 5
9. Assumptions and Constraints
- Pricing calculations will always use the rate of $1 = 5,000 MMK.
- Free plan users will not have access to premium models.
- All integrations must comply with OpenRouter API standards.
- No emojis or icons will be used in the UI.
10. Glossary
- MMK: Myanmar Kyat, the local currency.
- OpenRouter API: A unified API for accessing AI models.
- Cloudflare R2: A cloud storage solution for generated images.
- Alembic: A database migration tool for MySQL.
- LLM: Large Language Model, used for AI text generation.
End of Document
No comments yet. Be the first!