Skip to content

Latest commit

 

History

History
113 lines (77 loc) · 3.57 KB

File metadata and controls

113 lines (77 loc) · 3.57 KB

Specification Links

This document maps features in this repository to their source specifications in the specs repository.

Spec Version: v1.1-specs

Last Updated: 2025-12-06


How to Use This Document

  1. When implementing a feature, find it in the table below
  2. Click the spec link to view the authoritative specification
  3. Use line number references to load only relevant sections
  4. Follow the spec exactly for API contracts, schemas, and behaviors

Core Specifications

Architecture

  • Flutter Mobile App Spec

    • Complete app architecture (entire file - ~2500 lines)
    • Project structure (lines 100-300)
    • Feature specifications (lines 300-1800)
    • UI/UX guidelines (lines 1800-2200)
    • Performance optimization (lines 2200-2400)
  • API Specification

    • REST endpoints for mobile (lines 80-1200)
    • Authentication (lines 120-280)
    • Dashboard metrics (lines 500-750)
  • GraphQL Schema

    • Queries for dashboard (lines 400-600)
    • Real-time subscriptions (lines 800-900)

Design

Implementation


Cross-Cutting Concerns

Localization

Market Context

  • Vietnam Market Strategy
    • Mobile-first requirements
    • Payment integrations (MoMo, ZaloPay, VNPay)
    • Social platform integrations (Zalo, Facebook)

Monitoring & Operations


Spec Update Protocol

When the specs repository releases a new version:

  1. Review SPEC_CHANGELOG.md
  2. Identify breaking changes affecting this repository
  3. Update this file to reference new spec version
  4. Implement required changes
  5. Update repository version and tag release

AI Context Loading

AI assistants should:

  • Load specs on-demand using the links above
  • Use line number ranges to minimize context
  • Reference this spec version consistently
  • Follow AI Context Guide

Example:

semantic_search(
  repo: "https://github.com/localstore-platform/specs",
  query: "OTP authentication endpoint"
)

Then read specific sections:

read_file(
  "architecture/api-specification.md",
  lines: 150-280
)